@classytic/ledger 0.10.2 → 0.11.0

package/dist/plugins/index.d.mts

@@ -1,2 +1,2 @@
-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-ClLwzNRF.mjs";
+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-BFPFihTF.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,2 +1,2 @@
-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-Dzqzi3u0.mjs";
+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-DY3pPxIi.mjs";
 export { createLockPlugin, creditLimitPlugin, dailyLockPlugin, doubleEntryPlugin, fiscalLockPlugin, fxRealizationPlugin, idempotencyPlugin, periodResolver, watermarkResolver };

package/dist/reports/index.d.mts

@@ -1,2 +1,2 @@
-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-DyNm5bFu.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 };
+import { A as generateDimensionBreakdown, B as AgedBalanceOptions, C as FiscalReopenResult, D as DimensionBreakdownParams, E as DimensionBreakdownOptions, F as BudgetVsActualReport, G as DEFAULT_BUCKETS, H as AgedBalanceReport, I as BudgetVsActualRow, K as generateAgedBalance, L as generateBudgetVsActual, M as generateCashFlow, N as BudgetVsActualOptions, O as DimensionBreakdownReport, P as BudgetVsActualParams, R as BalanceSheetOptions, S as FiscalCloseResult, T as reopenFiscalPeriod, U as AgedBalanceRow, V as AgedBalanceParams, W as AgedBucketConfig, _ as IncomeStatementOptions, _t as DaybookOptions, a as RevaluationReport, b as generateGeneralLedger, bt as generateDaybook, f as PartnerLedgerLine, g as generatePartnerLedger, gt as DaybookLine, h as PartnerLedgerReport, i as RevaluationParams, j as CashFlowOptions, k as DimensionBreakdownRow, m as PartnerLedgerParams, n as generateTrialBalance, o as generateRevaluation, p as PartnerLedgerOptions, r as RevaluationOptions, t as TrialBalanceOptions, v as generateIncomeStatement, vt as DaybookParams, w as closeFiscalPeriod, x as FiscalCloseOptions, y as GeneralLedgerOptions, yt as DaybookReport, z as generateBalanceSheet } from "../trial-balance-UXV2PN6x.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 DaybookLine, type DaybookOptions, type DaybookParams, type DaybookReport, 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, generateDaybook, generateDimensionBreakdown, generateGeneralLedger, generateIncomeStatement, generatePartnerLedger, generateRevaluation, generateTrialBalance, reopenFiscalPeriod };

package/dist/reports/index.mjs

@@ -1,2 +1,2 @@
-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-CR0geilx.mjs";
-export { DEFAULT_BUCKETS, closeFiscalPeriod, generateAgedBalance, generateBalanceSheet, generateBudgetVsActual, generateCashFlow, generateDimensionBreakdown, generateGeneralLedger, generateIncomeStatement, generatePartnerLedger, generateRevaluation, generateTrialBalance, reopenFiscalPeriod };
+import { E as generateAgedBalance, T as DEFAULT_BUCKETS, _ as generateBalanceSheet, c as generateRevaluation, d as generateIncomeStatement, f as generateGeneralLedger, g as generateBudgetVsActual, h as generateCashFlow, m as generateDaybook, n as closeFiscalPeriod, p as generateDimensionBreakdown, r as reopenFiscalPeriod, s as generateTrialBalance, t as generatePartnerLedger } from "../partner-ledger-B0eym6Ss.mjs";
+export { DEFAULT_BUCKETS, closeFiscalPeriod, generateAgedBalance, generateBalanceSheet, generateBudgetVsActual, generateCashFlow, generateDaybook, generateDimensionBreakdown, generateGeneralLedger, generateIncomeStatement, generatePartnerLedger, generateRevaluation, generateTrialBalance, reopenFiscalPeriod };

package/dist/{trial-balance-DyNm5bFu.d.mts → trial-balance-UXV2PN6x.d.mts}

@@ -1,7 +1,72 @@
-import { c as DateRange } from "./core-DwjkrRkJ.mjs";
-import { t as CountryPack } from "./index-08IpHhrU.mjs";
+import { c as DateRange } from "./core-B7uVjqGS.mjs";
+import { t as CountryPack } from "./index-Dd7HknPP.mjs";
 import { ClientSession, Model } from "mongoose";
 
