@ripwords/myinvois-client 0.1.6 → 0.2.0

package/test/signAndSubmitInvoice.test.ts

@@ -1,452 +0,0 @@
-import { describe, expect, it } from 'vitest'
-import { MyInvoisClient } from '../src/index'
-import type { InvoiceV1_1 } from '../src/types'
-import {
-  generateCompleteDocument,
-  extractCertificateInfo,
-} from '../src/utils/document'
-
-/**
- * ⚠️ SECURITY NOTICE: This file uses environment variables for sensitive data.
- * Never hardcode actual TIN, NRIC, certificates, or API credentials in test files.
- * Use .env file for your actual values (already gitignored).
- */
-
-/**
- * Creates minimal test invoice data that meets all mandatory requirements
- * Following MyInvois v1.1 specification exactly
- */
-const createMinimalTestInvoice = (): InvoiceV1_1 => {
-  // Use current date/time to avoid validation errors
-  const now = new Date()
-  const currentDate = now.toISOString().split('T')[0] // YYYY-MM-DD
-  const currentTime = now.toISOString().split('T')[1].split('.')[0] + 'Z' // HH:MM:SSZ
-
-  return {
-    // === CORE MANDATORY FIELDS ===
-    eInvoiceVersion: '1.1',
-    eInvoiceTypeCode: '01', // Standard invoice
-    eInvoiceCodeOrNumber: `TEST-INV-${Date.now()}`, // Unique invoice number
-    eInvoiceDate: currentDate,
-    eInvoiceTime: currentTime,
-    invoiceCurrencyCode: 'MYR',
-
-    // === SUPPLIER (will be updated with certificate TIN) ===
-    supplier: {
-      name: 'Test Company Sdn Bhd',
-      tin: process.env.TIN_VALUE!, // Will be replaced with certificate TIN
-      registrationType: 'NRIC',
-      registrationNumber: process.env.NRIC_VALUE!,
-      contactNumber: '+60123456789',
-      address: {
-        addressLine0: '123 Test Street',
-        cityName: 'Kuala Lumpur',
-        state: '14', // Wilayah Persekutuan Kuala Lumpur
-        country: 'MYS',
-      },
-      industryClassificationCode: '41001',
-      industryClassificationDescription: 'Test Industry',
-    },
-
-    // === BUYER (using consolidated buyer for testing) ===
-    buyer: {
-      name: 'CONSOLIDATED E-INVOICE BUYER',
-      tin: 'EI00000000010', // Standard consolidated buyer TIN
-      registrationType: 'NRIC',
-      registrationNumber: process.env.NRIC_VALUE!,
-      sstRegistrationNumber: 'NA',
-      contactNumber: '+60123456789', // Valid phone number (minimum 8 chars)
-      address: {
-        addressLine0: 'NA',
-        cityName: 'KUALA LUMPUR',
-        state: '14',
-        country: 'MYS',
-      },
-    },
-
-    // === SINGLE LINE ITEM (minimal) ===
-    invoiceLineItems: [
-      {
-        itemClassificationCode: '001', // General goods
-        itemDescription: 'Test Product',
-        unitPrice: 100.0,
-        taxType: '01', // SST
-        taxRate: 6.0, // 6% SST
-        taxAmount: 6.0, // 6% of 100
-        totalTaxableAmountPerLine: 100.0,
-        totalAmountPerLine: 106.0, // 100 + 6
-      },
-    ],
-
-    // === MONETARY TOTALS ===
-    legalMonetaryTotal: {
-      taxExclusiveAmount: 100.0,
-      taxInclusiveAmount: 106.0,
-      payableAmount: 106.0,
-    },
-
-    // === TAX TOTAL ===
-    taxTotal: {
-      taxAmount: 6.0,
-    },
-
-    // === DIGITAL SIGNATURE (placeholder - will be populated by signing process) ===
-    issuerDigitalSignature: {
-      Id: 'signature',
-      'ds:SignedInfo': {
-        'ds:CanonicalizationMethod': {
-          Algorithm: 'http://www.w3.org/2006/12/xml-c14n11',
-        },
-        'ds:SignatureMethod': {
-          Algorithm: 'http://www.w3.org/2001/04/xmldsig-more#rsa-sha256',
-        },
-        'ds:Reference': [
-          {
-            Id: 'id-doc-signed-data',
-            URI: '',
-            'ds:DigestMethod': {
-              Algorithm: 'http://www.w3.org/2001/04/xmlenc#sha256',
-            },
-            'ds:DigestValue': '',
-          },
-          {
-            Id: 'id-xades-signed-props',
-            URI: '#id-xades-signed-props',
-            'ds:DigestMethod': {
-              Algorithm: 'http://www.w3.org/2001/04/xmlenc#sha256',
-            },
-            'ds:DigestValue': '',
-          },
-        ],
-      },
-      'ds:SignatureValue': '',
-      'ds:KeyInfo': {
-        'ds:X509Data': {
-          'ds:X509Certificate': '',
-        },
-      },
-      'ds:Object': {
-        'xades:QualifyingProperties': {
-          Target: 'signature',
-          'xades:SignedProperties': {
-            Target: 'signature',
-            Id: 'id-xades-signed-props',
-            'xades:SignedSignatureProperties': {
-              'xades:SigningTime': '',
-              'xades:SigningCertificate': {
-                'xades:Cert': {
-                  'xades:CertDigest': {
-                    'ds:DigestMethod': {
-                      Algorithm: 'http://www.w3.org/2001/04/xmlenc#sha256',
-                    },
-                    'ds:DigestValue': '',
-                  },
-                  'xades:IssuerSerial': {
-                    'ds:X509IssuerName': '',
-                    'ds:X509SerialNumber': '',
-                  },
-                },
-              },
-            },
-          },
-        },
-      },
-    },
-  }
-}
-
-describe('MyInvois Document Generation and Submission', () => {
-  const requiredEnvVars = [
-    'CLIENT_ID',
-    'CLIENT_SECRET',
-    'TEST_PRIVATE_KEY',
-    'TEST_CERTIFICATE',
-  ]
-
-  // Check environment variables
-  const missingVars = requiredEnvVars.filter(varName => !process.env[varName])
-
-  if (missingVars.length > 0) {
-    it.skip(`Skipping tests - Missing environment variables: ${missingVars.join(', ')}`, () => {
-      expect
-        .soft(
-          false,
-          `Missing required environment variables: ${missingVars.join(', ')}`,
-        )
-        .toBe(true)
-    })
-    return
-  }
-
-  const CLIENT_ID = process.env.CLIENT_ID!
-  const CLIENT_SECRET = process.env.CLIENT_SECRET!
-  const PRIVATE_KEY = process.env.TEST_PRIVATE_KEY!
-  const CERTIFICATE = process.env.TEST_CERTIFICATE!
-
-  it('should extract certificate information correctly', () => {
-    console.log('🔍 Extracting certificate information...')
-
-    const certInfo = extractCertificateInfo(CERTIFICATE)
-
-    console.log('Certificate Info:', {
-      issuerName: certInfo.issuerName,
-      serialNumber: certInfo.serialNumber,
-    })
-
-    expect(certInfo.issuerName).toBeDefined()
-    expect(certInfo.serialNumber).toBeDefined()
-    expect(typeof certInfo.issuerName).toBe('string')
-    expect(typeof certInfo.serialNumber).toBe('string')
-  })
-
-  it('should find TIN that matches certificate', async () => {
-    console.log('🔐 Finding TIN that matches certificate...')
-
-    const client = new MyInvoisClient(
-      CLIENT_ID,
-      CLIENT_SECRET,
-      'sandbox',
-      CERTIFICATE,
-      PRIVATE_KEY,
-      undefined,
-      true, // debug mode
-    )
-
-    // Test TIN formats that might match the certificate
-    // Note: These are example TIN formats - replace with your actual test TINs
-    const testTINs = [
-      process.env.TIN_VALUE, // Environment variable if set
-      process.env.TEST_TIN_1, // Additional test TIN from environment
-      process.env.TEST_TIN_2, // Additional test TIN from environment
-      process.env.TEST_TIN_3, // Additional test TIN from environment
-      'EI00000000010', // Consolidated buyer (shouldn't work for supplier)
-    ].filter(Boolean) // Remove undefined values
-
-    let certificateMatchingTIN: string | null = null
-    const validTINs: string[] = []
-
-    // Step 1: Check which TINs are valid in the system
-    console.log('📋 Step 1: Checking TIN validity...')
-    for (const tin of testTINs) {
-      try {
-        console.log(`Testing TIN validity: ${tin}`)
-        const isValid = await client.verifyTin(tin!, 'BRN', '123456789012')
-        console.log(`TIN ${tin} validity: ${isValid}`)
-
-        if (isValid) {
-          validTINs.push(tin!)
-        }
-      } catch (error) {
-        console.log(`❌ Error testing TIN ${tin}:`, error)
-      }
-    }
-
-    console.log(`📊 Found ${validTINs.length} valid TINs:`, validTINs)
-
-    // Step 2: Test each valid TIN with a minimal document submission to find certificate match
-    console.log('📋 Step 2: Testing certificate matching...')
-    for (const tin of validTINs) {
-      try {
-        console.log(`Testing TIN with certificate: ${tin}`)
-
-        // Create a minimal test invoice with this TIN
-        const testInvoice = createMinimalTestInvoice()
-        testInvoice.supplier.tin = tin
-        testInvoice.eInvoiceCodeOrNumber = `TEST-CERT-${Date.now()}`
-
-        // Try to submit it
-        const { status } = await client.submitDocument([testInvoice])
-
-        if (status === 202) {
-          console.log(`✅ SUCCESS! TIN ${tin} works with certificate`)
-          certificateMatchingTIN = tin
-          break
-        } else {
-          console.log(`❌ TIN ${tin} failed with status ${status}`)
-        }
-      } catch (error: any) {
-        if (
-          error.message?.includes(
-            'authenticated TIN and documents TIN is not matching',
-          )
-        ) {
-          console.log(`❌ TIN ${tin} doesn't match certificate`)
-        } else {
-          console.log(`❌ TIN ${tin} failed with error:`, error.message)
-        }
-      }
-    }
-
-    // Store the certificate-matching TIN for next test
-    if (certificateMatchingTIN) {
-      process.env.VALID_SUPPLIER_TIN = certificateMatchingTIN
-      console.log(
-        `🎯 Certificate matching TIN found: ${certificateMatchingTIN}`,
-      )
-    } else if (validTINs.length > 0) {
-      // Fallback to first valid TIN with a warning
-      process.env.VALID_SUPPLIER_TIN = validTINs[0]
-      console.log(
-        `⚠️  No certificate match found, using first valid TIN: ${validTINs[0]}`,
-      )
-      console.log(
-        `⚠️  This will likely cause TIN mismatch error in submission test`,
-      )
-    }
-
-    // For now, pass the test if we found any valid TINs (the main goal is to test the implementation)
-    expect.soft(validTINs.length, 'No valid TINs found').toBeGreaterThan(0)
-  }, 60000) // Increased timeout for multiple submissions
-
-  it('should generate valid document structure', () => {
-    console.log('📄 Generating document structure...')
-
-    const invoice = createMinimalTestInvoice()
-
-    // Use the valid TIN from previous test or fallback
-    const supplierTIN =
-      process.env.VALID_SUPPLIER_TIN || process.env.TIN_VALUE || 'C00000000000' // Replace with your TIN
-    invoice.supplier.tin = supplierTIN
-
-    console.log(`Using supplier TIN: ${supplierTIN}`)
-
-    const certInfo = extractCertificateInfo(CERTIFICATE)
-
-    const document = generateCompleteDocument([invoice], {
-      privateKeyPem: PRIVATE_KEY,
-      certificatePem: CERTIFICATE,
-      issuerName: certInfo.issuerName,
-      serialNumber: certInfo.serialNumber,
-    })
-
-    console.log('Generated document structure:')
-    console.log(
-      '- Namespace declarations:',
-      Object.keys(document).filter(k => k.startsWith('_')),
-    )
-    console.log('- Number of invoices:', document.Invoice.length)
-    console.log('- First invoice keys:', Object.keys(document.Invoice[0]))
-    console.log('- Has UBLExtensions:', !!document.Invoice[0].UBLExtensions)
-    console.log('- Has Signature:', !!document.Invoice[0].Signature)
-
-    // Basic structure validation
-    expect(document._D).toBe(
-      'urn:oasis:names:specification:ubl:schema:xsd:Invoice-2',
-    )
-    expect(document._A).toBe(
-      'urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2',
-    )
-    expect(document._B).toBe(
-      'urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2',
-    )
-    expect(document.Invoice).toHaveLength(1)
-    expect(document.Invoice[0].UBLExtensions).toBeDefined()
-    expect(document.Invoice[0].Signature).toBeDefined()
-
-    // Store document for next test
-    ;(globalThis as any).testDocument = document
-    ;(globalThis as any).testInvoice = invoice
-  })
-
-  it('should submit document to MyInvois successfully', async () => {
-    console.log('🚀 Submitting document to MyInvois...')
-
-    const document = (globalThis as any).testDocument
-    const invoice = (globalThis as any).testInvoice
-
-    if (!document || !invoice) {
-      throw new Error('Document not generated in previous test')
-    }
-
-    const client = new MyInvoisClient(
-      CLIENT_ID,
-      CLIENT_SECRET,
-      'sandbox',
-      CERTIFICATE,
-      PRIVATE_KEY,
-      undefined,
-      true, // debug mode
-    )
-
-    try {
-      console.log('📤 Submitting to MyInvois API...')
-      console.log('Document size:', JSON.stringify(document).length, 'bytes')
-
-      const { data: response, status } = await client.submitDocument([invoice])
-
-      console.log('📥 Response received:')
-      console.log('Status:', status)
-      console.log('Response:', JSON.stringify(response, null, 2))
-
-      // Validate response structure
-      expect(status).toBe(202) // MyInvois returns 202 Accepted
-      expect(response.submissionUid).toBeDefined()
-      expect(typeof response.submissionUid).toBe('string')
-
-      // Check for accepted/rejected documents
-      if (response.acceptedDocuments?.length > 0) {
-        console.log('✅ Documents accepted:', response.acceptedDocuments.length)
-        response.acceptedDocuments.forEach((doc, index) => {
-          console.log(`  Document ${index + 1}:`, doc.invoiceCodeNumber)
-        })
-      }
-
-      if (response.rejectedDocuments?.length > 0) {
-        console.log('❌ Documents rejected:', response.rejectedDocuments.length)
-        response.rejectedDocuments.forEach((doc, index) => {
-          console.log(`  Document ${index + 1}:`, doc.invoiceCodeNumber)
-          if (doc.error) {
-            console.log(`    Error:`, doc.error.message)
-            if (doc.error.details) {
-              doc.error.details.forEach((detail, detailIndex) => {
-                console.log(`      Detail ${detailIndex + 1}:`, detail.message)
-              })
-            }
-          }
-        })
-      }
-
-      // Get submission status
-      console.log('📊 Checking submission status...')
-      const submission = await client.getSubmissionStatus(
-        response.submissionUid,
-      )
-      console.log('Submission status:', submission?.status)
-
-      expect(submission).toBeDefined()
-      expect(['InProgress', 'Valid', 'PartiallyValid', 'Invalid']).toContain(
-        submission?.status,
-      )
-    } catch (error: any) {
-      console.error('💥 Submission failed:', error)
-
-      // Analyze common error types
-      if (
-        error.message?.includes(
-          'authenticated TIN and documents TIN is not matching',
-        )
-      ) {
-        console.log('\n🔍 TIN MISMATCH ERROR DETECTED!')
-        console.log(
-          'This means the TIN in the certificate does not match the TIN in the invoice.',
-        )
-        console.log(
-          'The certificate is registered to a different TIN in MyInvois system.',
-        )
-        console.log(
-          'Solution: Get the correct TIN for your certificate or get a certificate for your TIN.',
-        )
-      } else if (error.message?.includes('Invalid structure')) {
-        console.log('\n🔍 INVALID STRUCTURE ERROR DETECTED!')
-        console.log('This could be due to:')
-        console.log('1. Missing mandatory fields')
-        console.log('2. Incorrect field values')
-        console.log('3. Wrong data types')
-        console.log('4. Business rule violations')
-      }
-
-      // Re-throw to fail the test
-      throw error
-    }
-  }, 60000) // Extended timeout for API calls
-})

