@classytic/ledger 0.5.0 → 0.6.0

package/dist/{fiscal-close-Dk3yRT9i.mjs → partner-ledger-D9H5hegI.mjs}

@@ -1,4 +1,4 @@
-import { n as Errors } from "./errors-BmRjW38t.mjs";
+import { n as Errors } from "./errors-CSDQPNyt.mjs";
 import { i as extractMainType } from "./categories-BkKdv16V.mjs";
 import mongoose from "mongoose";
 //#region src/utils/tenant-guard.ts
@@ -1519,7 +1519,7 @@ async function closeFiscalPeriod(opts, params) {
 		if (orgField && organizationId) periodQuery[orgField] = organizationId;
 		const period = await FiscalPeriodModel.findOne(periodQuery, null, queryOpts).lean();
 		if (!period) throw Errors.notFound("Fiscal period not found");
-		if (period.closed) throw Errors.fiscal("Fiscal period is already closed");
+		if (period.closed) throw Errors.locked("fiscal", "Fiscal period is already closed");
 		const startDate = period.startDate;
 		const endDate = period.endDate;
 		const accountQuery = { active: true };
@@ -1538,7 +1538,7 @@ async function closeFiscalPeriod(opts, params) {
 				isIncome: at.category === "Income Statement-Income"
 			});
 		}
