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

package/dist/server/src/modules/charges-matcher/helpers/charge-validator.helper.d.ts

@@ -0,0 +1,33 @@
+import type { Document, Transaction } from '../types.js';
+/**
+ * Represents a charge with its associated transactions and documents
+ */
+interface Charge {
+    id: string;
+    owner_id: string | null;
+    transactions?: Transaction[];
+    documents?: Document[];
+}
+/**
+ * Validate a charge is properly formed for matching
+ * @throws Error with descriptive message if invalid
+ */
+export declare function validateChargeForMatching(charge: Charge): void;
+/**
+ * Check if charge is matched (has both transactions and accounting documents)
+ */
+export declare function isChargeMatched(charge: Charge): boolean;
+/**
+ * Check if charge has only transactions (no accounting documents)
+ */
+export declare function hasOnlyTransactions(charge: Charge): boolean;
+/**
+ * Check if charge has only accounting documents (no transactions)
+ */
+export declare function hasOnlyDocuments(charge: Charge): boolean;
+/**
+ * Validate that a charge is unmatched (for matching operations)
+ * @throws Error if charge is already matched
+ */
+export declare function validateChargeIsUnmatched(charge: Charge): void;
+export {};

package/dist/server/src/modules/charges-matcher/helpers/charge-validator.helper.js

@@ -0,0 +1,65 @@
+/**
+ * Accounting document types that count toward matched/unmatched status
+ */
+const ACCOUNTING_DOC_TYPES = [
+    'INVOICE',
+    'CREDIT_INVOICE',
+    'RECEIPT',
+    'INVOICE_RECEIPT',
+];
+/**
+ * Validate a charge is properly formed for matching
+ * @throws Error with descriptive message if invalid
+ */
+export function validateChargeForMatching(charge) {
+    if (!charge) {
+        throw new Error('Charge is required');
+    }
+    if (!charge.id) {
+        throw new Error('Charge must have an ID');
+    }
+    if (!charge.owner_id) {
+        throw new Error(`Charge ${charge.id} must have an owner_id`);
+    }
+    // Check if charge has data
+    const hasTransactions = charge.transactions && charge.transactions.length > 0;
+    const hasDocuments = charge.documents && charge.documents.length > 0;
+    if (!hasTransactions && !hasDocuments) {
+        throw new Error(`Charge ${charge.id} has no transactions or documents - cannot be matched`);
+    }
+}
+/**
+ * Check if charge is matched (has both transactions and accounting documents)
+ */
+export function isChargeMatched(charge) {
+    const hasTransactions = charge.transactions && charge.transactions.length > 0;
+    const hasAccountingDocs = charge.documents?.some(doc => ACCOUNTING_DOC_TYPES.includes(doc.type));
+    return !!hasTransactions && !!hasAccountingDocs;
+}
+/**
+ * Check if charge has only transactions (no accounting documents)
+ */
+export function hasOnlyTransactions(charge) {
+    const hasTransactions = charge.transactions && charge.transactions.length > 0;
+    const hasAccountingDocs = charge.documents?.some(doc => ACCOUNTING_DOC_TYPES.includes(doc.type));
+    return !!hasTransactions && !hasAccountingDocs;
+}
+/**
+ * Check if charge has only accounting documents (no transactions)
+ */
+export function hasOnlyDocuments(charge) {
+    const hasTransactions = charge.transactions && charge.transactions.length > 0;
+    const hasAccountingDocs = charge.documents?.some(doc => ACCOUNTING_DOC_TYPES.includes(doc.type));
+    return !hasTransactions && !!hasAccountingDocs;
+}
+/**
+ * Validate that a charge is unmatched (for matching operations)
+ * @throws Error if charge is already matched
+ */
+export function validateChargeIsUnmatched(charge) {
+    validateChargeForMatching(charge);
+    if (isChargeMatched(charge)) {
+        throw new Error(`Charge ${charge.id} is already matched (has both transactions and accounting documents)`);
+    }
+}
+//# sourceMappingURL=charge-validator.helper.js.map

