@classytic/ledger 0.5.1 → 0.7.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,38 +1,2 @@
-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-WcQLZU9n.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 */
-  generator: TaxLineGenerator;
-  /** Only apply tax hooks on posted entries (default: true) */
-  onlyOnPost?: boolean;
-}
-declare function taxHookPlugin(options: TaxHookPluginOptions): {
-  name: string;
-  apply(repo: RepositoryInstance): void;
-};
-//#endregion
-export { type DateLockPluginOptions, type DoubleEntryPluginOptions, type FiscalLockPluginOptions, type IdempotencyPluginOptions, type TaxHookPluginOptions, dateLockPlugin, doubleEntryPlugin, fiscalLockPlugin, idempotencyPlugin, taxHookPlugin };
+import { S as creditLimitPlugin, _ as FxRealizationPluginOptions, a as dailyLockPlugin, b as doubleEntryPlugin, c as periodResolver, d as LockAccountSelector, f as LockHit, g as idempotencyPlugin, h as IdempotencyPluginOptions, i as FiscalLockPluginOptions, l as createLockPlugin, m as LockResolverContext, n as watermarkResolver, o as fiscalLockPlugin, p as LockResolver, r as DailyLockPluginOptions, s as PeriodResolverOptions, t as WatermarkResolverOptions, u as CreateLockPluginOptions, v as fxRealizationPlugin, x as CreditLimitPluginOptions, y as DoubleEntryPluginOptions } from "../index-Bl0_ak5w.mjs";
+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 WatermarkResolverOptions, createLockPlugin, creditLimitPlugin, dailyLockPlugin, doubleEntryPlugin, fiscalLockPlugin, fxRealizationPlugin, idempotencyPlugin, periodResolver, watermarkResolver };

package/dist/plugins/index.mjs

