@things-factory/accounting 10.1.139 → 10.1.141

package/dist-server/service/bank-statement/bank-parser.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseBankWorkbook = parseBankWorkbook;
+exports.parseBankRows = parseBankRows;
+const xlsx_1 = require("xlsx");
+const bank_source_1 = require("./bank-source");
+const shell_1 = require("@things-factory/shell");
+function parseBankWorkbook(data, timezoneFor = () => 'Asia/Seoul') {
+    const workbook = (0, xlsx_1.read)(data, { type: 'buffer' });
+    if (workbook.SheetNames.length !== 1)
+        throw new shell_1.Refusal('bank-single-sheet', {}, 'Upload a statement with one sheet');
+    const rows = xlsx_1.utils.sheet_to_json(workbook.Sheets[workbook.SheetNames[0]], { header: 1, defval: null });
+    return parseBankRows(rows, timezoneFor);
+}
+function parseBankRows(rows, timezoneFor = () => 'Asia/Seoul') {
+    const headerIndex = rows.findIndex(row => row.includes('거래일시'));
+    if (headerIndex < 0)
+        throw new shell_1.Refusal('bank-unsupported-format', {}, 'Unsupported bank statement format');
+    const header = rows[headerIndex];
+    const metadata = rows.slice(0, headerIndex).map(row => row.join(' ')).join('\n');
+    const accountNumber = /계좌번호\s*:\s*([\d-]+)/.exec(metadata)?.[1];
+    if (!accountNumber)
+        throw new shell_1.Refusal('bank-missing-account', {}, 'The bank statement has no account number');
+    const woori = header.includes('지급(원)');
+    const foreign = header.includes('통화');
+    if (!woori && !foreign && !(header.includes('출금') && header.includes('입금') && header.includes('거래후 잔액')))
+        throw new shell_1.Refusal('bank-unsupported-format', {}, 'Unsupported bank statement format');
+    const bankName = woori ? '우리은행' : '기업은행';
+    const periods = metadata.match(/\d{4}[-.]\d{2}[-.]\d{2}/g) ?? [];
+    const text = (value) => value == null || value === '' ? null : String(value);
+    const money = (value) => {
+        if (value == null || value === '')
+            throw new shell_1.Refusal('bank-invalid-money', {}, 'Check the statement amounts and balances');
+        const n = Number(typeof value === 'string' ? value.replace(/,/g, '').trim() : value);
+        if (!Number.isFinite(n) || Math.abs(n * 100 - Math.round(n * 100)) > 0.0001)
+            throw new shell_1.Refusal('bank-invalid-money', {}, 'Check the statement amounts and balances');
+        return n;
+    };
+    const lines = [];
+    const occurrences = new Map();
+    const sourceRows = rows.slice(headerIndex + 1).map((raw, i) => ({ raw, row: i + headerIndex + 2 })).filter(({ raw }) => typeof raw[0] === 'number');
+    if (!sourceRows.length)
+        throw new shell_1.Refusal('bank-empty-statement', {}, 'The statement has no transactions');
+    for (const { raw, row } of sourceRows) {
+        const time = (0, bank_source_1.bankTimestamp)(String(raw[1]), timezoneFor(foreign ? String(raw[2]) : 'KRW'));
+        const deposit = money(raw[woori ? 5 : foreign ? 3 : 3]);
+        const withdrawal = money(raw[woori ? 4 : foreign ? 4 : 2]);
+        if (deposit < 0 || withdrawal < 0 || (deposit && withdrawal))
+            throw new shell_1.Refusal('bank-invalid-direction', { row }, 'Check the bank deposit and withdrawal direction');
+        const line = {
+            row, bankSequence: foreign ? raw[0] : sourceRows.length + 1 - raw[0],
+            currency: foreign ? String(raw[2]) : 'KRW', ...time,
+            type: deposit ? 'INCOME' : 'EXPENSE', amount: deposit || withdrawal,
+            balance: money(raw[woori ? 6 : foreign ? 5 : 4]),
+            bankDescription: text(raw[woori ? 3 : foreign ? 6 : 5]),
+            bankKind: foreign ? '외화' : text(raw[woori ? 2 : 9]),
+            bankCounterpartyName: text(raw[woori ? 3 : foreign ? 8 : 12]),
+            bankCounterpartyAccount: foreign || woori ? null : text(raw[6]),
+            bankCounterpartyBank: foreign || woori ? null : text(raw[7]),
+            bankMemo: foreign ? null : text(raw[8]), fingerprint: '', raw
+        };
+        if (!/^[A-Z]{3}$/.test(line.currency))
+            throw new shell_1.Refusal('bank-invalid-currency', { row }, 'Check the bank currency');
+        const base = (0, bank_source_1.bankFingerprint)({ ...line, accountNumber });
+        const occurrence = occurrences.get(base) ?? 0;
+        occurrences.set(base, occurrence + 1);
+        line.fingerprint = (0, bank_source_1.bankFingerprint)({ ...line, accountNumber }, occurrence);
+        lines.push(line);
+    }
+    // The bank's chronological row order resolves ties in second-resolution timestamps.
+    const sorted = [...lines].sort((a, b) => (a.transactionAt ?? a.transactionDate).localeCompare(b.transactionAt ?? b.transactionDate) || a.bankSequence - b.bankSequence);
+    const previous = new Map();
+    for (const line of sorted) {
+        const prior = previous.get(line.currency);
+        if (prior && Math.abs(line.balance - prior.balance - (line.type === 'INCOME' ? line.amount : -line.amount)) > 0.005)
+            throw new shell_1.Refusal('bank-balance-gap', { row: line.row }, 'The bank balance does not follow the previous transaction');
+        previous.set(line.currency, line);
+    }
+    const total = rows.find(row => row[1] === '합계');
+    if (total && !foreign && !woori) {
+        for (const [type, index] of [['EXPENSE', 2], ['INCOME', 3]]) {
+            const sum = lines.filter(line => line.type === type).reduce((n, line) => n + line.amount, 0);
+            if (Math.abs(sum - money(total[index])) > 0.005)
+                throw new shell_1.Refusal('bank-total-mismatch', {}, 'The bank transaction total does not match');
+        }
+    }
+    return { bankName, accountNumber, periodStart: periods[0]?.replace(/\./g, '-') ?? null, periodEnd: periods[1]?.replace(/\./g, '-') ?? null, rawRows: rows, lines };
+}
+//# sourceMappingURL=bank-parser.js.map

