biz-a-cli 2.3.80-15419 → 2.3.80

package/engine/fina/client.js

@@ -1,84 +0,0 @@
-/*
- * Doc 8 — the FINA API as engine/fina calls it (docs/DOC8-FINA-API-CONTRACT.md §1).
- *
- * `POST <api>/fina/rest/<Class>/%22<method>%22`, content-type text/plain, body `{"_parameters":[…]}`.
- *
- * ⚠️ FINA ANSWERS AN ERROR AS HTTP 200: TFinaMethod wraps it, `{"result":[{"error":"…"}]}`; TOrmMethod returns a
- * bare `{"error":"…"}`. Both are thrown here as FINA_REFUSED with FINA's own message (it is what the user needs to
- * read: "You do not have the right to edit", "Debits and Credits are out of balance by 500"…).
- * `scheduler/datalib.js` reads only `res.data?.error` and misses the wrapped form, which is why this has its own.
- *
- * Every call goes to the ONE FINA database this hub's FINA Cloud works on (config.js); a caller cannot choose
- * another, because `dbIndex` is set here, after the caller's request.
- */
-import axios from "axios";
-import { finaError, FinaError } from "./errors.js";
-
-export { FinaError };
-
-/* Mass actions run documents one after another (M-11), each well inside the FINA API's own 55 s. */
-const DEFAULT_TIMEOUT_MS = 55000;
-
-export const createFinaClient = ({ url, dbIndex, http = axios, timeout = DEFAULT_TIMEOUT_MS }) => {
-	const post = async (methodClass, method, parameters) => {
-		let res;
-		try {
-			res = await http.post(`${url}/fina/rest/${methodClass}/%22${method}%22`, JSON.stringify({ _parameters: parameters }), {
-				headers: { "content-type": "text/plain" },
-				timeout,
-				validateStatus: () => true,
-				maxContentLength: Infinity,
-				maxBodyLength: Infinity,
-			});
-		} catch (error) {
-			throw finaError("FINA_UNREACHABLE", `The FINA API at ${url} could not be reached: ${error?.message ?? error}`);
-		}
-		if (!res || res.status < 200 || res.status >= 300) {
-			throw finaError("FINA_ERROR", `The FINA API answered ${res?.status} to ${method}.`);
-		}
-		let body;
-		try {
-			body = typeof res.data === "string" ? JSON.parse(res.data) : res.data;
-		} catch {
-			throw finaError("FINA_ERROR", `The FINA API answered ${method} with something that is not JSON.`);
-		}
-		const refusal = body?.error ?? body?.result?.[0]?.error;
-		if (refusal !== undefined && refusal !== null && refusal !== "") throw finaError("FINA_REFUSED", String(refusal));
-		return body;
-	};
-
-	return {
-		dbIndex,
-
-		/* One statement, rows back with lower-cased keys (as execPostgres returns them). ⚠️ Single-line: a raw
-		   newline ends the command on this transport (memory: FINA block path limits). */
-		executeSql: async (sql) => {
-			if (/[\r\n]/.test(String(sql))) throw finaError("INVALID", "A FINA statement must be on one line.");
-			const body = await post("TFinaMethod", "ExecuteSQL", [String(sql), String(dbIndex)]);
-			const first = body?.result?.[0];
-			if (typeof first !== "string" || first === "") return [];
-			const rows = JSON.parse(first)?.data;
-			return (Array.isArray(rows) ? rows : []).map((row) =>
-				Object.fromEntries(Object.entries(row).map(([key, value]) => [key.toLowerCase(), value])),
-			);
-		},
-
-		/* `EXECUTE BLOCK AS BEGIN …; END` — one atomic statement (contract §5). */
-		block: async (sql) => post("TOrmMethod", "block", [JSON.stringify({ dbIndex, method: "block", object: String(sql) })]),
-
-		/* Documents and masters (contract §2). Answers the key FINA gave: JVID, GLACCOUNT, DEPTID… */
-		json2fina: async (request) => {
-			const body = await post("TFinaMethod", "json2fina", [JSON.stringify({ ...request, dbIndex })]);
-			return { id: body?.result?.[0]?.id ?? null };
-		},
-
-		/* Doc 8 M4 — a document's printed pages (contract §3): FINA's report as JPEGs, concatenated, sent as an array of
-		   byte values. ⚠️ `table` / `keyfield` / `id` go into FINA's SQL as they are: engine/fina/print.js builds them. */
-		template: async (request) => {
-			const body = await post("TFinaMethod", "template", [JSON.stringify({ ...request, dbIndex })]);
-			const bytes = body?.result?.[0];
-			if (!Array.isArray(bytes)) throw finaError("FINA_ERROR", "The FINA API answered template without the rendered pages.");
-			return Uint8Array.from(bytes);
-		},
-	};
-};

