@things-factory/accounting 10.1.139 → 10.1.140

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":"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","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 BankImportMutation | typeof BankStatementQuery)[];
 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/financial-institution/index.d.ts

@@ -2,5 +2,5 @@ import { FinancialInstitution } from './financial-institution';
 import { FinancialInstitutionQuery } from './financial-institution-query';
 import { FinancialInstitutionMutation } from './financial-institution-mutation';
 export declare const entities: (typeof FinancialInstitution)[];
-export declare const resolvers: (typeof FinancialInstitutionQuery | typeof FinancialInstitutionMutation)[];
+export declare const resolvers: (typeof FinancialInstitutionMutation | typeof FinancialInstitutionQuery)[];
 export declare const subscribers: any[];

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

@@ -4,6 +4,6 @@ import { FinancialStatementHistory } from './financial-statement-history';
 import { FinancialStatementLineQuery, FinancialStatementQuery } from './financial-statement-query';
 import { FinancialStatementMutation } from './financial-statement-mutation';
 import { FinancialStatementHistoryEntitySubscriber } from './event-subscriber';
-export declare const entities: (typeof FinancialStatementLine | typeof FinancialStatement | typeof FinancialStatementHistory)[];
-export declare const resolvers: (typeof FinancialStatementQuery | typeof FinancialStatementLineQuery | typeof FinancialStatementMutation)[];
+export declare const entities: (typeof FinancialStatement | typeof FinancialStatementHistory | typeof FinancialStatementLine)[];
+export declare const resolvers: (typeof FinancialStatementMutation | typeof FinancialStatementQuery | typeof FinancialStatementLineQuery)[];
 export declare const subscribers: (typeof FinancialStatementHistoryEntitySubscriber)[];

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

@@ -2,5 +2,5 @@ import { FiscalMonth } from './fiscal-month';
 import { FiscalMonthQuery } from './fiscal-month-query';
 import { FiscalMonthMutation } from './fiscal-month-mutation';
 export declare const entities: (typeof FiscalMonth)[];
-export declare const resolvers: (typeof FiscalMonthQuery | typeof FiscalMonthMutation)[];
+export declare const resolvers: (typeof FiscalMonthMutation | typeof FiscalMonthQuery)[];
 export declare const subscribers: any[];

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

@@ -2,5 +2,5 @@ import { FiscalQuarter } from './fiscal-quarter';
 import { FiscalQuarterQuery } from './fiscal-quarter-query';
 import { FiscalQuarterMutation } from './fiscal-quarter-mutation';
 export declare const entities: (typeof FiscalQuarter)[];
-export declare const resolvers: (typeof FiscalQuarterQuery | typeof FiscalQuarterMutation)[];
+export declare const resolvers: (typeof FiscalQuarterMutation | typeof FiscalQuarterQuery)[];
 export declare const subscribers: any[];

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

@@ -2,5 +2,5 @@ import { FiscalYear } from './fiscal-year';
 import { FiscalYearQuery } from './fiscal-year-query';
 import { FiscalYearMutation } from './fiscal-year-mutation';
 export declare const entities: (typeof FiscalYear)[];
-export declare const resolvers: (typeof FiscalYearQuery | typeof FiscalYearMutation)[];
+export declare const resolvers: (typeof FiscalYearMutation | typeof FiscalYearQuery)[];
 export declare const subscribers: any[];

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

