@classytic/ledger 0.2.0 → 0.4.0

package/dist/index.mjs

@@ -1,15 +1,15 @@
-import { n as createJournalEntrySchema, r as createAccountSchema, t as createFiscalPeriodSchema } from "./fiscal-period.schema-BQ5wsAq3.mjs";
-import { a as isValidJournalType, i as getJournalTypeCodes, n as JOURNAL_TYPES, t as JOURNAL_CODES } from "./journals-oH-FK3g8.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-L631E3De.mjs";
-import { n as Errors, t as AccountingError } from "./errors-B7yC-Jfw.mjs";
-import { n as finalizeSession, r as defaultLogger, t as acquireSession } from "./session-Ba8E3Ufa.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 { 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-kDKwDt0I.mjs";
-import { n as fiscalLockPlugin, r as doubleEntryPlugin, t as idempotencyPlugin } from "./idempotency.plugin-v9NQ_ta-.mjs";
+import { n as Errors, t as AccountingError } from "./errors-BoGUSUYL.mjs";
+import { i as doubleEntryPlugin, n as idempotencyPlugin, r as fiscalLockPlugin, t as dateLockPlugin } from "./date-lock.plugin-C8kqPBjh.mjs";
+import { C as DEFAULT_BUCKETS, S as isVirtualTaxAccount, _ as getDateRange, a as defaultLogger, b as calculateTotal, c as buildRevaluationEntry, d as generateGeneralLedger, f as generateDimensionBreakdown, g as buildItemFilters, h as generateBalanceSheet, i as finalizeSession, l as computeRevaluation, m as generateBudgetVsActual, n as reopenFiscalPeriod, o as generateTrialBalance, p as generateCashFlow, r as acquireSession, s as generateRevaluation, t as closeFiscalPeriod, u as generateIncomeStatement, v as getFiscalYearStart, w as generateAgedBalance, x as computeEndingBalance, y as buildAccountTypeMap } from "./fiscal-close-DmPV82e4.mjs";
+import { c as getNormalBalance, d as isValidCategory, l as isBalanceSheet, n as CATEGORY_KEYS, t as CATEGORIES, u as isIncomeStatement } from "./categories-FJlrvzcl.mjs";
+import { n as wireJournalEntryMethods, r as wireAccountMethods, t as wireReconciliationMethods } from "./reconciliation.repository-DgJEDVS-.mjs";
+import { a as createAccountSchema, i as createBudgetSchema, n as createJournalEntrySchema, r as createFiscalPeriodSchema, t as createReconciliationSchema } from "./reconciliation.schema-KScbsXbY.mjs";
+import { a as getJournalType, c as registerJournalType, i as getCustomJournalTypes, n as JOURNAL_TYPES, o as getJournalTypeCodes, s as isValidJournalType, t as JOURNAL_CODES } from "./journals-BcMn71Cq.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 "./exports-I5Xkq-9_.mjs";
+import { a as exportToCsv, i as quickbooksFieldMap, r as universalFieldMap, t as flattenJournalEntries } from "./exports-DoGQQtMQ.mjs";
+import { Schema } from "mongoose";
 //#region src/engine.ts
 var AccountingEngine = class {
 	config;
@@ -30,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({
@@ -51,7 +58,8 @@ var AccountingEngine = class {
 				country,
 				orgField,
 				fiscalYearStartMonth,
-				retainedEarningsCode,
+				retainedEarningsAccountCode,
+				retainedEarningsDisplayCode,
 				currentYearEarningsCode
 			}, params),
 			incomeStatement: (params) => generateIncomeStatement({
@@ -72,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)
 		};
 	}
@@ -110,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
@@ -143,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
@@ -157,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, 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 };

package/dist/journal-entry.schema-B1CzLwC3.d.mts