package/engine/fina/config.js

@@ -1,26 +0,0 @@
-/*
- * Doc 8 — is FINA Cloud on for this hub, and which FINA database is it?
- *
- * ⚠️ AN OPERATOR SETTING (`--finaCloudDbindex`), NOT A CONSOLE ONE. One FINA API can serve several companies'
- * databases by index; a tenant administrator who could choose the index could open another company's books. The
- * index is therefore fixed where the hub is started, as `--dbindex` is.
- *
- * ⚠️ NOT the registry's `finaDbIndex`: that one says where LOGIN users live (engine/orm/apiRoute.js), which on a
- * PostgreSQL tenant is the tenant's own database.
- *
- * Anything but a positive whole number means off: every `fina/*` route then answers NOT_CONFIGURED and the browser
- * write guard stands aside.
- */
-export const finaCloudConfig = (argv = {}) => {
-	const raw = argv?.finaCloudDbindex;
-	const dbIndex = Number(raw);
-	const enabled = raw !== undefined && raw !== null && raw !== "" && Number.isInteger(dbIndex) && dbIndex > 0;
-	return {
-		enabled,
-		dbIndex: enabled ? dbIndex : null,
-		/* Where this hub's own data lives: FINA$SETTING, FINA$USER_MAP, SYS$USERS, SYS$ADMINISTRATOR. */
-		tenantDbIndex: Number(argv?.dbindex),
-		/* The FINA API this hub already forwards to (hub.js -h / -p / --secure). */
-		url: `${argv?.secure === true ? "https" : "http"}://${argv?.hostname ?? "127.0.0.1"}:${argv?.port ?? 212}`,
-	};
-};

package/engine/fina/context.js