package/dist-server/service/bank-statement/bank-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bank-parser.js","sourceRoot":"","sources":["../../../server/service/bank-statement/bank-parser.ts"],"names":[],"mappings":"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","sourcesContent":["import { read, utils } from 'xlsx'\nimport { bankFingerprint, bankTimestamp } from './bank-source'\nimport { Refusal } from '@things-factory/shell'\n\nexport interface BankLine {\n  row: number\n  bankSequence: number\n  currency: string\n  transactionDate: string\n  transactionAt: string | null\n  bankLocalTime: string\n  type: 'INCOME' | 'EXPENSE'\n  amount: number\n  balance: number\n  bankDescription: string | null\n  bankKind: string | null\n  bankCounterpartyName: string | null\n  bankCounterpartyAccount: string | null\n  bankCounterpartyBank: string | null\n  bankMemo: string | null\n  fingerprint: string\n  raw: any[]\n}\n\nexport function parseBankWorkbook(data: Buffer, timezoneFor: (currency: string) => string = () => 'Asia/Seoul') {\n  const workbook = read(data, { type: 'buffer' })\n  if (workbook.SheetNames.length !== 1) throw new Refusal('bank-single-sheet', {}, 'Upload a statement with one sheet')\n  const rows = utils.sheet_to_json<any[]>(workbook.Sheets[workbook.SheetNames[0]], { header: 1, defval: null })\n  return parseBankRows(rows, timezoneFor)\n}\n\nexport function parseBankRows(rows: any[][], timezoneFor: (currency: string) => string = () => 'Asia/Seoul') {\n  const headerIndex = rows.findIndex(row => row.includes('거래일시'))\n  if (headerIndex < 0) throw new Refusal('bank-unsupported-format', {}, 'Unsupported bank statement format')\n  const header = rows[headerIndex]\n  const metadata = rows.slice(0, headerIndex).map(row => row.join(' ')).join('\\n')\n  const accountNumber = /계좌번호\\s*:\\s*([\\d-]+)/.exec(metadata)?.[1]\n  if (!accountNumber) throw new Refusal('bank-missing-account', {}, 'The bank statement has no account number')\n  const woori = header.includes('지급(원)')\n  const foreign = header.includes('통화')\n  if (!woori && !foreign && !(header.includes('출금') && header.includes('입금') && header.includes('거래후 잔액'))) throw new Refusal('bank-unsupported-format', {}, 'Unsupported bank statement format')\n  const bankName = woori ? '우리은행' : '기업은행'\n  const periods = metadata.match(/\\d{4}[-.]\\d{2}[-.]\\d{2}/g) ?? []\n  const text = (value: any) => value == null || value === '' ? null : String(value)\n  const money = (value: any) => {\n    if (value == null || value === '') throw new Refusal('bank-invalid-money', {}, 'Check the statement amounts and balances')\n    const n = Number(typeof value === 'string' ? value.replace(/,/g, '').trim() : value)\n    if (!Number.isFinite(n) || Math.abs(n * 100 - Math.round(n * 100)) > 0.0001) throw new Refusal('bank-invalid-money', {}, 'Check the statement amounts and balances')\n    return n\n  }\n  const lines: BankLine[] = []\n  const occurrences = new Map<string, number>()\n  const sourceRows = rows.slice(headerIndex + 1).map((raw, i) => ({ raw, row: i + headerIndex + 2 })).filter(({ raw }) => typeof raw[0] === 'number')\n  if (!sourceRows.length) throw new Refusal('bank-empty-statement', {}, 'The statement has no transactions')\n  for (const { raw, row } of sourceRows) {\n    const time = bankTimestamp(String(raw[1]), timezoneFor(foreign ? String(raw[2]) : 'KRW'))\n    const deposit = money(raw[woori ? 5 : foreign ? 3 : 3])\n    const withdrawal = money(raw[woori ? 4 : foreign ? 4 : 2])\n    if (deposit < 0 || withdrawal < 0 || (deposit && withdrawal)) throw new Refusal('bank-invalid-direction', { row }, 'Check the bank deposit and withdrawal direction')\n    const line: BankLine = {\n      row, bankSequence: foreign ? raw[0] : sourceRows.length + 1 - raw[0],\n      currency: foreign ? String(raw[2]) : 'KRW', ...time,\n      type: deposit ? 'INCOME' : 'EXPENSE', amount: deposit || withdrawal,\n      balance: money(raw[woori ? 6 : foreign ? 5 : 4]),\n      bankDescription: text(raw[woori ? 3 : foreign ? 6 : 5]),\n      bankKind: foreign ? '외화' : text(raw[woori ? 2 : 9]),\n      bankCounterpartyName: text(raw[woori ? 3 : foreign ? 8 : 12]),\n      bankCounterpartyAccount: foreign || woori ? null : text(raw[6]),\n      bankCounterpartyBank: foreign || woori ? null : text(raw[7]),\n      bankMemo: foreign ? null : text(raw[8]), fingerprint: '', raw\n    }\n    if (!/^[A-Z]{3}$/.test(line.currency)) throw new Refusal('bank-invalid-currency', { row }, 'Check the bank currency')\n    const base = bankFingerprint({ ...line, accountNumber })\n    const occurrence = occurrences.get(base) ?? 0\n    occurrences.set(base, occurrence + 1)\n    line.fingerprint = bankFingerprint({ ...line, accountNumber }, occurrence)\n    lines.push(line)\n  }\n  // The bank's chronological row order resolves ties in second-resolution timestamps.\n  const sorted = [...lines].sort((a, b) => (a.transactionAt ?? a.transactionDate).localeCompare(b.transactionAt ?? b.transactionDate) || a.bankSequence - b.bankSequence)\n  const previous = new Map<string, BankLine>()\n  for (const line of sorted) {\n    const prior = previous.get(line.currency)\n    if (prior && Math.abs(line.balance - prior.balance - (line.type === 'INCOME' ? line.amount : -line.amount)) > 0.005)\n      throw new Refusal('bank-balance-gap', { row: line.row }, 'The bank balance does not follow the previous transaction')\n    previous.set(line.currency, line)\n  }\n  const total = rows.find(row => row[1] === '합계')\n  if (total && !foreign && !woori) {\n    for (const [type, index] of [['EXPENSE', 2], ['INCOME', 3]] as const) {\n      const sum = lines.filter(line => line.type === type).reduce((n, line) => n + line.amount, 0)\n      if (Math.abs(sum - money(total[index])) > 0.005) throw new Refusal('bank-total-mismatch', {}, 'The bank transaction total does not match')\n    }\n  }\n  return { bankName, accountNumber, periodStart: periods[0]?.replace(/\\./g, '-') ?? null, periodEnd: periods[1]?.replace(/\\./g, '-') ?? null, rawRows: rows, lines }\n}\n"]}

package/dist-server/service/bank-statement/bank-reconcile.d.ts

@@ -0,0 +1,35 @@
+import type { BankLine } from './bank-parser';
+export interface LedgerCandidate {
+    id: string;
+    currency: string;
+    type: string;
+    amount: number;
+    transactionDate: string;
+    balance?: number;
+    source?: string;
+    bankFingerprint?: string;
+    bankAccountId?: string;
+    description?: string;
+    counterpartyName?: string;
+}
+/** Resolve the entire statement before writing: one ledger row cannot be consumed twice. */
+export declare function reconcileBankLines(lines: BankLine[], ledger: LedgerCandidate[]): {
+    line: BankLine;
+    candidates: LedgerCandidate[];
+    match: LedgerCandidate;
+}[];
+/**
+ * Place the held lines a person decided: on one of the line's own candidates (the row it is), or nowhere (a new
+ * transaction). No ledger row is taken twice, counting the ones the statement matched by itself. False when a
+ * decision names a line that was not held, or a row it may not take — then nothing is placed.
+ */
+export declare function placeHeldLines(plan: {
+    line: {
+        fingerprint: string;
+    };
+    candidates: LedgerCandidate[];
+    match?: LedgerCandidate;
+}[], decisions: readonly {
+    fingerprint: string;
+    transactionId?: string | null;
+}[]): boolean;

package/dist-server/service/bank-statement/bank-reconcile.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reconcileBankLines = reconcileBankLines;
+exports.placeHeldLines = placeHeldLines;
+const cents = (value) => Math.round(Number(value) * 100);
+const day = (value) => Date.parse(value + 'T00:00:00Z') / 86400000;
+const normalized = (value) => (value ?? '').normalize('NFKC').replace(/[^\p{L}\p{N}]/gu, '').toLowerCase();
+/** Resolve the entire statement before writing: one ledger row cannot be consumed twice. */
+function reconcileBankLines(lines, ledger) {
+    const candidates = lines.map(line => {
+        const possible = ledger.filter(old => !old.bankFingerprint && old.source !== 'BANK_STATEMENT' &&
+            old.currency === line.currency && old.type === line.type && cents(old.amount) === cents(line.amount));
+        const exact = possible.filter(old => old.transactionDate === line.transactionDate);
+        if (exact.length)
+            return exact;
+        // Date correction requires independent evidence, never amount alone.
+        return possible.filter(old => Math.abs(day(old.transactionDate) - day(line.transactionDate)) <= 7 && ((old.balance != null && cents(old.balance) === cents(line.balance)) ||
+            [old.description, old.counterpartyName].some(value => normalized(value).length >= 4 &&
+                [line.bankDescription, line.bankCounterpartyName].some(bank => normalized(bank) === normalized(value)))));
+    });
+    const uses = new Map();
+    for (const group of candidates)
+        for (const old of group)
+            uses.set(old.id, (uses.get(old.id) ?? 0) + 1);
+    return lines.map((line, index) => {
+        let group = candidates[index];
+        let uncertain = false;
+        if (!group.length) {
+            group = ledger.filter(old => !old.bankFingerprint && old.source !== 'BANK_STATEMENT' && old.currency === line.currency &&
+                old.type === line.type && cents(old.amount) === cents(line.amount) && Math.abs(day(old.transactionDate) - day(line.transactionDate)) <= 7);
+            uncertain = group.length > 0;
+        }
+        // A ledger total may represent multiple bank movements. Keep all its constituent rows pending.
+        if (!group.length) {
+            const sameDay = lines.filter(other => other.transactionDate === line.transactionDate && other.currency === line.currency && other.type === line.type);
+            group = ledger.filter(old => !old.bankFingerprint && old.source !== 'BANK_STATEMENT' && old.transactionDate === line.transactionDate &&
+                old.currency === line.currency && old.type === line.type && cents(old.amount) > cents(line.amount) &&
+                (cents(old.amount) === sameDay.reduce((sum, other) => sum + cents(other.amount), 0) ||
+                    sameDay.some(other => other !== line && cents(other.amount) + cents(line.amount) === cents(old.amount))));
+        }
+        return { line, candidates: group, match: !uncertain && group.length === 1 && uses.get(group[0].id) === 1 ? group[0] : undefined };
+    });
+}
+/**
+ * Place the held lines a person decided: on one of the line's own candidates (the row it is), or nowhere (a new
+ * transaction). No ledger row is taken twice, counting the ones the statement matched by itself. False when a
+ * decision names a line that was not held, or a row it may not take — then nothing is placed.
+ */
+function placeHeldLines(plan, decisions) {
+    const byLine = new Map(plan.map(item => [item.line.fingerprint, item]));
+    const taken = new Set(plan.filter(item => item.match).map(item => item.match.id));
+    const placed = [];
+    for (const decision of decisions) {
+        const item = byLine.get(decision.fingerprint);
+        if (!item || item.match || !item.candidates.length || placed.some(([one]) => one === item))
+            return false;
+        const id = decision.transactionId ?? null;
+        const row = id ? item.candidates.find(old => old.id === id) : undefined;
+        if (id && (!row || taken.has(id)))
+            return false;
+        if (row)
+            taken.add(row.id);
+        placed.push([item, row]);
+    }
+    for (const [item, row] of placed) {
+        item.match = row;
+        item.candidates = [];
+    }
+    return true;
+}
+//# sourceMappingURL=bank-reconcile.js.map

package/dist-server/service/bank-statement/bank-reconcile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bank-reconcile.js","sourceRoot":"","sources":["../../../server/service/bank-statement/bank-reconcile.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BankLine } from './bank-parser'\n\nexport interface LedgerCandidate {\n  id: string; currency: string; type: string; amount: number; transactionDate: string\n  balance?: number; source?: string; bankFingerprint?: string; bankAccountId?: string\n  description?: string; counterpartyName?: string\n}\nconst cents = (value: number) => Math.round(Number(value) * 100)\nconst day = (value: string) => Date.parse(value + 'T00:00:00Z') / 86400000\nconst normalized = (value?: string | null) => (value ?? '').normalize('NFKC').replace(/[^\\p{L}\\p{N}]/gu, '').toLowerCase()\n\n/** Resolve the entire statement before writing: one ledger row cannot be consumed twice. */\nexport function reconcileBankLines(lines: BankLine[], ledger: LedgerCandidate[]) {\n  const candidates = lines.map(line => {\n    const possible = ledger.filter(old => !old.bankFingerprint && old.source !== 'BANK_STATEMENT' &&\n      old.currency === line.currency && old.type === line.type && cents(old.amount) === cents(line.amount))\n    const exact = possible.filter(old => old.transactionDate === line.transactionDate)\n    if (exact.length) return exact\n    // Date correction requires independent evidence, never amount alone.\n    return possible.filter(old => Math.abs(day(old.transactionDate) - day(line.transactionDate)) <= 7 && (\n      (old.balance != null && cents(old.balance) === cents(line.balance)) ||\n      [old.description, old.counterpartyName].some(value => normalized(value).length >= 4 &&\n        [line.bankDescription, line.bankCounterpartyName].some(bank => normalized(bank) === normalized(value)))\n    ))\n  })\n  const uses = new Map<string, number>()\n  for (const group of candidates) for (const old of group) uses.set(old.id, (uses.get(old.id) ?? 0) + 1)\n  return lines.map((line, index) => {\n    let group = candidates[index]\n    let uncertain = false\n    if (!group.length) {\n      group = ledger.filter(old => !old.bankFingerprint && old.source !== 'BANK_STATEMENT' && old.currency === line.currency &&\n        old.type === line.type && cents(old.amount) === cents(line.amount) && Math.abs(day(old.transactionDate) - day(line.transactionDate)) <= 7)\n      uncertain = group.length > 0\n    }\n    // A ledger total may represent multiple bank movements. Keep all its constituent rows pending.\n    if (!group.length) {\n      const sameDay = lines.filter(other => other.transactionDate === line.transactionDate && other.currency === line.currency && other.type === line.type)\n      group = ledger.filter(old => !old.bankFingerprint && old.source !== 'BANK_STATEMENT' && old.transactionDate === line.transactionDate &&\n        old.currency === line.currency && old.type === line.type && cents(old.amount) > cents(line.amount) &&\n        (cents(old.amount) === sameDay.reduce((sum, other) => sum + cents(other.amount), 0) ||\n          sameDay.some(other => other !== line && cents(other.amount) + cents(line.amount) === cents(old.amount))))\n    }\n    return { line, candidates: group, match: !uncertain && group.length === 1 && uses.get(group[0].id) === 1 ? group[0] : undefined }\n  })\n}\n\n/**\n * Place the held lines a person decided: on one of the line's own candidates (the row it is), or nowhere (a new\n * transaction). No ledger row is taken twice, counting the ones the statement matched by itself. False when a\n * decision names a line that was not held, or a row it may not take — then nothing is placed.\n */\nexport function placeHeldLines(\n  plan: { line: { fingerprint: string }; candidates: LedgerCandidate[]; match?: LedgerCandidate }[],\n  decisions: readonly { fingerprint: string; transactionId?: string | null }[]\n): boolean {\n  const byLine = new Map(plan.map(item => [item.line.fingerprint, item]))\n  const taken = new Set(plan.filter(item => item.match).map(item => item.match!.id))\n  const placed: [typeof plan[number], LedgerCandidate | undefined][] = []\n  for (const decision of decisions) {\n    const item = byLine.get(decision.fingerprint)\n    if (!item || item.match || !item.candidates.length || placed.some(([one]) => one === item)) return false\n    const id = decision.transactionId ?? null\n    const row = id ? item.candidates.find(old => old.id === id) : undefined\n    if (id && (!row || taken.has(id))) return false\n    if (row) taken.add(row.id)\n    placed.push([item, row])\n  }\n  for (const [item, row] of placed) {\n    item.match = row\n    item.candidates = []\n  }\n  return true\n}\n"]}

package/dist-server/service/bank-statement/bank-source.d.ts

@@ -0,0 +1,25 @@
+/** Multipart headers may expose UTF-8 filename bytes as Latin-1 text. */
+export declare function bankFilename(value: string): string;
+/**
+ * Dates stay in the bank's local calendar; an unknown time is never invented. `bankLocalTime` is the time as the bank
+ * printed it — what identifies the line, whatever timezone the account is later given.
+ */
+export declare function bankTimestamp(value: string, timezone?: string): {
+    transactionDate: string;
+    transactionAt: string | null;
+    bankLocalTime: string;
+};
+/**
+ * File names and export row numbers change between overlapping statements; the account's timezone may change too.
+ * The line is known by what the bank printed: its local time string, not the instant it was read as (ADR-0120).
+ */
+export declare function bankFingerprint(line: {
+    accountNumber: string;
+    currency: string;
+    bankLocalTime: string;
+    type: string;
+    amount: number;
+    balance: number;
+    bankDescription: string | null;
+    bankKind: string | null;
+}, occurrence?: number): string;

package/dist-server/service/bank-statement/bank-source.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bankFilename = bankFilename;
+exports.bankTimestamp = bankTimestamp;
+exports.bankFingerprint = bankFingerprint;
+const tslib_1 = require("tslib");
+const moment_timezone_1 = tslib_1.__importDefault(require("moment-timezone"));
+const crypto_1 = require("crypto");
+const shell_1 = require("@things-factory/shell");
+/** Multipart headers may expose UTF-8 filename bytes as Latin-1 text. */
+function bankFilename(value) {
+    if (/[^\x00-\xff]/.test(value))
+        return value.normalize('NFC');
+    const decoded = Buffer.from(value, 'latin1').toString('utf8');
+    return (decoded.includes('\ufffd') ? value : decoded).normalize('NFC');
+}
+/**
+ * Dates stay in the bank's local calendar; an unknown time is never invented. `bankLocalTime` is the time as the bank
+ * printed it — what identifies the line, whatever timezone the account is later given.
+ */
+function bankTimestamp(value, timezone = 'Asia/Seoul') {
+    const normalized = value.trim().replace(/\./g, '-').replace(/[()]/g, '').replace(/\s+/g, ' ');
+    const match = /^(\d{4})-(\d{2})-(\d{2})(?: (\d{2}):(\d{2}):(\d{2}))?$/.exec(normalized);
+    if (!match)
+        throw new shell_1.Refusal('bank-invalid-time', { value }, 'Check the bank transaction timestamp');
+    const [, y, m, d, h, min, sec] = match;
+    const date = new Date(Date.UTC(+y, +m - 1, +d));
+    if (date.getUTCFullYear() !== +y || date.getUTCMonth() !== +m - 1 || date.getUTCDate() !== +d || (h !== undefined && (+h > 23 || +min > 59 || +sec > 59)))
+        throw new shell_1.Refusal('bank-invalid-time', { value }, 'Check the bank transaction timestamp');
+    if (!moment_timezone_1.default.tz.zone(timezone))
+        throw new shell_1.Refusal('bank-invalid-time', { value: timezone }, 'Invalid bank account time zone');
+    let transactionAt = null;
+    if (h !== undefined) {
+        const local = `${y}-${m}-${d} ${h}:${min}:${sec}`;
+        const instant = moment_timezone_1.default.tz(local, 'YYYY-MM-DD HH:mm:ss', true, timezone);
+        if (instant.format('YYYY-MM-DD HH:mm:ss') !== local)
+            throw new shell_1.Refusal('bank-invalid-time', { value }, 'Nonexistent local bank time');
+        if ([-120, -60, 60, 120].some(minutes => instant.clone().add(minutes, 'minutes').format('YYYY-MM-DD HH:mm:ss') === local))
+            throw new shell_1.Refusal('bank-invalid-time', { value }, 'Ambiguous local bank time');
+        transactionAt = instant.format('YYYY-MM-DDTHH:mm:ssZ');
+    }
+    return { transactionDate: `${y}-${m}-${d}`, transactionAt, bankLocalTime: h === undefined ? `${y}-${m}-${d}` : `${y}-${m}-${d} ${h}:${min}:${sec}` };
+}
+/**
+ * File names and export row numbers change between overlapping statements; the account's timezone may change too.
+ * The line is known by what the bank printed: its local time string, not the instant it was read as (ADR-0120).
+ */
+function bankFingerprint(line, occurrence = 0) {
+    return (0, crypto_1.createHash)('sha256').update(JSON.stringify([
+        line.accountNumber.replace(/\D/g, ''), line.currency, line.bankLocalTime,
+        line.type, line.amount.toFixed(2), line.balance.toFixed(2),
+        (line.bankDescription ?? '').normalize('NFKC').trim(), (line.bankKind ?? '').normalize('NFKC').trim(), occurrence
+    ])).digest('hex');
+}
+//# sourceMappingURL=bank-source.js.map

package/dist-server/service/bank-statement/bank-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bank-source.js","sourceRoot":"","sources":["../../../server/service/bank-statement/bank-source.ts"],"names":[],"mappings":";;AAKA,oCAIC;AAMD,sCAkBC;AAMD,0CAMC;;AA7CD,8EAAoC;AACpC,mCAAmC;AACnC,iDAA+C;AAE/C,yEAAyE;AACzE,SAAgB,YAAY,CAAC,KAAa;IACxC,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC7D,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;AACxE,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,KAAa,EAAE,QAAQ,GAAG,YAAY;IAClE,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC7F,MAAM,KAAK,GAAG,wDAAwD,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACvF,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,eAAO,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,EAAE,sCAAsC,CAAC,CAAA;IACrG,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,KAAK,CAAA;IACtC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IAC/C,IAAI,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,GAAG,EAAE,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;QACvJ,MAAM,IAAI,eAAO,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,EAAE,sCAAsC,CAAC,CAAA;IAC3F,IAAI,CAAC,yBAAM,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,eAAO,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,gCAAgC,CAAC,CAAA;IAC5H,IAAI,aAAa,GAAkB,IAAI,CAAA;IACvC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,EAAE,CAAA;QACjD,MAAM,OAAO,GAAG,yBAAM,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;QACvE,IAAI,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAC,KAAK,KAAK;YAAE,MAAM,IAAI,eAAO,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,EAAE,6BAA6B,CAAC,CAAA;QACrI,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,qBAAqB,CAAC,KAAK,KAAK,CAAC;YAAE,MAAM,IAAI,eAAO,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,EAAE,2BAA2B,CAAC,CAAA;QACzM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAA;IACxD,CAAC;IACD,OAAO,EAAE,eAAe,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,EAAE,EAAE,CAAA;AACtJ,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,IAAgL,EAAE,UAAU,GAAG,CAAC;IAC9N,OAAO,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;QAChD,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa;QACxE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1D,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,UAAU;KAClH,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACnB,CAAC","sourcesContent":["import moment from 'moment-timezone'\nimport { createHash } from 'crypto'\nimport { Refusal } from '@things-factory/shell'\n\n/** Multipart headers may expose UTF-8 filename bytes as Latin-1 text. */\nexport function bankFilename(value: string): string {\n  if (/[^\\x00-\\xff]/.test(value)) return value.normalize('NFC')\n  const decoded = Buffer.from(value, 'latin1').toString('utf8')\n  return (decoded.includes('\\ufffd') ? value : decoded).normalize('NFC')\n}\n\n/**\n * Dates stay in the bank's local calendar; an unknown time is never invented. `bankLocalTime` is the time as the bank\n * printed it — what identifies the line, whatever timezone the account is later given.\n */\nexport function bankTimestamp(value: string, timezone = 'Asia/Seoul'): { transactionDate: string; transactionAt: string | null; bankLocalTime: string } {\n  const normalized = value.trim().replace(/\\./g, '-').replace(/[()]/g, '').replace(/\\s+/g, ' ')\n  const match = /^(\\d{4})-(\\d{2})-(\\d{2})(?: (\\d{2}):(\\d{2}):(\\d{2}))?$/.exec(normalized)\n  if (!match) throw new Refusal('bank-invalid-time', { value }, 'Check the bank transaction timestamp')\n  const [, y, m, d, h, min, sec] = match\n  const date = new Date(Date.UTC(+y, +m - 1, +d))\n  if (date.getUTCFullYear() !== +y || date.getUTCMonth() !== +m - 1 || date.getUTCDate() !== +d || (h !== undefined && (+h > 23 || +min > 59 || +sec > 59)))\n    throw new Refusal('bank-invalid-time', { value }, 'Check the bank transaction timestamp')\n  if (!moment.tz.zone(timezone)) throw new Refusal('bank-invalid-time', { value: timezone }, 'Invalid bank account time zone')\n  let transactionAt: string | null = null\n  if (h !== undefined) {\n    const local = `${y}-${m}-${d} ${h}:${min}:${sec}`\n    const instant = moment.tz(local, 'YYYY-MM-DD HH:mm:ss', true, timezone)\n    if (instant.format('YYYY-MM-DD HH:mm:ss') !== local) throw new Refusal('bank-invalid-time', { value }, 'Nonexistent local bank time')\n    if ([-120, -60, 60, 120].some(minutes => instant.clone().add(minutes, 'minutes').format('YYYY-MM-DD HH:mm:ss') === local)) throw new Refusal('bank-invalid-time', { value }, 'Ambiguous local bank time')\n    transactionAt = instant.format('YYYY-MM-DDTHH:mm:ssZ')\n  }\n  return { transactionDate: `${y}-${m}-${d}`, transactionAt, bankLocalTime: h === undefined ? `${y}-${m}-${d}` : `${y}-${m}-${d} ${h}:${min}:${sec}` }\n}\n\n/**\n * File names and export row numbers change between overlapping statements; the account's timezone may change too.\n * The line is known by what the bank printed: its local time string, not the instant it was read as (ADR-0120).\n */\nexport function bankFingerprint(line: { accountNumber: string; currency: string; bankLocalTime: string; type: string; amount: number; balance: number; bankDescription: string | null; bankKind: string | null }, occurrence = 0): string {\n  return createHash('sha256').update(JSON.stringify([\n    line.accountNumber.replace(/\\D/g, ''), line.currency, line.bankLocalTime,\n    line.type, line.amount.toFixed(2), line.balance.toFixed(2),\n    (line.bankDescription ?? '').normalize('NFKC').trim(), (line.bankKind ?? '').normalize('NFKC').trim(), occurrence\n  ])).digest('hex')\n}\n"]}

package/dist-server/service/bank-statement/index.d.ts

@@ -1,5 +1,6 @@
 import { BankStatement } from './bank-statement';
 import { BankStatementQuery } from './bank-statement-query';
+import { BankImportMutation } from './bank-import-mutation';
 export declare const entities: (typeof BankStatement)[];
-export declare const resolvers: (typeof BankStatementQuery)[];
+export declare const resolvers: (typeof BankStatementQuery | typeof BankImportMutation)[];
 export declare const subscribers: any[];

package/dist-server/service/bank-statement/index.js

@@ -3,7 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.subscribers = exports.resolvers = exports.entities = void 0;
 const bank_statement_1 = require("./bank-statement");
 const bank_statement_query_1 = require("./bank-statement-query");
+const bank_import_mutation_1 = require("./bank-import-mutation");
 exports.entities = [bank_statement_1.BankStatement];
-exports.resolvers = [bank_statement_query_1.BankStatementQuery];
+exports.resolvers = [bank_statement_query_1.BankStatementQuery, bank_import_mutation_1.BankImportMutation];
 exports.subscribers = [];
 //# sourceMappingURL=index.js.map

package/dist-server/service/bank-statement/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/bank-statement/index.ts"],"names":[],"mappings":";;;AAAA,qDAAgD;AAChD,iEAA2D;AAE9C,QAAA,QAAQ,GAAG,CAAC,8BAAa,CAAC,CAAA;AAC1B,QAAA,SAAS,GAAG,CAAC,yCAAkB,CAAC,CAAA;AAChC,QAAA,WAAW,GAAG,EAAE,CAAA","sourcesContent":["import { BankStatement } from './bank-statement'\nimport { BankStatementQuery } from './bank-statement-query'\n\nexport const entities = [BankStatement]\nexport const resolvers = [BankStatementQuery]\nexport const subscribers = []\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/bank-statement/index.ts"],"names":[],"mappings":";;;AAAA,qDAAgD;AAChD,iEAA2D;AAC3D,iEAA2D;AAE9C,QAAA,QAAQ,GAAG,CAAC,8BAAa,CAAC,CAAA;AAC1B,QAAA,SAAS,GAAG,CAAC,yCAAkB,EAAE,yCAAkB,CAAC,CAAA;AACpD,QAAA,WAAW,GAAG,EAAE,CAAA","sourcesContent":["import { BankStatement } from './bank-statement'\nimport { BankStatementQuery } from './bank-statement-query'\nimport { BankImportMutation } from './bank-import-mutation'\n\nexport const entities = [BankStatement]\nexport const resolvers = [BankStatementQuery, BankImportMutation]\nexport const subscribers = []\n"]}

package/dist-server/service/index.d.ts

@@ -17,12 +17,19 @@ export * from './transaction/transaction-service';
 export * from './bank-account/bank-account-service';
 export * from './payment/payment-targets';
 export * from './payment/payment-service';
+export * from './payment/document-targets';
 export * from './financial-statement/financial-statement-line';
 export * from './financial-statement/financial-statement-service';
 export * from './recurring-cash-item/recurring-schedule';
 export * from './recurring-cash-item/recurring-cash-item-service';
+export * from './account/account-match';
+export * from './bank-statement/bank-source';
+export * from './bank-statement/bank-parser';
+export * from './bank-statement/bank-reconcile';
+export * from './bank-statement/bank-import-type';
+export * from './bank-statement/bank-import';
 export declare const entities: (typeof import("./financial-statement/financial-statement-line").FinancialStatementLine | typeof import("./financial-statement/financial-statement").FinancialStatement | typeof import("./accounting-category/accounting-category").AccountingCategory | typeof import("./account/account").Account | typeof import("./bank-account/bank-account").BankAccount | typeof import("./bank-statement/bank-statement").BankStatement | typeof import("./payment/payment").Payment | typeof import("./transaction/transaction").Transaction | typeof import("./accounting-document/accounting-document").AccountingDocument | typeof import("./recurring-cash-item/recurring-cash-item").RecurringCashItem | typeof import("./financial-institution/financial-institution").FinancialInstitution | typeof import("./fiscal-year/fiscal-year").FiscalYear | typeof import("./financial-statement/financial-statement-history").FinancialStatementHistory | typeof import("./transaction/transaction-history").TransactionHistory)[];
 export declare const subscribers: any[];
 export declare const schema: {
-    resolverClasses: (typeof import("./financial-statement/financial-statement-query").FinancialStatementQuery | typeof import("./financial-statement/financial-statement-query").FinancialStatementLineQuery | typeof import("./financial-statement/financial-statement-mutation").FinancialStatementMutation | typeof import("./accounting-category/accounting-category-query").AccountingCategoryQuery | typeof import("./accounting-category/accounting-category-mutation").AccountingCategoryMutation | typeof import("./transaction/transaction-query").TransactionQuery | typeof import("./transaction/transaction-mutation").TransactionMutation | typeof import("./bank-account/bank-account-query").BankAccountQuery | typeof import("./bank-account/bank-account-mutation").BankAccountMutation | typeof import("./bank-statement/bank-statement-query").BankStatementQuery | typeof import("./payment/payment-query").PaymentQuery | typeof import("./payment/payment-mutation").PaymentMutation | typeof import("./account/account-query").AccountQuery | typeof import("./account/account-mutation").AccountMutation | typeof import("./accounting-document/accounting-document-query").AccountingDocumentQuery | typeof import("./accounting-document/accounting-document-mutation").AccountingDocumentMutation | typeof import("./recurring-cash-item/recurring-cash-item-query").RecurringCashItemQuery | typeof import("./recurring-cash-item/recurring-cash-item-mutation").RecurringCashItemMutation | typeof import("./financial-institution/financial-institution-query").FinancialInstitutionQuery | typeof import("./financial-institution/financial-institution-mutation").FinancialInstitutionMutation | typeof import("./fiscal-month/fiscal-month-query").FiscalMonthQuery | typeof import("./fiscal-month/fiscal-month-mutation").FiscalMonthMutation | typeof import("./fiscal-quarter/fiscal-quarter-query").FiscalQuarterQuery | typeof import("./fiscal-quarter/fiscal-quarter-mutation").FiscalQuarterMutation | typeof import("./fiscal-year/fiscal-year-query").FiscalYearQuery | typeof import("./fiscal-year/fiscal-year-mutation").FiscalYearMutation)[];
+    resolverClasses: (typeof import("./financial-statement/financial-statement-query").FinancialStatementQuery | typeof import("./financial-statement/financial-statement-query").FinancialStatementLineQuery | typeof import("./financial-statement/financial-statement-mutation").FinancialStatementMutation | typeof import("./accounting-category/accounting-category-query").AccountingCategoryQuery | typeof import("./accounting-category/accounting-category-mutation").AccountingCategoryMutation | typeof import("./transaction/transaction-query").TransactionQuery | typeof import("./transaction/transaction-mutation").TransactionMutation | typeof import("./bank-account/bank-account-query").BankAccountQuery | typeof import("./bank-account/bank-account-mutation").BankAccountMutation | typeof import("./bank-statement/bank-statement-query").BankStatementQuery | typeof import("./bank-statement/bank-import-mutation").BankImportMutation | typeof import("./payment/payment-query").PaymentQuery | typeof import("./payment/payment-mutation").PaymentMutation | typeof import("./account/account-query").AccountQuery | typeof import("./account/account-mutation").AccountMutation | typeof import("./accounting-document/accounting-document-query").AccountingDocumentQuery | typeof import("./accounting-document/accounting-document-mutation").AccountingDocumentMutation | typeof import("./recurring-cash-item/recurring-cash-item-query").RecurringCashItemQuery | typeof import("./recurring-cash-item/recurring-cash-item-mutation").RecurringCashItemMutation | typeof import("./financial-institution/financial-institution-query").FinancialInstitutionQuery | typeof import("./financial-institution/financial-institution-mutation").FinancialInstitutionMutation | typeof import("./fiscal-month/fiscal-month-query").FiscalMonthQuery | typeof import("./fiscal-month/fiscal-month-mutation").FiscalMonthMutation | typeof import("./fiscal-quarter/fiscal-quarter-query").FiscalQuarterQuery | typeof import("./fiscal-quarter/fiscal-quarter-mutation").FiscalQuarterMutation | typeof import("./fiscal-year/fiscal-year-query").FiscalYearQuery | typeof import("./fiscal-year/fiscal-year-mutation").FiscalYearMutation)[];
 };

package/dist-server/service/index.js

@@ -23,10 +23,17 @@ tslib_1.__exportStar(require("./transaction/transaction-service"), exports);
 tslib_1.__exportStar(require("./bank-account/bank-account-service"), exports);
 tslib_1.__exportStar(require("./payment/payment-targets"), exports);
 tslib_1.__exportStar(require("./payment/payment-service"), exports);
+tslib_1.__exportStar(require("./payment/document-targets"), exports);
 tslib_1.__exportStar(require("./financial-statement/financial-statement-line"), exports);
 tslib_1.__exportStar(require("./financial-statement/financial-statement-service"), exports);
 tslib_1.__exportStar(require("./recurring-cash-item/recurring-schedule"), exports);
 tslib_1.__exportStar(require("./recurring-cash-item/recurring-cash-item-service"), exports);
+tslib_1.__exportStar(require("./account/account-match"), exports);
+tslib_1.__exportStar(require("./bank-statement/bank-source"), exports);
+tslib_1.__exportStar(require("./bank-statement/bank-parser"), exports);
+tslib_1.__exportStar(require("./bank-statement/bank-reconcile"), exports);
+tslib_1.__exportStar(require("./bank-statement/bank-import-type"), exports);
+tslib_1.__exportStar(require("./bank-statement/bank-import"), exports);
 /* IMPORT ENTITIES AND RESOLVERS */
 const financial_statement_1 = require("./financial-statement");
 const accounting_category_1 = require("./accounting-category");

package/dist-server/service/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/service/index.ts"],"names":[],"mappings":";;;;AAAA,yBAAyB;AACzB,2DAAgC;AAChC,oFAAyD;AACzD,oFAAyD;AACzD,oEAAyC;AACzC,sEAA2C;AAC3C,0EAA+C;AAC/C,4DAAiC;AACjC,4DAAiC;AACjC,oFAAyD;AACzD,oFAAyD;AACzD,wFAA6D;AAC7D,sEAA2C;AAC3C,0EAA+C;AAC/C,oEAAyC;AAEzC,qBAAqB;AACrB,2EAAgD;AAChD,4EAAiD;AACjD,8EAAmD;AACnD,oEAAyC;AACzC,oEAAyC;AACzC,yFAA8D;AAC9D,4FAAiE;AACjE,mFAAwD;AACxD,4FAAiE;AAEjE,mCAAmC;AACnC,+DAI8B;AAC9B,+DAI8B;AAC9B,+CAIsB;AACtB,iDAIuB;AACvB,qDAIyB;AACzB,uCAIkB;AAClB,uCAIkB;AAClB,+DAI8B;AAC9B,+DAI8B;AAC9B,mEAIgC;AAChC,iDAIuB;AACvB,qDAIyB;AACzB,+CAIsB;AAET,QAAA,QAAQ,GAAG;IACtB,GAAG,8BAA0B;IAC7B,GAAG,8BAA0B;IAC7B,GAAG,sBAAmB;IACtB,GAAG,uBAAmB;IACtB,GAAG,yBAAqB;IACxB,GAAG,kBAAe;IAClB,GAAG,kBAAe;IAClB,GAAG,8BAA0B;IAC7B,GAAG,8BAAyB;IAC5B,GAAG,gCAA4B;IAC/B,GAAG,uBAAmB;IACtB,GAAG,yBAAqB;IACxB,GAAG,sBAAkB;CACtB,CAAA;AAEY,QAAA,WAAW,GAAG;IACzB,GAAG,iCAA6B;IAChC,GAAG,iCAA6B;IAChC,GAAG,yBAAsB;IACzB,GAAG,0BAAsB;IACzB,GAAG,4BAAwB;IAC3B,GAAG,qBAAkB;IACrB,GAAG,qBAAkB;IACrB,GAAG,iCAA6B;IAChC,GAAG,iCAA4B;IAC/B,GAAG,mCAA+B;IAClC,GAAG,0BAAsB;IACzB,GAAG,4BAAwB;IAC3B,GAAG,yBAAqB;CACzB,CAAA;AAEY,QAAA,MAAM,GAAG;IACpB,eAAe,EAAE;QACf,GAAG,+BAA2B;QAC9B,GAAG,+BAA2B;QAC9B,GAAG,uBAAoB;QACvB,GAAG,wBAAoB;QACvB,GAAG,0BAAsB;QACzB,GAAG,mBAAgB;QACnB,GAAG,mBAAgB;QACnB,GAAG,+BAA2B;QAC9B,GAAG,+BAA0B;QAC7B,GAAG,iCAA6B;QAChC,GAAG,wBAAoB;QACvB,GAAG,0BAAsB;QACzB,GAAG,uBAAmB;KACvB;CACF,CAAA","sourcesContent":["/* EXPORT ENTITY TYPES */\nexport * from './cash-flow-type'\nexport * from './financial-statement/financial-statement'\nexport * from './accounting-category/accounting-category'\nexport * from './transaction/transaction'\nexport * from './bank-account/bank-account'\nexport * from './bank-statement/bank-statement'\nexport * from './payment/payment'\nexport * from './account/account'\nexport * from './accounting-document/accounting-document'\nexport * from './recurring-cash-item/recurring-cash-item'\nexport * from './financial-institution/financial-institution'\nexport * from './fiscal-month/fiscal-month'\nexport * from './fiscal-quarter/fiscal-quarter'\nexport * from './fiscal-year/fiscal-year'\n\n/* EXPORT SERVICES */\nexport * from './transaction/transaction-period'\nexport * from './transaction/transaction-service'\nexport * from './bank-account/bank-account-service'\nexport * from './payment/payment-targets'\nexport * from './payment/payment-service'\nexport * from './financial-statement/financial-statement-line'\nexport * from './financial-statement/financial-statement-service'\nexport * from './recurring-cash-item/recurring-schedule'\nexport * from './recurring-cash-item/recurring-cash-item-service'\n\n/* IMPORT ENTITIES AND RESOLVERS */\nimport {\n  entities as FinancialStatementEntities,\n  resolvers as FinancialStatementResolvers,\n  subscribers as FinancialStatementSubscribers\n} from './financial-statement'\nimport {\n  entities as AccountingCategoryEntities,\n  resolvers as AccountingCategoryResolvers,\n  subscribers as AccountingCategorySubscribers\n} from './accounting-category'\nimport {\n  entities as TransactionEntities,\n  resolvers as TransactionResolvers,\n  subscribers as TransactionSubscribers\n} from './transaction'\nimport {\n  entities as BankAccountEntities,\n  resolvers as BankAccountResolvers,\n  subscribers as BankAccountSubscribers\n} from './bank-account'\nimport {\n  entities as BankStatementEntities,\n  resolvers as BankStatementResolvers,\n  subscribers as BankStatementSubscribers\n} from './bank-statement'\nimport {\n  entities as PaymentEntities,\n  resolvers as PaymentResolvers,\n  subscribers as PaymentSubscribers\n} from './payment'\nimport {\n  entities as AccountEntities,\n  resolvers as AccountResolvers,\n  subscribers as AccountSubscribers\n} from './account'\nimport {\n  entities as AccountingDocumentEntities,\n  resolvers as AccountingDocumentResolvers,\n  subscribers as AccountingDocumentSubscribers\n} from './accounting-document'\nimport {\n  entities as RecurringCashItemEntities,\n  resolvers as RecurringCashItemResolvers,\n  subscribers as RecurringCashItemSubscribers\n} from './recurring-cash-item'\nimport {\n  entities as FinancialInstitutionEntities,\n  resolvers as FinancialInstitutionResolvers,\n  subscribers as FinancialInstitutionSubscribers\n} from './financial-institution'\nimport {\n  entities as FiscalMonthEntities,\n  resolvers as FiscalMonthResolvers,\n  subscribers as FiscalMonthSubscribers\n} from './fiscal-month'\nimport {\n  entities as FiscalQuarterEntities,\n  resolvers as FiscalQuarterResolvers,\n  subscribers as FiscalQuarterSubscribers\n} from './fiscal-quarter'\nimport {\n  entities as FiscalYearEntities,\n  resolvers as FiscalYearResolvers,\n  subscribers as FiscalYearSubscribers\n} from './fiscal-year'\n\nexport const entities = [\n  ...FinancialStatementEntities,\n  ...AccountingCategoryEntities,\n  ...TransactionEntities,\n  ...BankAccountEntities,\n  ...BankStatementEntities,\n  ...PaymentEntities,\n  ...AccountEntities,\n  ...AccountingDocumentEntities,\n  ...RecurringCashItemEntities,\n  ...FinancialInstitutionEntities,\n  ...FiscalMonthEntities,\n  ...FiscalQuarterEntities,\n  ...FiscalYearEntities\n]\n\nexport const subscribers = [\n  ...FinancialStatementSubscribers,\n  ...AccountingCategorySubscribers,\n  ...TransactionSubscribers,\n  ...BankAccountSubscribers,\n  ...BankStatementSubscribers,\n  ...PaymentSubscribers,\n  ...AccountSubscribers,\n  ...AccountingDocumentSubscribers,\n  ...RecurringCashItemSubscribers,\n  ...FinancialInstitutionSubscribers,\n  ...FiscalMonthSubscribers,\n  ...FiscalQuarterSubscribers,\n  ...FiscalYearSubscribers\n]\n\nexport const schema = {\n  resolverClasses: [\n    ...FinancialStatementResolvers,\n    ...AccountingCategoryResolvers,\n    ...TransactionResolvers,\n    ...BankAccountResolvers,\n    ...BankStatementResolvers,\n    ...PaymentResolvers,\n    ...AccountResolvers,\n    ...AccountingDocumentResolvers,\n    ...RecurringCashItemResolvers,\n    ...FinancialInstitutionResolvers,\n    ...FiscalMonthResolvers,\n    ...FiscalQuarterResolvers,\n    ...FiscalYearResolvers\n  ]\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/service/index.ts"],"names":[],"mappings":";;;;AAAA,yBAAyB;AACzB,2DAAgC;AAChC,oFAAyD;AACzD,oFAAyD;AACzD,oEAAyC;AACzC,sEAA2C;AAC3C,0EAA+C;AAC/C,4DAAiC;AACjC,4DAAiC;AACjC,oFAAyD;AACzD,oFAAyD;AACzD,wFAA6D;AAC7D,sEAA2C;AAC3C,0EAA+C;AAC/C,oEAAyC;AAEzC,qBAAqB;AACrB,2EAAgD;AAChD,4EAAiD;AACjD,8EAAmD;AACnD,oEAAyC;AACzC,oEAAyC;AACzC,qEAA0C;AAC1C,yFAA8D;AAC9D,4FAAiE;AACjE,mFAAwD;AACxD,4FAAiE;AACjE,kEAAuC;AACvC,uEAA4C;AAC5C,uEAA4C;AAC5C,0EAA+C;AAC/C,4EAAiD;AACjD,uEAA4C;AAE5C,mCAAmC;AACnC,+DAI8B;AAC9B,+DAI8B;AAC9B,+CAIsB;AACtB,iDAIuB;AACvB,qDAIyB;AACzB,uCAIkB;AAClB,uCAIkB;AAClB,+DAI8B;AAC9B,+DAI8B;AAC9B,mEAIgC;AAChC,iDAIuB;AACvB,qDAIyB;AACzB,+CAIsB;AAET,QAAA,QAAQ,GAAG;IACtB,GAAG,8BAA0B;IAC7B,GAAG,8BAA0B;IAC7B,GAAG,sBAAmB;IACtB,GAAG,uBAAmB;IACtB,GAAG,yBAAqB;IACxB,GAAG,kBAAe;IAClB,GAAG,kBAAe;IAClB,GAAG,8BAA0B;IAC7B,GAAG,8BAAyB;IAC5B,GAAG,gCAA4B;IAC/B,GAAG,uBAAmB;IACtB,GAAG,yBAAqB;IACxB,GAAG,sBAAkB;CACtB,CAAA;AAEY,QAAA,WAAW,GAAG;IACzB,GAAG,iCAA6B;IAChC,GAAG,iCAA6B;IAChC,GAAG,yBAAsB;IACzB,GAAG,0BAAsB;IACzB,GAAG,4BAAwB;IAC3B,GAAG,qBAAkB;IACrB,GAAG,qBAAkB;IACrB,GAAG,iCAA6B;IAChC,GAAG,iCAA4B;IAC/B,GAAG,mCAA+B;IAClC,GAAG,0BAAsB;IACzB,GAAG,4BAAwB;IAC3B,GAAG,yBAAqB;CACzB,CAAA;AAEY,QAAA,MAAM,GAAG;IACpB,eAAe,EAAE;QACf,GAAG,+BAA2B;QAC9B,GAAG,+BAA2B;QAC9B,GAAG,uBAAoB;QACvB,GAAG,wBAAoB;QACvB,GAAG,0BAAsB;QACzB,GAAG,mBAAgB;QACnB,GAAG,mBAAgB;QACnB,GAAG,+BAA2B;QAC9B,GAAG,+BAA0B;QAC7B,GAAG,iCAA6B;QAChC,GAAG,wBAAoB;QACvB,GAAG,0BAAsB;QACzB,GAAG,uBAAmB;KACvB;CACF,CAAA","sourcesContent":["/* EXPORT ENTITY TYPES */\nexport * from './cash-flow-type'\nexport * from './financial-statement/financial-statement'\nexport * from './accounting-category/accounting-category'\nexport * from './transaction/transaction'\nexport * from './bank-account/bank-account'\nexport * from './bank-statement/bank-statement'\nexport * from './payment/payment'\nexport * from './account/account'\nexport * from './accounting-document/accounting-document'\nexport * from './recurring-cash-item/recurring-cash-item'\nexport * from './financial-institution/financial-institution'\nexport * from './fiscal-month/fiscal-month'\nexport * from './fiscal-quarter/fiscal-quarter'\nexport * from './fiscal-year/fiscal-year'\n\n/* EXPORT SERVICES */\nexport * from './transaction/transaction-period'\nexport * from './transaction/transaction-service'\nexport * from './bank-account/bank-account-service'\nexport * from './payment/payment-targets'\nexport * from './payment/payment-service'\nexport * from './payment/document-targets'\nexport * from './financial-statement/financial-statement-line'\nexport * from './financial-statement/financial-statement-service'\nexport * from './recurring-cash-item/recurring-schedule'\nexport * from './recurring-cash-item/recurring-cash-item-service'\nexport * from './account/account-match'\nexport * from './bank-statement/bank-source'\nexport * from './bank-statement/bank-parser'\nexport * from './bank-statement/bank-reconcile'\nexport * from './bank-statement/bank-import-type'\nexport * from './bank-statement/bank-import'\n\n/* IMPORT ENTITIES AND RESOLVERS */\nimport {\n  entities as FinancialStatementEntities,\n  resolvers as FinancialStatementResolvers,\n  subscribers as FinancialStatementSubscribers\n} from './financial-statement'\nimport {\n  entities as AccountingCategoryEntities,\n  resolvers as AccountingCategoryResolvers,\n  subscribers as AccountingCategorySubscribers\n} from './accounting-category'\nimport {\n  entities as TransactionEntities,\n  resolvers as TransactionResolvers,\n  subscribers as TransactionSubscribers\n} from './transaction'\nimport {\n  entities as BankAccountEntities,\n  resolvers as BankAccountResolvers,\n  subscribers as BankAccountSubscribers\n} from './bank-account'\nimport {\n  entities as BankStatementEntities,\n  resolvers as BankStatementResolvers,\n  subscribers as BankStatementSubscribers\n} from './bank-statement'\nimport {\n  entities as PaymentEntities,\n  resolvers as PaymentResolvers,\n  subscribers as PaymentSubscribers\n} from './payment'\nimport {\n  entities as AccountEntities,\n  resolvers as AccountResolvers,\n  subscribers as AccountSubscribers\n} from './account'\nimport {\n  entities as AccountingDocumentEntities,\n  resolvers as AccountingDocumentResolvers,\n  subscribers as AccountingDocumentSubscribers\n} from './accounting-document'\nimport {\n  entities as RecurringCashItemEntities,\n  resolvers as RecurringCashItemResolvers,\n  subscribers as RecurringCashItemSubscribers\n} from './recurring-cash-item'\nimport {\n  entities as FinancialInstitutionEntities,\n  resolvers as FinancialInstitutionResolvers,\n  subscribers as FinancialInstitutionSubscribers\n} from './financial-institution'\nimport {\n  entities as FiscalMonthEntities,\n  resolvers as FiscalMonthResolvers,\n  subscribers as FiscalMonthSubscribers\n} from './fiscal-month'\nimport {\n  entities as FiscalQuarterEntities,\n  resolvers as FiscalQuarterResolvers,\n  subscribers as FiscalQuarterSubscribers\n} from './fiscal-quarter'\nimport {\n  entities as FiscalYearEntities,\n  resolvers as FiscalYearResolvers,\n  subscribers as FiscalYearSubscribers\n} from './fiscal-year'\n\nexport const entities = [\n  ...FinancialStatementEntities,\n  ...AccountingCategoryEntities,\n  ...TransactionEntities,\n  ...BankAccountEntities,\n  ...BankStatementEntities,\n  ...PaymentEntities,\n  ...AccountEntities,\n  ...AccountingDocumentEntities,\n  ...RecurringCashItemEntities,\n  ...FinancialInstitutionEntities,\n  ...FiscalMonthEntities,\n  ...FiscalQuarterEntities,\n  ...FiscalYearEntities\n]\n\nexport const subscribers = [\n  ...FinancialStatementSubscribers,\n  ...AccountingCategorySubscribers,\n  ...TransactionSubscribers,\n  ...BankAccountSubscribers,\n  ...BankStatementSubscribers,\n  ...PaymentSubscribers,\n  ...AccountSubscribers,\n  ...AccountingDocumentSubscribers,\n  ...RecurringCashItemSubscribers,\n  ...FinancialInstitutionSubscribers,\n  ...FiscalMonthSubscribers,\n  ...FiscalQuarterSubscribers,\n  ...FiscalYearSubscribers\n]\n\nexport const schema = {\n  resolverClasses: [\n    ...FinancialStatementResolvers,\n    ...AccountingCategoryResolvers,\n    ...TransactionResolvers,\n    ...BankAccountResolvers,\n    ...BankStatementResolvers,\n    ...PaymentResolvers,\n    ...AccountResolvers,\n    ...AccountingDocumentResolvers,\n    ...RecurringCashItemResolvers,\n    ...FinancialInstitutionResolvers,\n    ...FiscalMonthResolvers,\n    ...FiscalQuarterResolvers,\n    ...FiscalYearResolvers\n  ]\n}\n"]}

package/dist-server/service/payment/document-targets.d.ts

@@ -0,0 +1,16 @@
+import { EntityManager } from 'typeorm';
+import { Payment } from './payment';
+export declare const INVOICE_TARGET = "Invoice";
+export declare const TAX_INVOICE_TARGET = "TaxInvoice";
+/** What a payment pays of its document, in the document's currency. */
+export declare const paidOfDocument: (payment: Payment) => number;
+/** The payments on some documents of a kind, or of some bank lines, with their line. */
+export declare function documentPaymentsOf(tx: EntityManager, domain: {
+    id: string;
+}, targetType: string, of: {
+    documentIds?: string[];
+    transactionIds?: string[];
+}, options?: {
+    withDeleted?: boolean;
+    relations?: string[];
+}): Promise<Payment[]>;

package/dist-server/service/payment/document-targets.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paidOfDocument = exports.TAX_INVOICE_TARGET = exports.INVOICE_TARGET = void 0;
+exports.documentPaymentsOf = documentPaymentsOf;
+const typeorm_1 = require("typeorm");
+const invoice_1 = require("@things-factory/invoice");
+const shell_1 = require("@things-factory/shell");
+const tax_invoice_1 = require("@things-factory/tax-invoice");
+const transaction_1 = require("../transaction/transaction");
+const payment_1 = require("./payment");
+const payment_targets_1 = require("./payment-targets");
+/*
+ * The bank lines that paid a commercial invoice or a tax invoice (ADR-0122). Both documents evidence the money - a
+ * contract round may settle it too - so they are EVIDENCE, each kind on its own: a local-L/C export's zero-rated tax
+ * invoice and its commercial invoice each evidence the whole deposit. The rules are the same in every application,
+ * so accounting registers both kinds; the document modules do not know accounting.
+ */
+exports.INVOICE_TARGET = 'Invoice';
+exports.TAX_INVOICE_TARGET = 'TaxInvoice';
+/** What a payment pays of its document, in the document's currency. */
+const paidOfDocument = (payment) => Number(payment.targetAmount ?? payment.amount);
+exports.paidOfDocument = paidOfDocument;
+/** The payments on some documents of a kind, or of some bank lines, with their line. */
+async function documentPaymentsOf(tx, domain, targetType, of, options = {}) {
+    return tx.getRepository(payment_1.Payment).find({
+        where: {
+            domain: { id: domain.id },
+            targetType,
+            ...(of.documentIds ? { targetId: (0, typeorm_1.In)(of.documentIds) } : {}),
+            ...(of.transactionIds ? { transaction: { id: (0, typeorm_1.In)(of.transactionIds) } } : {})
+        },
+        withDeleted: options.withDeleted,
+        relations: ['transaction', ...(options.relations ?? [])]
+    });
+}
+const fits = (amount, currency) => {
+    const scale = 10 ** (0, invoice_1.currencyDigits)(currency);
+    return Math.abs(amount * scale - Math.round(amount * scale)) <= 0.00001;
+};
+/**
+ * A document is paid by bank lines on its side - money in for a sale, out for a purchase, the other way for a
+ * negative one - and by no more than its total, in its own currency. A line in another currency says what it paid of
+ * the document (targetAmount) and on what basis (notes); a line in the same currency says nothing more.
+ */
+async function checkDocuments(tx, domain, targetType, documents, codes) {
+    const payments = await documentPaymentsOf(tx, domain, targetType, { documentIds: documents.map(one => one.id) });
+    for (const document of documents) {
+        const ofDocument = payments.filter(one => one.targetId === document.id);
+        const incoming = document.sale === document.total >= 0;
+        for (const one of ofDocument) {
+            const line = one.transaction;
+            if (line.category !== transaction_1.TransactionCategory.CONFIRMED || line.type !== (incoming ? 'INCOME' : 'EXPENSE'))
+                throw new shell_1.Refusal(codes.side, {}, 'choose a deposit for a sale, a withdrawal for a purchase; the other way for a negative document');
+            const lineCurrency = line.currency ?? 'KRW';
+            if (lineCurrency === document.currency) {
+                if (one.targetAmount !== null && one.targetAmount !== undefined)
+                    throw new shell_1.Refusal('document-payment-same-currency', {}, 'a line in the document currency says its amount once');
+            }
+            else {
+                if (one.targetAmount === null || one.targetAmount === undefined)
+                    throw new shell_1.Refusal('document-payment-amount-required', { currency: document.currency }, 'record what the line paid in the document currency');
+                if (!one.notes?.trim())
+                    throw new shell_1.Refusal('document-payment-basis-required', {}, 'record the exchange rate or settlement basis in notes');
+            }
+            if (!fits(Number(one.amount), lineCurrency) || !fits((0, exports.paidOfDocument)(one), document.currency))
+                throw new shell_1.Refusal('document-payment-precision', {}, 'an amount has more decimals than its currency');
+        }
+        if (ofDocument.reduce((sum, one) => sum + (0, exports.paidOfDocument)(one), 0) > Math.abs(document.total) + 0.00001)
+            throw new shell_1.Refusal(codes.over, {}, 'the payments are more than the document');
+    }
+}
+(0, payment_targets_1.registerPaymentTarget)(exports.INVOICE_TARGET, {
+    purpose: payment_1.PaymentPurpose.EVIDENCE,
+    async label(tx, domain, ids) {
+        const invoices = await tx.getRepository(invoice_1.Invoice).find({ where: { domain: { id: domain.id }, id: (0, typeorm_1.In)(ids) } });
+        return new Map(invoices.map(one => [one.id, [one.number, one.direction === 'SALES' ? one.buyerName : one.supplierName].filter(Boolean).join(' ')]));
+    },
+    async validate(tx, domain, { targetIds }) {
+        const invoices = await tx.getRepository(invoice_1.Invoice).find({ where: { domain: { id: domain.id }, id: (0, typeorm_1.In)(targetIds) } });
+        if (invoices.length !== new Set(targetIds).size)
+            throw new shell_1.Refusal('invoice-not-found', {}, 'the invoice was not found - reload and try again');
+        await checkDocuments(tx, domain, exports.INVOICE_TARGET, invoices.map(one => ({ id: one.id, currency: one.currency, total: Number(one.totalAmount), sale: one.direction === 'SALES' })), { side: 'invoice-payment-side', over: 'invoice-payment-over' });
+    }
+});
+(0, payment_targets_1.registerPaymentTarget)(exports.TAX_INVOICE_TARGET, {
+    purpose: payment_1.PaymentPurpose.EVIDENCE,
+    async label(tx, domain, ids) {
+        const invoices = await tx.getRepository(tax_invoice_1.TaxInvoice).find({ where: { domain: { id: domain.id }, id: (0, typeorm_1.In)(ids) } });
+        return new Map(invoices.map(one => [one.id, [one.issueDate, one.category === tax_invoice_1.Category.EXPORT ? one.buyerBusinessName : one.supplierBusinessName, one.approvalNo].filter(Boolean).join(' ')]));
+    },
+    /* A tax invoice is in won. */
+    async validate(tx, domain, { targetIds }) {
+        const invoices = await tx.getRepository(tax_invoice_1.TaxInvoice).find({ where: { domain: { id: domain.id }, id: (0, typeorm_1.In)(targetIds) } });
+        if (invoices.length !== new Set(targetIds).size)
+            throw new shell_1.Refusal('tax-invoice-not-found', {}, 'the tax invoice was not found - reload and try again');
+        await checkDocuments(tx, domain, exports.TAX_INVOICE_TARGET, invoices.map(one => ({ id: one.id, currency: 'KRW', total: Number(one.totalAmount), sale: one.category === tax_invoice_1.Category.EXPORT })), { side: 'tax-invoice-payment-side', over: 'tax-invoice-payment-over' });
+    }
+});
+//# sourceMappingURL=document-targets.js.map