package/dist/server/src/modules/charges-matcher/helpers/charge-validator.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"charge-validator.helper.js","sourceRoot":"","sources":["../../../../../../src/modules/charges-matcher/helpers/charge-validator.helper.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,oBAAoB,GAAmB;IAC3C,SAAS;IACT,gBAAgB;IAChB,SAAS;IACT,iBAAiB;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAc;IACtD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,CAAC,EAAE,wBAAwB,CAAC,CAAC;IAC/D,CAAC;IAED,2BAA2B;IAC3B,MAAM,eAAe,GAAG,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9E,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAErE,IAAI,CAAC,eAAe,IAAI,CAAC,YAAY,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,CAAC,EAAE,uDAAuD,CAAC,CAAC;IAC9F,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,eAAe,GAAG,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAE9E,MAAM,iBAAiB,GAAG,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CACrD,oBAAoB,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAoB,CAAC,CACxD,CAAC;IAEF,OAAO,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,iBAAiB,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,eAAe,GAAG,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAE9E,MAAM,iBAAiB,GAAG,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CACrD,oBAAoB,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAoB,CAAC,CACxD,CAAC;IAEF,OAAO,CAAC,CAAC,eAAe,IAAI,CAAC,iBAAiB,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,MAAM,eAAe,GAAG,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAE9E,MAAM,iBAAiB,GAAG,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CACrD,oBAAoB,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAoB,CAAC,CACxD,CAAC;IAEF,OAAO,CAAC,eAAe,IAAI,CAAC,CAAC,iBAAiB,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAc;IACtD,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAElC,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,UAAU,MAAM,CAAC,EAAE,sEAAsE,CAC1F,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/server/src/modules/charges-matcher/helpers/currency-confidence.helper.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Calculate confidence score based on currency match
+ * @param transactionCurrency - Currency code from transaction
+ * @param documentCurrency - Currency code from document
+ * @returns 1.0 if same, 0.2 if one/both missing, 0.0 if different
+ */
+export declare function calculateCurrencyConfidence(transactionCurrency: string | null | undefined, documentCurrency: string | null | undefined): number;

package/dist/server/src/modules/charges-matcher/helpers/currency-confidence.helper.js

@@ -0,0 +1,18 @@
+/**
+ * Calculate confidence score based on currency match
+ * @param transactionCurrency - Currency code from transaction
+ * @param documentCurrency - Currency code from document
+ * @returns 1.0 if same, 0.2 if one/both missing, 0.0 if different
+ */
+export function calculateCurrencyConfidence(transactionCurrency, documentCurrency) {
+    // Handle null/undefined/empty cases
+    if (!transactionCurrency || !documentCurrency) {
+        return 0.2;
+    }
+    // Case-insensitive comparison
+    if (transactionCurrency.toUpperCase() === documentCurrency.toUpperCase()) {
+        return 1.0;
+    }
+    return 0.0;
+}
+//# sourceMappingURL=currency-confidence.helper.js.map

package/dist/server/src/modules/charges-matcher/helpers/currency-confidence.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency-confidence.helper.js","sourceRoot":"","sources":["../../../../../../src/modules/charges-matcher/helpers/currency-confidence.helper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,mBAA8C,EAC9C,gBAA2C;IAE3C,oCAAoC;IACpC,IAAI,CAAC,mBAAmB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC9C,OAAO,GAAG,CAAC;IACb,CAAC;IAED,8BAA8B;IAC9B,IAAI,mBAAmB,CAAC,WAAW,EAAE,KAAK,gBAAgB,CAAC,WAAW,EAAE,EAAE,CAAC;QACzE,OAAO,GAAG,CAAC;IACb,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/server/src/modules/charges-matcher/helpers/date-confidence.helper.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Calculate confidence score based on date proximity
+ * @param date1 - First date
+ * @param date2 - Second date
+ * @returns Confidence score from 0.0 (30+ days) to 1.0 (same day)
+ */
+export declare function calculateDateConfidence(date1: Date, date2: Date): number;

package/dist/server/src/modules/charges-matcher/helpers/date-confidence.helper.js

@@ -0,0 +1,35 @@
+/**
+ * Calculate the absolute difference in days between two dates
+ * Ignores time components by comparing only the date parts
+ * @param date1 - First date
+ * @param date2 - Second date
+ * @returns Absolute difference in days
+ */
+function calculateDaysDifference(date1, date2) {
+    // Create new dates with time set to midnight to ignore time components
+    const d1 = new Date(date1.getFullYear(), date1.getMonth(), date1.getDate());
+    const d2 = new Date(date2.getFullYear(), date2.getMonth(), date2.getDate());
+    // Calculate difference in milliseconds
+    const diffMs = Math.abs(d1.getTime() - d2.getTime());
+    // Convert to days
+    const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
+    return diffDays;
+}
+/**
+ * Calculate confidence score based on date proximity
+ * @param date1 - First date
+ * @param date2 - Second date
+ * @returns Confidence score from 0.0 (30+ days) to 1.0 (same day)
+ */
+export function calculateDateConfidence(date1, date2) {
+    const daysDiff = calculateDaysDifference(date1, date2);
+    // 30 or more days: return 0.0
+    if (daysDiff >= 30) {
+        return 0.0;
+    }
+    // Linear degradation: 1.0 - (days_diff / 30)
+    const confidence = 1.0 - daysDiff / 30;
+    // Round to 2 decimal places
+    return Math.round(confidence * 100) / 100;
+}
+//# sourceMappingURL=date-confidence.helper.js.map

package/dist/server/src/modules/charges-matcher/helpers/date-confidence.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-confidence.helper.js","sourceRoot":"","sources":["../../../../../../src/modules/charges-matcher/helpers/date-confidence.helper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,SAAS,uBAAuB,CAAC,KAAW,EAAE,KAAW;IACvD,uEAAuE;IACvE,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5E,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAE5E,uCAAuC;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAErD,kBAAkB;IAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAE5D,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAW,EAAE,KAAW;IAC9D,MAAM,QAAQ,GAAG,uBAAuB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAEvD,8BAA8B;IAC9B,IAAI,QAAQ,IAAI,EAAE,EAAE,CAAC;QACnB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,6CAA6C;IAC7C,MAAM,UAAU,GAAG,GAAG,GAAG,QAAQ,GAAG,EAAE,CAAC;IAEvC,4BAA4B;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AAC5C,CAAC"}

package/dist/server/src/modules/charges-matcher/helpers/document-amount.helper.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Document Amount Normalization
+ *
+ * Normalizes document amounts for comparison with transaction amounts.
+ * Per specification (section 4.3.1):
+ * 1. Start with absolute value of total_amount
+ * 2. If business is creditor: negate
+ * 3. If document type is CREDIT_INVOICE: negate
+ */
+/**
+ * Document types from database schema
+ */
+export type DocumentType = 'CREDIT_INVOICE' | 'INVOICE' | 'INVOICE_RECEIPT' | 'OTHER' | 'PROFORMA' | 'RECEIPT' | 'UNPROCESSED';
+/**
+ * Normalize document amount for comparison with transaction amount
+ *
+ * Per specification:
+ * - Start with absolute value of total_amount
+ * - If business is creditor (debtor is user): negate
+ * - If document type is CREDIT_INVOICE: negate
+ *
+ * Examples:
+ * - INVOICE, business debtor (creditor is user): |100| = 100
+ * - INVOICE, business creditor (debtor is user): |100| * -1 = -100
+ * - CREDIT_INVOICE, business debtor: |100| * -1 = -100
+ * - CREDIT_INVOICE, business creditor: |100| * -1 * -1 = 100 (double negation)
+ *
+ * @param totalAmount - Raw total_amount from document (can be positive or negative)
+ * @param isBusinessCreditor - Whether the business is the creditor (from business extraction)
+ * @param documentType - Type of document
+ * @returns Normalized amount (signed) for comparison with transaction amount
+ *
+ * @example
+ * // Regular invoice where user is creditor (business owes user)
+ * normalizeDocumentAmount(100, false, 'INVOICE') // Returns 100
+ *
+ * @example
+ * // Regular invoice where user is debtor (user owes business)
+ * normalizeDocumentAmount(100, true, 'INVOICE') // Returns -100
+ *
+ * @example
+ * // Credit invoice where user is creditor (user owes business a refund)
+ * normalizeDocumentAmount(100, false, 'CREDIT_INVOICE') // Returns -100
+ *
+ * @example
+ * // Credit invoice where user is debtor (business owes user a refund)
+ * normalizeDocumentAmount(100, true, 'CREDIT_INVOICE') // Returns 100 (double negation)
+ */
+export declare function normalizeDocumentAmount(totalAmount: number, isBusinessCreditor: boolean, documentType: DocumentType): number;

package/dist/server/src/modules/charges-matcher/helpers/document-amount.helper.js

@@ -0,0 +1,58 @@
+/**
+ * Document Amount Normalization
+ *
+ * Normalizes document amounts for comparison with transaction amounts.
+ * Per specification (section 4.3.1):
+ * 1. Start with absolute value of total_amount
+ * 2. If business is creditor: negate
+ * 3. If document type is CREDIT_INVOICE: negate
+ */
+/**
+ * Normalize document amount for comparison with transaction amount
+ *
+ * Per specification:
+ * - Start with absolute value of total_amount
+ * - If business is creditor (debtor is user): negate
+ * - If document type is CREDIT_INVOICE: negate
+ *
+ * Examples:
+ * - INVOICE, business debtor (creditor is user): |100| = 100
+ * - INVOICE, business creditor (debtor is user): |100| * -1 = -100
+ * - CREDIT_INVOICE, business debtor: |100| * -1 = -100
+ * - CREDIT_INVOICE, business creditor: |100| * -1 * -1 = 100 (double negation)
+ *
+ * @param totalAmount - Raw total_amount from document (can be positive or negative)
+ * @param isBusinessCreditor - Whether the business is the creditor (from business extraction)
+ * @param documentType - Type of document
+ * @returns Normalized amount (signed) for comparison with transaction amount
+ *
+ * @example
+ * // Regular invoice where user is creditor (business owes user)
+ * normalizeDocumentAmount(100, false, 'INVOICE') // Returns 100
+ *
+ * @example
+ * // Regular invoice where user is debtor (user owes business)
+ * normalizeDocumentAmount(100, true, 'INVOICE') // Returns -100
+ *
+ * @example
+ * // Credit invoice where user is creditor (user owes business a refund)
+ * normalizeDocumentAmount(100, false, 'CREDIT_INVOICE') // Returns -100
+ *
+ * @example
+ * // Credit invoice where user is debtor (business owes user a refund)
+ * normalizeDocumentAmount(100, true, 'CREDIT_INVOICE') // Returns 100 (double negation)
+ */
+export function normalizeDocumentAmount(totalAmount, isBusinessCreditor, documentType) {
+    // Step 1: Start with absolute value
+    let normalizedAmount = Math.abs(totalAmount);
+    // Step 2: If business is creditor (debtor is user), negate
+    if (isBusinessCreditor) {
+        normalizedAmount = -normalizedAmount;
+    }
+    // Step 3: If document type is CREDIT_INVOICE, negate
+    if (documentType === 'CREDIT_INVOICE') {
+        normalizedAmount = -normalizedAmount;
+    }
+    return normalizedAmount;
+}
+//# sourceMappingURL=document-amount.helper.js.map

package/dist/server/src/modules/charges-matcher/helpers/document-amount.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-amount.helper.js","sourceRoot":"","sources":["../../../../../../src/modules/charges-matcher/helpers/document-amount.helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,uBAAuB,CACrC,WAAmB,EACnB,kBAA2B,EAC3B,YAA0B;IAE1B,oCAAoC;IACpC,IAAI,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAE7C,2DAA2D;IAC3D,IAAI,kBAAkB,EAAE,CAAC;QACvB,gBAAgB,GAAG,CAAC,gBAAgB,CAAC;IACvC,CAAC;IAED,qDAAqD;IACrD,IAAI,YAAY,KAAK,gBAAgB,EAAE,CAAC;QACtC,gBAAgB,GAAG,CAAC,gBAAgB,CAAC;IACvC,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}

