@ripwords/myinvois-client 0.1.6 → 0.2.0

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

package/myinvois-cert.conf.template

@@ -1,23 +0,0 @@
-[req]
-distinguished_name = req_distinguished_name
-req_extensions = v3_req
-prompt = no
-
-[req_distinguished_name]
-C = MY
-ST = YOUR_STATE
-L = YOUR_CITY
-O = YOUR_COMPANY_NAME
-CN = YOUR_COMPANY_NAME
-emailAddress = YOUR_EMAIL
-# SERIALNUMBER field - Business registration number (e.g., 202301234567)
-serialNumber = YOUR_BUSINESS_REGISTRATION_NUMBER
-
-[v3_req]
-keyUsage = keyEncipherment, dataEncipherment, digitalSignature, nonRepudiation
-extendedKeyUsage = clientAuth, emailProtection
-subjectAltName = @alt_names
-
-[alt_names]
-email.1 = YOUR_EMAIL
-DNS.1 = YOUR_DOMAIN

package/scripts/gen-cert.sh

@@ -1,159 +0,0 @@
-#!/bin/bash
-
-# MyInvois Test Certificate Generator
-# Generates self-signed certificates with required MyInvois fields for testing
-
-set -e  # Exit on any error
-
-echo "🔐 MyInvois Test Certificate Generator"
-echo "======================================"
-echo ""
-
-# Check if OpenSSL is available
-if ! command -v openssl &> /dev/null; then
-    echo "❌ Error: OpenSSL is not installed or not in PATH"
-    echo "Please install OpenSSL first."
-    exit 1
-fi
-
-echo "✅ OpenSSL found: $(openssl version)"
-echo ""
-
-# Get user input
-echo "📝 Please provide your certificate details:"
-echo ""
-
-read -p "Company Name (e.g., 'My Company Sdn Bhd'): " COMPANY_NAME
-read -p "State/Province (e.g., 'Kuala Lumpur'): " STATE
-read -p "City (e.g., 'Kuala Lumpur'): " CITY
-read -p "Email Address: " EMAIL
-read -p "Domain (optional, e.g., 'mycompany.com'): " DOMAIN
-read -p "Business Registration Number (e.g., '202301234567'): " BUSINESS_REG
-read -p "MyInvois TIN (e.g., 'IG12345678901'): " TIN
-
-echo ""
-
-# Validate required fields
-if [[ -z "$COMPANY_NAME" || -z "$STATE" || -z "$CITY" || -z "$EMAIL" || -z "$BUSINESS_REG" || -z "$TIN" ]]; then
-    echo "❌ Error: All fields except domain are required"
-    exit 1
-fi
-
-# Set default domain if not provided
-if [[ -z "$DOMAIN" ]]; then
-    DOMAIN="localhost"
-fi
-
-echo "📋 Certificate Details:"
-echo "  Company: $COMPANY_NAME"
-echo "  State: $STATE"
-echo "  City: $CITY"
-echo "  Email: $EMAIL"
-echo "  Domain: $DOMAIN"
-echo "  Business Reg: $BUSINESS_REG"
-echo "  TIN: $TIN"
-echo ""
-
-read -p "Continue with these details? (y/N): " CONFIRM
-if [[ ! "$CONFIRM" =~ ^[Yy]$ ]]; then
-    echo "❌ Cancelled by user"
-    exit 0
-fi
-
-echo ""
-echo "🔧 Generating certificate files..."
-
-# Create temporary config file
-CONFIG_FILE="myinvois-cert-temp.conf"
-cat > "$CONFIG_FILE" << EOF
-[req]
-distinguished_name = req_distinguished_name
-req_extensions = v3_req
-prompt = no
-
-[req_distinguished_name]
-C = MY
-ST = $STATE
-L = $CITY
-O = $COMPANY_NAME
-CN = $COMPANY_NAME
-emailAddress = $EMAIL
-serialNumber = $BUSINESS_REG
-
-[v3_req]
-keyUsage = keyEncipherment, dataEncipherment, digitalSignature, nonRepudiation
-extendedKeyUsage = clientAuth, emailProtection
-subjectAltName = @alt_names
-
-[alt_names]
-email.1 = $EMAIL
-DNS.1 = $DOMAIN
-EOF
-
-# Generate private key
-echo "🔑 Generating private key..."
-if openssl genrsa -out myinvois-test-key.pem 2048; then
-    chmod 600 myinvois-test-key.pem
-    echo "✅ Private key saved: myinvois-test-key.pem"
-else
-    echo "❌ Failed to generate private key"
-    exit 1
-fi
-
-# Generate basic certificate
-echo "📜 Generating basic certificate..."
-if openssl req -new -x509 -key myinvois-test-key.pem -out myinvois-test-cert.pem -days 365 -config "$CONFIG_FILE"; then
-    echo "✅ Basic certificate saved: myinvois-test-cert.pem"
-else
-    echo "❌ Failed to generate basic certificate"
-    exit 1
-fi
-
-# Generate enhanced certificate with organizationIdentifier
-echo "🚀 Generating enhanced certificate with organizationIdentifier..."
-if openssl req -new -x509 -key myinvois-test-key.pem -out myinvois-enhanced-cert.pem -days 365 \
-  -subj "/C=MY/ST=$STATE/L=$CITY/O=$COMPANY_NAME/CN=$COMPANY_NAME/serialNumber=$BUSINESS_REG/2.5.4.97=$TIN/emailAddress=$EMAIL"; then
-    echo "✅ Enhanced certificate saved: myinvois-enhanced-cert.pem"
-else
-    echo "❌ Failed to generate enhanced certificate"
-    exit 1
-fi
-
-# Clean up temporary config
-rm "$CONFIG_FILE"
-
-echo ""
-echo "🔍 Verifying enhanced certificate..."
-
-# Verify the enhanced certificate has required fields
-if openssl x509 -in myinvois-enhanced-cert.pem -text -noout | grep -q "organizationIdentifier"; then
-    echo "✅ organizationIdentifier field: Found"
-else
-    echo "❌ organizationIdentifier field: Missing"
-fi
-
-if openssl x509 -in myinvois-enhanced-cert.pem -text -noout | grep -q "serialNumber"; then
-    echo "✅ SERIALNUMBER field: Found"
-else
-    echo "❌ SERIALNUMBER field: Missing"
-fi
-
-echo ""
-echo "📋 Certificate subject:"
-openssl x509 -in myinvois-enhanced-cert.pem -noout -subject | sed 's/subject=/  /'
-
-echo ""
-echo "🎉 Certificate generation complete!"
-echo ""
-echo "📁 Generated files:"
-echo "  • myinvois-test-key.pem (private key - keep secure!)"
-echo "  • myinvois-test-cert.pem (basic certificate)"
-echo "  • myinvois-enhanced-cert.pem (with organizationIdentifier - recommended)"
-echo ""
-echo "💡 Next steps:"
-echo "  1. Use 'myinvois-enhanced-cert.pem' for testing MyInvois integration"
-echo "  2. Update your environment variables to use these files"
-echo "  3. For production, obtain official certificate from MyInvois-approved CA"
-echo ""
-echo "⚠️  Note: These are self-signed certificates for testing only!"
-echo "   They will resolve DS306, DS307, DS309 errors but not CA trust issues." 

package/src/api/platform/platformLogin.ts

@@ -1,34 +0,0 @@
-import type { ClientCredentials, TokenResponse } from '../../types'
-
-export const platformLogin = async (
-  client: ClientCredentials,
-): Promise<{
-  token: string
-  tokenExpiration: Date
-}> => {
-  const { clientId, clientSecret, baseUrl, onBehalfOf, debug } = client
-  try {
-    const response = await fetch(`${baseUrl}/connect/token`, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/x-www-form-urlencoded',
-        ...(onBehalfOf ? { onbehalfof: onBehalfOf } : {}),
-      },
-      body: new URLSearchParams({
-        grant_type: 'client_credentials',
-        client_id: clientId,
-        client_secret: clientSecret,
-        scope: 'InvoicingAPI',
-      }),
-    })
-
-    const tokenResponse: TokenResponse = await response.json()
-    return {
-      token: tokenResponse.access_token,
-      tokenExpiration: new Date(Date.now() + tokenResponse.expires_in * 1000),
-    }
-  } catch (error) {
-    if (debug) console.error(error)
-    throw error
-  }
-}