@classytic/ledger 0.1.5 → 0.3.0

package/dist/index.mjs

@@ -1,16 +1,15 @@
-import { n as createJournalEntrySchema, r as createAccountSchema, t as createFiscalPeriodSchema } from "./fiscal-period.schema-CbALaaKl.mjs";
-import { a as isValidJournalType, i as getJournalTypeCodes, n as JOURNAL_TYPES, t as JOURNAL_CODES } from "./journals-CI3Wb4EF.mjs";
-import { a as generateIncomeStatement, c as calculateTotal, d as generateTrialBalance, f as buildItemFilters, i as generateGeneralLedger, l as computeEndingBalance, m as getFiscalYearStart, n as reopenFiscalPeriod, o as generateBalanceSheet, p as getDateRange, r as generateCashFlow, s as buildAccountTypeMap, t as closeFiscalPeriod, u as isVirtualTaxAccount } from "./fiscal-close-DuXDgVvb.mjs";
-import { n as Errors, t as AccountingError } from "./errors-CeqRahE-.mjs";
-import { n as finalizeSession, r as defaultLogger, t as acquireSession } from "./session-Dh0s6zG4.mjs";
-import { c as getNormalBalance, d as isValidCategory, l as isBalanceSheet, n as CATEGORY_KEYS, t as CATEGORIES, u as isIncomeStatement } from "./categories-BNJBd4ze.mjs";
+import { a as createAccountSchema, i as createJournalEntrySchema, n as createBudgetSchema, r as createFiscalPeriodSchema, t as createReconciliationSchema } from "./reconciliation.schema-BuetvZTd.mjs";
+import { a as isValidJournalType, i as getJournalTypeCodes, n as JOURNAL_TYPES, t as JOURNAL_CODES } from "./journals-oH-FK3g8.mjs";
+import { C as getDateRange, S as buildItemFilters, _ as buildAccountTypeMap, a as defaultLogger, b as isVirtualTaxAccount, c as computeRevaluation, d as DEFAULT_BUCKETS, f as generateAgedBalance, g as generateBalanceSheet, h as generateIncomeStatement, i as finalizeSession, l as generateBudgetVsActual, m as generateGeneralLedger, n as reopenFiscalPeriod, o as generateRevaluation, p as generateCashFlow, r as acquireSession, s as buildRevaluationEntry, t as closeFiscalPeriod, u as generateDimensionBreakdown, v as calculateTotal, w as getFiscalYearStart, x as generateTrialBalance, y as computeEndingBalance } from "./fiscal-close-B6LhQ10f.mjs";
+import { n as Errors, t as AccountingError } from "./errors-B7yC-Jfw.mjs";
+import { c as getNormalBalance, d as isValidCategory, l as isBalanceSheet, n as CATEGORY_KEYS, t as CATEGORIES, u as isIncomeStatement } from "./categories-CclX7Q94.mjs";
+import { n as wireJournalEntryMethods, r as wireReconciliationMethods, t as wireAccountMethods } from "./account.repository-BpkSd6q3.mjs";
 import { Money, add, allocate, format, formatPlain, fromDecimal, multiply, parseCents, percentage, splitTaxExclusive, splitTaxInclusive, subtract, toDecimal } from "./money.mjs";
-import { n as wireJournalEntryMethods, t as wireAccountMethods } from "./account.repository-Crf5DGO4.mjs";
-import { n as fiscalLockPlugin, r as doubleEntryPlugin, t as idempotencyPlugin } from "./idempotency.plugin-C6r8RI8d.mjs";
-import { i as isValidCurrency, n as getCurrency, r as getMinorUnit, t as CURRENCIES } from "./currencies-BBk3NwXn.mjs";
+import { i as doubleEntryPlugin, n as idempotencyPlugin, r as fiscalLockPlugin, t as dateLockPlugin } from "./date-lock.plugin-eYAJ9h_u.mjs";
+import { i as isValidCurrency, n as getCurrency, r as getMinorUnit, t as CURRENCIES } from "./currencies-W8kQAkm0.mjs";
 import { defineCountryPack } from "./country/index.mjs";