@@ -1,58 +0,0 @@
-/*
- * Doc 8 D2 — WHO is calling a `fina/*` engine route, decided once, before the route runs.
- *
- * Only the SIGNED principal counts (x-biza-principal, verified here; principalForCliScript), never an id in the
- * payload. Answers `{ ok: true, principal, config }` or `{ ok: false, code, error }`:
- *
- * - NOT_CONFIGURED: FINA Cloud is off on this hub (no --finaCloudDbindex).
- * - FINA_CLOUD_NEEDS_POSTGRES: engine/fina's tables (FINA$SETTING, FINA$USER_MAP) are PostgreSQL migrations.
- * - UNAUTHENTICATED:
- *   - no principal, or one that does not verify — in EVERY principal mode: `observe` lets a data request through,
- *     but it never invents an identity, and a FINA write needs one;
- *   - ⚠️ a principal signed for another database. The user id means a row of SYS$USERS in the database it was
- *     minted for; FINA$USER_MAP and SYS$ADMINISTRATOR are read in THIS hub's database. Two hubs on one machine can
- *     share a secret, so a token from the other would otherwise name somebody else's user here;
- *   - ⚠️ a session row that is revoked, expired or cannot be read (Doc 4 §9.4: access ends at once — the token
- *     alone would keep working for the rest of its 12 hours).
- */
-import { principalForCliScript } from "../../security/internalPrincipal.js";
-import { finaCloudConfig } from "./config.js";
-
-const refused = (code, error) => ({ ok: false, code, error });
-
-export const finaContext = async (headers, { argv = {}, isPostgresIndex, readSession = null } = {}) => {
-	const config = finaCloudConfig(argv);
-	if (!config.enabled) {
-		return refused("NOT_CONFIGURED", "FINA Cloud is not switched on for this company (the hub runs without --finaCloudDbindex).");
-	}
-
-	let postgres = false;
-	try {
-		postgres = typeof isPostgresIndex === "function" && isPostgresIndex(config.tenantDbIndex) === true;
-	} catch {
-		postgres = false;
-	}
-	if (!postgres) {
-		return refused("FINA_CLOUD_NEEDS_POSTGRES", `FINA Cloud needs this company's Biz-A database (${config.tenantDbIndex}) on PostgreSQL.`);
-	}
-
-	const principal = principalForCliScript(headers, { mode: argv?.principalMode || "observe" });
-	if (!principal) return refused("UNAUTHENTICATED", "No signed-in Biz-A user came with this request. Sign in again.");
-	if (Number(principal.dbIndex) !== config.tenantDbIndex) {
-		return refused("UNAUTHENTICATED", "This sign-in belongs to another Biz-A database. Sign in to this company again.");
-	}
-
-	if (principal.sessionId !== null && principal.sessionId !== undefined && principal.sessionId !== "" && typeof readSession === "function") {
-		let session;
-		try {
-			session = await readSession(principal.sessionId);
-		} catch {
-			session = null;
-		}
-		if (!session?.ok) {
-			return refused("UNAUTHENTICATED", `This session can no longer be used (${session?.reason ?? "unreadable"}). Sign in again.`);
-		}
-	}
-
-	return { ok: true, principal, config };
-};

package/engine/fina/document.js

@@ -1,67 +0,0 @@
-/*
- * Doc 8 M4 — one FINA document read for its form (view, T-01): the master, its lines and their extended values, read
- * through the document's server-owned descriptor (documents/*.js). Any mapped FINA user may read (D4: view).
- *
- * Extended fields (T-12–T-16): only the MAPPED ones are read, from EXTENDED by the master's and the lines'
- * EXTENDEDIDs, and answered as `ext_<field>` beside the other values.
- */
-import { finaError } from "./errors.js";
-import { requireRight } from "./identity.js";
-import { documentOf, documentId } from "./documents/index.js";
-import { readMappings } from "./template.js";
-
-/* The master row, or null — also what print and the template choice check a document against. */
-export const readMaster = async (client, document, id) => {
-	const { select, from, filter, key } = document.master;
-	const where = [`M.${key} = ${id}`, ...(filter ? [filter] : [])].join(" AND ");
-	return (await client.executeSql(`SELECT ${select} FROM ${from} WHERE ${where} `))?.[0] ?? null;
-};
-
-const extendedValues = async (client, ids, fields) => {
-	const wanted = [...new Set(ids.map(Number).filter((id) => Number.isInteger(id) && id > 0))];
-	if (wanted.length === 0 || fields.length === 0) return new Map();
-	const rows = (await client.executeSql(`SELECT EXTENDEDID, ${fields.join(", ")} FROM EXTENDED WHERE EXTENDEDID IN (${wanted.join(", ")})`)) ?? [];
-	return new Map(rows.map((row) => [Number(row.extendedid), row]));
-};
-
-const withExtended = (row, extended, mappings) => {
-	const values = extended.get(Number(row.extendedid)) ?? {};
-	const out = { ...row };
-	for (const mapping of mappings) out[mapping.key] = values[mapping.field.toLowerCase()] ?? null;
-	return out;
-};
-
-/* Doc 8 M5a — a document as FINA has it now: what the form shows (get) and what an edit starts from (documentWrite). */
-export const readDocument = async (client, document, id) => {
-	const master = await readMaster(client, document, id);
-	if (!master) throw finaError("DOCUMENT_NOT_FOUND", `${document.label} ${id} was not found.`);
-	const { select, from, key, order, line } = document.detail;
-	const lines = (await client.executeSql(`SELECT ${select} FROM ${from} WHERE ${key} = ${id} ORDER BY ${order}`)) ?? [];
-
-	const mappings = await readMappings(client, document.extended);
-	const masterMappings = mappings.filter((m) => m.part === "master");
-	const lineMappings = mappings.filter((m) => m.part === "detail");
-	const fields = [...new Set(mappings.map((m) => m.field))];
-	const extended = await extendedValues(client, [master.extendedid, ...lines.map((l) => l.extendedid)], fields);
-
-	return {
-		id,
-		templateId: master.templateid ?? null,
-		master: withExtended(master, extended, masterMappings),
-		lines: lines.map((row) => withExtended(line ? line(row) : row, extended, lineMappings)),
-	};
-};
-
-export const createDocumentService = ({ client, identity, submissionOf = null }) => ({
-	get: async (principal, name, rawId) => {
-		const document = documentOf(name);
-		const id = documentId(rawId);
-		requireRight(await identity.resolve(principal), document.rights, null);
-		const doc = await readDocument(client, document, id);
-		/* What an edit must be sent against: changed by someone else meanwhile, the save is refused (DOCUMENT_CHANGED). */
-		const answer = { ...doc, version: document.write?.version ? document.write.version(doc) : null };
-		/* Doc 8 M7b (L-02): a document that has an approval flow says which submission it came from, or null. */
-		if (submissionOf && document.write?.needsApproval) answer.submission = (await submissionOf(id)) ?? null;
-		return answer;
-	},
-});