package/dist/server/src/modules/charges-matcher/helpers/document-business.helper.d.ts

@@ -0,0 +1,13 @@
+export interface DocumentBusinessInfo {
+    businessId: string | null;
+    isBusinessCreditor: boolean;
+}
+/**
+ * Extract business information from a document
+ * @param creditorId - Document's creditor_id
+ * @param debtorId - Document's debtor_id
+ * @param adminBusinessId - Current user's ID
+ * @returns Business ID and whether business is the creditor
+ * @throws Error if both or neither IDs match adminBusinessId
+ */
+export declare function extractDocumentBusiness(creditorId: string | null, debtorId: string | null, adminBusinessId: string): DocumentBusinessInfo;

package/dist/server/src/modules/charges-matcher/helpers/document-business.helper.js

@@ -0,0 +1,37 @@
+/**
+ * Extract business information from a document
+ * @param creditorId - Document's creditor_id
+ * @param debtorId - Document's debtor_id
+ * @param adminBusinessId - Current user's ID
+ * @returns Business ID and whether business is the creditor
+ * @throws Error if both or neither IDs match adminBusinessId
+ */
+export function extractDocumentBusiness(creditorId, debtorId, adminBusinessId) {
+    // Check if both are null
+    if (creditorId === null && debtorId === null) {
+        throw new Error('Document has both creditor_id and debtor_id as null - invalid document state');
+    }
+    const isCreditorUser = creditorId === adminBusinessId;
+    const isDebtorUser = debtorId === adminBusinessId;
+    // Both sides are user
+    if (isCreditorUser && isDebtorUser) {
+        throw new Error('Document has both creditor_id and debtor_id equal to user ID - invalid document state');
+    }
+    // Neither side is user
+    if (!isCreditorUser && !isDebtorUser) {
+        throw new Error('Document has neither creditor_id nor debtor_id equal to user ID - document does not belong to user');
+    }
+    // User is debtor, business is creditor (or creditor is null)
+    if (isDebtorUser) {
+        return {
+            businessId: creditorId,
+            isBusinessCreditor: true,
+        };
+    }
+    // User is creditor, business is debtor (or debtor is null)
+    return {
+        businessId: debtorId,
+        isBusinessCreditor: false,
+    };
+}
+//# sourceMappingURL=document-business.helper.js.map