@@ -1,57 +1,2 @@
-import { i as doubleEntryPlugin, n as idempotencyPlugin, r as fiscalLockPlugin, t as dateLockPlugin } from "../date-lock.plugin-B6WyvqNG.mjs";
-//#region src/utils/tax-hooks.ts
-/**
-* Apply a tax hook to journal items.
-*
-* Iterates each item that has a taxCode in taxDetails, calls
-* `generator.generateTaxLines` for each, and appends the generated
-* tax lines as new journal items.
-*
-* @returns The original items + generated tax items
-*/
-function applyTaxHook(items, generator) {
-	const taxLines = [];
-	for (const item of items) {
-		const taxDetails = item.taxDetails;
-		if (!taxDetails || taxDetails.length === 0) continue;
-		const taxCode = taxDetails.find((td) => td.taxCode != null)?.taxCode;
-		if (!taxCode) continue;
-		const side = item.debit > 0 ? "debit" : "credit";
-		const amount = item.debit > 0 ? item.debit : item.credit;
-		const input = {
-			account: item.account,
-			amount,
-			side,
-			taxCode
-		};
-		const generated = generator.generateTaxLines(input);
-		for (const line of generated) taxLines.push({
-			account: line.account,
-			debit: line.debit,
-			credit: line.credit,
-			label: line.label,
-			taxDetails: line.taxDetails
-		});
-	}
-	return [...items, ...taxLines];
-}
-//#endregion
-//#region src/plugins/tax-hook.plugin.ts
-function taxHookPlugin(options) {
-	const { generator, onlyOnPost = true } = options;
-	return {
-		name: "accounting:tax-hook",
-		apply(repo) {
-			repo.on("before:create", (context) => {
-				const data = context.data;
-				if (!data) return;
-				if (onlyOnPost && data.state !== "posted") return;
-				const items = data.journalItems;
-				if (!items || items.length === 0) return;
-				data.journalItems = applyTaxHook(items, generator);
-			});
-		}
-	};
-}
-//#endregion
-export { dateLockPlugin, doubleEntryPlugin, fiscalLockPlugin, idempotencyPlugin, taxHookPlugin };
+import { a as watermarkResolver, c as idempotencyPlugin, i as fiscalLockPlugin, l as doubleEntryPlugin, n as creditLimitPlugin, o as periodResolver, r as dailyLockPlugin, s as createLockPlugin, t as fxRealizationPlugin } from "../fx-realization.plugin-CfYy1tB6.mjs";
+export { createLockPlugin, creditLimitPlugin, dailyLockPlugin, doubleEntryPlugin, fiscalLockPlugin, fxRealizationPlugin, idempotencyPlugin, periodResolver, 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 { $ as AgedBalanceParams, 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, Q as AgedBalanceOptions, R as BalanceSheetOptions, S as FiscalCloseResult, T as reopenFiscalPeriod, _ as IncomeStatementOptions, a as RevaluationReport, b as generateGeneralLedger, et as AgedBalanceReport, f as PartnerLedgerLine, g as generatePartnerLedger, h as PartnerLedgerReport, i as RevaluationParams, it as generateAgedBalance, j as CashFlowOptions, k as DimensionBreakdownRow, m as PartnerLedgerParams, n as generateTrialBalance, nt as AgedBucketConfig, o as generateRevaluation, p as PartnerLedgerOptions, r as RevaluationOptions, rt as DEFAULT_BUCKETS, t as TrialBalanceOptions, tt as AgedBalanceRow, v as generateIncomeStatement, w as closeFiscalPeriod, x as FiscalCloseOptions, y as GeneralLedgerOptions, z as generateBalanceSheet } from "../trial-balance-DTc8kzTD.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 };

package/dist/{trial-balance-BZ7yOOFD.d.mts → trial-balance-DTc8kzTD.d.mts}

@@ -1,5 +1,5 @@
 import { c as DateRange } from "./core-BkGjuVZj.mjs";
-import { t as CountryPack } from "./index-GmfEFxVn.mjs";
+import { t as CountryPack } from "./index-BX8miYdu.mjs";
 import { ClientSession, Model } from "mongoose";
 
 //#region src/utils/logger.d.ts
@@ -178,37 +178,6 @@ interface CashFlowReport {
   financing: CashFlowSection;
   netCashFlow: number;
 }
-interface TaxAccountBalance {
-  code: string;
-  name: string;
-  balance: number;
-  taxMetadata?: unknown;
-}
-interface TaxReturnSummary {
-  totalSales: number;
-  gstHstCollected: number;
-  inputTaxCredits: number;
-  netTax: number;
-  finalAmount: number;
-  isRefund: boolean;
-  refundAmount: number;
-  paymentAmount: number;
-}
-interface TaxReport {
-  period: {
-    startDate: string;
-    endDate: string;
-    province: string;
-  };
-  accountBalances: {
-    collected: Record<string, TaxAccountBalance>;
-    itc: Record<string, TaxAccountBalance>;
-    instalments: Record<string, TaxAccountBalance>;
-  };
-  craLines: Record<string | number, number>;
-  summary: TaxReturnSummary;
-  calculatedAt: string;
-}
 //#endregion
 //#region src/reports/balance-sheet.d.ts
 interface BalanceSheetOptions {
@@ -403,6 +372,79 @@ declare function generateIncomeStatement(opts: IncomeStatementOptions, params: {
   filters?: Record<string, unknown>;
 }): Promise<IncomeStatementReport>;
 //#endregion
+//#region src/reports/partner-ledger.d.ts
+interface PartnerLedgerOptions {
+  AccountModel: Model<unknown>;
+  JournalEntryModel: Model<unknown>;
+  orgField?: string;
+}
+interface PartnerLedgerParams {
+  organizationId?: unknown;
+  /**
+   * The control account being ledgered — typically `2111 A/P`
+   * (supplier statement) or `1141 A/R` (customer statement).
+   */
+  controlAccountId: unknown;
+  /**
+   * Field name on each journal item that holds the partner reference.
+   * Default: `'partnerId'`. Whatever you declared in
+   * `schemaOptions.journalEntry.extraItemFields`.
+   */
+  partnerField?: string;
+  /**
+   * The specific partner whose statement we're generating. Required —
+   * to get all partners use `generateAgedBalance` instead.
+   */
+  partnerId: unknown;
+  startDate: Date;
+  endDate: Date;
+  /**
+   * If true, include items already matched (settled) inside the period.
+   * Default: true — statements show settled activity in the period.
+   */
+  includeMatched?: boolean;
+  /** Custom aged buckets for the open-items summary. */
+  buckets?: AgedBucketConfig[];
+}
+interface PartnerLedgerLine {
+  date: Date;
+  entry: unknown;
+  itemIndex: number;
+  referenceNumber?: string;
+  label?: string;
+  debit: number;
+  credit: number;
+  /** Running balance (debit - credit, signed) including this row. */
+  balance: number;
+  matchingNumber: string | null;
+  maturityDate?: Date | null;
+  /** Days past `maturityDate` as of `endDate`; null if no maturity set. */
+  daysPastDue: number | null;
+  isMatched: boolean;
+}
+interface PartnerLedgerReport {
+  metadata: {
+    generatedAt: string;
+    partnerId: unknown;
+    controlAccount: {
+      id: unknown;
+      name?: string;
+      code?: string;
+    };
+    period: {
+      startDate: string;
+      endDate: string;
+    };
+  };
+  openingBalance: number;
+  closingBalance: number;
+  openItemsTotal: number;
+  matchedTotal: number;
+  lines: PartnerLedgerLine[];
+  agedBuckets: Record<string, number>;
+}
+declare function generatePartnerLedger(opts: PartnerLedgerOptions, params: PartnerLedgerParams): Promise<PartnerLedgerReport>;
+//#endregion
 //#region src/utils/revaluation.d.ts
 /**
  * Foreign Exchange Revaluation Utilities
@@ -539,4 +581,4 @@ declare function generateTrialBalance(opts: TrialBalanceOptions, params: {
   filters?: Record<string, unknown>;
 }): Promise<TrialBalanceReport>;
 //#endregion
-export { AgedBucketConfig as $, BudgetVsActualReport as A, IncomeStatementReport as B, DimensionBreakdownReport as C, generateCashFlow as D, CashFlowOptions as E, BalanceSheetReport as F, TaxReport as G, ReportAccount as H, CashFlowReport as I, TrialBalanceRow as J, TaxReturnSummary as K, CashFlowSection as L, generateBudgetVsActual as M, BalanceSheetOptions as N, BudgetVsActualOptions as O, generateBalanceSheet as P, AgedBalanceRow as Q, GeneralLedgerAccount as R, DimensionBreakdownParams as S, generateDimensionBreakdown as T, ReportCategory as U, LedgerEntry as V, ReportGroup as W, AgedBalanceParams as X, AgedBalanceOptions as Y, AgedBalanceReport as Z, FiscalCloseResult as _, RevaluationReport as a, reopenFiscalPeriod as b, RevaluationRate as c, computeRevaluation as d, DEFAULT_BUCKETS as et, IncomeStatementOptions as f, FiscalCloseOptions as g, generateGeneralLedger as h, RevaluationParams as i, BudgetVsActualRow as j, BudgetVsActualParams as k, RevaluationResult as l, GeneralLedgerOptions as m, generateTrialBalance as n, Logger as nt, generateRevaluation as o, generateIncomeStatement as p, TrialBalanceReport as q, RevaluationOptions as r, defaultLogger as rt, AccountForeignBalance as s, TrialBalanceOptions as t, generateAgedBalance as tt, buildRevaluationEntry as u, FiscalReopenResult as v, DimensionBreakdownRow as w, DimensionBreakdownOptions as x, closeFiscalPeriod as y, GeneralLedgerReport as z };
+export { AgedBalanceParams as $, generateDimensionBreakdown as A, BalanceSheetReport as B, FiscalReopenResult as C, DimensionBreakdownParams as D, DimensionBreakdownOptions as E, BudgetVsActualReport as F, IncomeStatementReport as G, CashFlowSection as H, BudgetVsActualRow as I, ReportCategory as J, LedgerEntry as K, generateBudgetVsActual as L, generateCashFlow as M, BudgetVsActualOptions as N, DimensionBreakdownReport as O, BudgetVsActualParams as P, AgedBalanceOptions as Q, BalanceSheetOptions as R, FiscalCloseResult as S, reopenFiscalPeriod as T, GeneralLedgerAccount as U, CashFlowReport as V, GeneralLedgerReport as W, TrialBalanceReport as X, ReportGroup as Y, TrialBalanceRow as Z, IncomeStatementOptions as _, RevaluationReport as a, Logger as at, generateGeneralLedger as b, RevaluationRate as c, computeRevaluation as d, AgedBalanceReport as et, PartnerLedgerLine as f, generatePartnerLedger as g, PartnerLedgerReport as h, RevaluationParams as i, generateAgedBalance as it, CashFlowOptions as j, DimensionBreakdownRow as k, RevaluationResult as l, PartnerLedgerParams as m, generateTrialBalance as n, AgedBucketConfig as nt, generateRevaluation as o, defaultLogger as ot, PartnerLedgerOptions as p, ReportAccount as q, RevaluationOptions as r, DEFAULT_BUCKETS as rt, AccountForeignBalance as s, TrialBalanceOptions as t, AgedBalanceRow as tt, buildRevaluationEntry as u, generateIncomeStatement as v, closeFiscalPeriod as w, FiscalCloseOptions as x, GeneralLedgerOptions as y, generateBalanceSheet as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/ledger",
-  "version": "0.5.1",
+  "version": "0.7.0",
   "description": "Production-grade double-entry accounting engine for MongoDB — schemas, reports, tax, multi-tenant",
   "type": "module",
   "sideEffects": false,
@@ -78,7 +78,7 @@
     "url": "git+https://github.com/classytic/accounting.git"
   },
   "peerDependencies": {
-    "@classytic/mongokit": ">=3.5.3",
+    "@classytic/mongokit": ">=3.5.5",
     "mongoose": ">=9.4.1"
   },
   "engines": {
@@ -96,12 +96,13 @@
     "format": "biome format src/ --write",
     "check": "biome ci src/ --diagnostic-level=error",
     "knip": "knip",
-    "prepublishOnly": "npm run check && npm run build && npm run typecheck && npm test",
-    "release": "npm run check && npm run build && npm run typecheck && npm test && npm publish --access public"
+    "smoke": "node scripts/smoke.mjs",
+    "prepublishOnly": "npm run check && npm run build && npm run typecheck && npm test && npm run smoke",
+    "release": "npm run check && npm run build && npm run typecheck && npm test && npm run smoke && npm publish --access public"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.10",
-    "@classytic/mongokit": "^3.5.3",
+    "@classytic/mongokit": "^3.5.5",
     "@types/node": "^22.0.0",
     "@vitest/coverage-v8": "^3.2.4",
     "knip": "^6.3.0",