@accounter/server 0.0.8-alpha-20251102200443-d7162b8ce1dfc629b8b454df17dcec9ed005a052 → 0.0.8-alpha-20251103003648-f6467c8cb9c739ec4439c260bccc7325f6a761ae

package/dist/server/src/modules/charges-matcher/__tests__/business-confidence.test.js

@@ -0,0 +1,143 @@
+import { describe, expect, it } from 'vitest';
+import { calculateBusinessConfidence } from '../helpers/business-confidence.helper.js';
+describe('calculateBusinessConfidence', () => {
+    const businessId1 = 'business-123';
+    const businessId2 = 'business-456';
+    const businessId3 = 'business-789';
+    describe('exact match - both non-null', () => {
+        it('should return 1.0 when both IDs match', () => {
+            const result = calculateBusinessConfidence(businessId1, businessId1);
+            expect(result).toBe(1.0);
+        });
+        it('should return 1.0 for different business IDs that match', () => {
+            const result = calculateBusinessConfidence(businessId2, businessId2);
+            expect(result).toBe(1.0);
+        });
+        it('should return 1.0 for UUID-like IDs that match', () => {
+            const uuidBusiness = '550e8400-e29b-41d4-a716-446655440000';
+            const result = calculateBusinessConfidence(uuidBusiness, uuidBusiness);
+            expect(result).toBe(1.0);
+        });
+    });
+    describe('one ID is null', () => {
+        it('should return 0.5 when transaction ID is null', () => {
+            const result = calculateBusinessConfidence(null, businessId1);
+            expect(result).toBe(0.5);
+        });
+        it('should return 0.5 when document ID is null', () => {
+            const result = calculateBusinessConfidence(businessId1, null);
+            expect(result).toBe(0.5);
+        });
+        it('should return 0.5 when transaction ID is null with different business ID', () => {
+            const result = calculateBusinessConfidence(null, businessId2);
+            expect(result).toBe(0.5);
+        });
+        it('should return 0.5 when document ID is null with different business ID', () => {
+            const result = calculateBusinessConfidence(businessId3, null);
+            expect(result).toBe(0.5);
+        });
+    });
+    describe('both IDs are null', () => {
+        it('should return 0.5 when both IDs are null', () => {
+            const result = calculateBusinessConfidence(null, null);
+            expect(result).toBe(0.5);
+        });
+    });
+    describe('mismatch - both non-null but different', () => {
+        it('should return 0.2 when IDs do not match', () => {
+            const result = calculateBusinessConfidence(businessId1, businessId2);
+            expect(result).toBe(0.2);
+        });
+        it('should return 0.2 for different business IDs', () => {
+            const result = calculateBusinessConfidence(businessId2, businessId3);
+            expect(result).toBe(0.2);
+        });
+        it('should return 0.2 for UUID-like IDs that do not match', () => {
+            const uuid1 = '550e8400-e29b-41d4-a716-446655440000';
+            const uuid2 = '660e8400-e29b-41d4-a716-446655440000';
+            const result = calculateBusinessConfidence(uuid1, uuid2);
+            expect(result).toBe(0.2);
+        });
+        it('should be case-sensitive for business IDs', () => {
+            const result = calculateBusinessConfidence('business-ABC', 'business-abc');
+            expect(result).toBe(0.2);
+        });
+    });
+    describe('various business ID formats', () => {
+        it('should work with numeric string IDs', () => {
+            const result = calculateBusinessConfidence('12345', '12345');
+            expect(result).toBe(1.0);
+        });
+        it('should work with alphanumeric IDs', () => {
+            const result = calculateBusinessConfidence('bus-abc-123', 'bus-abc-123');
+            expect(result).toBe(1.0);
+        });
+        it('should work with short IDs', () => {
+            const result = calculateBusinessConfidence('a', 'a');
+            expect(result).toBe(1.0);
+        });
+        it('should work with long UUIDs', () => {
+            const longUuid = '123e4567-e89b-12d3-a456-426614174000';
+            const result = calculateBusinessConfidence(longUuid, longUuid);
+            expect(result).toBe(1.0);
+        });
+        it('should detect mismatch with similar but different IDs', () => {
+            const result = calculateBusinessConfidence('business-123', 'business-124');
+            expect(result).toBe(0.2);
+        });
+    });
+    describe('return value validation', () => {
+        it('should return exactly 1.0, 0.5, or 0.2 (no other values)', () => {
+            const results = [
+                calculateBusinessConfidence(businessId1, businessId1), // 1.0
+                calculateBusinessConfidence(businessId1, businessId2), // 0.2
+                calculateBusinessConfidence(null, businessId1), // 0.5
+                calculateBusinessConfidence(businessId1, null), // 0.5
+                calculateBusinessConfidence(null, null), // 0.5
+            ];
+            results.forEach(result => {
+                expect([1.0, 0.5, 0.2]).toContain(result);
+            });
+        });
+        it('should return exact values without rounding issues', () => {
+            const exactMatch = calculateBusinessConfidence(businessId1, businessId1);
+            const oneNull = calculateBusinessConfidence(null, businessId1);
+            const mismatch = calculateBusinessConfidence(businessId1, businessId2);
+            expect(exactMatch === 1.0).toBe(true);
+            expect(oneNull === 0.5).toBe(true);
+            expect(mismatch === 0.2).toBe(true);
+        });
+    });
+    describe('symmetry', () => {
+        it('should return same result regardless of parameter order for matching IDs', () => {
+            expect(calculateBusinessConfidence(businessId1, businessId1)).toBe(calculateBusinessConfidence(businessId1, businessId1));
+        });
+        it('should return same result regardless of parameter order for mismatching IDs', () => {
+            expect(calculateBusinessConfidence(businessId1, businessId2)).toBe(calculateBusinessConfidence(businessId2, businessId1));
+        });
+        it('should return same result regardless of parameter order for null cases', () => {
+            expect(calculateBusinessConfidence(null, businessId1)).toBe(calculateBusinessConfidence(businessId1, null));
+        });
+    });
+    describe('edge cases', () => {
+        it('should handle empty string as a valid business ID', () => {
+            const result = calculateBusinessConfidence('', '');
+            expect(result).toBe(1.0);
+        });
+        it('should treat empty string as different from null', () => {
+            const result = calculateBusinessConfidence('', null);
+            expect(result).toBe(0.5);
+        });
+        it('should handle IDs with special characters', () => {
+            const specialId = 'business-id_with-special.chars@123';
+            const result = calculateBusinessConfidence(specialId, specialId);
+            expect(result).toBe(1.0);
+        });
+        it('should handle very long business IDs', () => {
+            const longId = 'a'.repeat(1000);
+            const result = calculateBusinessConfidence(longId, longId);
+            expect(result).toBe(1.0);
+        });
+    });
+});
+//# sourceMappingURL=business-confidence.test.js.map