-import { a as exportToCsv, n as quickbooksFieldMap, r as flattenJournalEntries, t as universalFieldMap } from "./universal-CMfrZ2hG.mjs";
-
+import { a as exportToCsv, n as quickbooksFieldMap, r as flattenJournalEntries, t as universalFieldMap } from "./exports-I5Xkq-9_.mjs";
+import { Schema } from "mongoose";
 //#region src/engine.ts
 var AccountingEngine = class {
 	config;
@@ -31,12 +30,19 @@ var AccountingEngine = class {
 	createFiscalPeriodSchema(options) {
 		return createFiscalPeriodSchema(this.config, options);
 	}
+	createBudgetSchema(options) {
+		return createBudgetSchema(this.config, options);
+	}
+	createReconciliationSchema(accountModelName, journalEntryModelName, options) {
+		return createReconciliationSchema(this.config, accountModelName, journalEntryModelName, options);
+	}
 	createReports(models) {
-		const { Account: AccountModel, JournalEntry: JournalEntryModel } = models;
+		const { Account: AccountModel, JournalEntry: JournalEntryModel, Budget: BudgetModel } = models;
 		const { country, config } = this;
 		const orgField = config.multiTenant?.orgField;
 		const fiscalYearStartMonth = config.fiscalYearStartMonth ?? 1;
-		const retainedEarningsCode = config.retainedEarningsCode;
+		const retainedEarningsAccountCode = config.retainedEarningsAccountCode;
+		const retainedEarningsDisplayCode = config.retainedEarningsDisplayCode;
 		const currentYearEarningsCode = config.currentYearEarningsCode;
 		return {
 			trialBalance: (params) => generateTrialBalance({
@@ -52,7 +58,8 @@ var AccountingEngine = class {
 				country,
 				orgField,
 				fiscalYearStartMonth,
-				retainedEarningsCode,
+				retainedEarningsAccountCode,
+				retainedEarningsDisplayCode,
 				currentYearEarningsCode
 			}, params),
 			incomeStatement: (params) => generateIncomeStatement({
@@ -73,6 +80,35 @@ var AccountingEngine = class {
 				JournalEntryModel,
 				country,
 				orgField
+			}, params),
+			agedBalance: (params) => generateAgedBalance({
+				AccountModel,
+				JournalEntryModel,
+				country,
+				orgField
+			}, params),
+			dimensionBreakdown: (params) => generateDimensionBreakdown({
+				AccountModel,
+				JournalEntryModel,
+				country,
+				orgField
+			}, params),
+			budgetVsActual: (params) => {
+				if (!BudgetModel) throw new Error("Budget model required — pass Budget to createReports()");
+				return generateBudgetVsActual({
+					AccountModel,
+					JournalEntryModel,
+					BudgetModel,
+					country,
+					orgField
+				}, params);
+			},
+			revaluation: (params) => generateRevaluation({
+				AccountModel,
+				JournalEntryModel,
+				country,
+				orgField,
+				baseCurrency: this.currency
 			}, params)
 		};
 	}
@@ -111,23 +147,22 @@ var AccountingEngine = class {
 	createJournalEntryRepository(createRepository, models, additionalPlugins = []) {
 		const orgField = this.config.multiTenant?.orgField;
 		const { JournalEntryModel, AccountModel, FiscalPeriodModel } = models;
+		const jeModel = JournalEntryModel;
 		const plugins = [...additionalPlugins, doubleEntryPlugin({
-			JournalEntryModel,
+			JournalEntryModel: jeModel,
 			AccountModel,
 			orgField
 		})];
 		if (FiscalPeriodModel) plugins.push(fiscalLockPlugin({
 			FiscalPeriodModel,
-			JournalEntryModel,
+			JournalEntryModel: jeModel,
 			orgField
 		}));
 		if (this.config.idempotency) plugins.push(idempotencyPlugin({
-			JournalEntryModel,
+			JournalEntryModel: jeModel,
 			orgField
 		}));
-		const repository = createRepository(JournalEntryModel, plugins);
-		wireJournalEntryMethods(repository, JournalEntryModel, orgField, this.config.strictness);
-		return repository;
+		return wireJournalEntryMethods(createRepository(JournalEntryModel, plugins), JournalEntryModel, orgField, this.config.strictness);
 	}
 	/**
 	* Wire post/reverse domain methods onto a mongokit Repository
@@ -144,8 +179,7 @@ var AccountingEngine = class {
 	*/
 	wireJournalEntryRepository(repository, JournalEntryModel) {
 		const orgField = this.config.multiTenant?.orgField;
-		wireJournalEntryMethods(repository, JournalEntryModel, orgField, this.config.strictness);
-		return repository;
+		return wireJournalEntryMethods(repository, JournalEntryModel, orgField, this.config.strictness);
 	}
 	/**
 	* Wire seedAccounts/bulkCreate and posting-account validation onto a
@@ -158,14 +192,77 @@ var AccountingEngine = class {
 	*/
 	wireAccountRepository(repository, AccountModel) {
 		const orgField = this.config.multiTenant?.orgField;
-		wireAccountMethods(repository, AccountModel, this.country, orgField);
-		return repository;
+		return wireAccountMethods(repository, AccountModel, this.country, orgField);
+	}
+	/**
+	* Wire reconcile/unreconcile/getUnreconciled methods onto a mongokit Repository.
+	*/
+	wireReconciliationRepository(repository, ReconciliationModel, JournalEntryModel) {
+		const orgField = this.config.multiTenant?.orgField;
+		return wireReconciliationMethods(repository, ReconciliationModel, JournalEntryModel, orgField);
 	}
 };
 function createAccountingEngine(config) {
 	return new AccountingEngine(config);
 }
-
 //#endregion
-export { AccountingEngine, AccountingError, CATEGORIES, CATEGORY_KEYS, CURRENCIES, Errors, JOURNAL_CODES, JOURNAL_TYPES, Money, 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.mjs.map
+//#region src/utils/dimensions.ts
+/**
+* Analytic Dimensions — Helpers for defining analytic dimensions
+* (department, project, cost center) on journal items.
+*
+* Generates Mongoose schema fields and indexes for dimension queries.
+*/
+/**
+* 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 }, ... }
+* ```
+*/
+function buildDimensionFields(dimensions) {
+	const fields = {};
+	for (const dim of dimensions) {
+		const fieldDef = {
+			type: Schema.Types.ObjectId,
+			required: dim.required ?? false,
+			default: null
+		};
+		if (dim.ref) fieldDef.ref = dim.ref;
+		fields[dim.field] = fieldDef;
+	}
+	return fields;
+}
+/**
+* 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
+*/
+function buildDimensionIndexes(dimensions, orgField) {
+	return dimensions.map((dim) => {
+		const fields = {};
+		if (orgField) fields[orgField] = 1;
+		fields[`journalItems.${dim.field}`] = 1;
+		fields.date = -1;
+		return {
+			fields,
+			options: {}
+		};
+	});
+}
+//#endregion
+export { AccountingEngine, AccountingError, CATEGORIES, CATEGORY_KEYS, CURRENCIES, DEFAULT_BUCKETS, Errors, JOURNAL_CODES, JOURNAL_TYPES, Money, 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, generateCashFlow, generateDimensionBreakdown, generateGeneralLedger, generateIncomeStatement, generateRevaluation, 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, wireReconciliationMethods };

package/dist/{journals-CI3Wb4EF.mjs → journals-oH-FK3g8.mjs}

@@ -86,7 +86,5 @@ function isValidJournalType(code) {
 function getJournalType(code) {
 	return JOURNAL_TYPES[code] ?? null;
 }
-
 //#endregion
 export { isValidJournalType as a, getJournalTypeCodes as i, JOURNAL_TYPES as n, getJournalType as r, JOURNAL_CODES as t };
-//# sourceMappingURL=journals-CI3Wb4EF.mjs.map

package/dist/{logger-Cv6VVc4r.d.mts → logger-CbHWZl7v.d.mts}

@@ -11,5 +11,4 @@ interface Logger {
 /** Default console-based implementation */
 declare const defaultLogger: Logger;
 //#endregion
-export { defaultLogger as n, Logger as t };
-//# sourceMappingURL=logger-Cv6VVc4r.d.mts.map
+export { defaultLogger as n, Logger as t };

package/dist/money.d.mts

@@ -125,5 +125,4 @@ declare const Money: {
   readonly parseCents: typeof parseCents;
 };
 //#endregion
-export { Money, abs, add, allocate, equals, format, formatPlain, fromDecimal, isNegative, isPositive, isValid, isZero, max, min, multiply, negate, parseCents, percentage, round, splitTaxExclusive, splitTaxInclusive, subtract, toDecimal };
-//# sourceMappingURL=money.d.mts.map
+export { Money, abs, add, allocate, equals, format, formatPlain, fromDecimal, isNegative, isPositive, isValid, isZero, max, min, multiply, negate, parseCents, percentage, round, splitTaxExclusive, splitTaxInclusive, subtract, toDecimal };

package/dist/money.mjs

@@ -30,7 +30,9 @@ function round(amount) {
 /** Convert a decimal dollar amount to integer cents: 10.50 → 1050 */
 function fromDecimal(dollars, minorUnit = 2) {
 	const factor = 10 ** minorUnit;
-	return Math.round(dollars * factor);
+	const cents = Math.round(dollars * factor);
+	if (!Number.isSafeInteger(cents)) throw new Error(`Amount ${dollars} exceeds safe integer limit when converted to minor units. Max safe amount: ${Number.MAX_SAFE_INTEGER / factor}`);
+	return cents;
 }
 /** Convert integer cents to a decimal dollar amount: 1050 → 10.50 */
 function toDecimal(cents, minorUnit = 2) {
@@ -191,7 +193,5 @@ const Money = {
 	isValid,
 	parseCents
 };
-
 //#endregion
 export { Money, abs, add, allocate, equals, format, formatPlain, fromDecimal, isNegative, isPositive, isValid, isZero, max, min, multiply, negate, parseCents, percentage, round, splitTaxExclusive, splitTaxInclusive, subtract, toDecimal };
-//# sourceMappingURL=money.mjs.map

package/dist/plugins/index.d.mts

@@ -1,2 +1,38 @@
-import { a as DoubleEntryPluginOptions, i as fiscalLockPlugin, n as idempotencyPlugin, o as doubleEntryPlugin, r as FiscalLockPluginOptions, t as IdempotencyPluginOptions } from "../idempotency.plugin-BESs9YPD.mjs";
-export { type DoubleEntryPluginOptions, type FiscalLockPluginOptions, type IdempotencyPluginOptions, doubleEntryPlugin, fiscalLockPlugin, idempotencyPlugin };
+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-B_CNsInz.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 };

package/dist/plugins/index.mjs

@@ -1,3 +1,57 @@
-import { n as fiscalLockPlugin, r as doubleEntryPlugin, t as idempotencyPlugin } from "../idempotency.plugin-C6r8RI8d.mjs";
-
-export { doubleEntryPlugin, fiscalLockPlugin, idempotencyPlugin };
+import { i as doubleEntryPlugin, n as idempotencyPlugin, r as fiscalLockPlugin, t as dateLockPlugin } from "../date-lock.plugin-eYAJ9h_u.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 };

package/dist/reconciliation.repository-CW4-8q90.d.mts

@@ -0,0 +1,135 @@
+import { t as CountryPack } from "./index-CxZqRaOU.mjs";
+import { s as StrictnessConfig } from "./engine-Cn-9yerQ.mjs";
+import { ClientSession, Model } from "mongoose";
+import { Repository } from "@classytic/mongokit";
+
+//#region src/types/repositories.d.ts
+interface PostOptions {
+  session?: ClientSession | null;
+  /** Actor performing this operation (required when strictness.requireActor is enabled) */
+  actorId?: unknown;
+}
+interface ReverseOptions extends PostOptions {
+  /** Date for the reversal entry (defaults to now) */
+  reversalDate?: Date;
+}
+interface SeedOptions {
+  session?: ClientSession | null;
+}
+interface SeedResult {
+  created: number;
+  skipped: number;
+}
+interface BulkCreateInput {
+  accountTypeCode?: string;
+  accountNumber?: string;
+  name?: string;
+  active?: boolean;
+  isCashAccount?: boolean;
+}
+interface BulkCreateResult {
+  summary: {
+    total: number;
+    created: number;
+    skipped: number;
+    errors: number;
+  };
+  created: Array<Record<string, unknown>>;
+  skipped: Array<Record<string, unknown>>;
+  errors: Array<Record<string, unknown>>;
+}
+interface ReverseResult {
+  original: Record<string, unknown>;
+  reversal: Record<string, unknown>;
+}
+interface ReconcileParams {
+  accountId: unknown;
+  journalEntryIds: unknown[];
+  organizationId?: unknown;
+  note?: string;
+  session?: ClientSession;
+}
+/**
+ * Journal Entry Repository — extends mongokit Repository with accounting domain methods.
+ *
+ * Inherits ALL Repository<TDoc> methods: create, getById, getAll, update,
+ * delete, count, exists, distinct, aggregate, withTransaction, etc.
+ */
+interface JournalEntryRepository<TDoc = unknown> extends Repository<TDoc> {
+  /** Post an entry (draft → posted). Validates items, balance, and accounts. */
+  post(id: unknown, orgId?: unknown, options?: PostOptions): Promise<Record<string, unknown>>;
+  /** Unpost an entry (posted → draft). Resets state for re-editing. */
+  unpost(id: unknown, orgId?: unknown, options?: PostOptions): Promise<Record<string, unknown>>;
+  /** Archive a draft entry (draft → archived). Preserves audit trail. */
+  archive(id: unknown, orgId?: unknown, options?: PostOptions): Promise<Record<string, unknown>>;
+  /** Duplicate an entry as a new draft. Copies items, type, and label. */
+  duplicate(id: unknown, orgId?: unknown, options?: PostOptions): Promise<Record<string, unknown>>;
+  /** Reverse a posted entry. Creates mirror entry with flipped debits/credits. */
+  reverse(id: unknown, orgId?: unknown, options?: ReverseOptions): Promise<ReverseResult>;
+}
+/**
+ * Account Repository — extends mongokit Repository with seed and bulk operations.
+ */
+interface AccountRepository<TDoc = unknown> extends Repository<TDoc> {
+  /** Seed standard posting accounts for an org from the country pack. */
+  seedAccounts(orgId: unknown, options?: SeedOptions): Promise<SeedResult>;
+  /** Bulk create accounts with validation and skip-if-exists logic. */
+  bulkCreate(accounts: BulkCreateInput[], orgId: unknown): Promise<BulkCreateResult>;
+}
+/**
+ * Reconciliation Repository — extends mongokit Repository with bank reconciliation methods.
+ */
+interface ReconciliationRepository<TDoc = unknown> extends Repository<TDoc> {
+  /** Reconcile journal entries for a specific account. */
+  reconcile(params: ReconcileParams): Promise<Record<string, unknown>>;
+  /** Remove a reconciliation record. */
+  unreconcile(params: {
+    reconciliationId: unknown;
+    organizationId?: unknown;
+  }): Promise<{
+    success: boolean;
+  }>;
+  /** Get unreconciled journal entries for an account. */
+  getUnreconciled(params: {
+    accountId: unknown;
+    organizationId?: unknown;
+  }): Promise<Record<string, unknown>[]>;
+}
+//#endregion
+//#region src/repositories/journal-entry.repository.d.ts
+/**
+ * Wire post/reverse onto an existing mongokit Repository.
+ *
+ * All reads use `repository.getByQuery()` so registered plugins
+ * (multi-tenant, audit, cache) fire on every operation.
+ *
+ * @param repository - A mongokit Repository instance (already created)
+ * @param _JournalEntryModel - (Deprecated) The Mongoose model — no longer used internally; kept for API compat
+ * @param orgField - The multi-tenant field name (e.g. 'business')
+ * @param strictness - Strictness rules (immutable, requireActor, requireApproval)
+ */
+declare function wireJournalEntryMethods<TDoc = unknown>(repository: Repository<TDoc>, _JournalEntryModel: unknown, orgField?: string, strictness?: StrictnessConfig): JournalEntryRepository<TDoc>;
+//#endregion
+//#region src/repositories/account.repository.d.ts
+/**
+ * Wire seedAccounts, bulkCreate and posting-account validation
+ * onto an existing mongokit Repository.
+ *
+ * @param repository - A mongokit Repository instance (already created)
+ * @param AccountModel - The Mongoose model for accounts
+ * @param country - The CountryPack for account type lookups
+ * @param orgField - The multi-tenant field name (e.g. 'business')
+ */
+declare function wireAccountMethods<TDoc = unknown>(repository: Repository<TDoc>, AccountModel: Model<unknown>, country: CountryPack, orgField?: string): AccountRepository<TDoc>;
+//#endregion
+//#region src/repositories/reconciliation.repository.d.ts
+/**
+ * Wire reconciliation methods onto an existing mongokit Repository.
+ *
+ * - reconcile() uses repository.create() so hooks (multi-tenant, audit) fire
+ * - unreconcile() uses repository.delete() so hooks fire
+ * - Cross-repo reads (JournalEntryModel) use direct Model access (acceptable)
+ */
+declare function wireReconciliationMethods<TDoc = unknown>(repository: Repository<TDoc>, _ReconciliationModel: Model<unknown>, JournalEntryModel: Model<unknown>, orgField?: string): ReconciliationRepository<TDoc>;
+//#endregion
+export { BulkCreateInput as a, PostOptions as c, ReverseOptions as d, ReverseResult as f, AccountRepository as i, ReconcileParams as l, SeedResult as m, wireAccountMethods as n, BulkCreateResult as o, SeedOptions as p, wireJournalEntryMethods as r, JournalEntryRepository as s, wireReconciliationMethods as t, ReconciliationRepository as u };