Testing Overview

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/bnishit/purchase-ocr/llms.txt

Use this file to discover all available pages before exploring further.

​

What’s Tested

• Business Logic: Invoice reconciliation algorithms in lib/
• Standards Compliance: GST rate normalization, UQC codes, GSTIN validation
• Edge Cases: Handling of malformed data, null values, and boundary conditions
• Calculation Accuracy: Item totals, discounts, tax calculations, and reconciliation

​

Current Test Coverage

​

Vitest Configuration

import { defineConfig } from 'vitest/config'
import path from 'path'

export default defineConfig({
  test: {
    globals: true,
    environment: 'node',
    include: ['**/*.test.ts'],
    coverage: {
      provider: 'v8',
      reporter: ['text', 'json', 'html'],
      include: ['lib/**/*.ts'],
    },
  },
  resolve: {
    alias: {
      '@': path.resolve(__dirname, '.'),
    },
  },
})

​

Configuration Highlights

• Globals enabled: describe, it, expect available without imports
• Node environment: Tests run in Node.js context
• Coverage provider: V8 for accurate code coverage
• Coverage reporters: Text (terminal), JSON, and HTML formats
• Path alias: @/ resolves to project root
• Test pattern: All *.test.ts files are included

​

Testing Strategy

​

Unit Tests

• Helper functions (n(), r2(), effectiveDiscountPct())
• Standards normalization (normalizeGstRate(), normalizeUqc())
• State code extraction (getStateCodeFromGstin())

​

Integration Tests

• Full invoice reconciliation with multiple items
• Discount cascading (item-level and header-level)
• GST splitting (CGST/SGST vs IGST)
• HSN tax table scaling
• TCS and round-off handling

​

Real-World Scenarios

• Retail invoices with multiple products
• B2B invoices with TCS
• Service invoices with IGST
• Multi-rate invoices with different GST slabs

​

Future Testing Plans

​

Related

• Running Tests - Commands and workflows
• Writing Tests - Guidelines and examples