@@ -0,0 +1,103 @@
+import { o as SchemaOptions, r as JournalSchemaOptions, t as AccountingEngineConfig } from "./engine-DF-MtsEr.mjs";
+import mongoose from "mongoose";
+
+//#region src/schemas/account.schema.d.ts
+declare function createAccountSchema(config: AccountingEngineConfig, options?: SchemaOptions): mongoose.Schema<any, mongoose.Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
+  timestamps: true;
+}, {
+  [x: number]: any;
+  [x: string]: any;
+} & mongoose.DefaultTimestampProps, mongoose.Document<unknown, {}, {
+  [x: number]: any;
+  [x: string]: any;
+} & mongoose.DefaultTimestampProps, {
+  id: string;
+}, Omit<mongoose.DefaultSchemaOptions, "timestamps"> & {
+  timestamps: true;
+}> & Omit<{
+  [x: number]: any;
+  [x: string]: any;
+} & mongoose.DefaultTimestampProps & {
+  _id: mongoose.Types.ObjectId;
+} & {
+  __v: number;
+}, "id"> & {
+  id: string;
+}, unknown, {
+  [x: number]: any;
+  [x: string]: any;
+  createdAt: NativeDate;
+  updatedAt: NativeDate;
+} & {
+  _id: mongoose.Types.ObjectId;
+} & {
+  __v: number;
+}>;
+//#endregion
+//#region src/schemas/fiscal-period.schema.d.ts
+declare function createFiscalPeriodSchema(config: AccountingEngineConfig, options?: SchemaOptions): mongoose.Schema<any, mongoose.Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
+  timestamps: true;
+}, {
+  [x: number]: any;
+  [x: string]: any;
+} & mongoose.DefaultTimestampProps, mongoose.Document<unknown, {}, {
+  [x: number]: any;
+  [x: string]: any;
+} & mongoose.DefaultTimestampProps, {
+  id: string;
+}, Omit<mongoose.DefaultSchemaOptions, "timestamps"> & {
+  timestamps: true;
+}> & Omit<{
+  [x: number]: any;
+  [x: string]: any;
+} & mongoose.DefaultTimestampProps & {
+  _id: mongoose.Types.ObjectId;
+} & {
+  __v: number;
+}, "id"> & {
+  id: string;
+}, unknown, {
+  [x: number]: any;
+  [x: string]: any;
+  createdAt: NativeDate;
+  updatedAt: NativeDate;
+} & {
+  _id: mongoose.Types.ObjectId;
+} & {
+  __v: number;
+}>;
+//#endregion
+//#region src/schemas/journal-entry.schema.d.ts
+declare function createJournalEntrySchema(config: AccountingEngineConfig, accountModelName: string, options?: JournalSchemaOptions): mongoose.Schema<any, mongoose.Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
+  timestamps: true;
+}, {
+  [x: number]: any;
+  [x: string]: any;
+} & mongoose.DefaultTimestampProps, mongoose.Document<unknown, {}, {
+  [x: number]: any;
+  [x: string]: any;
+} & mongoose.DefaultTimestampProps, {
+  id: string;
+}, Omit<mongoose.DefaultSchemaOptions, "timestamps"> & {
+  timestamps: true;
+}> & Omit<{
+  [x: number]: any;
+  [x: string]: any;
+} & mongoose.DefaultTimestampProps & {
+  _id: mongoose.Types.ObjectId;
+} & {
+  __v: number;
+}, "id"> & {
+  id: string;
+}, unknown, {
+  [x: number]: any;
+  [x: string]: any;
+  createdAt: NativeDate;
+  updatedAt: NativeDate;
+} & {
+  _id: mongoose.Types.ObjectId;
+} & {
+  __v: number;
+}>;
+//#endregion
+export { createFiscalPeriodSchema as n, createAccountSchema as r, createJournalEntrySchema as t };

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

@@ -77,16 +77,37 @@ const JOURNAL_TYPES = Object.freeze({
 	}
 });
 const JOURNAL_CODES = Object.freeze(Object.fromEntries(Object.keys(JOURNAL_TYPES).map((k) => [k, k])));
+const _customTypes = {};
+let _frozen = false;
+/**
+* Register a custom journal type. Must be called **before** schema
+* initialization (`createJournalEntrySchema`). Custom types are
+* automatically included in Mongoose enum validation and all lookup
+* functions.
+*/
+function registerJournalType(code, def) {
+	if (_frozen) throw new Error("Cannot register journal types after schema initialization");
+	if (code in JOURNAL_TYPES) throw new Error(`Cannot override built-in journal type: ${code}`);
+	if (def.code !== code) throw new Error(`Journal type code mismatch: key="${code}" but def.code="${def.code}"`);
+	if (!def.name || !def.description) throw new Error(`Journal type "${code}" requires non-empty name and description`);
+	_customTypes[code] = def;
+}
+/** Returns all custom (non-built-in) journal types. */
+function getCustomJournalTypes() {
+	return Object.values(_customTypes);
+}
+/** @internal Lock the registry — called by `createJournalEntrySchema`. */
+function _freezeJournalTypes() {
+	_frozen = true;
+}
 function getJournalTypeCodes() {
-	return Object.keys(JOURNAL_TYPES);
+	return [...Object.keys(JOURNAL_TYPES), ...Object.keys(_customTypes)];
 }
 function isValidJournalType(code) {
-	return code in JOURNAL_TYPES;
+	return code in JOURNAL_TYPES || code in _customTypes;
 }
 function getJournalType(code) {
-	return JOURNAL_TYPES[code] ?? null;
+	return JOURNAL_TYPES[code] ?? _customTypes[code] ?? null;
 }
 //#endregion
-export { isValidJournalType as a, getJournalTypeCodes as i, JOURNAL_TYPES as n, getJournalType as r, JOURNAL_CODES as t };
-
-//# sourceMappingURL=journals-oH-FK3g8.mjs.map
+export { getJournalType as a, registerJournalType as c, getCustomJournalTypes as i, JOURNAL_TYPES as n, getJournalTypeCodes as o, _freezeJournalTypes as r, isValidJournalType as s, JOURNAL_CODES as t };