package/engine/fina/documentWrite.js

@@ -1,173 +0,0 @@
-/*
- * Doc 8 M5a — saving a FINA document from Biz-A (F-25, F-27, F-30, F-32, F-33; contract §2.1, §2.1a, §6, §8).
- *
- * The document's server-owned `write` block (documents/<doc>.js) says WHAT is written; this runs it in a fixed order:
- *   1. the FINA right: create for a new document, edit for an existing one (D4);
- *   2. Need Approval on → refused here (the approval flow, M7, is the only way in then);
- *   3. on edit, the document as FINA has it NOW — gone, changed since it was opened (`version`), a locked line;
- *   4. the rules — every problem in ONE DOCUMENT_RULE, so the user fixes them all at once;
- *   5. the Biz-A date lock on the new AND the old date (D2a): an edit can neither enter nor leave the locked range;
- *   6. FINA's CHECK_PERIOD on both dates (the API checks only the old one, appendix V12);
- *   7. json2fina as the caller's FINA user; a new number colliding (HEADLESS, contract §9) is retried up to 3 times;
- *   8. the number read back by id (the response has none, T-27), FINA's totals compared with what was sent.
- *
- * ⚠️ ONE SIMPAN, ONE DOCUMENT. A save the hub gives up on (28 s) may still be committing in FINA; the browser resends
- * it with the SAME requestId, which answers the first save's outcome instead of writing a second document.
- */
-import { finaError } from "./errors.js";
-import { requireRight } from "./identity.js";
-import { documentOf, documentId } from "./documents/index.js";
-import { readDocument } from "./document.js";
-import { listTemplates, assertTemplateOfType, readMappings } from "./template.js";
-import { isDateLocked, toDateOnly } from "./lock.js";
-import { checkPeriods } from "./period.js";
-import { ownerOf } from "./attachments.js";
-
-const COLLISION_RETRIES = 3;
-const REQUEST_TTL_MS = 10 * 60 * 1000;
-const requests = new Map();
-
-/* Tests only: forget the request ids seen. */
-export const resetDocumentRequests = () => requests.clear();
-
-export const createDocumentWriter = ({ client, identity, settings, features, attachments = null, now = () => Date.now() }) => {
-	const run = async (principal, name, request, { approved = false } = {}) => {
-		const document = documentOf(name);
-		const write = document.write;
-		if (!write) throw finaError("INVALID", `${document.label} is read only in Biz-A.`);
-		const blank = request?.id === null || request?.id === undefined || request?.id === "";
-		const id = blank ? null : documentId(request.id);
-		const isNew = id === null;
-		const who = requireRight(await identity.resolve(principal), document.rights, isNew ? "create" : "edit");
-
-		const config = await settings.read();
-		/* Doc 8 M7: with Need Approval on, a NEW document is submitted (fina/submission) and reaches FINA only through its
-		   approval, which posts it here as `approved` (submission.js; no route passes that). A document already in FINA is
-		   edited directly (Agung 2026-10-14). */
-		if (isNew && !approved && write.needsApproval?.(config)) {
-			throw finaError("DOCUMENT_RULE", `Need Approval is on in the FINA Cloud console: a new ${document.label} is submitted for approval (Pengajuan).`);
-		}
-		const flags = await features.read();
-
-		let current = null;
-		if (!isNew) {
-			current = await readDocument(client, document, id);
-			if (request?.version && write.version(current) !== request.version) {
-				throw finaError("DOCUMENT_CHANGED", `${document.label} ${current.master?.jvnumber ?? id} was changed in FINA since it was opened. Open it again.`);
-			}
-			const locked = write.locked ? await write.locked(client, id) : [];
-			if (locked.length > 0) throw finaError("DOCUMENT_RULE", locked.join("\n"));
-		}
-
-		const normalized = write.normalize(request?.master, request?.lines);
-		const problems = [...normalized.problems];
-		if (problems.length === 0) problems.push(...(await write.validate({ client, lines: normalized.lines, settings: config, features: flags })));
-		if (problems.length > 0) throw finaError("DOCUMENT_RULE", problems.join("\n"));
-
-		const upTo = config?.lock?.upTo ?? null;
-		const newDate = normalized.master.transdate;
-		const oldDate = current ? toDateOnly(current.master?.transdate) : null;
-		for (const date of [newDate, oldDate]) {
-			if (date && isDateLocked(date, upTo)) {
-				throw finaError("DATE_LOCKED", `${date} is on or before the Biz-A lock date ${toDateOnly(upTo)}: it cannot be saved from Biz-A.`);
-			}
-		}
-		await checkPeriods(client, [newDate, oldDate]);
-
-		if (normalized.master.templateid) assertTemplateOfType(await listTemplates(client, document.templateType), normalized.master.templateid);
-		const mappings = await readMappings(client, document.extended);
-		const data = write.payload({ isNew, master: normalized.master, lines: normalized.lines, current, mappings });
-
-		let answer;
-		for (let attempt = 0; ; attempt++) {
-			try {
-				answer = await client.json2fina({ id: isNew ? -1 : String(id), dataModule: write.dataModule, transType: write.transType, userId: who.finaUser.id, data });
-				break;
-			} catch (error) {
-				const collision = isNew && error?.code === "FINA_REFUSED" && /already exist/i.test(String(error?.message ?? ""));
-				if (collision && attempt < COLLISION_RETRIES) continue;
-				throw error;
-			}
-		}
-
-		const savedId = isNew ? documentId(answer?.id) : id;
-		const back = write.readBack ? await write.readBack(client, savedId, normalized.lines) : { number: null, warnings: [] };
-		return { id: savedId, number: back.number, warnings: back.warnings };
-	};
-
-	/*
-	 * Doc 8 M5b — delete (F-32, F-33). FINA's API checks neither the delete right (V3) nor, as far as recorded, the period
-	 * on a delete, so this does: the edit right (D4: delete = E), the document as FINA has it now (gone, a reconciled
-	 * line, V17), the Biz-A lock and FINA's period on its date. One json2fina call removes the master, its lines, its GL
-	 * entries and its extended rows (contract §2, verified in M0).
-	 */
-	const removeRun = async (principal, name, request) => {
-		const document = documentOf(name);
-		const write = document.write;
-		if (!write) throw finaError("INVALID", `${document.label} is read only in Biz-A.`);
-		const id = documentId(request?.id);
-		const who = requireRight(await identity.resolve(principal), document.rights, "delete");
-		const current = await readDocument(client, document, id);
-		const locked = write.locked ? await write.locked(client, id, "deleted") : [];
-		if (locked.length > 0) throw finaError("DOCUMENT_RULE", locked.join("\n"));
-
-		const config = await settings.read();
-		const upTo = config?.lock?.upTo ?? null;
-		const date = toDateOnly(current.master?.transdate);
-		if (isDateLocked(date, upTo)) {
-			throw finaError("DATE_LOCKED", `${date} is on or before the Biz-A lock date ${toDateOnly(upTo)}: it cannot be deleted from Biz-A.`);
-		}
-		await checkPeriods(client, [date]);
-
-		await client.json2fina({ id: String(id), delete: "1", dataModule: write.dataModule, transType: write.transType, userId: who.finaUser.id, data: { master: {} } });
-		/* Doc 8 M6: its attachments (Biz-A's, SYS$ATTACHMENT) go with it, once FINA has deleted it. */
-		const warnings = [];
-		if (attachments && document.attachments) {
-			try {
-				await attachments.removeOwner({ owner: ownerOf(document.name, id) });
-			} catch (error) {
-				warnings.push(`Its attachments could not be removed: ${error?.message ?? error}`);
-			}
-		}
-		return { id, number: current.master?.jvnumber ?? null, ...(warnings.length > 0 && { warnings }) };
-	};
-
-	/*
-	 * Doc 8 M5b — a mass edit (M-13–M-17): the HEADER only. The keys a patch may carry are the date, the description and
-	 * the master's MAPPED extended fields; anything else (a line, the number) is refused. The patched document then goes
-	 * the single edit's way (M-16) with its own lines, so FINA re-posts it to the GL (M-15) and both dates are checked
-	 * (M-17).
-	 */
-	const patchRun = async (principal, name, request) => {
-		const document = documentOf(name);
-		if (!document.write) throw finaError("INVALID", `${document.label} is read only in Biz-A.`);
-		const id = documentId(request?.id);
-		const patch = request?.master;
-		if (!patch || typeof patch !== "object" || Array.isArray(patch) || Object.keys(patch).length === 0) {
-			throw finaError("INVALID", "Nothing to change: a mass edit names the date, the description or an extended field.");
-		}
-		requireRight(await identity.resolve(principal), document.rights, "edit");
-		const current = await readDocument(client, document, id);
-		const extended = Object.keys(current.master ?? {}).filter((k) => /^ext_/.test(k));
-		const allowed = new Set(["transdate", "transdescription", ...extended]);
-		const refused = Object.keys(patch).filter((k) => !allowed.has(k));
-		if (refused.length > 0) {
-			throw finaError("INVALID", `A mass edit changes only the date, the description and the mapped extended fields, not ${refused.join(", ")}.`);
-		}
-		const own = Object.fromEntries(["transdate", "transdescription", "templateid", ...extended].map((k) => [k, current.master[k] ?? null]));
-		return run(principal, name, { id, version: document.write.version(current), master: { ...own, ...patch }, lines: current.lines });
-	};
-
-	/* `requestId` (from the browser, one per action) makes a resend answer the first outcome; `dbIndex` scopes it. */
-	const once = (action, fn) => (principal, name, request = {}, { dbIndex, ...options } = {}) => {
-		const requestId = String(request?.requestId ?? "").trim();
-		if (!requestId) return fn(principal, name, request, options);
-		const at = now();
-		for (const [key, entry] of requests) if (at - entry.at > REQUEST_TTL_MS) requests.delete(key);
-		const key = `${action}:${dbIndex ?? ""}:${principal?.userId ?? ""}:${requestId}`;
-		if (!requests.has(key)) requests.set(key, { at, promise: fn(principal, name, request, options) });
-		return requests.get(key).promise;
-	};
-
-	return { save: once("save", run), remove: once("remove", removeRun), patch: once("patch", patchRun) };
-};