package/dist/server/src/modules/charges-matcher/helpers/document-business.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-business.helper.js","sourceRoot":"","sources":["../../../../../../src/modules/charges-matcher/helpers/document-business.helper.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,UAAyB,EACzB,QAAuB,EACvB,eAAuB;IAEvB,yBAAyB;IACzB,IAAI,UAAU,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAClG,CAAC;IAED,MAAM,cAAc,GAAG,UAAU,KAAK,eAAe,CAAC;IACtD,MAAM,YAAY,GAAG,QAAQ,KAAK,eAAe,CAAC;IAElD,sBAAsB;IACtB,IAAI,cAAc,IAAI,YAAY,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,uFAAuF,CACxF,CAAC;IACJ,CAAC;IAED,uBAAuB;IACvB,IAAI,CAAC,cAAc,IAAI,CAAC,YAAY,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,oGAAoG,CACrG,CAAC;IACJ,CAAC;IAED,6DAA6D;IAC7D,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO;YACL,UAAU,EAAE,UAAU;YACtB,kBAAkB,EAAE,IAAI;SACzB,CAAC;IACJ,CAAC;IAED,2DAA2D;IAC3D,OAAO;QACL,UAAU,EAAE,QAAQ;QACpB,kBAAkB,EAAE,KAAK;KAC1B,CAAC;AACJ,CAAC"}

