@classytic/ledger 0.4.2 → 0.5.1

package/dist/{date-lock.plugin-DL6pe24p.mjs → date-lock.plugin-B6WyvqNG.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,23 +57,51 @@ 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) => {
 				const data = context.data;
 				if (!data) return;
-				if (JournalEntryModel) {
+				const internalOp = context._ledgerInternal;
+				if (JournalEntryModel && !internalOp) {
 					const id = context.id;
 					if (id) {
 						if ((await JournalEntryModel.findById(id).select("state").session(context.session ?? null).lean())?.state === "posted") {

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/{idempotency.plugin-zU-GKJ0-.d.mts → idempotency.plugin-WcQLZU9n.d.mts}

@@ -15,6 +15,44 @@ declare function dateLockPlugin(options: DateLockPluginOptions): {
   apply(repo: RepositoryInstance): void;
 };
 //#endregion
+//#region src/types/mongokit-augmentation.d.ts
+/**
+ * Module augmentation for `@classytic/mongokit`.
+ *
+ * Ledger's state-transition methods (post, unpost, archive, reverseMark) tag
+ * their `repository.update()` call with a `_ledgerInternal` flag so the
+ * double-entry immutability guard can distinguish legitimate transitions from
+ * arbitrary edits. This file types that flag onto both `RepositoryContext`
+ * (what plugins observe) and `SessionOptions` (what callers pass) so consumers
+ * and plugin authors get full IntelliSense without casts.
+ *
+ * This file is side-effect only — importing it anywhere in the package is
+ * enough to activate the augmentation. `src/types/index.ts` re-exports it.
+ */
+type LedgerInternalOp = 'post' | 'unpost' | 'archive' | 'reverseMark';
+declare module '@classytic/mongokit' {
+  interface RepositoryContext {
+    /**
+     * Set by ledger's repository methods (post, unpost, archive, reverseMark)
+     * to signal a legitimate internal state transition. Plugins observing
+     * `before:update` can read this to distinguish from arbitrary edits.
+     *
+     * External `repository.update()` callers cannot spoof this flag because
+     * it is only set by ledger's own repo methods, never surfaced in the
+     * public API.
+     */
+    _ledgerInternal?: LedgerInternalOp;
+  }
+  interface SessionOptions {
+    /**
+     * Ledger-internal flag — see `RepositoryContext._ledgerInternal`.
+     * Typed here so ledger's repo methods can pass it without casts.
+     * Consumers should never set this directly.
+     */
+    _ledgerInternal?: LedgerInternalOp;
+  }
+}
+//#endregion
 //#region src/plugins/double-entry.plugin.d.ts
 interface DoubleEntryPluginOptions {
   /** Only enforce on posted entries (default: true) */

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 {