@@ -21,8 +21,13 @@ 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 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 * 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("./fiscal-year/fiscal-year").FiscalYear | typeof import("./accounting-category/accounting-category").AccountingCategory | typeof import("./account/account").Account | typeof import("./financial-institution/financial-institution").FinancialInstitution | typeof import("./transaction/transaction").Transaction | typeof import("./accounting-document/accounting-document").AccountingDocument | typeof import("./bank-account/bank-account").BankAccount | typeof import("./bank-statement/bank-statement").BankStatement | typeof import("./financial-statement/financial-statement").FinancialStatement | typeof import("./financial-statement/financial-statement-history").FinancialStatementHistory | typeof import("./financial-statement/financial-statement-line").FinancialStatementLine | typeof import("./transaction/transaction-history").TransactionHistory | typeof import("./payment/payment").Payment | typeof import("./recurring-cash-item/recurring-cash-item").RecurringCashItem)[];
 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("./account/account-mutation").AccountMutation | typeof import("./account/account-query").AccountQuery | typeof import("./accounting-category/accounting-category-mutation").AccountingCategoryMutation | typeof import("./accounting-category/accounting-category-query").AccountingCategoryQuery | typeof import("./accounting-document/accounting-document-mutation").AccountingDocumentMutation | typeof import("./accounting-document/accounting-document-query").AccountingDocumentQuery | typeof import("./bank-account/bank-account-mutation").BankAccountMutation | typeof import("./bank-account/bank-account-query").BankAccountQuery | typeof import("./bank-statement/bank-import-mutation").BankImportMutation | typeof import("./bank-statement/bank-statement-query").BankStatementQuery | typeof import("./financial-institution/financial-institution-mutation").FinancialInstitutionMutation | typeof import("./financial-institution/financial-institution-query").FinancialInstitutionQuery | typeof import("./financial-statement/financial-statement-mutation").FinancialStatementMutation | typeof import("./financial-statement/financial-statement-query").FinancialStatementQuery | typeof import("./financial-statement/financial-statement-query").FinancialStatementLineQuery | typeof import("./fiscal-month/fiscal-month-mutation").FiscalMonthMutation | typeof import("./fiscal-month/fiscal-month-query").FiscalMonthQuery | typeof import("./fiscal-quarter/fiscal-quarter-mutation").FiscalQuarterMutation | typeof import("./fiscal-quarter/fiscal-quarter-query").FiscalQuarterQuery | typeof import("./fiscal-year/fiscal-year-mutation").FiscalYearMutation | typeof import("./fiscal-year/fiscal-year-query").FiscalYearQuery | typeof import("./transaction/transaction-query").TransactionQuery | typeof import("./transaction/transaction-mutation").TransactionMutation | typeof import("./payment/payment-query").PaymentQuery | typeof import("./payment/payment-mutation").PaymentMutation | typeof import("./recurring-cash-item/recurring-cash-item-query").RecurringCashItemQuery | typeof import("./recurring-cash-item/recurring-cash-item-mutation").RecurringCashItemMutation)[];
 };

package/dist-server/service/index.js

@@ -27,6 +27,11 @@ tslib_1.__exportStar(require("./financial-statement/financial-statement-line"),
 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("./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,yFAA8D;AAC9D,4FAAiE;AACjE,mFAAwD;AACxD,4FAAiE;AACjE,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 './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 './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/transaction/transaction-service.d.ts

@@ -20,10 +20,15 @@ export type TransactionInput = Partial<Omit<Transaction, 'bankAccount' | 'accoun
         id: string;
     } | null;
 };