package/test/signature-diagnostics.test.ts

@@ -1,130 +0,0 @@
-import { describe, it } from 'vitest'
-import type { InvoiceV1_1 } from '../src/types'
-import {
-  diagnoseSignatureIssues,
-  printDiagnostics,
-} from '../src/utils/signature-diagnostics'
-
-/**
- * ⚠️ SECURITY NOTICE: This file uses environment variables for sensitive data.
- * Never hardcode actual TIN, NRIC, certificates, or API credentials in test files.
- * Use .env file for your actual values (already gitignored).
- */
-
-describe('Signature Diagnostics', () => {
-  it('should analyze current certificate and signature implementation', () => {
-    const CLIENT_ID = process.env.CLIENT_ID
-    const CLIENT_SECRET = process.env.CLIENT_SECRET
-    const PRIVATE_KEY = process.env.TEST_PRIVATE_KEY
-    const CERTIFICATE = process.env.TEST_CERTIFICATE
-
-    if (!CLIENT_ID || !CLIENT_SECRET || !PRIVATE_KEY || !CERTIFICATE) {
-      console.log('⚠️  Skipping diagnostics - Missing environment variables')
-      return
-    }
-
-    // Create test invoice
-    const testInvoice: InvoiceV1_1 = {
-      eInvoiceVersion: '1.1',
-      eInvoiceTypeCode: '01',
-      eInvoiceCodeOrNumber: `DIAG-${Date.now()}`,
-      eInvoiceDate: new Date().toISOString().split('T')[0],
-      eInvoiceTime: new Date().toISOString().split('T')[1].split('.')[0] + 'Z',
-      invoiceCurrencyCode: 'MYR',
-
-      supplier: {
-        name: 'Test Company Sdn Bhd',
-        tin: process.env.TIN_VALUE || 'IG00000000000', // Replace with your TIN
-        registrationType: 'NRIC',
-        registrationNumber: process.env.NRIC_VALUE || '123456789012',
-        contactNumber: '+60123456789',
-        address: {
-          addressLine0: '123 Test Street',
-          cityName: 'Kuala Lumpur',
-          state: '14',
-          country: 'MYS',
-        },
-        industryClassificationCode: '41001',
-        industryClassificationDescription: 'Test Industry',
-      },
-
-      buyer: {
-        name: 'CONSOLIDATED E-INVOICE BUYER',
-        tin: 'EI00000000010',
-        registrationType: 'NRIC',
-        registrationNumber: process.env.BUYER_NRIC_VALUE || '000000000000', // Replace with test NRIC
-        sstRegistrationNumber: 'NA',
-        contactNumber: '+60123456789',
-        address: {
-          addressLine0: 'NA',
-          cityName: 'KUALA LUMPUR',
-          state: '14',
-          country: 'MYS',
-        },
-      },
-
-      invoiceLineItems: [
-        {
-          itemClassificationCode: '001',
-          itemDescription: 'Test Product',
-          unitPrice: 100.0,
-          taxType: '01',
-          taxRate: 6.0,
-          taxAmount: 6.0,
-          totalTaxableAmountPerLine: 100.0,
-          totalAmountPerLine: 106.0,
-        },
-      ],
-
-      legalMonetaryTotal: {
-        taxExclusiveAmount: 100.0,
-        taxInclusiveAmount: 106.0,
-        payableAmount: 106.0,
-      },
-
-      taxTotal: {
-        taxAmount: 6.0,
-      },
-
-      issuerDigitalSignature: {} as any,
-    }
-
-    console.log('🔍 Running MyInvois Signature Diagnostics...\n')
-
-    try {
-      const diagnosticResult = diagnoseSignatureIssues(
-        [testInvoice],
-        CERTIFICATE,
-      )
-
-      printDiagnostics(diagnosticResult)
-
-      // Summary
-      const certificateIssues =
-        diagnosticResult.certificateAnalysis.issues.length
-      const signatureIssues = diagnosticResult.signatureAnalysis.issues.length
-
-      console.log('\n📊 SUMMARY:')
-      console.log(`   Certificate Issues: ${certificateIssues}`)
-      console.log(`   Signature Issues: ${signatureIssues}`)
-      console.log(`   Total Issues: ${certificateIssues + signatureIssues}`)
-
-      if (certificateIssues > 0) {
-        console.log('\n🚨 PRIMARY ACTION REQUIRED:')
-        console.log(
-          '   Obtain official business certificate from MyInvois-approved CA',
-        )
-        console.log(
-          '   Self-generated certificates cannot pass MyInvois validation',
-        )
-      }
-
-      if (signatureIssues > 0) {
-        console.log('\n⚙️  SECONDARY ACTION:')
-        console.log('   Review and optimize signature implementation')
-      }
-    } catch (error) {
-      console.error('❌ Diagnostic failed:', error)
-    }
-  })
-})