package/engine/fina/documents/index.js

@@ -1,28 +0,0 @@
-/*
- * Doc 8 M4 — the FINA documents engine/fina serves, by the name the browser uses.
- *
- * ⚠️ SERVER-OWNED, like the masters: a request names a document; its tables, key, filter, template type, print
- * dictionary and recurring class come from here. Nothing a browser sends reaches FINA's SQL except validated integers.
- */
-import { finaError } from "../errors.js";
-import jv from "./jv.js";
-import si from "./si.js";
-
-const DOCUMENTS = { jv, si };
-
-export const DOCUMENT_NAMES = Object.keys(DOCUMENTS);
-
-export const documentOf = (name) => {
-	const document = DOCUMENTS[String(name ?? "").trim().toLowerCase()];
-	if (!document) throw finaError("INVALID", `Unknown document ${JSON.stringify(name)}: it is one of ${DOCUMENT_NAMES.join(", ")}.`);
-	return document;
-};
-
-/* A document id is a positive integer — it goes into FINA's SQL. */
-export const documentId = (value) => {
-	const id = Number(value);
-	if (value === null || value === undefined || typeof value === "boolean" || !Number.isInteger(id) || id <= 0 || !/^\d+$/.test(String(value).trim())) {
-		throw finaError("INVALID", `A document id is a positive whole number, not ${JSON.stringify(value)}.`);
-	}
-	return id;
-};