+/** A line that came from a bank statement keeps the statement's facts (§`BANK_FACTS`). */
+export declare function protectBankFacts(current: Partial<Transaction> & {
+    bankAccountId?: string;
+}, patch: Record<string, any>): void;
 /**
  * Apply rows to a domain's transactions: `+` (or no id) adds, `M` changes, `-` deletes (softly - a financial row
  * that was deleted stays readable). A transaction that pays something, or is paid, is unlinked before it is
  * deleted; when its money changes, its payments are checked again - the general rule and each target kind's own.
+ * A line from a bank statement keeps the statement's facts (§`protectBankFacts`).
  */
 export declare function saveTransactions(tx: EntityManager, domain: {
     id: string;

package/dist-server/service/transaction/transaction-service.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.protectBankFacts = protectBankFacts;
 exports.saveTransactions = saveTransactions;
 const typeorm_1 = require("typeorm");
 const shell_1 = require("@things-factory/shell");
@@ -10,6 +11,24 @@ const payment_service_1 = require("../payment/payment-service");
 const payment_targets_1 = require("../payment/payment-targets");
 const transaction_1 = require("./transaction");
 const transaction_period_1 = require("./transaction-period");
+/** What a bank statement says of a line - changed only by a statement; what a person writes beside them stays open. */
+const BANK_FACTS = ['transactionDate', 'type', 'amount', 'balance', 'currency', 'bankAccount'];
+/** A line that came from a bank statement keeps the statement's facts (§`BANK_FACTS`). */
+function protectBankFacts(current, patch) {
+    if (current.source !== transaction_1.TransactionSource.BANK_STATEMENT)
+        return;
+    for (const field of BANK_FACTS) {
+        if (!(field in patch))
+            continue;
+        const before = field === 'bankAccount' ? current.bankAccountId ?? current.bankAccount?.id : current[field];
+        const after = field === 'bankAccount' ? patch.bankAccount?.id : patch[field];
+        const equal = ['amount', 'balance'].includes(field)
+            ? (before == null && after == null) || (before != null && after != null && Number(before) === Number(after))
+            : before === after;
+        if (!equal)
+            throw new shell_1.Refusal('bank-facts-locked', {}, 'Bank facts can only be updated from a statement; annotations remain editable');
+    }
+}
 /** What its payments depend on - they are checked again, and their owners follow, when one of these changes. */
 const FACTS = ['amount', 'type', 'currency', 'transactionDate'];
 /**
@@ -73,6 +92,7 @@ async function paymentsOn(tx, domain, ids) {
  * Apply rows to a domain's transactions: `+` (or no id) adds, `M` changes, `-` deletes (softly - a financial row
  * that was deleted stays readable). A transaction that pays something, or is paid, is unlinked before it is
  * deleted; when its money changes, its payments are checked again - the general rule and each target kind's own.
+ * A line from a bank statement keeps the statement's facts (§`protectBankFacts`).
  */
 async function saveTransactions(tx, domain, user, inputs) {
     const repo = tx.getRepository(transaction_1.Transaction);
@@ -92,6 +112,8 @@ async function saveTransactions(tx, domain, user, inputs) {
         const current = isNew ? undefined : await repo.findOne({ where: { domain: { id: domain.id }, id: input.id } });
         if (!isNew && !current)
             throw new shell_1.Refusal('transaction-not-found', {}, 'a transaction was not found - reload and try again');
+        if (current)
+            protectBankFacts(current, input);
         const row = rowOf(input, current);
         if (row.bankAccount?.id && !('currency' in input)) {
             const account = await tx

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

@@ -1 +1 @@
-{"version":3,"file":"transaction-service.js","sourceRoot":"","sources":["../../../server/service/transaction/transaction-service.ts"],"names":[],"mappings":"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","sourcesContent":["import { EntityManager, In } from 'typeorm'\n\nimport { Refusal } from '@things-factory/shell'\n\nimport { BankAccount } from '../bank-account/bank-account'\nimport { CashFlowType } from '../cash-flow-type'\nimport { Payment } from '../payment/payment'\nimport { checkPaymentsWithin } from '../payment/payment-service'\nimport { paymentTargetOf } from '../payment/payment-targets'\nimport { ForecastStatus, Transaction, TransactionCategory } from './transaction'\nimport { forecastDay, yearMonthOf } from './transaction-period'\n\n/** A transaction as a module writes it: what a person may write, and the facts a bank statement gives. */\nexport type TransactionInput = Partial<\n  Omit<Transaction, 'bankAccount' | 'account' | 'counterparty' | 'recurringItem' | 'bankStatement'>\n> & {\n  id?: string\n  cuFlag?: string\n  bankAccount?: { id: string } | null\n  account?: { id: string } | null\n  counterparty?: { id: string } | null\n  recurringItem?: { id: string } | null\n  bankStatement?: { id: string } | null\n}\n\n/** What its payments depend on - they are checked again, and their owners follow, when one of these changes. */\nconst FACTS = ['amount', 'type', 'currency', 'transactionDate'] as const\n\n/**\n * The row a patch writes over the current one: a confirmed transaction has a day and takes its year and month from it;\n * a forecast has a year and a month, and the day its timing names.\n */\nfunction rowOf(input: TransactionInput, current: Transaction | undefined): Record<string, any> {\n  const { id, cuFlag, ...fields } = input\n  const row: Record<string, any> = { ...fields }\n  const merged = { ...current, ...row }\n  const category = merged.category ?? TransactionCategory.CONFIRMED\n  row.category = category\n\n  if (!current && !row.type) throw new Refusal('transaction-type-required', {}, 'type: money in or money out')\n  if (row.type !== undefined && !Object.values(CashFlowType).includes(row.type))\n    throw new Refusal('transaction-type-required', {}, 'type: money in or money out')\n  if (!current && (row.amount === undefined || row.amount === null)) row.amount = 0\n\n  if (category === TransactionCategory.CONFIRMED) {\n    const period = yearMonthOf(merged.transactionDate)\n    if (!period)\n      throw new Refusal(\n        'transaction-date-required',\n        { value: merged.transactionDate ?? '' },\n        'transactionDate: YYYY-MM-DD'\n      )\n    Object.assign(row, period, { status: null })\n  } else {\n    const [year, month] = [Number(merged.year), Number(merged.month)]\n    if (!year) throw new Refusal('forecast-year-required', {}, 'year: the year it is planned in')\n    if (!(month >= 1 && month <= 12))\n      throw new Refusal('month-out-of-range', { month: merged.month ?? '' }, 'month: must be 1 to 12')\n    if (!String(merged.description ?? '').trim())\n      throw new Refusal('forecast-description-required', {}, 'description: what is planned')\n    Object.assign(row, { year, month, transactionDate: forecastDay(year, month, merged.timing) })\n    if (!merged.status) row.status = ForecastStatus.PLANNED\n  }\n\n  if (\n    merged.probability !== undefined &&\n    merged.probability !== null &&\n    !(merged.probability >= 0 && merged.probability <= 100)\n  ) {\n    throw new Refusal('probability-out-of-range', {}, 'probability: must be 0 to 100')\n  }\n\n  return row\n}\n\n/** The payments on these transactions, and the transfers into them, by target kind. */\nasync function paymentsOn(tx: EntityManager, domain: { id: string }, ids: string[]): Promise<Payment[]> {\n  if (!ids.length) return []\n  const repo = tx.getRepository(Payment)\n  return [\n    ...(await repo.find({\n      where: { domain: { id: domain.id }, transaction: { id: In(ids) } },\n      relations: ['transaction']\n    })),\n    ...(await repo.find({\n      where: { domain: { id: domain.id }, targetType: 'Transaction', targetId: In(ids) },\n      relations: ['transaction']\n    }))\n  ]\n}\n\n/**\n * Apply rows to a domain's transactions: `+` (or no id) adds, `M` changes, `-` deletes (softly - a financial row\n * that was deleted stays readable). A transaction that pays something, or is paid, is unlinked before it is\n * deleted; when its money changes, its payments are checked again - the general rule and each target kind's own.\n */\nexport async function saveTransactions(\n  tx: EntityManager,\n  domain: { id: string },\n  user: any,\n  inputs: TransactionInput[]\n): Promise<Transaction[]> {\n  const repo = tx.getRepository(Transaction)\n\n  const deletes = [...new Set(inputs.filter(one => one.cuFlag === '-' && one.id).map(one => one.id!))]\n  if (deletes.length) {\n    const found = await repo.find({ where: { domain: { id: domain.id }, id: In(deletes) } })\n    if (found.length !== deletes.length)\n      throw new Refusal('transaction-not-found', {}, 'a transaction was not found - reload and try again')\n    if ((await paymentsOn(tx, domain, deletes)).length)\n      throw new Refusal('transaction-has-payments', {}, 'unlink what the transaction paid before deleting it')\n    await repo.softRemove(found)\n  }\n\n  const saved: Transaction[] = []\n  const factsChanged: string[] = []\n  for (const input of inputs.filter(one => one.cuFlag !== '-')) {\n    const isNew = !input.id || input.cuFlag === '+'\n    const current = isNew ? undefined : await repo.findOne({ where: { domain: { id: domain.id }, id: input.id } })\n    if (!isNew && !current)\n      throw new Refusal('transaction-not-found', {}, 'a transaction was not found - reload and try again')\n\n    const row = rowOf(input, current)\n    if (row.bankAccount?.id && !('currency' in input)) {\n      const account = await tx\n        .getRepository(BankAccount)\n        .findOne({ where: { domain: { id: domain.id }, id: row.bankAccount.id } })\n      if (!account)\n        throw new Refusal('bank-account-not-found', {}, 'the bank account was not found - reload and try again')\n      if (account.currency) row.currency = account.currency\n    }\n\n    if (row.bankFingerprint) {\n      const twin = await repo.findOne({ where: { domain: { id: domain.id }, bankFingerprint: row.bankFingerprint } })\n      if (twin && twin.id !== current?.id)\n        throw new Refusal(\n          'bank-line-twice',\n          { day: twin.transactionDate ?? '' },\n          'this bank line is already in the books'\n        )\n    }\n\n    const written = await repo.save({ ...(current ?? { domain, creator: user }), ...row, updater: user } as Transaction)\n    if (current && FACTS.some(field => field in row && row[field] !== (current as any)[field]))\n      factsChanged.push(current.id)\n    saved.push(written)\n  }\n\n  if (factsChanged.length) {\n    const payments = await paymentsOn(tx, domain, factsChanged)\n    await checkPaymentsWithin(\n      tx,\n      domain,\n      payments.map(one => one.transaction.id)\n    )\n    const kinds = new Map<string, Payment[]>()\n    for (const payment of payments) kinds.set(payment.targetType, [...(kinds.get(payment.targetType) ?? []), payment])\n    const touchedOf = (ofKind: Payment[]) => ({\n      targetIds: [...new Set(ofKind.map(one => one.targetId))],\n      transactionIds: [...new Set(ofKind.map(one => one.transaction.id))]\n    })\n    for (const [targetType, ofKind] of kinds)\n      await paymentTargetOf(targetType)?.validate?.(tx, domain, touchedOf(ofKind))\n    for (const [targetType, ofKind] of kinds)\n      await paymentTargetOf(targetType)?.onSaved?.(tx, domain, touchedOf(ofKind))\n  }\n\n  return saved\n}\n"]}
+{"version":3,"file":"transaction-service.js","sourceRoot":"","sources":["../../../server/service/transaction/transaction-service.ts"],"names":[],"mappings":"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","sourcesContent":["import { EntityManager, In } from 'typeorm'\n\nimport { Refusal } from '@things-factory/shell'\n\nimport { BankAccount } from '../bank-account/bank-account'\nimport { CashFlowType } from '../cash-flow-type'\nimport { Payment } from '../payment/payment'\nimport { checkPaymentsWithin } from '../payment/payment-service'\nimport { paymentTargetOf } from '../payment/payment-targets'\nimport { ForecastStatus, Transaction, TransactionCategory, TransactionSource } from './transaction'\nimport { forecastDay, yearMonthOf } from './transaction-period'\n\n/** A transaction as a module writes it: what a person may write, and the facts a bank statement gives. */\nexport type TransactionInput = Partial<\n  Omit<Transaction, 'bankAccount' | 'account' | 'counterparty' | 'recurringItem' | 'bankStatement'>\n> & {\n  id?: string\n  cuFlag?: string\n  bankAccount?: { id: string } | null\n  account?: { id: string } | null\n  counterparty?: { id: string } | null\n  recurringItem?: { id: string } | null\n  bankStatement?: { id: string } | null\n}\n\n/** What a bank statement says of a line - changed only by a statement; what a person writes beside them stays open. */\nconst BANK_FACTS = ['transactionDate', 'type', 'amount', 'balance', 'currency', 'bankAccount'] as const\n\n/** A line that came from a bank statement keeps the statement's facts (§`BANK_FACTS`). */\nexport function protectBankFacts(current: Partial<Transaction> & { bankAccountId?: string }, patch: Record<string, any>): void {\n  if (current.source !== TransactionSource.BANK_STATEMENT) return\n  for (const field of BANK_FACTS) {\n    if (!(field in patch)) continue\n    const before = field === 'bankAccount' ? current.bankAccountId ?? current.bankAccount?.id : (current as any)[field]\n    const after = field === 'bankAccount' ? patch.bankAccount?.id : patch[field]\n    const equal = ['amount', 'balance'].includes(field)\n      ? (before == null && after == null) || (before != null && after != null && Number(before) === Number(after))\n      : before === after\n    if (!equal)\n      throw new Refusal('bank-facts-locked', {}, 'Bank facts can only be updated from a statement; annotations remain editable')\n  }\n}\n\n/** What its payments depend on - they are checked again, and their owners follow, when one of these changes. */\nconst FACTS = ['amount', 'type', 'currency', 'transactionDate'] as const\n\n/**\n * The row a patch writes over the current one: a confirmed transaction has a day and takes its year and month from it;\n * a forecast has a year and a month, and the day its timing names.\n */\nfunction rowOf(input: TransactionInput, current: Transaction | undefined): Record<string, any> {\n  const { id, cuFlag, ...fields } = input\n  const row: Record<string, any> = { ...fields }\n  const merged = { ...current, ...row }\n  const category = merged.category ?? TransactionCategory.CONFIRMED\n  row.category = category\n\n  if (!current && !row.type) throw new Refusal('transaction-type-required', {}, 'type: money in or money out')\n  if (row.type !== undefined && !Object.values(CashFlowType).includes(row.type))\n    throw new Refusal('transaction-type-required', {}, 'type: money in or money out')\n  if (!current && (row.amount === undefined || row.amount === null)) row.amount = 0\n\n  if (category === TransactionCategory.CONFIRMED) {\n    const period = yearMonthOf(merged.transactionDate)\n    if (!period)\n      throw new Refusal(\n        'transaction-date-required',\n        { value: merged.transactionDate ?? '' },\n        'transactionDate: YYYY-MM-DD'\n      )\n    Object.assign(row, period, { status: null })\n  } else {\n    const [year, month] = [Number(merged.year), Number(merged.month)]\n    if (!year) throw new Refusal('forecast-year-required', {}, 'year: the year it is planned in')\n    if (!(month >= 1 && month <= 12))\n      throw new Refusal('month-out-of-range', { month: merged.month ?? '' }, 'month: must be 1 to 12')\n    if (!String(merged.description ?? '').trim())\n      throw new Refusal('forecast-description-required', {}, 'description: what is planned')\n    Object.assign(row, { year, month, transactionDate: forecastDay(year, month, merged.timing) })\n    if (!merged.status) row.status = ForecastStatus.PLANNED\n  }\n\n  if (\n    merged.probability !== undefined &&\n    merged.probability !== null &&\n    !(merged.probability >= 0 && merged.probability <= 100)\n  ) {\n    throw new Refusal('probability-out-of-range', {}, 'probability: must be 0 to 100')\n  }\n\n  return row\n}\n\n/** The payments on these transactions, and the transfers into them, by target kind. */\nasync function paymentsOn(tx: EntityManager, domain: { id: string }, ids: string[]): Promise<Payment[]> {\n  if (!ids.length) return []\n  const repo = tx.getRepository(Payment)\n  return [\n    ...(await repo.find({\n      where: { domain: { id: domain.id }, transaction: { id: In(ids) } },\n      relations: ['transaction']\n    })),\n    ...(await repo.find({\n      where: { domain: { id: domain.id }, targetType: 'Transaction', targetId: In(ids) },\n      relations: ['transaction']\n    }))\n  ]\n}\n\n/**\n * Apply rows to a domain's transactions: `+` (or no id) adds, `M` changes, `-` deletes (softly - a financial row\n * that was deleted stays readable). A transaction that pays something, or is paid, is unlinked before it is\n * deleted; when its money changes, its payments are checked again - the general rule and each target kind's own.\n * A line from a bank statement keeps the statement's facts (§`protectBankFacts`).\n */\nexport async function saveTransactions(\n  tx: EntityManager,\n  domain: { id: string },\n  user: any,\n  inputs: TransactionInput[]\n): Promise<Transaction[]> {\n  const repo = tx.getRepository(Transaction)\n\n  const deletes = [...new Set(inputs.filter(one => one.cuFlag === '-' && one.id).map(one => one.id!))]\n  if (deletes.length) {\n    const found = await repo.find({ where: { domain: { id: domain.id }, id: In(deletes) } })\n    if (found.length !== deletes.length)\n      throw new Refusal('transaction-not-found', {}, 'a transaction was not found - reload and try again')\n    if ((await paymentsOn(tx, domain, deletes)).length)\n      throw new Refusal('transaction-has-payments', {}, 'unlink what the transaction paid before deleting it')\n    await repo.softRemove(found)\n  }\n\n  const saved: Transaction[] = []\n  const factsChanged: string[] = []\n  for (const input of inputs.filter(one => one.cuFlag !== '-')) {\n    const isNew = !input.id || input.cuFlag === '+'\n    const current = isNew ? undefined : await repo.findOne({ where: { domain: { id: domain.id }, id: input.id } })\n    if (!isNew && !current)\n      throw new Refusal('transaction-not-found', {}, 'a transaction was not found - reload and try again')\n\n    if (current) protectBankFacts(current, input)\n    const row = rowOf(input, current)\n    if (row.bankAccount?.id && !('currency' in input)) {\n      const account = await tx\n        .getRepository(BankAccount)\n        .findOne({ where: { domain: { id: domain.id }, id: row.bankAccount.id } })\n      if (!account)\n        throw new Refusal('bank-account-not-found', {}, 'the bank account was not found - reload and try again')\n      if (account.currency) row.currency = account.currency\n    }\n\n    if (row.bankFingerprint) {\n      const twin = await repo.findOne({ where: { domain: { id: domain.id }, bankFingerprint: row.bankFingerprint } })\n      if (twin && twin.id !== current?.id)\n        throw new Refusal(\n          'bank-line-twice',\n          { day: twin.transactionDate ?? '' },\n          'this bank line is already in the books'\n        )\n    }\n\n    const written = await repo.save({ ...(current ?? { domain, creator: user }), ...row, updater: user } as Transaction)\n    if (current && FACTS.some(field => field in row && row[field] !== (current as any)[field]))\n      factsChanged.push(current.id)\n    saved.push(written)\n  }\n\n  if (factsChanged.length) {\n    const payments = await paymentsOn(tx, domain, factsChanged)\n    await checkPaymentsWithin(\n      tx,\n      domain,\n      payments.map(one => one.transaction.id)\n    )\n    const kinds = new Map<string, Payment[]>()\n    for (const payment of payments) kinds.set(payment.targetType, [...(kinds.get(payment.targetType) ?? []), payment])\n    const touchedOf = (ofKind: Payment[]) => ({\n      targetIds: [...new Set(ofKind.map(one => one.targetId))],\n      transactionIds: [...new Set(ofKind.map(one => one.transaction.id))]\n    })\n    for (const [targetType, ofKind] of kinds)\n      await paymentTargetOf(targetType)?.validate?.(tx, domain, touchedOf(ofKind))\n    for (const [targetType, ofKind] of kinds)\n      await paymentTargetOf(targetType)?.onSaved?.(tx, domain, touchedOf(ofKind))\n  }\n\n  return saved\n}\n"]}