package/dist/server/src/modules/charges-matcher/helpers/overall-confidence.helper.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Overall Confidence Calculator
+ *
+ * Combines individual confidence scores (amount, currency, business, date)
+ * into a single weighted overall confidence score.
+ *
+ * Formula: (amount × 0.4) + (currency × 0.2) + (business × 0.3) + (date × 0.1)
+ */
+export interface ConfidenceComponents {
+    amount: number;
+    currency: number;
+    business: number;
+    date: number;
+}
+/**
+ * Calculate overall confidence score from individual components
+ *
+ * @param components - Individual confidence scores (each 0.0 to 1.0)
+ * @returns Weighted overall confidence score (0.0 to 1.0, rounded to 2 decimals)
+ *
+ * @throws {Error} If any component is null or undefined
+ * @throws {Error} If any component is outside the valid range [0.0, 1.0]
+ *
+ * @example
+ * // Perfect match
+ * calculateOverallConfidence({
+ *   amount: 1.0,
+ *   currency: 1.0,
+ *   business: 1.0,
+ *   date: 1.0
+ * }) // Returns 1.0
+ *
+ * @example
+ * // Mixed confidence
+ * calculateOverallConfidence({
+ *   amount: 0.9,
+ *   currency: 1.0,
+ *   business: 0.5,
+ *   date: 0.8
+ * }) // Returns 0.79
+ */
+export declare function calculateOverallConfidence(components: ConfidenceComponents): number;