package/engine/fina/documents/jv.js

@@ -1,105 +0,0 @@
-/*
- * Doc 8 M4 — the Journal Voucher as engine/fina reads, prints and keeps its recurring lines (contract §2.1, §3, §7;
- * appendix F-03 §1.3). Its screen binding is the app's (finaDocuments.jv); this is what the SERVER trusts.
- *
- * Plain JVs only: Other Payment / Other Receipt and the RO rows share the JV table under another TRANSTYPE.
- * Dept / Project / Person travel as codes, as the desktop's recurring and json2fina carry them.
- */
-import jvWrite from "./jvWrite.js";
-
-const money = (v) => (v === null || v === undefined || v === "" ? null : Number(v));
-
-export default {
-	name: "jv",
-	label: "Journal Voucher",
-	rights: "jv",
-	templateType: 14,
-	/* Doc 8 M6 (F-34): a JV has attachments, kept in Biz-A (engine/fina/attachments.js). */
-	attachments: true,
-	/*
-	 * Doc 8 M5a — written from Biz-A through FINA's TdmJV (contract §2.1, §2.1a). The rules, the payload and the version
-	 * are jvWrite's; documentWrite.js runs them in order (right → approval → current → rules → lock → period → write).
-	 */
-	write: {
-		dataModule: "TdmJV",
-		transType: "GLJV",
-		...jvWrite,
-		/* A-01: with Need Approval on, a JV reaches FINA only through its approval (M7). */
-		needsApproval: (settings) => !!settings?.jv?.needApproval,
-		/* V17: a reconciled line blocks an edit and a delete (M5b). */
-		locked: async (client, id, verb = "edited") =>
-			((await client.executeSql(`SELECT SEQ FROM JVDET WHERE JVID = ${id} AND RECONCILEID IS NOT NULL`)) ?? []).map(
-				(r) => `Line ${Number(r.seq) + 1} is reconciled in FINA: this JV cannot be ${verb}.`,
-			),
-		/* T-27: the response carries no number; FINA's own totals are compared with what was sent. */
-		readBack: async (client, id, lines) => {
-			const head = (await client.executeSql(`SELECT JVNUMBER, JVAMOUNT FROM JV WHERE JVID = ${id}`))?.[0] ?? {};
-			const det = (await client.executeSql(`SELECT COUNT(*) AS N, SUM(GLAMOUNT) AS S FROM JVDET WHERE JVID = ${id}`))?.[0] ?? {};
-			const warnings = [];
-			if (Number(det.n) !== lines.length) warnings.push(`FINA keeps ${Number(det.n)} lines for this JV; ${lines.length} were sent.`);
-			if (Math.abs(Number(det.s ?? 0)) > 0.0005) warnings.push(`FINA's lines of this JV are out of balance by ${Math.abs(Number(det.s))}.`);
-			return { number: head.jvnumber ?? null, warnings };
-		},
-	},
-	master: {
-		table: "JV",
-		key: "JVID",
-		select: "M.JVID, M.JVNUMBER, M.TRANSDATE, M.TRANSDESCRIPTION, M.JVAMOUNT, M.TEMPLATEID, M.EXTENDEDID",
-		from: "JV M",
-		filter: "M.TRANSTYPE = 'JV'",
-	},
-	detail: {
-		select:
-			"D.SEQ, D.GLACCOUNT, A.ACCOUNTNAME, D.GLAMOUNT, D.DESCRIPTION, D.RATE, D.PRIMEAMOUNT, DP.DEPTNO, PJ.PROJECTNO, P.PERSONNO, P.NAME AS PERSONNAME, D.EXTENDEDID",
-		from:
-			"JVDET D LEFT JOIN GLACCNT A ON A.GLACCOUNT = D.GLACCOUNT LEFT JOIN DEPARTMENT DP ON DP.DEPTID = D.DEPTID " +
-			"LEFT JOIN PROJECT PJ ON PJ.PROJECTID = D.PROJECTID LEFT JOIN PERSONDATA P ON P.ID = D.SUBSIDIARY",
-		key: "D.JVID",
-		order: "D.SEQ",
-		/* The desktop shows a JV line as Debit / Credit; FINA stores one signed GLAMOUNT. */
-		line: (row) => {
-			const amount = money(row.glamount);
-			return { ...row, debit: amount !== null && amount > 0 ? amount : null, credit: amount !== null && amount < 0 ? -amount : null };
-		},
-	},
-	/* EXTENDEDMAPPING.MAPTABLENAME of the master and of a line (T-14, T-15). */
-	extended: { master: "JV", detail: "JVDET" },
-	print: {
-		/* `JVID` drives the report's queries; the totals are template variables that call the desktop form's functions,
-		   which the API does not have — so they are passed as values (contract §3). */
-		dictionary: async ({ client, id }) => {
-			const totals =
-				(await client.executeSql(
-					`SELECT SUM(CASE WHEN GLAMOUNT > 0 THEN GLAMOUNT ELSE 0 END) AS DEBIT, SUM(CASE WHEN GLAMOUNT < 0 THEN -GLAMOUNT ELSE 0 END) AS CREDIT FROM JVDET WHERE JVID = ${id}`,
-				))?.[0] ?? {};
-			return [
-				{ param: "JVID", value: String(id) },
-				{ param: "Total Debit", value: String(money(totals.debit) ?? 0) },
-				{ param: "Total Credit", value: String(money(totals.credit) ?? 0) },
-			];
-		},
-	},
-	/*
-	 * FINA desktop's `TJVRecurring` (RecurringUtility.pas): TABLENAME JVDET, the primary field GLACCOUNT, and the
-	 * exception list it stores. Biz-A writes GLAMOUNT, never the desktop's Debit / Credit (replaying those can zero a
-	 * line, appendix F-03 §1.3); it reads either. Mapped extended fields follow as `jvdet<field>` (lower case).
-	 */
-	recurring: {
-		class: "TJVRecurring",
-		tableName: "JVDET",
-		exception: "EXTENDEDID|JVID|SEQ|ProjectID|DeptID|SUBSIDIARY|EXTENDEDID|ReconcileID|FixAssetID|POSTED",
-		extendedPrefix: "jvdet",
-		fields: [
-			{ name: "GLACCOUNT", key: "glaccount", type: "string" },
-			{ name: "GLAMOUNT", key: "glamount", type: "money" },
-			{ name: "DESCRIPTION", key: "description", type: "string" },
-			{ name: "RATE", key: "rate", type: "money" },
-			{ name: "PRIMEAMOUNT", key: "primeamount", type: "money" },
-			{ name: "DeptNo", key: "deptno", type: "string" },
-			{ name: "ProjectNo", key: "projectno", type: "string" },
-			{ name: "PersonNo", key: "personno", type: "string" },
-		],
-		/* A desktop row with Debit / Credit and no GLAMOUNT. */
-		amountFrom: { key: "glamount", debit: "DEBIT", credit: "CREDIT" },
-	},
-};