@classytic/ledger 0.2.0 → 0.4.0

package/dist/{idempotency.plugin-CPxPt4vX.d.mts → idempotency.plugin-zU-GKJ0-.d.mts}

@@ -1,10 +1,21 @@
-import { Model } from "mongoose";
+import { ClientSession, Model } from "mongoose";
+import { RepositoryInstance } from "@classytic/mongokit";
 
-//#region src/plugins/double-entry.plugin.d.ts
-/** Minimal interface matching @classytic/mongokit RepositoryInstance */
-interface RepositoryInstance$2 {
-  on(event: string, listener: (data: unknown) => void | Promise<void>): unknown;
+//#region src/plugins/date-lock.plugin.d.ts
+interface DateLockPluginOptions {
+  /** Async function to resolve the lock date for a given org. Return null for no lock. */
+  getLockDate: (orgId?: unknown, session?: ClientSession) => Promise<Date | null>;
+  /** Mongoose model for journal entries (needed for partial updates) */
+  JournalEntryModel: Model<unknown>;
+  /** Org field name */
+  orgField?: string;
 }
+declare function dateLockPlugin(options: DateLockPluginOptions): {
+  name: string;
+  apply(repo: RepositoryInstance): void;
+};
+//#endregion
+//#region src/plugins/double-entry.plugin.d.ts
 interface DoubleEntryPluginOptions {
   /** Only enforce on posted entries (default: true) */
   onlyOnPost?: boolean;
@@ -17,14 +28,10 @@ interface DoubleEntryPluginOptions {
 }
 declare function doubleEntryPlugin(options?: DoubleEntryPluginOptions): {
   name: string;
-  apply(repo: RepositoryInstance$2): void;
+  apply(repo: RepositoryInstance): void;
 };
 //#endregion
 //#region src/plugins/fiscal-lock.plugin.d.ts
-/** Minimal interface matching @classytic/mongokit RepositoryInstance */
-interface RepositoryInstance$1 {
-  on(event: string, listener: (data: unknown) => void | Promise<void>): unknown;
-}
 interface FiscalLockPluginOptions {
   /** Mongoose model for fiscal periods */
   FiscalPeriodModel: Model<unknown>;
@@ -35,14 +42,10 @@ interface FiscalLockPluginOptions {
 }
 declare function fiscalLockPlugin(options: FiscalLockPluginOptions): {
   name: string;
-  apply(repo: RepositoryInstance$1): void;
+  apply(repo: RepositoryInstance): void;
 };
 //#endregion
 //#region src/plugins/idempotency.plugin.d.ts
-/** Minimal interface matching @classytic/mongokit RepositoryInstance */
-interface RepositoryInstance {
-  on(event: string, listener: (data: unknown) => void | Promise<void>): unknown;
-}
 interface IdempotencyPluginOptions {
   /** Mongoose model for journal entries */
   JournalEntryModel: Model<unknown>;
@@ -54,5 +57,4 @@ declare function idempotencyPlugin(options: IdempotencyPluginOptions): {
   apply(repo: RepositoryInstance): void;
 };
 //#endregion
-export { DoubleEntryPluginOptions as a, fiscalLockPlugin as i, idempotencyPlugin as n, doubleEntryPlugin as o, FiscalLockPluginOptions as r, IdempotencyPluginOptions as t };
-//# sourceMappingURL=idempotency.plugin-CPxPt4vX.d.mts.map
+export { DoubleEntryPluginOptions as a, dateLockPlugin as c, fiscalLockPlugin as i, idempotencyPlugin as n, doubleEntryPlugin as o, FiscalLockPluginOptions as r, DateLockPluginOptions as s, IdempotencyPluginOptions as t };

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

@@ -49,9 +49,23 @@ interface CountryPack {
   readonly regions: readonly string[];
   /** Tax report template (e.g., CRA GST/HST return) */
   readonly taxReport?: TaxReportTemplate;
-  /** Account code for prior retained earnings (e.g. '3660' CA, '3200' US) */
-  readonly retainedEarningsCode?: string;
-  /** Account code for current year net income (e.g. '3680' CA, '3210' US) */
+  /**
+   * The retained earnings account code — the account that holds accumulated
+   * retained earnings (e.g. '3600' CA, '3310' BD).
+   *
+   * On the balance sheet, this account is excluded from normal equity grouping
+   * and its balance is folded into the computed "Retained Earnings" section
+   * (opening RE = RE account balance + prior-year unclosed P&L).
+   *
+   * Inspired by Odoo's `equity_unaffected` account type.
+   */
+  readonly retainedEarningsAccountCode?: string;
+  /**
+   * Display code for the "Previous Years Retained Earnings" line on the
+   * balance sheet (e.g. '3660' for CA GIFI). Defaults to retainedEarningsAccountCode.
+   */
+  readonly retainedEarningsDisplayCode?: string;
+  /** Display code for current year net income line (e.g. '3680' CA, '3311' BD) */
   readonly currentYearEarningsCode?: string;
   /** Group label code used to identify Cost of Sales in the income statement */
   readonly cogsGroupCode?: string;
@@ -85,7 +99,8 @@ interface CountryPackInput {
   taxCodesByRegion: TaxCodesByRegion;
   regions: readonly string[];
   taxReport?: TaxReportTemplate;
-  retainedEarningsCode?: string;
+  retainedEarningsAccountCode?: string;
+  retainedEarningsDisplayCode?: string;
   currentYearEarningsCode?: string;
   cogsGroupCode?: string;
   reportLabels?: {
@@ -101,5 +116,4 @@ interface CountryPackInput {
  */
 declare function defineCountryPack(input: CountryPackInput): CountryPack;
 //#endregion
-export { TaxReportLine as a, TaxCodesByRegion as i, CountryPackInput as n, TaxReportTemplate as o, TaxCode as r, defineCountryPack as s, CountryPack as t };
-//# sourceMappingURL=index-ZnSiqHYV.d.mts.map
+export { TaxReportLine as a, TaxCodesByRegion as i, CountryPackInput as n, TaxReportTemplate as o, TaxCode as r, defineCountryPack as s, CountryPack as t };

package/dist/{index-BPukb3L8.d.mts → index-J-XIbXH-.d.mts}

@@ -121,17 +121,16 @@ declare function extractAllRows<TRow>(fieldMap: ExportFieldMap<TRow>, rows: read
 /** One-shot: map + serialize to CSV string. */
 declare function exportToCsv<TRow>(fieldMap: ExportFieldMap<TRow>, rows: readonly TRow[], options?: CsvOptions): string;
 //#endregion
-//#region src/exports/flatten-journal.d.ts
-/** Flatten a single journal entry into one FlatJournalRow per journal item. */
-declare function flattenJournalEntry(entry: PopulatedJournalEntry): FlatJournalRow[];
-/** Flatten multiple journal entries into a single flat row array. */
-declare function flattenJournalEntries(entries: readonly PopulatedJournalEntry[]): FlatJournalRow[];
-//#endregion
 //#region src/exports/field-maps/quickbooks.d.ts
 declare const quickbooksFieldMap: ExportFieldMap<FlatJournalRow>;
 //#endregion
 //#region src/exports/field-maps/universal.d.ts
 declare const universalFieldMap: ExportFieldMap<FlatJournalRow>;
 //#endregion
-export { PopulatedJournalEntry as _, exportToCsv as a, getHeaders as c, serializeCsv as d, CsvOptions as f, PopulatedAccount as g, FlatJournalRow as h, flattenJournalEntry as i, buildCsv as l, ExportFieldMap as m, quickbooksFieldMap as n, extractAllRows as o, ExportField as p, flattenJournalEntries as r, extractRow as s, universalFieldMap as t, escapeCell as u, PopulatedJournalItem as v };
-//# sourceMappingURL=index-BPukb3L8.d.mts.map
+//#region src/exports/flatten-journal.d.ts
+/** Flatten a single journal entry into one FlatJournalRow per journal item. */
+declare function flattenJournalEntry(entry: PopulatedJournalEntry): FlatJournalRow[];
+/** Flatten multiple journal entries into a single flat row array. */
+declare function flattenJournalEntries(entries: readonly PopulatedJournalEntry[]): FlatJournalRow[];
+//#endregion
+export { PopulatedJournalEntry as _, exportToCsv as a, getHeaders as c, serializeCsv as d, CsvOptions as f, PopulatedAccount as g, FlatJournalRow as h, quickbooksFieldMap as i, buildCsv as l, ExportFieldMap as m, flattenJournalEntry as n, extractAllRows as o, ExportField as p, universalFieldMap as r, extractRow as s, flattenJournalEntries as t, escapeCell as u, PopulatedJournalItem as v };

package/dist/index.d.mts

@@ -1,16 +1,17 @@
 import { _ as TaxMetadata, a as Cents, c as DateRange, d as JournalType, f as MainType, g as TaxDetail, h as StatementType, i as CategoryKey, l as EntryState, m as ObjectId, n as CashFlowCategory, o as Currency, p as NormalBalance, s as DateOption, t as AccountType, u as JournalItem, v as TotalAccountOp } from "./core-8Xfnpn6g.mjs";
-import { _ as getNormalBalance, a as JOURNAL_CODES, b as isValidCategory, c as getJournalTypeCodes, d as CATEGORY_KEYS, i as isValidCurrency, l as isValidJournalType, n as getCurrency, o as JOURNAL_TYPES, r as getMinorUnit, t as CURRENCIES, u as CATEGORIES, v as isBalanceSheet, y as isIncomeStatement } from "./currencies-4WAbFRlw.mjs";
-import { a as TaxReportLine, i as TaxCodesByRegion, n as CountryPackInput, o as TaxReportTemplate, r as TaxCode, s as defineCountryPack, t as CountryPack } from "./index-ZnSiqHYV.mjs";
-import { _ as PopulatedJournalEntry, a as exportToCsv, h as FlatJournalRow, m as ExportFieldMap, n as quickbooksFieldMap, p as ExportField, r as flattenJournalEntries, t as universalFieldMap } from "./index-BPukb3L8.mjs";
+import { S as isValidCategory, a as getJournalTypeCodes, b as isBalanceSheet, c as CURRENCIES, d as isValidCurrency, f as CATEGORIES, i as getJournalType, l as getCurrency, n as JOURNAL_TYPES, o as isValidJournalType, p as CATEGORY_KEYS, r as getCustomJournalTypes, s as registerJournalType, t as JOURNAL_CODES, u as getMinorUnit, x as isIncomeStatement, y as getNormalBalance } from "./journals-DTipb_rz.mjs";
+import { a as TaxReportLine, i as TaxCodesByRegion, n as CountryPackInput, o as TaxReportTemplate, r as TaxCode, s as defineCountryPack, t as CountryPack } from "./index-CxZqRaOU.mjs";
+import { _ as PopulatedJournalEntry, a as exportToCsv, h as FlatJournalRow, i as quickbooksFieldMap, m as ExportFieldMap, p as ExportField, r as universalFieldMap, t as flattenJournalEntries } from "./index-J-XIbXH-.mjs";
 import { Money, abs, add, allocate, equals, format, formatPlain, fromDecimal, isNegative, isPositive, isValid, isZero, max, min, multiply, negate, parseCents, percentage, round, splitTaxExclusive, splitTaxInclusive, subtract, toDecimal } from "./money.mjs";
 import { n as defaultLogger, t as Logger } from "./logger-UbTdBb1x.mjs";
-import { a as MultiTenantConfig, i as MultiCurrencyConfig, n as AuditConfig, o as SchemaOptions, r as JournalSchemaOptions, s as StrictnessConfig, t as AccountingEngineConfig } from "./engine-BzBMpWuy.mjs";
-import { n as createJournalEntrySchema, r as createAccountSchema, t as createFiscalPeriodSchema } from "./fiscal-period.schema-BRdKAjrr.mjs";
-import { i as fiscalLockPlugin, n as idempotencyPlugin, o as doubleEntryPlugin } from "./idempotency.plugin-CPxPt4vX.mjs";
-import { C as ReportAccount, D as TaxReturnSummary, E as TaxReport, O as TrialBalanceReport, S as LedgerEntry, T as ReportGroup, _ as CashFlowReport, a as reopenFiscalPeriod, b as GeneralLedgerReport, d as generateIncomeStatement, g as BalanceSheetReport, h as generateTrialBalance, i as closeFiscalPeriod, k as TrialBalanceRow, l as generateGeneralLedger, p as generateBalanceSheet, s as generateCashFlow, v as CashFlowSection, w as ReportCategory, x as IncomeStatementReport, y as GeneralLedgerAccount } from "./fiscal-close-dNlzB37y.mjs";
-import { n as wireJournalEntryMethods, t as wireAccountMethods } from "./account.repository-C7gwFLfM.mjs";
+import { a as MultiTenantConfig, i as MultiCurrencyConfig, n as AuditConfig, o as SchemaOptions, r as JournalSchemaOptions, s as StrictnessConfig, t as AccountingEngineConfig } from "./engine-DF-MtsEr.mjs";
+import { a as BulkCreateInput, c as PostOptions, d as ReverseOptions, f as ReverseResult, i as AccountRepository, l as ReconcileParams, m as SeedResult, n as wireJournalEntryMethods, o as BulkCreateResult, p as SeedOptions, r as wireAccountMethods, s as JournalEntryRepository, t as wireReconciliationMethods, u as ReconciliationRepository } from "./reconciliation.repository-DEybU_Ok.mjs";
+import { n as createFiscalPeriodSchema, r as createAccountSchema, t as createJournalEntrySchema } from "./journal-entry.schema-B1CzLwC3.mjs";
+import { c as dateLockPlugin, i as fiscalLockPlugin, n as idempotencyPlugin, o as doubleEntryPlugin } from "./idempotency.plugin-zU-GKJ0-.mjs";
+import { $ as AgedBucketConfig, A as BudgetVsActualReport, B as IncomeStatementReport, C as DimensionBreakdownReport, D as generateCashFlow, F as BalanceSheetReport, G as TaxReport, H as ReportAccount, I as CashFlowReport, J as TrialBalanceRow, K as TaxReturnSummary, L as CashFlowSection, M as generateBudgetVsActual, O as BudgetVsActualOptions, P as generateBalanceSheet, Q as AgedBalanceRow, R as GeneralLedgerAccount, S as DimensionBreakdownParams, T as generateDimensionBreakdown, U as ReportCategory, V as LedgerEntry, W as ReportGroup, X as AgedBalanceParams, Y as AgedBalanceOptions, Z as AgedBalanceReport, a as RevaluationReport, b as reopenFiscalPeriod, c as RevaluationRate, d as computeRevaluation, et as DEFAULT_BUCKETS, h as generateGeneralLedger, i as RevaluationParams, j as BudgetVsActualRow, k as BudgetVsActualParams, l as RevaluationResult, n as generateTrialBalance, o as generateRevaluation, p as generateIncomeStatement, q as TrialBalanceReport, r as RevaluationOptions, s as AccountForeignBalance, tt as generateAgedBalance, u as buildRevaluationEntry, w as DimensionBreakdownRow, x as DimensionBreakdownOptions, y as closeFiscalPeriod, z as GeneralLedgerReport } from "./trial-balance-DcQ0xj_4.mjs";
 import * as mongoose$1 from "mongoose";
 import { ClientSession, Connection, Model } from "mongoose";
+import { PluginType, Repository } from "@classytic/mongokit";
 
 //#region src/engine.d.ts
 declare class AccountingEngine {
@@ -44,34 +45,163 @@ declare class AccountingEngine {
   constructor(config: AccountingEngineConfig);
   createAccountSchema(options?: SchemaOptions): mongoose$1.Schema<any, Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
     timestamps: true;
-  }, any, any, unknown, {
+  }, {
+    [x: number]: any;
     [x: string]: any;
-  } & Required<{
-    _id: unknown;
-  }> & {
+  } & mongoose$1.DefaultTimestampProps, mongoose$1.Document<unknown, {}, {
+    [x: number]: any;
+    [x: string]: any;
+  } & mongoose$1.DefaultTimestampProps, {
+    id: string;
+  }, Omit<mongoose$1.DefaultSchemaOptions, "timestamps"> & {
+    timestamps: true;
+  }> & Omit<{
+    [x: number]: any;
+    [x: string]: any;
+  } & mongoose$1.DefaultTimestampProps & {
+    _id: mongoose$1.Types.ObjectId;
+  } & {
+    __v: number;
+  }, "id"> & {
+    id: string;
+  }, unknown, {
+    [x: number]: any;
+    [x: string]: any;
+    createdAt: NativeDate;
+    updatedAt: NativeDate;
+  } & {
+    _id: mongoose$1.Types.ObjectId;
+  } & {
     __v: number;
   }>;
   createJournalEntrySchema(accountModelName: string, options?: JournalSchemaOptions): mongoose$1.Schema<any, Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
     timestamps: true;
-  }, any, any, unknown, {
+  }, {
+    [x: number]: any;
+    [x: string]: any;
+  } & mongoose$1.DefaultTimestampProps, mongoose$1.Document<unknown, {}, {
+    [x: number]: any;
+    [x: string]: any;
+  } & mongoose$1.DefaultTimestampProps, {
+    id: string;
+  }, Omit<mongoose$1.DefaultSchemaOptions, "timestamps"> & {
+    timestamps: true;
+  }> & Omit<{
+    [x: number]: any;
     [x: string]: any;
-  } & Required<{
-    _id: unknown;
-  }> & {
+  } & mongoose$1.DefaultTimestampProps & {
+    _id: mongoose$1.Types.ObjectId;
+  } & {
+    __v: number;
+  }, "id"> & {
+    id: string;
+  }, unknown, {
+    [x: number]: any;
+    [x: string]: any;
+    createdAt: NativeDate;
+    updatedAt: NativeDate;
+  } & {
+    _id: mongoose$1.Types.ObjectId;
+  } & {
     __v: number;
   }>;
   createFiscalPeriodSchema(options?: SchemaOptions): mongoose$1.Schema<any, Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
     timestamps: true;
-  }, any, any, unknown, {
+  }, {
+    [x: number]: any;
+    [x: string]: any;
+  } & mongoose$1.DefaultTimestampProps, mongoose$1.Document<unknown, {}, {
+    [x: number]: any;
+    [x: string]: any;
+  } & mongoose$1.DefaultTimestampProps, {
+    id: string;
+  }, Omit<mongoose$1.DefaultSchemaOptions, "timestamps"> & {
+    timestamps: true;
+  }> & Omit<{
+    [x: number]: any;
+    [x: string]: any;
+  } & mongoose$1.DefaultTimestampProps & {
+    _id: mongoose$1.Types.ObjectId;
+  } & {
+    __v: number;
+  }, "id"> & {
+    id: string;
+  }, unknown, {
+    [x: number]: any;
     [x: string]: any;
-  } & Required<{
-    _id: unknown;
-  }> & {
+    createdAt: NativeDate;
+    updatedAt: NativeDate;
+  } & {
+    _id: mongoose$1.Types.ObjectId;
+  } & {
+    __v: number;
+  }>;
+  createBudgetSchema(options?: SchemaOptions): mongoose$1.Schema<any, Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
+    timestamps: true;
+  }, {
+    [x: number]: any;
+    [x: string]: any;
+  } & mongoose$1.DefaultTimestampProps, mongoose$1.Document<unknown, {}, {
+    [x: number]: any;
+    [x: string]: any;
+  } & mongoose$1.DefaultTimestampProps, {
+    id: string;
+  }, Omit<mongoose$1.DefaultSchemaOptions, "timestamps"> & {
+    timestamps: true;
+  }> & Omit<{
+    [x: number]: any;
+    [x: string]: any;
+  } & mongoose$1.DefaultTimestampProps & {
+    _id: mongoose$1.Types.ObjectId;
+  } & {
+    __v: number;
+  }, "id"> & {
+    id: string;
+  }, unknown, {
+    [x: number]: any;
+    [x: string]: any;
+    createdAt: NativeDate;
+    updatedAt: NativeDate;
+  } & {
+    _id: mongoose$1.Types.ObjectId;
+  } & {
+    __v: number;
+  }>;
+  createReconciliationSchema(accountModelName: string, journalEntryModelName: string, options?: SchemaOptions): mongoose$1.Schema<any, Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
+    timestamps: true;
+  }, {
+    [x: number]: any;
+    [x: string]: any;
+  } & mongoose$1.DefaultTimestampProps, mongoose$1.Document<unknown, {}, {
+    [x: number]: any;
+    [x: string]: any;
+  } & mongoose$1.DefaultTimestampProps, {
+    id: string;
+  }, Omit<mongoose$1.DefaultSchemaOptions, "timestamps"> & {
+    timestamps: true;
+  }> & Omit<{
+    [x: number]: any;
+    [x: string]: any;
+  } & mongoose$1.DefaultTimestampProps & {
+    _id: mongoose$1.Types.ObjectId;
+  } & {
+    __v: number;
+  }, "id"> & {
+    id: string;
+  }, unknown, {
+    [x: number]: any;
+    [x: string]: any;
+    createdAt: NativeDate;
+    updatedAt: NativeDate;
+  } & {
+    _id: mongoose$1.Types.ObjectId;
+  } & {
     __v: number;
   }>;
   createReports(models: {
     Account: Model<unknown>;
     JournalEntry: Model<unknown>;
+    Budget?: Model<unknown>;
   }): {
     trialBalance: (params: {
       organizationId?: unknown;
@@ -108,6 +238,44 @@ declare class AccountingEngine {
       businessName?: string;
       filters?: Record<string, unknown>;
     }) => Promise<CashFlowReport>;
+    agedBalance: (params: {
+      organizationId?: unknown;
+      asOfDate?: Date;
+      type: "receivable" | "payable";
+      accountIds?: unknown[];
+      dueDateField?: string;
+      contactField?: string;
+      buckets?: Array<{
+        label: string;
+        minDays: number;
+        maxDays: number;
+      }>;
+    }) => Promise<AgedBalanceReport>;
+    dimensionBreakdown: (params: {
+      organizationId?: unknown;
+      dateOption: "month" | "quarter" | "year" | "custom";
+      dateValue: unknown;
+      dimension: string;
+      accountCategory?: string;
+      filters?: Record<string, unknown>;
+    }) => Promise<DimensionBreakdownReport>;
+    budgetVsActual: (params: {
+      organizationId?: unknown;
+      dateOption: "month" | "quarter" | "year" | "custom";
+      dateValue: unknown;
+      accountIds?: unknown[];
+      filters?: Record<string, unknown>;
+    }) => Promise<BudgetVsActualReport>;
+    revaluation: (params: {
+      organizationId?: unknown;
+      asOfDate: Date;
+      rates: Array<{
+        currency: string;
+        rate: number;
+      }>;
+      unrealizedGainLossAccountId: unknown;
+      generateEntry?: boolean;
+    }) => Promise<RevaluationReport>;
   };
   /** Get all posting account types (accounts you can post transactions to) */
   getPostingAccountTypes(): readonly AccountType[];
@@ -133,11 +301,11 @@ declare class AccountingEngine {
    * @param additionalPlugins - Extra plugins to include (e.g. timestampPlugin)
    * @returns A wired repository with post(), unpost(), reverse(), duplicate(), and all plugins configured
    */
-  createJournalEntryRepository(createRepository: (model: Model<unknown>, plugins: any[]) => any, models: {
-    JournalEntryModel: Model<unknown>;
+  createJournalEntryRepository<TDoc = unknown>(createRepository: (model: Model<TDoc>, plugins: PluginType[]) => Repository<TDoc>, models: {
+    JournalEntryModel: Model<TDoc>;
     AccountModel: Model<unknown>;
     FiscalPeriodModel?: Model<unknown>;
-  }, additionalPlugins?: any[]): any;
+  }, additionalPlugins?: PluginType[]): JournalEntryRepository<TDoc>;
   /**
    * Wire post/reverse domain methods onto a mongokit Repository
    * for journal entries. The repository must already be created via
@@ -151,7 +319,7 @@ declare class AccountingEngine {
    * @param JournalEntryModel - The Mongoose model for journal entries
    * @returns The same repository, now with `.post()` and `.reverse()`
    */
-  wireJournalEntryRepository(repository: any, JournalEntryModel: Model<unknown>): any;
+  wireJournalEntryRepository<TDoc = unknown>(repository: Repository<TDoc>, JournalEntryModel: Model<unknown>): JournalEntryRepository<TDoc>;
   /**
    * Wire seedAccounts/bulkCreate and posting-account validation onto a
    * mongokit Repository for accounts. The repository must already be
@@ -161,24 +329,14 @@ declare class AccountingEngine {
    * @param AccountModel - The Mongoose model for accounts
    * @returns The same repository, now with `.seedAccounts()` and `.bulkCreate()`
    */
-  wireAccountRepository(repository: any, AccountModel: Model<unknown>): any;
+  wireAccountRepository<TDoc = unknown>(repository: Repository<TDoc>, AccountModel: Model<unknown>): AccountRepository<TDoc>;
+  /**
+   * Wire reconcile/unreconcile/getUnreconciled methods onto a mongokit Repository.
+   */
+  wireReconciliationRepository<TDoc = unknown>(repository: Repository<TDoc>, ReconciliationModel: Model<unknown>, JournalEntryModel: Model<unknown>): ReconciliationRepository<TDoc>;
 }
 declare function createAccountingEngine(config: AccountingEngineConfig): AccountingEngine;
 //#endregion
-//#region src/utils/date-range.d.ts
-/**
- * Compute start/end dates from a date option + value.
- *
- * Examples:
- *   getDateRange('month', '2025-03')            → Mar 1 – Mar 31
- *   getDateRange('quarter', { quarter: 2, year: 2025 }) → Apr 1 – Jun 30
- *   getDateRange('year', 2025)                  → Jan 1 – Dec 31
- *   getDateRange('custom', { startDate, endDate })
- */
-declare function getDateRange(option: DateOption, value: unknown): DateRange;
-/** Get fiscal year start date for a given date and fiscal start month */
-declare function getFiscalYearStart(date: Date, fiscalStartMonth?: number): Date;
-//#endregion
 //#region src/utils/account-helpers.d.ts
 /**
  * Check if an account type is a virtual tax sub-account.
@@ -205,6 +363,71 @@ declare function computeEndingBalance(category: CategoryKey, totalDebit: number,
  */
 declare function buildAccountTypeMap(accountTypes: readonly AccountType[]): Map<string, AccountType>;
 //#endregion
+//#region src/utils/date-range.d.ts
+/**
+ * Compute start/end dates from a date option + value.
+ *
+ * @throws {Error} If value is null/undefined/invalid for the given option
+ *
+ * Examples:
+ *   getDateRange('month', '2025-03')            → Mar 1 – Mar 31
+ *   getDateRange('quarter', { quarter: 2, year: 2025 }) → Apr 1 – Jun 30
+ *   getDateRange('year', 2025)                  → Jan 1 – Dec 31
+ *   getDateRange('custom', { startDate, endDate })
+ */
+declare function getDateRange(option: DateOption, value: unknown): DateRange;
+/** Get fiscal year start date for a given date and fiscal start month */
+declare function getFiscalYearStart(date: Date, fiscalStartMonth?: number): Date;
+//#endregion
+//#region src/utils/dimensions.d.ts
+/**
+ * Analytic Dimensions — Helpers for defining analytic dimensions
+ * (department, project, cost center) on journal items.
+ *
+ * Generates Mongoose schema fields and indexes for dimension queries.
+ */
+interface DimensionDefinition {
+  /** Field name on the journal item, e.g. 'departmentId' */
+  field: string;
+  /** Human-readable label, e.g. 'Department' */
+  label: string;
+  /** Mongoose model ref for population, e.g. 'Department' */
+  ref?: string;
+  /** Whether the field is required (default: false) */
+  required?: boolean;
+}
+/**
+ * Build extraItemFields schema definition for a set of dimensions.
+ *
+ * Returns a Mongoose schema-compatible object suitable for spreading into
+ * `extraItemFields` in JournalSchemaOptions.
+ *
+ * @example
+ * ```typescript
+ * const fields = buildDimensionFields([
+ *   { field: 'departmentId', label: 'Department', ref: 'Department' },
+ *   { field: 'projectId', label: 'Project', ref: 'Project' },
+ * ]);
+ * // => { departmentId: { type: Schema.Types.ObjectId, ref: 'Department', required: false, default: null }, ... }
+ * ```
+ */
+declare function buildDimensionFields(dimensions: DimensionDefinition[]): Record<string, unknown>;
+/**
+ * Build extra indexes for dimension queries.
+ *
+ * Each dimension gets a compound index on `journalItems.{field}` + `date`
+ * for efficient filtered reporting. When `orgField` is provided, it is
+ * prepended to each index for multi-tenant scoping.
+ *
+ * @param dimensions - Array of dimension definitions
+ * @param orgField - Optional org-scoping field name (e.g. 'business')
+ * @returns Array of index specifications compatible with `extraIndexes` in JournalSchemaOptions
+ */
+declare function buildDimensionIndexes(dimensions: DimensionDefinition[], orgField?: string): Array<{
+  fields: Record<string, 1 | -1>;
+  options?: Record<string, unknown>;
+}>;
+//#endregion
 //#region src/utils/errors.d.ts
 /**
  * Typed error for the accounting package.
@@ -225,6 +448,23 @@ declare const Errors: {
   readonly fiscal: (msg: string) => AccountingError;
 };
 //#endregion
+//#region src/utils/filter-builder.d.ts
+/**
+ * Filter Builder — Sanitizes user-supplied dimension filters for aggregation pipelines.
+ *
+ * Prevents injection of dangerous MongoDB operators while allowing
+ * standard equality and comparison filters on custom dimension fields.
+ */
+/**
+ * Build a sanitized filter object from user-supplied dimension filters.
+ * Blocks dangerous operators ($where, $expr, $function, etc.).
+ *
+ * @param filters - Key-value filters (e.g. { 'journalItems.departmentId': 'dept-1' })
+ * @returns Sanitized filter object safe for $match stages
+ * @throws Error if a blocked operator is used
+ */
+declare function buildItemFilters(filters?: Record<string, unknown>): Record<string, unknown>;
+//#endregion
 //#region src/utils/session.d.ts
 interface SessionResult {
   session: ClientSession | null;
@@ -243,23 +483,6 @@ declare function acquireSession(db: Connection, externalSession: ClientSession |
  */
 declare function finalizeSession(session: ClientSession | null, ownSession: boolean, success: boolean): Promise<void>;
 //#endregion
-//#region src/utils/filter-builder.d.ts
-/**
- * Filter Builder — Sanitizes user-supplied dimension filters for aggregation pipelines.
- *
- * Prevents injection of dangerous MongoDB operators while allowing
- * standard equality and comparison filters on custom dimension fields.
- */
-/**
- * Build a sanitized filter object from user-supplied dimension filters.
- * Blocks dangerous operators ($where, $expr, $function, etc.).
- *
- * @param filters - Key-value filters (e.g. { 'journalItems.departmentId': 'dept-1' })
- * @returns Sanitized filter object safe for $match stages
- * @throws Error if a blocked operator is used
- */
-declare function buildItemFilters(filters?: Record<string, unknown>): Record<string, unknown>;
-//#endregion
 //#region src/types/contracts.d.ts
 /** A single line produced by a subledger for posting */
 interface SubledgerJournalItem {
@@ -304,5 +527,4 @@ interface PostingResult {
   idempotencyKeys?: string[];
 }
 //#endregion
-export { type AccountType, AccountingEngine, type AccountingEngineConfig, AccountingError, type AuditConfig, type BalanceSheetReport, CATEGORIES, CATEGORY_KEYS, CURRENCIES, type CashFlowCategory, type CashFlowReport, type CashFlowSection, type CategoryKey, type Cents, type CountryPack, type CountryPackInput, type Currency, type DateOption, type DateRange, type EntryState, Errors, type ExportField, type ExportFieldMap, type FlatJournalRow, type GeneralLedgerAccount, type GeneralLedgerReport, type IncomeStatementReport, JOURNAL_CODES, JOURNAL_TYPES, type JournalItem, type JournalSchemaOptions, type JournalType, type LedgerEntry, type Logger, type MainType, Money, type MultiCurrencyConfig, type MultiTenantConfig, type NormalBalance, type PopulatedJournalEntry, type PostingContract, type PostingResult, type ReportAccount, type ReportCategory, type ReportGroup, type SchemaOptions, type SessionResult, type StatementType, type StrictnessConfig, type SubledgerJournalItem, type SubledgerPostingInput, type TaxCode, type TaxCodesByRegion, type TaxDetail, type TaxMetadata, type TaxReport, type TaxReportLine, type TaxReportTemplate, type TaxReturnSummary, type TotalAccountOp, type TrialBalanceReport, type TrialBalanceRow, acquireSession, add, allocate, buildAccountTypeMap, buildItemFilters, calculateTotal, closeFiscalPeriod, computeEndingBalance, createAccountSchema, createAccountingEngine, createFiscalPeriodSchema, createJournalEntrySchema, defaultLogger, defineCountryPack, doubleEntryPlugin, exportToCsv, finalizeSession, fiscalLockPlugin, flattenJournalEntries, format, formatPlain, fromDecimal, generateBalanceSheet, generateCashFlow, generateGeneralLedger, generateIncomeStatement, generateTrialBalance, getCurrency, getDateRange, getFiscalYearStart, getJournalTypeCodes, getMinorUnit, getNormalBalance, idempotencyPlugin, isBalanceSheet, isIncomeStatement, isValidCategory, isValidCurrency, isValidJournalType, isVirtualTaxAccount, multiply, parseCents, percentage, quickbooksFieldMap, reopenFiscalPeriod, splitTaxExclusive, splitTaxInclusive, subtract, toDecimal, universalFieldMap, wireAccountMethods, wireJournalEntryMethods };
-//# sourceMappingURL=index.d.mts.map
+export { type AccountForeignBalance, type AccountRepository, type AccountType, AccountingEngine, type AccountingEngineConfig, AccountingError, type AgedBalanceOptions, type AgedBalanceParams, type AgedBalanceReport, type AgedBalanceRow, type AgedBucketConfig, type AuditConfig, type BalanceSheetReport, type BudgetVsActualOptions, type BudgetVsActualParams, type BudgetVsActualReport, type BudgetVsActualRow, type BulkCreateInput, type BulkCreateResult, CATEGORIES, CATEGORY_KEYS, CURRENCIES, type CashFlowCategory, type CashFlowReport, type CashFlowSection, type CategoryKey, type Cents, type CountryPack, type CountryPackInput, type Currency, DEFAULT_BUCKETS, type DateOption, type DateRange, type DimensionBreakdownOptions, type DimensionBreakdownParams, type DimensionBreakdownReport, type DimensionBreakdownRow, type DimensionDefinition, type EntryState, Errors, type ExportField, type ExportFieldMap, type FlatJournalRow, type GeneralLedgerAccount, type GeneralLedgerReport, type IncomeStatementReport, JOURNAL_CODES, JOURNAL_TYPES, type JournalEntryRepository, type JournalItem, type JournalSchemaOptions, type JournalType, type LedgerEntry, type Logger, type MainType, Money, type MultiCurrencyConfig, type MultiTenantConfig, type NormalBalance, type PopulatedJournalEntry, type PostOptions, type PostingContract, type PostingResult, type ReconcileParams, type ReconciliationRepository, type ReportAccount, type ReportCategory, type ReportGroup, type RevaluationOptions, type RevaluationParams, type RevaluationRate, type RevaluationReport, type RevaluationResult, type ReverseOptions, type ReverseResult, type SchemaOptions, type SeedOptions, type SeedResult, type SessionResult, type StatementType, type StrictnessConfig, type SubledgerJournalItem, type SubledgerPostingInput, type TaxCode, type TaxCodesByRegion, type TaxDetail, type TaxMetadata, type TaxReport, type TaxReportLine, type TaxReportTemplate, type TaxReturnSummary, type TotalAccountOp, type TrialBalanceReport, type TrialBalanceRow, acquireSession, add, allocate, buildAccountTypeMap, buildDimensionFields, buildDimensionIndexes, buildItemFilters, buildRevaluationEntry, calculateTotal, closeFiscalPeriod, computeEndingBalance, computeRevaluation, createAccountSchema, createAccountingEngine, createFiscalPeriodSchema, createJournalEntrySchema, dateLockPlugin, defaultLogger, defineCountryPack, doubleEntryPlugin, exportToCsv, finalizeSession, fiscalLockPlugin, flattenJournalEntries, format, formatPlain, fromDecimal, generateAgedBalance, generateBalanceSheet, generateBudgetVsActual, generateCashFlow, generateDimensionBreakdown, generateGeneralLedger, generateIncomeStatement, generateRevaluation, generateTrialBalance, getCurrency, getCustomJournalTypes, getDateRange, getFiscalYearStart, getJournalType, getJournalTypeCodes, getMinorUnit, getNormalBalance, idempotencyPlugin, isBalanceSheet, isIncomeStatement, isValidCategory, isValidCurrency, isValidJournalType, isVirtualTaxAccount, multiply, parseCents, percentage, quickbooksFieldMap, registerJournalType, reopenFiscalPeriod, splitTaxExclusive, splitTaxInclusive, subtract, toDecimal, universalFieldMap, wireAccountMethods, wireJournalEntryMethods, wireReconciliationMethods };