@classytic/ledger 0.4.2 → 0.5.0

package/dist/{date-lock.plugin-DL6pe24p.mjs → date-lock.plugin-B2Jy0ukX.mjs}

@@ -1,17 +1,41 @@
-import { n as Errors } from "./errors-B_dyYZc_.mjs";
+import { n as Errors } from "./errors-BmRjW38t.mjs";
 //#region src/plugins/double-entry.plugin.ts
 function doubleEntryPlugin(options = {}) {
 	const { onlyOnPost = true, JournalEntryModel, AccountModel, orgField } = options;
 	function validateItems(items, data) {
+		const lineErrors = [];
 		for (let i = 0; i < items.length; i++) {
 			const d = items[i].debit ?? 0;
 			const c = items[i].credit ?? 0;
-			if (d > 0 && c > 0) throw Errors.validation(`Invalid journal item at index ${i}: a line cannot have both debit (${d}) and credit (${c}) greater than zero.`);
-			if (d === 0 && c === 0) throw Errors.validation(`Invalid journal item at index ${i}: a line cannot have both debit and credit equal to zero.`);
+			if (d > 0 && c > 0) lineErrors.push({
+				path: `journalItems.${i}`,
+				issue: "line cannot have both debit and credit greater than zero",
+				value: {
+					debit: d,
+					credit: c
+				}
+			});
+			if (d === 0 && c === 0) lineErrors.push({
+				path: `journalItems.${i}`,
+				issue: "line cannot have both debit and credit equal to zero",
+				value: {
+					debit: 0,
+					credit: 0
+				}
+			});
 		}
+		if (lineErrors.length > 0) throw Errors.validation(`Invalid journal line(s): ${lineErrors.map((e) => `${e.path} — ${e.issue}`).join("; ")}`, lineErrors);
 		const totalDebit = items.reduce((s, i) => s + (i.debit ?? 0), 0);
 		const totalCredit = items.reduce((s, i) => s + (i.credit ?? 0), 0);
-		if (totalDebit !== totalCredit) throw Errors.validation(`Double-entry violation: debits (${totalDebit}) ≠ credits (${totalCredit}). Difference: ${Math.abs(totalDebit - totalCredit)}`);
+		if (totalDebit !== totalCredit) throw Errors.validation(`Double-entry violation: debits (${totalDebit}) ≠ credits (${totalCredit}). Difference: ${Math.abs(totalDebit - totalCredit)}`, [{
+			path: "journalItems",
+			issue: "debits must equal credits",
+			value: {
+				totalDebit,
+				totalCredit,
+				difference: totalDebit - totalCredit
+			}
+		}]);
 		data.totalDebit = totalDebit;
 		data.totalCredit = totalCredit;
 	}
@@ -33,17 +57,44 @@ function doubleEntryPlugin(options = {}) {
 			};
 			/** Verify all journal item accounts exist and belong to the same org */
 			const validateAccounts = async (items, data, context) => {
-				const accountIds = items.map((i) => i.account).filter((a) => a != null && a !== "");
-				if (accountIds.length === 0) throw Errors.validation("Posted entry has items with missing accounts.");
+				const missingIdxs = [];
+				items.forEach((item, idx) => {
+					if (item.account == null || item.account === "") missingIdxs.push(idx);
+				});
+				if (missingIdxs.length > 0) throw Errors.validation(`Posted entry has items with missing accounts at index(es): ${missingIdxs.join(", ")}.`, missingIdxs.map((i) => ({
+					path: `journalItems.${i}.account`,
+					issue: "account is required on posted entries"
+				})));
+				const accountIds = items.map((i) => i.account);
 				const selectFields = orgField ? `_id ${orgField}` : "_id";
 				const accounts = await AccountModel?.find({ _id: { $in: accountIds } }).select(selectFields).session(context.session ?? null).lean();
 				const foundIds = new Set(accounts.map((a) => String(a._id)));
-				const missingCount = accountIds.filter((id) => !foundIds.has(String(id))).length;
-				if (missingCount > 0) throw Errors.validation(`${missingCount} item(s) reference non-existent accounts.`);
+				const missingFieldErrors = [];
+				items.forEach((item, idx) => {
+					if (!foundIds.has(String(item.account))) missingFieldErrors.push({
+						path: `journalItems.${idx}.account`,
+						issue: "account does not exist",
+						value: item.account
+					});
+				});
+				if (missingFieldErrors.length > 0) throw Errors.validation(`${missingFieldErrors.length} item(s) reference non-existent accounts.`, missingFieldErrors);
 				if (orgField && data[orgField] != null) {
 					const dataOrg = String(data[orgField]);
-					const crossTenant = accounts.filter((a) => String(a[orgField]) !== dataOrg);
-					if (crossTenant.length > 0) throw Errors.validation(`${crossTenant.length} item(s) reference accounts from another organization.`);
+					const accountOrgById = new Map(accounts.map((a) => [String(a._id), String(a[orgField])]));
+					const crossTenantFieldErrors = [];
+					items.forEach((item, idx) => {
+						const acctOrg = accountOrgById.get(String(item.account));
+						if (acctOrg !== void 0 && acctOrg !== dataOrg) crossTenantFieldErrors.push({
+							path: `journalItems.${idx}.account`,
+							issue: "account belongs to another organization",
+							value: {
+								account: item.account,
+								expectedOrg: dataOrg,
+								actualOrg: acctOrg
+							}
+						});
+					});
+					if (crossTenantFieldErrors.length > 0) throw Errors.validation(`${crossTenantFieldErrors.length} item(s) reference accounts from another organization.`, crossTenantFieldErrors);
 				}
 			};
 			const validateUpdate = async (context) => {

package/dist/errors-BmRjW38t.mjs

@@ -0,0 +1,33 @@
+//#region src/utils/errors.ts
+var AccountingError = class extends Error {
+	status;
+	code;
+	fields;
+	constructor(message, status = 400, code = "ACCOUNTING_ERROR", fields) {
+		super(message);
+		this.name = "AccountingError";
+		this.status = status;
+		this.code = code;
+		if (fields && fields.length > 0) this.fields = Object.freeze([...fields]);
+	}
+	/** Serialize to a plain object for API responses and logs. */
+	toJSON() {
+		return {
+			name: this.name,
+			message: this.message,
+			status: this.status,
+			code: this.code,
+			...this.fields ? { fields: this.fields } : {}
+		};
+	}
+};
+/** Convenience factory functions. */
+const Errors = {
+	validation: (msg, fields) => new AccountingError(msg, 400, "VALIDATION_ERROR", fields),
+	notFound: (msg, fields) => new AccountingError(msg, 404, "NOT_FOUND", fields),
+	conflict: (msg, fields) => new AccountingError(msg, 409, "CONFLICT", fields),
+	immutable: (msg, fields) => new AccountingError(msg, 403, "IMMUTABLE_ENTRY", fields),
+	fiscal: (msg, fields) => new AccountingError(msg, 400, "FISCAL_ERROR", fields)
+};
+//#endregion
+export { Errors as n, AccountingError as t };

package/dist/exports/index.d.mts

@@ -1,2 +1,2 @@
-import { _ as PopulatedJournalEntry, a as exportToCsv, c as getHeaders, d as serializeCsv, f as CsvOptions, g as PopulatedAccount, h as FlatJournalRow, i as quickbooksFieldMap, l as buildCsv, m as ExportFieldMap, n as flattenJournalEntry, o as extractAllRows, p as ExportField, r as universalFieldMap, s as extractRow, t as flattenJournalEntries, u as escapeCell, v as PopulatedJournalItem } from "../index-J-XIbXH-.mjs";
+import { _ as PopulatedJournalEntry, a as exportToCsv, c as getHeaders, d as serializeCsv, f as CsvOptions, g as PopulatedAccount, h as FlatJournalRow, i as quickbooksFieldMap, l as buildCsv, m as ExportFieldMap, n as flattenJournalEntry, o as extractAllRows, p as ExportField, r as universalFieldMap, s as extractRow, t as flattenJournalEntries, u as escapeCell, v as PopulatedJournalItem } from "../index-D1ZjgVxn.mjs";
 export { CsvOptions, ExportField, ExportFieldMap, FlatJournalRow, PopulatedAccount, PopulatedJournalEntry, PopulatedJournalItem, buildCsv, escapeCell, exportToCsv, extractAllRows, extractRow, flattenJournalEntries, flattenJournalEntry, getHeaders, quickbooksFieldMap, serializeCsv, universalFieldMap };

package/dist/exports/index.mjs

@@ -1,2 +1,2 @@
-import { a as exportToCsv, c as getHeaders, d as serializeCsv, i as quickbooksFieldMap, l as buildCsv, n as flattenJournalEntry, o as extractAllRows, r as universalFieldMap, s as extractRow, t as flattenJournalEntries, u as escapeCell } from "../exports-DoGQQtMQ.mjs";
+import { a as exportToCsv, c as getHeaders, d as serializeCsv, i as quickbooksFieldMap, l as buildCsv, n as flattenJournalEntry, o as extractAllRows, r as universalFieldMap, s as extractRow, t as flattenJournalEntries, u as escapeCell } from "../exports-BP-0Ni5W.mjs";
 export { buildCsv, escapeCell, exportToCsv, extractAllRows, extractRow, flattenJournalEntries, flattenJournalEntry, getHeaders, quickbooksFieldMap, serializeCsv, universalFieldMap };

package/dist/{fiscal-close-B2_7WMTe.mjs → fiscal-close-Dk3yRT9i.mjs}

@@ -1,7 +1,17 @@
-import { n as Errors } from "./errors-B_dyYZc_.mjs";
-import { t as requireOrgScope } from "./tenant-guard-r17Se3Bb.mjs";
-import { i as extractMainType } from "./categories-DWogBUgQ.mjs";
+import { n as Errors } from "./errors-BmRjW38t.mjs";
+import { i as extractMainType } from "./categories-BkKdv16V.mjs";
 import mongoose from "mongoose";
+//#region src/utils/tenant-guard.ts
+/**
+* Multi-tenant scope guard.
+*
+* Throws when orgField is configured (multi-tenant mode active) but
+* organizationId is missing — preventing unscoped cross-tenant queries.
+*/
+function requireOrgScope(orgField, organizationId) {
+	if (orgField && !organizationId) throw Errors.validation("organizationId is required when multi-tenant mode is configured (orgField: \"" + orgField + "\"). Refusing to run unscoped query.");
+}
+//#endregion
 //#region src/reports/aged-balance.ts
 const DEFAULT_BUCKETS = [
 	{
@@ -1650,4 +1660,4 @@ async function reopenFiscalPeriod(opts, params) {
 	}
 }
 //#endregion
-export { DEFAULT_BUCKETS as C, isVirtualTaxAccount as S, getDateRange as _, defaultLogger as a, calculateTotal as b, buildRevaluationEntry as c, generateGeneralLedger as d, generateDimensionBreakdown as f, buildItemFilters as g, generateBalanceSheet as h, finalizeSession as i, computeRevaluation as l, generateBudgetVsActual as m, reopenFiscalPeriod as n, generateTrialBalance as o, generateCashFlow as p, acquireSession as r, generateRevaluation as s, closeFiscalPeriod as t, generateIncomeStatement as u, getFiscalYearStart as v, generateAgedBalance as w, computeEndingBalance as x, buildAccountTypeMap as y };
+export { DEFAULT_BUCKETS as C, isVirtualTaxAccount as S, requireOrgScope as T, getDateRange as _, defaultLogger as a, calculateTotal as b, buildRevaluationEntry as c, generateGeneralLedger as d, generateDimensionBreakdown as f, buildItemFilters as g, generateBalanceSheet as h, finalizeSession as i, computeRevaluation as l, generateBudgetVsActual as m, reopenFiscalPeriod as n, generateTrialBalance as o, generateCashFlow as p, acquireSession as r, generateRevaluation as s, closeFiscalPeriod as t, generateIncomeStatement as u, getFiscalYearStart as v, generateAgedBalance as w, computeEndingBalance as x, buildAccountTypeMap as y };

package/dist/{index-CxZqRaOU.d.mts → index-GmfEFxVn.d.mts}

@@ -1,4 +1,4 @@
-import { t as AccountType } from "./core-8Xfnpn6g.mjs";
+import { t as AccountType } from "./core-BkGjuVZj.mjs";
 
 //#region src/country/index.d.ts
 interface TaxCode {