package/dist/server/src/modules/charges-matcher/helpers/overall-confidence.helper.js

@@ -0,0 +1,77 @@
+/**
+ * Overall Confidence Calculator
+ *
+ * Combines individual confidence scores (amount, currency, business, date)
+ * into a single weighted overall confidence score.
+ *
+ * Formula: (amount × 0.4) + (currency × 0.2) + (business × 0.3) + (date × 0.1)
+ */
+/**
+ * Weights for each confidence component
+ */
+const CONFIDENCE_WEIGHTS = {
+    amount: 0.4,
+    currency: 0.2,
+    business: 0.3,
+    date: 0.1,
+};
+/**
+ * Calculate overall confidence score from individual components
+ *
+ * @param components - Individual confidence scores (each 0.0 to 1.0)
+ * @returns Weighted overall confidence score (0.0 to 1.0, rounded to 2 decimals)
+ *
+ * @throws {Error} If any component is null or undefined
+ * @throws {Error} If any component is outside the valid range [0.0, 1.0]
+ *
+ * @example
+ * // Perfect match
+ * calculateOverallConfidence({
+ *   amount: 1.0,
+ *   currency: 1.0,
+ *   business: 1.0,
+ *   date: 1.0
+ * }) // Returns 1.0
+ *
+ * @example
+ * // Mixed confidence
+ * calculateOverallConfidence({
+ *   amount: 0.9,
+ *   currency: 1.0,
+ *   business: 0.5,
+ *   date: 0.8
+ * }) // Returns 0.79
+ */
+export function calculateOverallConfidence(components) {
+    // Validate all components are present
+    if (components.amount == null) {
+        throw new Error('Amount confidence is required');
+    }
+    if (components.currency == null) {
+        throw new Error('Currency confidence is required');
+    }
+    if (components.business == null) {
+        throw new Error('Business confidence is required');
+    }
+    if (components.date == null) {
+        throw new Error('Date confidence is required');
+    }
+    // Validate all components are in valid range
+    const validateRange = (value, name) => {
+        if (value < 0.0 || value > 1.0) {
+            throw new Error(`${name} confidence must be between 0.0 and 1.0, got ${value}`);
+        }
+    };
+    validateRange(components.amount, 'Amount');
+    validateRange(components.currency, 'Currency');
+    validateRange(components.business, 'Business');
+    validateRange(components.date, 'Date');
+    // Calculate weighted sum
+    const weightedSum = components.amount * CONFIDENCE_WEIGHTS.amount +
+        components.currency * CONFIDENCE_WEIGHTS.currency +
+        components.business * CONFIDENCE_WEIGHTS.business +
+        components.date * CONFIDENCE_WEIGHTS.date;
+    // Round to 2 decimal places
+    return Math.round(weightedSum * 100) / 100;
+}
+//# sourceMappingURL=overall-confidence.helper.js.map

package/dist/server/src/modules/charges-matcher/helpers/overall-confidence.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overall-confidence.helper.js","sourceRoot":"","sources":["../../../../../../src/modules/charges-matcher/helpers/overall-confidence.helper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH;;GAEG;AACH,MAAM,kBAAkB,GAAG;IACzB,MAAM,EAAE,GAAG;IACX,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,IAAI,EAAE,GAAG;CACD,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,0BAA0B,CAAC,UAAgC;IACzE,sCAAsC;IACtC,IAAI,UAAU,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,6CAA6C;IAC7C,MAAM,aAAa,GAAG,CAAC,KAAa,EAAE,IAAY,EAAQ,EAAE;QAC1D,IAAI,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,gDAAgD,KAAK,EAAE,CAAC,CAAC;QAClF,CAAC;IACH,CAAC,CAAC;IAEF,aAAa,CAAC,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3C,aAAa,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC/C,aAAa,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC/C,aAAa,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAEvC,yBAAyB;IACzB,MAAM,WAAW,GACf,UAAU,CAAC,MAAM,GAAG,kBAAkB,CAAC,MAAM;QAC7C,UAAU,CAAC,QAAQ,GAAG,kBAAkB,CAAC,QAAQ;QACjD,UAAU,CAAC,QAAQ,GAAG,kBAAkB,CAAC,QAAQ;QACjD,UAAU,CAAC,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC;IAE5C,4BAA4B;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AAC7C,CAAC"}