+//#region src/reports/daybook.d.ts
+interface DaybookOptions {
+  JournalEntryModel: Model<unknown>;
+  orgField?: string;
+}
+interface DaybookParams {
+  organizationId?: unknown;
+  startDate: Date;
+  endDate: Date;
+  /** Default `'posted'`. Pass `'draft'` or `'all'` to widen. */
+  state?: 'posted' | 'draft' | 'all';
+  /** Filter to one specific account (renders that account's daybook slice). */
+  accountId?: unknown;
+  /** Filter to one journal type (e.g. `'SALES'`, `'PURCHASES'`). */
+  journalType?: string;
+  /** Filter to one partner (item-level field). */
+  partnerId?: unknown;
+  /** Field name on each item that holds the partner reference. Default `partnerId`. */
+  partnerField?: string;
+  /** Hard cap on rows. Default 5000 — prevents accidental full-table dumps. */
+  limit?: number;
+}
+interface DaybookLine {
+  date: Date;
+  entryId: unknown;
+  itemIndex: number;
+  referenceNumber?: string;
+  journalType?: string;
+  entryLabel?: string;
+  itemLabel?: string;
+  state?: string;
+  accountId: unknown;
+  /** Item-level debit in minor units (paisa). */
+  debit: number;
+  /** Item-level credit in minor units (paisa). */
+  credit: number;
+  partnerId?: unknown;
+  matchingNumber?: string | null;
+}
+interface DaybookReport {
+  metadata: {
+    generatedAt: string;
+    period: {
+      startDate: string;
+      endDate: string;
+    };
+    state: string;
+    filters: {
+      accountId?: unknown;
+      journalType?: string;
+      partnerId?: unknown;
+    };
+    truncated: boolean;
+    rowCount: number;
+  };
+  lines: DaybookLine[];
+  /** Sum of debits across the returned slice (minor units). */
+  totalDebit: number;
+  /** Sum of credits across the returned slice (minor units). */
+  totalCredit: number;
+  /** Net = totalDebit − totalCredit. Posted-only slices should net to 0. */
+  netDelta: number;
+}
+declare function generateDaybook(opts: DaybookOptions, params: DaybookParams): Promise<DaybookReport>;
+//#endregion
 //#region src/utils/logger.d.ts
 /**
  * Minimal logger interface for the accounting package.
@@ -15,49 +80,6 @@ interface Logger {
 /** Default console-based implementation */
 declare const defaultLogger: Logger;
 //#endregion