package/tsconfig.json

@@ -1,39 +0,0 @@
-{
-  "compilerOptions": {
-    /* Base Options: */
-    "esModuleInterop": true,
-    "skipLibCheck": false,
-    "target": "ESNext",
-    "allowJs": false,
-    "resolveJsonModule": true,
-    "moduleDetection": "force",
-    "isolatedModules": true, // Often recommended for bundlers
-    "composite": true,
-    /* Strictness */
-    "strict": true,
-    "noUncheckedIndexedAccess": true,
-    "noImplicitAny": true,
-    /* Bundler Behavior */
-    "moduleResolution": "Bundler", // Or "NodeNext"
-    "module": "ESNext",
-    "noEmit": true, // Rolldown handles emission
-    /* Path Resolution */
-    "baseUrl": ".", // Important for resolving paths relative to root
-    /* Type Checking */
-    "types": [
-      "bun"
-    ] // Include Bun types if using Bun runtime features
-  },
-  "include": [
-    "src/**/*.ts",
-    "src/**/*.d.ts",
-    "rolldown.config.ts",
-    "test/MyInvoisClient.test.ts",
-    "test/base64.test.ts",
-    "test/transform.test.ts"
-  ],
-  "exclude": [
-    "node_modules",
-    "dist"
-  ]
-}

package/tsdown.config.ts

@@ -1,31 +0,0 @@
-import { defineConfig } from 'tsdown'
-
-const external = [
-  'xmldom-ts',
-  'xpath-ts',
-  'xml-c14n',
-  'xml-crypto',
-  'crypto',
-  '@xmldom/xmldom',
-]
-
-export default [
-  defineConfig({
-    entry: ['./src'],
-    dts: {
-      isolatedDeclarations: true,
-    },
-    external,
-  }),
-  defineConfig({
-    entry: ['./src'],
-    format: 'cjs',
-    sourcemap: true,
-    platform: 'node',
-    outputOptions: {
-      entryFileNames: 'index.cjs',
-      chunkFileNames: '[name]-[hash].cjs',
-    },
-    external,
-  }),
-]

package/vitest.config.ts

@@ -1,8 +0,0 @@
-import { defineConfig } from 'vitest/config'
-
-export default defineConfig({
-  root: '.',
-  test: {
-    setupFiles: ['dotenv/config'],
-  },
-})