-		if (!retainedEarningsId) throw Errors.fiscal(`Retained earnings account (code: ${retainedEarningsAccountCode}) not found. Create this account before closing the fiscal period.`);
+		if (!retainedEarningsId) throw Errors.locked("fiscal", `Retained earnings account (code: ${retainedEarningsAccountCode}) not found. Create this account before closing the fiscal period.`);
 		const baseMatch = {
 			state: "posted",
 			date: {
@@ -1630,13 +1630,13 @@ async function reopenFiscalPeriod(opts, params) {
 		if (orgField && organizationId) periodQuery[orgField] = organizationId;
 		const period = await FiscalPeriodModel.findOne(periodQuery, null, queryOpts).lean();
 		if (!period) throw Errors.notFound("Fiscal period not found");
-		if (!period.closed) throw Errors.fiscal("Fiscal period is not closed");
+		if (!period.closed) throw Errors.locked("fiscal", "Fiscal period is not closed");
 		const laterQuery = {
 			closed: true,
 			startDate: { $gt: period.endDate }
 		};
 		if (orgField && organizationId) laterQuery[orgField] = organizationId;
-		if (await FiscalPeriodModel.findOne(laterQuery, null, queryOpts).lean()) throw Errors.fiscal("Cannot reopen: a later fiscal period is already closed. Reopen later periods first.");
+		if (await FiscalPeriodModel.findOne(laterQuery, null, queryOpts).lean()) throw Errors.locked("fiscal", "Cannot reopen: a later fiscal period is already closed. Reopen later periods first.");
 		const closingEntryId = period.closingEntryId ?? null;
 		if (closingEntryId) await JournalEntryModel.findByIdAndDelete(closingEntryId, queryOpts);
 		const reopenedAt = /* @__PURE__ */ new Date();
@@ -1660,4 +1660,141 @@ async function reopenFiscalPeriod(opts, params) {
 	}
 }
 //#endregion
-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 };
+//#region src/reports/partner-ledger.ts
+async function generatePartnerLedger(opts, params) {
+	const { AccountModel, JournalEntryModel, orgField } = opts;
+	const { controlAccountId, partnerField = "partnerId", partnerId, startDate, endDate, includeMatched = true, buckets = DEFAULT_BUCKETS } = params;
+	requireOrgScope(orgField, params.organizationId);
+	const accountDoc = await AccountModel.findById(controlAccountId).lean();
+	const openingMatch = {
+		state: "posted",
+		date: { $lt: startDate }
+	};
+	if (orgField && params.organizationId) openingMatch[orgField] = params.organizationId;
+	const openingPipeline = [
+		{ $match: openingMatch },
+		{ $unwind: "$journalItems" },
+		{ $match: {
+			"journalItems.account": controlAccountId,
+			[`journalItems.${partnerField}`]: partnerId
+		} },
+		{ $group: {
+			_id: null,
+			debit: { $sum: { $ifNull: ["$journalItems.debit", 0] } },
+			credit: { $sum: { $ifNull: ["$journalItems.credit", 0] } }
+		} }
+	];
+	const openingResult = await JournalEntryModel.aggregate(openingPipeline);
+	const openingBalance = (openingResult[0]?.debit ?? 0) - (openingResult[0]?.credit ?? 0);
+	const periodMatch = {
+		state: "posted",
+		date: {
+			$gte: startDate,
+			$lte: endDate
+		}
+	};
+	if (orgField && params.organizationId) periodMatch[orgField] = params.organizationId;
+	const itemMatch = {
+		"journalItems.account": controlAccountId,
+		[`journalItems.${partnerField}`]: partnerId
+	};
+	if (!includeMatched) itemMatch.$or = [{ "journalItems.matchingNumber": null }, { "journalItems.matchingNumber": { $exists: false } }];
+	const linePipeline = [
+		{ $match: periodMatch },
+		{ $addFields: { journalItems: { $map: {
+			input: { $range: [0, { $size: "$journalItems" }] },
+			as: "idx",
+			in: { $mergeObjects: [{ $arrayElemAt: ["$journalItems", "$$idx"] }, { _itemIndex: "$$idx" }] }
+		} } } },
+		{ $unwind: "$journalItems" },
+		{ $match: itemMatch },
+		{ $project: {
+			_id: 0,
+			entry: "$_id",
+			itemIndex: "$journalItems._itemIndex",
+			date: { $ifNull: ["$journalItems.date", "$date"] },
+			referenceNumber: 1,
+			label: "$journalItems.label",
+			debit: { $ifNull: ["$journalItems.debit", 0] },
+			credit: { $ifNull: ["$journalItems.credit", 0] },
+			signedDelta: { $subtract: [{ $ifNull: ["$journalItems.debit", 0] }, { $ifNull: ["$journalItems.credit", 0] }] },
+			matchingNumber: "$journalItems.matchingNumber",
+			maturityDate: "$journalItems.maturityDate"
+		} },
+		{ $sort: {
+			date: 1,
+			entry: 1,
+			itemIndex: 1
+		} },
+		{ $setWindowFields: {
+			sortBy: {
+				date: 1,
+				entry: 1,
+				itemIndex: 1
+			},
+			output: { runningDelta: {
+				$sum: "$signedDelta",
+				window: { documents: ["unbounded", "current"] }
+			} }
+		} }
+	];
+	const rawLines = await JournalEntryModel.aggregate(linePipeline);
+	const endMs = endDate.getTime();
+	const lines = rawLines.map((r) => {
+		const matchingNumber = r.matchingNumber ?? null;
+		const maturityDate = r.maturityDate ?? null;
+		const daysPastDue = maturityDate ? Math.max(0, Math.floor((endMs - new Date(maturityDate).getTime()) / 864e5)) : null;
+		return {
+			date: r.date,
+			entry: r.entry,
+			itemIndex: r.itemIndex,
+			referenceNumber: r.referenceNumber,
+			label: r.label,
+			debit: r.debit,
+			credit: r.credit,
+			balance: openingBalance + r.runningDelta,
+			matchingNumber,
+			maturityDate,
+			daysPastDue,
+			isMatched: matchingNumber != null
+		};
+	});
+	const closingBalance = lines.length > 0 ? lines[lines.length - 1].balance : openingBalance;
+	let openItemsTotal = 0;
+	let matchedTotal = 0;
+	for (const l of lines) {
+		const delta = l.debit - l.credit;
+		if (l.isMatched) matchedTotal += delta;
+		else openItemsTotal += delta;
+	}
+	const agedBuckets = Object.fromEntries(buckets.map((b) => [b.label, 0]));
+	for (const l of lines) {
+		if (l.isMatched) continue;
+		const days = l.daysPastDue ?? 0;
+		const bucket = buckets.find((b) => days >= b.minDays && days < b.maxDays);
+		if (bucket) agedBuckets[bucket.label] += l.debit - l.credit;
+	}
+	return {
+		metadata: {
+			generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			partnerId,
+			controlAccount: {
+				id: controlAccountId,
+				name: accountDoc?.name,
+				code: accountDoc?.accountNumber
+			},
+			period: {
+				startDate: startDate.toISOString().split("T")[0],
+				endDate: endDate.toISOString().split("T")[0]
+			}
+		},
+		openingBalance,
+		closingBalance,
+		openItemsTotal,
+		matchedTotal,
+		lines,
+		agedBuckets
+	};
+}
+//#endregion
+export { isVirtualTaxAccount as C, requireOrgScope as E, computeEndingBalance as S, generateAgedBalance as T, buildItemFilters as _, finalizeSession as a, buildAccountTypeMap as b, generateRevaluation as c, generateIncomeStatement as d, generateGeneralLedger as f, generateBalanceSheet as g, generateBudgetVsActual as h, acquireSession as i, buildRevaluationEntry as l, generateCashFlow as m, closeFiscalPeriod as n, defaultLogger as o, generateDimensionBreakdown as p, reopenFiscalPeriod as r, generateTrialBalance as s, generatePartnerLedger as t, computeRevaluation as u, getDateRange as v, DEFAULT_BUCKETS as w, calculateTotal as x, getFiscalYearStart as y };

package/dist/plugins/index.d.mts

@@ -1,28 +1,6 @@
-import { a as DoubleEntryPluginOptions, c as dateLockPlugin, i as fiscalLockPlugin, n as idempotencyPlugin, o as doubleEntryPlugin, r as FiscalLockPluginOptions, s as DateLockPluginOptions, t as IdempotencyPluginOptions } from "../idempotency.plugin-CK7LHnBn.mjs";
+import { C as DoubleEntryPluginOptions, E as creditLimitPlugin, S as fxRealizationPlugin, T as CreditLimitPluginOptions, _ as LockResolver, a as DailyLockPluginOptions, b as idempotencyPlugin, c as dailyLockPlugin, d as PeriodResolverOptions, f as periodResolver, g as LockHit, h as LockAccountSelector, i as watermarkResolver, l as fiscalLockPlugin, m as CreateLockPluginOptions, o as FiscalLockPluginOptions, p as createLockPlugin, r as WatermarkResolverOptions, s as TaxLockPluginOptions, t as TaxLineGenerator, u as taxLockPlugin, v as LockResolverContext, w as doubleEntryPlugin, x as FxRealizationPluginOptions, y as IdempotencyPluginOptions } from "../tax-hooks-BnVenul5.mjs";
 import { RepositoryInstance } from "@classytic/mongokit";
 
-//#region src/utils/tax-hooks.d.ts
-interface TaxLineInput {
-  account: unknown;
-  amount: number;
-  side: 'debit' | 'credit';
-  taxCode?: string;
-  extraFields?: Record<string, unknown>;
-}
-interface GeneratedTaxLine {
-  account: unknown;
-  debit: number;
-  credit: number;
-  label?: string;
-  taxDetails?: Array<{
-    taxCode: string;
-    taxName?: string;
-  }>;
-}
-interface TaxLineGenerator {
-  generateTaxLines(input: TaxLineInput): GeneratedTaxLine[];
-}
-//#endregion
 //#region src/plugins/tax-hook.plugin.d.ts
 interface TaxHookPluginOptions {
   /** Tax line generator — implements the tax calculation logic */
@@ -35,4 +13,4 @@ declare function taxHookPlugin(options: TaxHookPluginOptions): {
   apply(repo: RepositoryInstance): void;
 };
 //#endregion
-export { type DateLockPluginOptions, type DoubleEntryPluginOptions, type FiscalLockPluginOptions, type IdempotencyPluginOptions, type TaxHookPluginOptions, dateLockPlugin, doubleEntryPlugin, fiscalLockPlugin, idempotencyPlugin, taxHookPlugin };
+export { type CreateLockPluginOptions, type CreditLimitPluginOptions, type DailyLockPluginOptions, type DoubleEntryPluginOptions, type FiscalLockPluginOptions, type FxRealizationPluginOptions, type IdempotencyPluginOptions, type LockAccountSelector, type LockHit, type LockResolver, type LockResolverContext, type PeriodResolverOptions, type TaxHookPluginOptions, type TaxLockPluginOptions, type WatermarkResolverOptions, createLockPlugin, creditLimitPlugin, dailyLockPlugin, doubleEntryPlugin, fiscalLockPlugin, fxRealizationPlugin, idempotencyPlugin, periodResolver, taxHookPlugin, taxLockPlugin, watermarkResolver };

package/dist/plugins/index.mjs

@@ -1,4 +1,4 @@
-import { i as doubleEntryPlugin, n as idempotencyPlugin, r as fiscalLockPlugin, t as dateLockPlugin } from "../date-lock.plugin-B2Jy0ukX.mjs";
+import { a as taxLockPlugin, c as createLockPlugin, i as fiscalLockPlugin, l as idempotencyPlugin, n as creditLimitPlugin, o as watermarkResolver, r as dailyLockPlugin, s as periodResolver, t as fxRealizationPlugin, u as doubleEntryPlugin } from "../fx-realization.plugin-CgQFDGv2.mjs";
 //#region src/utils/tax-hooks.ts
 /**
 * Apply a tax hook to journal items.
@@ -54,4 +54,4 @@ function taxHookPlugin(options) {
 	};
 }
 //#endregion
-export { dateLockPlugin, doubleEntryPlugin, fiscalLockPlugin, idempotencyPlugin, taxHookPlugin };
+export { createLockPlugin, creditLimitPlugin, dailyLockPlugin, doubleEntryPlugin, fiscalLockPlugin, fxRealizationPlugin, idempotencyPlugin, periodResolver, taxHookPlugin, taxLockPlugin, watermarkResolver };

package/dist/reports/index.d.mts

@@ -1,2 +1,2 @@
-import { $ as AgedBucketConfig, A as BudgetVsActualReport, C as DimensionBreakdownReport, D as generateCashFlow, E as CashFlowOptions, M as generateBudgetVsActual, N as BalanceSheetOptions, O as BudgetVsActualOptions, P as generateBalanceSheet, Q as AgedBalanceRow, S as DimensionBreakdownParams, T as generateDimensionBreakdown, X as AgedBalanceParams, Y as AgedBalanceOptions, Z as AgedBalanceReport, _ as FiscalCloseResult, a as RevaluationReport, b as reopenFiscalPeriod, et as DEFAULT_BUCKETS, f as IncomeStatementOptions, g as FiscalCloseOptions, h as generateGeneralLedger, i as RevaluationParams, j as BudgetVsActualRow, k as BudgetVsActualParams, m as GeneralLedgerOptions, n as generateTrialBalance, o as generateRevaluation, p as generateIncomeStatement, r as RevaluationOptions, t as TrialBalanceOptions, tt as generateAgedBalance, v as FiscalReopenResult, w as DimensionBreakdownRow, x as DimensionBreakdownOptions, y as closeFiscalPeriod } from "../trial-balance-BZ7yOOFD.mjs";
-export { type AgedBalanceOptions, type AgedBalanceParams, type AgedBalanceReport, type AgedBalanceRow, type AgedBucketConfig, type BalanceSheetOptions, type BudgetVsActualOptions, type BudgetVsActualParams, type BudgetVsActualReport, type BudgetVsActualRow, type CashFlowOptions, DEFAULT_BUCKETS, type DimensionBreakdownOptions, type DimensionBreakdownParams, type DimensionBreakdownReport, type DimensionBreakdownRow, type FiscalCloseOptions, type FiscalCloseResult, type FiscalReopenResult, type GeneralLedgerOptions, type IncomeStatementOptions, type RevaluationOptions, type RevaluationParams, type RevaluationReport, type TrialBalanceOptions, closeFiscalPeriod, generateAgedBalance, generateBalanceSheet, generateBudgetVsActual, generateCashFlow, generateDimensionBreakdown, generateGeneralLedger, generateIncomeStatement, generateRevaluation, generateTrialBalance, reopenFiscalPeriod };
+import { A as generateDimensionBreakdown, C as FiscalReopenResult, D as DimensionBreakdownParams, E as DimensionBreakdownOptions, F as BudgetVsActualReport, I as BudgetVsActualRow, L as generateBudgetVsActual, M as generateCashFlow, N as BudgetVsActualOptions, O as DimensionBreakdownReport, P as BudgetVsActualParams, R as BalanceSheetOptions, S as FiscalCloseResult, T as reopenFiscalPeriod, _ as IncomeStatementOptions, a as RevaluationReport, at as DEFAULT_BUCKETS, b as generateGeneralLedger, et as AgedBalanceOptions, f as PartnerLedgerLine, g as generatePartnerLedger, h as PartnerLedgerReport, i as RevaluationParams, it as AgedBucketConfig, j as CashFlowOptions, k as DimensionBreakdownRow, m as PartnerLedgerParams, n as generateTrialBalance, nt as AgedBalanceReport, o as generateRevaluation, ot as generateAgedBalance, p as PartnerLedgerOptions, r as RevaluationOptions, rt as AgedBalanceRow, t as TrialBalanceOptions, tt as AgedBalanceParams, v as generateIncomeStatement, w as closeFiscalPeriod, x as FiscalCloseOptions, y as GeneralLedgerOptions, z as generateBalanceSheet } from "../trial-balance-s92GEvRR.mjs";
+export { type AgedBalanceOptions, type AgedBalanceParams, type AgedBalanceReport, type AgedBalanceRow, type AgedBucketConfig, type BalanceSheetOptions, type BudgetVsActualOptions, type BudgetVsActualParams, type BudgetVsActualReport, type BudgetVsActualRow, type CashFlowOptions, DEFAULT_BUCKETS, type DimensionBreakdownOptions, type DimensionBreakdownParams, type DimensionBreakdownReport, type DimensionBreakdownRow, type FiscalCloseOptions, type FiscalCloseResult, type FiscalReopenResult, type GeneralLedgerOptions, type IncomeStatementOptions, type PartnerLedgerLine, type PartnerLedgerOptions, type PartnerLedgerParams, type PartnerLedgerReport, type RevaluationOptions, type RevaluationParams, type RevaluationReport, type TrialBalanceOptions, closeFiscalPeriod, generateAgedBalance, generateBalanceSheet, generateBudgetVsActual, generateCashFlow, generateDimensionBreakdown, generateGeneralLedger, generateIncomeStatement, generatePartnerLedger, generateRevaluation, generateTrialBalance, reopenFiscalPeriod };

package/dist/reports/index.mjs

@@ -1,2 +1,2 @@
-import { C as DEFAULT_BUCKETS, d as generateGeneralLedger, f as generateDimensionBreakdown, h as generateBalanceSheet, m as generateBudgetVsActual, n as reopenFiscalPeriod, o as generateTrialBalance, p as generateCashFlow, s as generateRevaluation, t as closeFiscalPeriod, u as generateIncomeStatement, w as generateAgedBalance } from "../fiscal-close-Dk3yRT9i.mjs";
-export { DEFAULT_BUCKETS, closeFiscalPeriod, generateAgedBalance, generateBalanceSheet, generateBudgetVsActual, generateCashFlow, generateDimensionBreakdown, generateGeneralLedger, generateIncomeStatement, generateRevaluation, generateTrialBalance, reopenFiscalPeriod };
+import { T as generateAgedBalance, c as generateRevaluation, d as generateIncomeStatement, f as generateGeneralLedger, g as generateBalanceSheet, h as generateBudgetVsActual, m as generateCashFlow, n as closeFiscalPeriod, p as generateDimensionBreakdown, r as reopenFiscalPeriod, s as generateTrialBalance, t as generatePartnerLedger, w as DEFAULT_BUCKETS } from "../partner-ledger-D9H5hegI.mjs";
+export { DEFAULT_BUCKETS, closeFiscalPeriod, generateAgedBalance, generateBalanceSheet, generateBudgetVsActual, generateCashFlow, generateDimensionBreakdown, generateGeneralLedger, generateIncomeStatement, generatePartnerLedger, generateRevaluation, generateTrialBalance, reopenFiscalPeriod };