package/dist/server/src/modules/charges-matcher/index.d.ts

@@ -0,0 +1,3 @@
+export declare const chargesMatcherModule: import("graphql-modules").Module;
+export { ChargesMatcherProvider } from './providers/charges-matcher.provider.js';
+export * as ChargesMatcherTypes from './types.js';

package/dist/server/src/modules/charges-matcher/index.js

@@ -0,0 +1,15 @@
+import chargesMatcherTypeDefs from './typeDefs/charges-matcher.graphql.js';
+import { createModule } from 'graphql-modules';
+import { ChargesMatcherProvider } from './providers/charges-matcher.provider.js';
+import { chargesMatcherResolvers } from './resolvers/index.js';
+const __dirname = new URL('.', import.meta.url).pathname;
+export const chargesMatcherModule = createModule({
+    id: 'charges-matcher',
+    dirname: __dirname,
+    typeDefs: [chargesMatcherTypeDefs],
+    resolvers: [chargesMatcherResolvers],
+    providers: [ChargesMatcherProvider],
+});
+export { ChargesMatcherProvider } from './providers/charges-matcher.provider.js';
+export * as ChargesMatcherTypes from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/server/src/modules/charges-matcher/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/charges-matcher/index.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;AAEzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAC;IAC/C,EAAE,EAAE,iBAAiB;IACrB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,CAAC,sBAAsB,CAAC;IAClC,SAAS,EAAE,CAAC,uBAAuB,CAAC;IACpC,SAAS,EAAE,CAAC,sBAAsB,CAAC;CACpC,CAAC,CAAC;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,KAAK,mBAAmB,MAAM,YAAY,CAAC"}

package/dist/server/src/modules/charges-matcher/providers/auto-match.provider.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Auto-Match Provider
+ *
+ * Implements the core auto-match logic for processing all unmatched charges
+ * and automatically merging charges with high-confidence matches (≥0.95).
+ */
+import type { ChargeWithData } from '../types.js';
+import { type MatchResult } from './single-match.provider.js';
+/**
+ * Result of processing a single charge for auto-matching
+ */
+export interface ProcessChargeResult {
+    /** Match result if a valid match was found, null otherwise */
+    match: MatchResult | null;
+    /** Status of the processing */
+    status: 'matched' | 'skipped' | 'no-match';
+    /** Reason for the status (useful for debugging/logging) */
+    reason?: string;
+}
+/**
+ * Process a single unmatched charge and find best match
+ *
+ * This function uses findMatches() from single-match provider with NO date window
+ * restriction, then filters for high-confidence matches (≥0.95 threshold).
+ *
+ * @param sourceCharge - Unmatched charge to process (must have only transactions OR only documents)
+ * @param allCandidates - All candidate charges to search (complementary type to source)
+ * @param userId - Current user ID for business extraction
+ * @returns Processing result with match status
+ *
+ * @throws Error if sourceCharge is already matched (has both transactions and documents)
+ * @throws Error if sourceCharge has no transactions or documents
+ * @throws Error if any validation fails (propagated from findMatches)
+ */
+export declare function processChargeForAutoMatch(sourceCharge: ChargeWithData, allCandidates: ChargeWithData[], userId: string): ProcessChargeResult;
+/**
+ * Determine merge direction for two charges
+ *
+ * The merge direction follows these rules:
+ * 1. If one charge is matched (has both transactions and documents), keep the matched one
+ * 2. If both are unmatched, keep the one with transactions (transaction charge is the "anchor")
+ * 3. If neither has transactions, keep the first one (arbitrary but consistent)
+ *
+ * @param charge1 - First charge
+ * @param charge2 - Second charge
+ * @returns [source, target] tuple where source will be merged INTO target (source is deleted)
+ */
+export declare function determineMergeDirection(charge1: ChargeWithData, charge2: ChargeWithData): [ChargeWithData, ChargeWithData];