-//#region src/reports/aged-balance.d.ts
-interface AgedBucketConfig {
-  label: string;
-  minDays: number;
-  maxDays: number;
-}
-declare const DEFAULT_BUCKETS: AgedBucketConfig[];
-interface AgedBalanceOptions {
-  AccountModel: Model<unknown>;
-  JournalEntryModel: Model<unknown>;
-  country: CountryPack;
-  orgField?: string;
-}
-interface AgedBalanceParams {
-  organizationId?: unknown;
-  asOfDate?: Date;
-  type: 'receivable' | 'payable';
-  accountIds?: unknown[];
-  dueDateField?: string;
-  contactField?: string;
-  buckets?: AgedBucketConfig[];
-}
-interface AgedBalanceRow {
-  accountId: unknown;
-  accountName: string;
-  accountCode: string;
-  contactId?: unknown;
-  total: number;
-  buckets: Record<string, number>;
-}
-interface AgedBalanceReport {
-  metadata: {
-    generatedAt: string;
-    asOfDate: string;
-    type: string;
-  };
-  bucketLabels: string[];
-  rows: AgedBalanceRow[];
-  totals: Record<string, number>;
-  grandTotal: number;
-}
-declare function generateAgedBalance(opts: AgedBalanceOptions, params: AgedBalanceParams): Promise<AgedBalanceReport>;
-//#endregion
 //#region src/types/report.d.ts
 interface ReportMetadata {
   businessName?: string;
@@ -82,6 +104,39 @@ interface ReportCategory {
   total: number;
   groups: ReportGroup[];
 }
+type ComparativeMode = 'monthly' | 'quarterly' | null;
+interface PeriodColumn {
+  /** Stable column key (e.g. '2026-01', '2026-Q2', 'total', '31-60'). */
+  key: string;
+  /** Human label shown in the column header (e.g. 'Jan 2026', 'Q2 2026'). */
+  label: string;
+  /**
+   * Column start boundary — ISO yyyy-mm-dd. Empty string for age buckets
+   * (`isAgeBucket: true`), since aging buckets represent age windows
+   * relative to `asOfDate`, not absolute date ranges.
+   */
+  startDate: string;
+  /**
+   * Column end boundary — ISO yyyy-mm-dd. Empty string for age buckets.
+   * Consumers should drive UI rendering off `isAgeBucket` + `label`, not
+   * `startDate`/`endDate`, when displaying aging columns.
+   */
+  endDate: string;
+  /** True for aggregate columns appended after detail columns. */
+  isTotal?: boolean;
+  /** True when the column is an aging bucket rather than a date period. */
+  isAgeBucket?: boolean;
+}
+interface ReportLine<TSource = Record<string, unknown>> {
+  label: string;
+  code: string;
+  amounts: Record<string, number>;
+  source: TSource;
+}
+interface ReportSection<TSource = Record<string, unknown>> {
+  totals: Record<string, number>;
+  lines: Array<ReportLine<TSource>>;
+}
 interface TrialBalanceRow {
   account: unknown;
   initial: {
@@ -97,45 +152,109 @@ interface TrialBalanceRow {
     credit: number;
   };
 }
+interface TrialBalanceColumnRow {
+  account: unknown;
+  initial: {
+    debit: Record<string, number>;
+    credit: Record<string, number>;
+  };
+  current: {
+    debit: Record<string, number>;
+    credit: Record<string, number>;
+  };
+  ending: {
+    debit: Record<string, number>;
+    credit: Record<string, number>;
+  };
+}
 interface TrialBalanceReport {
   metadata?: ReportMetadata & {
     periodStart: string;
     periodEnd: string;
     displayPeriod: string;
+    comparative?: ComparativeMode;
   };
-  rows: TrialBalanceRow[];
   period: DateRange;
+  periods: PeriodColumn[];
+  columnarRows: TrialBalanceColumnRow[];
 }
 interface BalanceSheetReport {
   metadata: ReportMetadata & {
     asOfDate: string;
     displayDate: string;
+    comparative?: ComparativeMode;
+    /**
+     * Display labels sourced from the country pack's `reportLabels`. FE
+     * renders section headers from these so the same engine output can
+     * power "Stockholders' Equity" (US) or "Owners' Equity" (UK) without
+     * a fork. Defaults: assets='Assets', liabilities='Liabilities', equity='Equity'.
+     */
+    labels?: {
+      assets?: string;
+      liabilities?: string;
+      equity?: string;
+    };
   };
-  assets: ReportCategory;
-  liabilities: ReportCategory;
-  equity: ReportCategory;
-  summary: {
-    totalAssets: number;
-    totalLiabilities: number;
-    totalEquity: number;
-    liabilitiesAndEquity: number;
-    difference: number;
-    isBalanced: boolean;
+  periods: PeriodColumn[];
+  summaryByPeriod: {
+    totalAssets: Record<string, number>;
+    totalLiabilities: Record<string, number>;
+    totalEquity: Record<string, number>;
+    liabilitiesAndEquity: Record<string, number>;
+    difference: Record<string, number>;
+    isBalanced: Record<string, boolean>;
   };
-}
+  assetsSection: BalanceSheetSection;
+  liabilitiesSection: BalanceSheetSection;
+  equitySection: BalanceSheetSection;
+}
+type BalanceSheetLineSource = {
+  kind: 'account';
+  accountId: string;
+  group: string;
+  section: 'assets' | 'liabilities' | 'equity';
+} | {
+  kind: 'calculated';
+  accountId: string;
+  group: string;
+  section: 'equity';
+};
+type BalanceSheetSection = ReportSection<BalanceSheetLineSource>;
 interface IncomeStatementReport {
   metadata: ReportMetadata & {
     periodStart: string;
     periodEnd: string;
     displayPeriod: string;
+    comparative?: ComparativeMode;
+    /**
+     * Display labels sourced from the country pack's `reportLabels`. Same
+     * shape as `BalanceSheetReport.metadata.labels`; powers section
+     * headers like "Net Revenue" (US) vs "Revenue" (default).
+     */
+    labels?: {
+      revenue?: string;
+      expenses?: string;
+    };
   };
-  revenue: ReportCategory;
-  costOfSales: number;
-  grossProfit: number;
-  expenses: ReportCategory;
-  operatingIncome: number;
-  netIncome: number;
-}
+  periods: PeriodColumn[];
+  revenueSection: IncomeStatementSection;
+  expensesSection: IncomeStatementSection;
+  summarySection: IncomeStatementSection;
+  costOfSalesByPeriod: Record<string, number>;
+  grossProfitByPeriod: Record<string, number>;
+  operatingIncomeByPeriod: Record<string, number>;
+  netIncomeByPeriod: Record<string, number>;
+}
+type IncomeStatementLineSource = {
+  kind: 'account';
+  accountId: string;
+  group: string;
+  statementType: 'revenue' | 'expense';
+} | {
+  kind: 'aggregate';
+  name: 'costOfSales' | 'grossProfit' | 'operatingIncome' | 'netIncome';
+};
+type IncomeStatementSection = ReportSection<IncomeStatementLineSource>;
 interface LedgerEntry {
   date: Date;
   referenceNumber: string;
@@ -159,25 +278,106 @@ interface GeneralLedgerReport {
   accounts: GeneralLedgerAccount[];
   period: DateRange;
 }
-interface CashFlowSection {
-  total: number;
-  accounts: Array<{
-    name: string;
-    code: string;
-    amount: number;
-  }>;
+/** Discriminator on each CashFlowLine — drives UI drill-down + section logic. */
+type CashFlowLineSource = {
+  kind: 'netIncome';
+} | {
+  kind: 'nonCashAdjustment';
+  tag: string;
+} | {
+  kind: 'workingCapital';
+  accountId: string;
+} | {
+  kind: 'directMovement';
+  accountId: string;
+} | {
+  kind: 'fxEffect';
+};
+/**
+ * One column of a comparative CFS — also used for single-period reports
+ * (in which case `periods` has a single entry with key `'total'`).
+ */
+type CashFlowPeriodColumn = PeriodColumn;
+type CashFlowSection = ReportSection<CashFlowLineSource>;
+/**
+ * Per-column reconciliation. `tieOutOk: false` means the algorithm has
+ * drifted from reality — fail-loud QA signal. Mirrors ERPNext's
+ * opening/closing balance reconciliation (cash_flow.py:282-308).
+ */
+interface CashFlowColumnReconciliation {
+  openingCash: number;
+  closingCash: number;
+  /** `openingCash + netCashFlow` — what closingCash should be. */
+  calculated: number;
+  /** `true` when |closingCash − calculated| ≤ 1 cent. */
+  tieOutOk: boolean;
 }
 interface CashFlowReport {
   metadata: ReportMetadata & {
     periodStart: string;
     periodEnd: string;
-    displayPeriod: string;
+    displayPeriod: string; /** Currency the report is denominated in. */
+    currency?: string; /** Comparative mode used to build the columns ('monthly' | 'quarterly' | null). */
+    comparative?: ComparativeMode;
   };
+  /** Column definitions in display order. Always at least one entry. */
+  periods: CashFlowPeriodColumn[];
+  /** Operating: Net Income + non-cash adjustments + ΔWorking Capital. */
   operating: CashFlowSection;
+  /** Investing: direct movements on fixed/non-current asset accounts. */
   investing: CashFlowSection;
+  /** Financing: direct movements on equity (excl. retained earnings) + non-current liabilities. */
   financing: CashFlowSection;
-  netCashFlow: number;
+  /** FX cash effect (IAS 7 §28 / ASC 230) per column. Zero for single-currency hosts. */
+  fxEffect: Record<string, number>;
+  /** Net change in cash per column = operating + investing + financing + fxEffect. */
+  netCashFlow: Record<string, number>;
+  /** Per-column tie-out against actual cash account balance deltas. */
+  cashReconciliation: Record<string, CashFlowColumnReconciliation>;
+}
+//#endregion
+//#region src/reports/aged-balance.d.ts
+interface AgedBucketConfig {
+  label: string;
+  minDays: number;
+  maxDays: number;
+}
+declare const DEFAULT_BUCKETS: AgedBucketConfig[];
+interface AgedBalanceOptions {
+  AccountModel: Model<unknown>;
+  JournalEntryModel: Model<unknown>;
+  country: CountryPack;
+  orgField?: string;
 }
+interface AgedBalanceParams {
+  organizationId?: unknown;
+  asOfDate?: Date;
+  type: 'receivable' | 'payable';
+  accountIds?: unknown[];
+  dueDateField?: string;
+  contactField?: string;
+  buckets?: AgedBucketConfig[];
+}
+interface AgedBalanceRow {
+  accountId: unknown;
+  accountName: string;
+  accountCode: string;
+  contactId?: unknown;
+  total: number;
+  amounts: Record<string, number>;
+}
+interface AgedBalanceReport {
+  metadata: {
+    generatedAt: string;
+    asOfDate: string;
+    type: string;
+  };
+  periods: PeriodColumn[];
+  rows: AgedBalanceRow[];
+  totals: Record<string, number>;
+  grandTotal: number;
+}
+declare function generateAgedBalance(opts: AgedBalanceOptions, params: AgedBalanceParams): Promise<AgedBalanceReport>;
 //#endregion
 //#region src/reports/balance-sheet.d.ts
 interface BalanceSheetOptions {
@@ -201,6 +401,7 @@ declare function generateBalanceSheet(opts: BalanceSheetOptions, params: {
   organizationId?: unknown;
   dateOption: 'month' | 'quarter' | 'year' | 'custom';
   dateValue: unknown;
+  comparative?: 'monthly' | 'quarterly' | null;
   businessName?: string;
   filters?: Record<string, unknown>;
 }): Promise<BalanceSheetReport>;
@@ -255,9 +456,11 @@ interface CashFlowOptions {
 declare function generateCashFlow(opts: CashFlowOptions, params: {
   organizationId?: unknown;
   dateOption: 'month' | 'quarter' | 'year' | 'custom';
-  dateValue: unknown;
+  dateValue: unknown; /** Expand the outer range into per-month or per-quarter columns + a YTD total. */
+  comparative?: 'monthly' | 'quarterly' | null;
   businessName?: string;
   filters?: Record<string, unknown>;
+  currency?: string;
 }): Promise<CashFlowReport>;
 //#endregion
 //#region src/reports/dimension-breakdown.d.ts
@@ -368,6 +571,7 @@ declare function generateIncomeStatement(opts: IncomeStatementOptions, params: {
   organizationId?: unknown;
   dateOption: 'month' | 'quarter' | 'year' | 'custom';
   dateValue: unknown;
+  comparative?: 'monthly' | 'quarterly' | null;
   businessName?: string;
   filters?: Record<string, unknown>;
 }): Promise<IncomeStatementReport>;
@@ -577,8 +781,9 @@ declare function generateTrialBalance(opts: TrialBalanceOptions, params: {
   dateOption: 'month' | 'quarter' | 'year' | 'custom';
   dateValue: unknown;
   accountId?: string;
+  comparative?: 'monthly' | 'quarterly' | null;
   businessName?: string;
   filters?: Record<string, unknown>;
 }): Promise<TrialBalanceReport>;
 //#endregion
-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 };
+export { GeneralLedgerAccount as $, generateDimensionBreakdown as A, AgedBalanceOptions as B, FiscalReopenResult as C, DimensionBreakdownParams as D, DimensionBreakdownOptions as E, BudgetVsActualReport as F, DEFAULT_BUCKETS as G, AgedBalanceReport as H, BudgetVsActualRow as I, BalanceSheetReport as J, generateAgedBalance as K, generateBudgetVsActual as L, generateCashFlow as M, BudgetVsActualOptions as N, DimensionBreakdownReport as O, BudgetVsActualParams as P, ComparativeMode as Q, BalanceSheetOptions as R, FiscalCloseResult as S, reopenFiscalPeriod as T, AgedBalanceRow as U, AgedBalanceParams as V, AgedBucketConfig as W, CashFlowReport as X, BalanceSheetSection as Y, CashFlowSection as Z, IncomeStatementOptions as _, DaybookOptions as _t, RevaluationReport as a, PeriodColumn as at, generateGeneralLedger as b, generateDaybook as bt, RevaluationRate as c, ReportGroup as ct, computeRevaluation as d, TrialBalanceColumnRow as dt, GeneralLedgerReport as et, PartnerLedgerLine as f, TrialBalanceReport as ft, generatePartnerLedger as g, DaybookLine as gt, PartnerLedgerReport as h, defaultLogger as ht, RevaluationParams as i, LedgerEntry as it, CashFlowOptions as j, DimensionBreakdownRow as k, RevaluationResult as l, ReportLine as lt, PartnerLedgerParams as m, Logger as mt, generateTrialBalance as n, IncomeStatementReport as nt, generateRevaluation as o, ReportAccount as ot, PartnerLedgerOptions as p, TrialBalanceRow as pt, BalanceSheetLineSource as q, RevaluationOptions as r, IncomeStatementSection as rt, AccountForeignBalance as s, ReportCategory as st, TrialBalanceOptions as t, IncomeStatementLineSource as tt, buildRevaluationEntry as u, ReportSection as ut, generateIncomeStatement as v, DaybookParams as vt, closeFiscalPeriod as w, FiscalCloseOptions as x, GeneralLedgerOptions as y, DaybookReport as yt, generateBalanceSheet as z };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@classytic/ledger",
-  "version": "0.10.2",
-  "description": "Production-grade double-entry accounting engine for MongoDB — schemas, reports, tax, multi-tenant",
+  "version": "0.11.0",
+  "description": "Production-grade double-entry accounting engine for MongoDB — schemas, reports, tax, multi-tenant",
   "type": "module",
   "sideEffects": false,
   "main": "./dist/index.mjs",
@@ -43,11 +43,6 @@
       "import": "./dist/exports/index.mjs",
       "default": "./dist/exports/index.mjs"
     },
-    "./sync": {
-      "types": "./dist/sync/index.d.mts",
-      "import": "./dist/sync/index.mjs",
-      "default": "./dist/sync/index.mjs"
-    },
     "./events": {
       "types": "./dist/events/index.d.mts",
       "import": "./dist/events/index.mjs",
@@ -93,25 +88,18 @@
     "url": "git+https://github.com/classytic/ledger.git"
   },
   "peerDependencies": {
-    "@classytic/fin-io": ">=0.1.0",
-    "@classytic/mongokit": ">=3.11.0",
-    "@classytic/primitives": ">=0.1.0",
-    "@classytic/repo-core": ">=0.2.0",
+    "@classytic/mongokit": ">=3.13.0",
+    "@classytic/primitives": ">=0.5.0",
+    "@classytic/repo-core": ">=0.4.0",
     "mongoose": ">=9.4.1",
     "zod": ">=4.0.0"
   },
-  "peerDependenciesMeta": {
-    "@classytic/fin-io": {
-      "optional": true
-    }
-  },
   "devDependencies": {
     "@biomejs/biome": "^2.4.12",
     "@classytic/dev-tools": "^0.2.0",
-    "@classytic/fin-io": ">=0.1.0",
-    "@classytic/mongokit": ">=3.11.0",
-    "@classytic/primitives": ">=0.1.0",
-    "@classytic/repo-core": ">=0.2.0",
+    "@classytic/mongokit": ">=3.13.0",
+    "@classytic/primitives": ">=0.5.0",
+    "@classytic/repo-core": ">=0.4.0",
     "@types/node": "^25.5.0",
     "@vitest/coverage-v8": "^4.1.4",
     "knip": "^6.4.1",

package/dist/opening-balance-1cixYh6Y.mjs

@@ -1,60 +0,0 @@
-//#region src/sync/builders/opening-balance.ts
-function buildOpeningBalanceEntry(input) {
-	const { cutoverDate, balances, equityAccountCode } = input;
-	const dateStr = cutoverDate.toISOString().split("T")[0];
-	const label = input.label ?? `Opening Balance — Cutover ${dateStr}`;
-	const items = [];
-	let totalDebit = 0;
-	let totalCredit = 0;
-	for (const { accountCode, balance } of balances) {
-		if (balance === 0) continue;
-		if (balance > 0) {
-			items.push({
-				account: accountCode,
-				debit: balance,
-				credit: 0,
-				label: "Opening balance"
-			});
-			totalDebit += balance;
-		} else {
-			const absBalance = Math.abs(balance);
-			items.push({
-				account: accountCode,
-				debit: 0,
-				credit: absBalance,
-				label: "Opening balance"
-			});
-			totalCredit += absBalance;
-		}
-	}
-	const residual = totalDebit - totalCredit;
-	const lineCount = items.length;
-	if (residual > 0) items.push({
-		account: equityAccountCode,
-		debit: 0,
-		credit: residual,
-		label: "Opening balance equity (contra)"
-	});
-	else if (residual < 0) items.push({
-		account: equityAccountCode,
-		debit: Math.abs(residual),
-		credit: 0,
-		label: "Opening balance equity (contra)"
-	});
-	return {
-		entry: {
-			date: cutoverDate,
-			label,
-			journalType: "GENERAL",
-			journalItems: items,
-			extra: {
-				_externalId: `opening-balance:${dateStr}`,
-				_importSource: "opening-balance"
-			}
-		},
-		residual,
-		lineCount
-	};
-}
-//#endregion
-export { buildOpeningBalanceEntry as t };