package/dist/server/src/modules/charges-matcher/__tests__/business-confidence.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"business-confidence.test.js","sourceRoot":"","sources":["../../../../../../src/modules/charges-matcher/__tests__/business-confidence.test.ts"],"names":[],"mappings":"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"}

package/dist/server/src/modules/charges-matcher/__tests__/candidate-filter.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/server/src/modules/charges-matcher/__tests__/candidate-filter.test.js

@@ -0,0 +1,186 @@
+import { describe, expect, it } from 'vitest';
+import { isValidDocumentForMatching, isValidTransactionForMatching, isWithinDateWindow, } from '../helpers/candidate-filter.helper.js';
+describe('Candidate Filter', () => {
+    describe('isValidTransactionForMatching', () => {
+        it('should include normal transactions', () => {
+            const transaction = {
+                id: 'tx-1',
+                is_fee: false,
+                amount: '100.00',
+            };
+            expect(isValidTransactionForMatching(transaction)).toBe(true);
+        });
+        it('should exclude fee transactions', () => {
+            const transaction = {
+                id: 'tx-2',
+                is_fee: true,
+                amount: '5.00',
+            };
+            expect(isValidTransactionForMatching(transaction)).toBe(false);
+        });
+        it('should handle transactions with various states', () => {
+            const validTransaction = {
+                id: 'tx-3',
+                is_fee: false,
+                amount: '250.50',
+                currency: 'USD',
+            };
+            expect(isValidTransactionForMatching(validTransaction)).toBe(true);
+        });
+    });
+    describe('isValidDocumentForMatching', () => {
+        it('should include valid documents', () => {
+            const document = {
+                id: 'doc-1',
+                total_amount: 100,
+                currency_code: 'USD',
+                type: 'INVOICE',
+            };
+            expect(isValidDocumentForMatching(document)).toBe(true);
+        });
+        it('should exclude documents with null total_amount', () => {
+            const document = {
+                id: 'doc-2',
+                total_amount: null,
+                currency_code: 'USD',
+                type: 'INVOICE',
+            };
+            expect(isValidDocumentForMatching(document)).toBe(false);
+        });
+        it('should exclude documents with undefined total_amount', () => {
+            const document = {
+                id: 'doc-3',
+                total_amount: undefined,
+                currency_code: 'USD',
+                type: 'INVOICE',
+            };
+            expect(isValidDocumentForMatching(document)).toBe(false);
+        });
+        it('should exclude documents with null currency_code', () => {
+            const document = {
+                id: 'doc-4',
+                total_amount: 100,
+                currency_code: null,
+                type: 'INVOICE',
+            };
+            expect(isValidDocumentForMatching(document)).toBe(false);
+        });
+        it('should exclude documents with empty currency_code', () => {
+            const document = {
+                id: 'doc-5',
+                total_amount: 100,
+                currency_code: null,
+                type: 'INVOICE',
+            };
+            expect(isValidDocumentForMatching(document)).toBe(false);
+        });
+        it('should include documents with zero amount (valid)', () => {
+            const document = {
+                id: 'doc-6',
+                total_amount: 0,
+                currency_code: 'EUR',
+                type: 'CREDIT_INVOICE',
+            };
+            expect(isValidDocumentForMatching(document)).toBe(true);
+        });
+        it('should include documents with negative amounts', () => {
+            const document = {
+                id: 'doc-7',
+                total_amount: -50,
+                currency_code: 'ILS',
+                type: 'CREDIT_INVOICE',
+            };
+            expect(isValidDocumentForMatching(document)).toBe(true);
+        });
+    });
+    describe('isWithinDateWindow', () => {
+        const referenceDate = new Date('2024-06-15');
+        it('should include same date', () => {
+            const candidateDate = new Date('2024-06-15');
+            expect(isWithinDateWindow(candidateDate, referenceDate)).toBe(true);
+        });
+        it('should include date 11 months before', () => {
+            const candidateDate = new Date('2023-07-15');
+            expect(isWithinDateWindow(candidateDate, referenceDate)).toBe(true);
+        });
+        it('should include date 11 months after', () => {
+            const candidateDate = new Date('2025-05-15');
+            expect(isWithinDateWindow(candidateDate, referenceDate)).toBe(true);
+        });
+        it('should include date exactly 12 months before', () => {
+            const candidateDate = new Date('2023-06-15');
+            expect(isWithinDateWindow(candidateDate, referenceDate)).toBe(true);
+        });
+        it('should include date exactly 12 months after', () => {
+            const candidateDate = new Date('2025-06-15');
+            expect(isWithinDateWindow(candidateDate, referenceDate)).toBe(true);
+        });
+        it('should exclude date 12 months + 1 day before', () => {
+            const candidateDate = new Date('2023-06-14');
+            expect(isWithinDateWindow(candidateDate, referenceDate)).toBe(false);
+        });
+        it('should exclude date 12 months + 1 day after', () => {
+            const candidateDate = new Date('2025-06-16');
+            expect(isWithinDateWindow(candidateDate, referenceDate)).toBe(false);
+        });
+        it('should handle different years', () => {
+            const candidateDate2023 = new Date('2023-09-01'); // 9+ months before
+            const candidateDate2025 = new Date('2025-03-01'); // 8+ months after
+            expect(isWithinDateWindow(candidateDate2023, referenceDate)).toBe(true);
+            expect(isWithinDateWindow(candidateDate2025, referenceDate)).toBe(true);
+        });
+        it('should handle edge cases around month boundaries - end of month', () => {
+            const refDate = new Date('2024-01-31');
+            const candidate11MonthsLater = new Date('2024-12-31'); // Exactly 11 months
+            expect(isWithinDateWindow(candidate11MonthsLater, refDate)).toBe(true);
+        });
+        it('should handle edge cases around month boundaries - February leap year', () => {
+            const refDate = new Date('2024-02-29'); // Leap year
+            const candidate = new Date('2023-03-01'); // Just over 12 months before
+            expect(isWithinDateWindow(candidate, refDate)).toBe(true);
+        });
+        it('should work with custom window - 6 months', () => {
+            const candidateDate3MonthsBefore = new Date('2024-03-15');
+            const candidateDate7MonthsBefore = new Date('2023-11-15');
+            expect(isWithinDateWindow(candidateDate3MonthsBefore, referenceDate, 6)).toBe(true);
+            expect(isWithinDateWindow(candidateDate7MonthsBefore, referenceDate, 6)).toBe(false);
+        });
+        it('should work with custom window - 3 months', () => {
+            const candidateDate2MonthsAfter = new Date('2024-08-15');
+            const candidateDate4MonthsAfter = new Date('2024-10-15');
+            expect(isWithinDateWindow(candidateDate2MonthsAfter, referenceDate, 3)).toBe(true);
+            expect(isWithinDateWindow(candidateDate4MonthsAfter, referenceDate, 3)).toBe(false);
+        });
+        it('should handle month boundary edge case - 12 months exactly', () => {
+            const refDate = new Date('2024-01-15');
+            const candidate12MonthsAfter = new Date('2025-01-15');
+            const candidateJustOver12Months = new Date('2025-01-16');
+            expect(isWithinDateWindow(candidate12MonthsAfter, refDate)).toBe(true);
+            expect(isWithinDateWindow(candidateJustOver12Months, refDate)).toBe(false);
+        });
+        it('should handle year transitions', () => {
+            const refDate = new Date('2024-01-01');
+            const candidateDate = new Date('2023-01-01'); // Exactly 12 months before
+            expect(isWithinDateWindow(candidateDate, refDate)).toBe(true);
+        });
+        it('should be inclusive on boundary dates', () => {
+            const refDate = new Date('2024-06-15');
+            const minBoundary = new Date('2023-06-15'); // -12 months
+            const maxBoundary = new Date('2025-06-15'); // +12 months
+            expect(isWithinDateWindow(minBoundary, refDate)).toBe(true);
+            expect(isWithinDateWindow(maxBoundary, refDate)).toBe(true);
+        });
+        it('should handle dates with time components', () => {
+            const refDate = new Date('2024-06-15T10:30:00');
+            const candidateDate = new Date('2024-06-15T23:59:59');
+            expect(isWithinDateWindow(candidateDate, refDate)).toBe(true);
+        });
+        it('should work with very small window - 1 month', () => {
+            const candidateDate1MonthBefore = new Date('2024-05-15');
+            const candidateDate2MonthsBefore = new Date('2024-04-15');
+            expect(isWithinDateWindow(candidateDate1MonthBefore, referenceDate, 1)).toBe(true);
+            expect(isWithinDateWindow(candidateDate2MonthsBefore, referenceDate, 1)).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=candidate-filter.test.js.map

package/dist/server/src/modules/charges-matcher/__tests__/candidate-filter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate-filter.test.js","sourceRoot":"","sources":["../../../../../../src/modules/charges-matcher/__tests__/candidate-filter.test.ts"],"names":[],"mappings":"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"}

package/dist/server/src/modules/charges-matcher/__tests__/charge-validator.test.d.ts

@@ -0,0 +1 @@
+export {};