package/dist/{currencies-4WAbFRlw.d.mts → journals-DTipb_rz.d.mts}

@@ -21,18 +21,26 @@ declare function extractMainType(key: string): MainType | null;
 /** Extract statement type from a category key string */
 declare function extractStatementType(key: string): StatementType | null;
 //#endregion
+//#region src/constants/currencies.d.ts
+declare const CURRENCIES: Readonly<Record<string, Currency>>;
+declare function getCurrency(code: string): Currency | null;
+declare function isValidCurrency(code: string): boolean;
+declare function getMinorUnit(code: string): number;
+//#endregion
 //#region src/constants/journals.d.ts
 declare const JOURNAL_TYPES: Readonly<Record<string, JournalType>>;
 declare const JOURNAL_CODES: Readonly<Record<string, string>>;
+/**
+ * Register a custom journal type. Must be called **before** schema
+ * initialization (`createJournalEntrySchema`). Custom types are
+ * automatically included in Mongoose enum validation and all lookup
+ * functions.
+ */
+declare function registerJournalType(code: string, def: JournalType): void;
+/** Returns all custom (non-built-in) journal types. */
+declare function getCustomJournalTypes(): JournalType[];
 declare function getJournalTypeCodes(): string[];
 declare function isValidJournalType(code: string): boolean;
 declare function getJournalType(code: string): JournalType | null;
 //#endregion
-//#region src/constants/currencies.d.ts
-declare const CURRENCIES: Readonly<Record<string, Currency>>;
-declare function getCurrency(code: string): Currency | null;
-declare function isValidCurrency(code: string): boolean;
-declare function getMinorUnit(code: string): number;
-//#endregion
-export { getNormalBalance as _, JOURNAL_CODES as a, isValidCategory as b, getJournalTypeCodes as c, CATEGORY_KEYS as d, categoryKey as f, getCategoryStatementType as g, getCategoryMainType as h, isValidCurrency as i, isValidJournalType as l, extractStatementType as m, getCurrency as n, JOURNAL_TYPES as o, extractMainType as p, getMinorUnit as r, getJournalType as s, CURRENCIES as t, CATEGORIES as u, isBalanceSheet as v, isIncomeStatement as y };
-//# sourceMappingURL=currencies-4WAbFRlw.d.mts.map
+export { isValidCategory as S, getCategoryMainType as _, getJournalTypeCodes as a, isBalanceSheet as b, CURRENCIES as c, isValidCurrency as d, CATEGORIES as f, extractStatementType as g, extractMainType as h, getJournalType as i, getCurrency as l, categoryKey as m, JOURNAL_TYPES as n, isValidJournalType as o, CATEGORY_KEYS as p, getCustomJournalTypes as r, registerJournalType as s, JOURNAL_CODES as t, getMinorUnit as u, getCategoryStatementType as v, isIncomeStatement as x, getNormalBalance as y };

package/dist/logger-UbTdBb1x.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-UbTdBb1x.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) {
@@ -91,7 +93,7 @@ function allocate(totalCents, ratios) {
 	const ratioSum = ratios.reduce((s, r) => s + r, 0);
 	if (ratioSum === 0) throw new Error("Sum of ratios must be > 0");
 	const allocations = ratios.map((r) => Math.floor(totalCents * r / ratioSum));
-	let remainder = totalCents - allocations.reduce((s, a) => s + a, 0);
+	const remainder = totalCents - allocations.reduce((s, a) => s + a, 0);
 	const fractions = ratios.map((r, i) => ({
 		index: i,
 		frac: totalCents * r / ratioSum - allocations[i]
@@ -164,7 +166,7 @@ function parseCents(input, minorUnit = 2) {
 	if (typeof input === "number") return fromDecimal(input, minorUnit);
 	const cleaned = input.replace(/[$,\s]/g, "");
 	const parsed = parseFloat(cleaned);
-	if (isNaN(parsed)) throw new Error(`Cannot parse "${input}" as money`);
+	if (Number.isNaN(parsed)) throw new Error(`Cannot parse "${input}" as money`);
 	return fromDecimal(parsed, minorUnit);
 }
 const Money = {
@@ -193,5 +195,3 @@ const Money = {
 };
 //#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-CPxPt4vX.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-zU-GKJ0-.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,2 +1,57 @@
-import { n as fiscalLockPlugin, r as doubleEntryPlugin, t as idempotencyPlugin } from "../idempotency.plugin-v9NQ_ta-.mjs";
-export { doubleEntryPlugin, fiscalLockPlugin, idempotencyPlugin };
+import { i as doubleEntryPlugin, n as idempotencyPlugin, r as fiscalLockPlugin, t as dateLockPlugin } from "../date-lock.plugin-C8kqPBjh.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 };