@classytic/ledger 0.1.5 → 0.3.0

package/dist/country/index.d.mts

@@ -1,105 +1,2 @@
-import { t as AccountType } from "../core-Cx0baosR.mjs";
-
-//#region src/country/index.d.ts
-interface TaxCode {
-  readonly code: string;
-  readonly name: string;
-  readonly taxType: string;
-  readonly rate: number;
-  readonly direction: 'collected' | 'recoverable' | 'paid';
-  readonly province?: string;
-  readonly reportLines?: readonly number[];
-  readonly description: string;
-  readonly active: boolean;
-}
-interface TaxCodesByRegion {
-  readonly [region: string]: readonly string[];
-}
-interface TaxReportLine {
-  readonly line: number | string;
-  readonly name: string;
-  readonly description: string;
-  readonly type: 'input' | 'calculated' | 'manual';
-  readonly calculate?: (data: Record<string | number, number>) => number;
-  readonly section: string;
-}
-interface TaxReportTemplate {
-  readonly name: string;
-  readonly lines: Readonly<Record<string | number, TaxReportLine>>;
-  calculate(inputData: Record<string | number, number>, manualData?: Record<string | number, number>): Record<string | number, number>;
-  summarize(calculated: Record<string | number, number>): Record<string, unknown>;
-}
-interface CountryPack {
-  /** ISO 3166-1 alpha-2 code (e.g., 'CA', 'US', 'GB') */
-  readonly code: string;
-  /** Country name */
-  readonly name: string;
-  /** Default currency code */
-  readonly defaultCurrency: string;
-  /**
-   * Full chart of accounts template — flat array of account type definitions.
-   * Includes both regular accounts and virtual tax sub-accounts.
-   */
-  readonly accountTypes: readonly AccountType[];
-  /** Tax codes indexed by code string */
-  readonly taxCodes: Readonly<Record<string, TaxCode>>;
-  /** Tax codes grouped by region/province/state */
-  readonly taxCodesByRegion: TaxCodesByRegion;
-  /** Available regions (provinces/states) */
-  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) */
-  readonly currentYearEarningsCode?: string;
-  /** Group label code used to identify Cost of Sales in the income statement */
-  readonly cogsGroupCode?: string;
-  /** Override default English report section names */
-  readonly reportLabels?: {
-    readonly assets?: string;
-    readonly liabilities?: string;
-    readonly equity?: string;
-    readonly revenue?: string;
-    readonly expenses?: string;
-  };
-  /** Get all account types that can be posted to (not groups, not totals) */
-  getPostingAccountTypes(): readonly AccountType[];
-  /** Get account type by code */
-  getAccountType(code: string): AccountType | undefined;
-  /** Validate an account type code exists */
-  isValidAccountType(code: string): boolean;
-  /** Check if an account type can receive postings */
-  isPostingAccount(code: string): boolean;
-  /** Get tax codes for a specific region */
-  getTaxCodesForRegion(region: string): TaxCode[];
-  /** Flatten hierarchical accounts (if needed) */
-  flattenAccountTypes(): readonly AccountType[];
-}
-interface CountryPackInput {
-  code: string;
-  name: string;
-  defaultCurrency: string;
-  accountTypes: readonly AccountType[];
-  taxCodes: Readonly<Record<string, TaxCode>>;
-  taxCodesByRegion: TaxCodesByRegion;
-  regions: readonly string[];
-  taxReport?: TaxReportTemplate;
-  retainedEarningsCode?: string;
-  currentYearEarningsCode?: string;
-  cogsGroupCode?: string;
-  reportLabels?: {
-    readonly assets?: string;
-    readonly liabilities?: string;
-    readonly equity?: string;
-    readonly revenue?: string;
-    readonly expenses?: string;
-  };
-}
-/**
- * Factory to create a CountryPack with auto-generated helper methods.
- */
-declare function defineCountryPack(input: CountryPackInput): CountryPack;
-//#endregion
-export { CountryPack, CountryPackInput, TaxCode, TaxCodesByRegion, TaxReportLine, TaxReportTemplate, defineCountryPack };
-//# sourceMappingURL=index.d.mts.map
+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";
+export { CountryPack, CountryPackInput, TaxCode, TaxCodesByRegion, TaxReportLine, TaxReportTemplate, defineCountryPack };

package/dist/country/index.mjs

@@ -21,7 +21,5 @@ function defineCountryPack(input) {
 		flattenAccountTypes: () => input.accountTypes
 	};
 }
-
 //#endregion
 export { defineCountryPack };
-//# sourceMappingURL=index.mjs.map

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

@@ -1,4 +1,4 @@
-import { d as JournalType, f as MainType, h as StatementType, i as CategoryKey, o as Currency, r as Category } from "./core-Cx0baosR.mjs";
+import { d as JournalType, f as MainType, h as StatementType, i as CategoryKey, o as Currency, r as Category } from "./core-8Xfnpn6g.mjs";
 
 //#region src/constants/categories.d.ts
 /** All valid categories */
@@ -34,5 +34,4 @@ 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-Bkn3FNkC.d.mts.map
+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 };

package/dist/{currencies-BBk3NwXn.mjs → currencies-W8kQAkm0.mjs}

@@ -76,7 +76,5 @@ function isValidCurrency(code) {
 function getMinorUnit(code) {
 	return CURRENCIES[code]?.minorUnit ?? 2;
 }
-
 //#endregion
 export { isValidCurrency as i, getCurrency as n, getMinorUnit as r, CURRENCIES as t };
-//# sourceMappingURL=currencies-BBk3NwXn.mjs.map

package/dist/{idempotency.plugin-C6r8RI8d.mjs → date-lock.plugin-eYAJ9h_u.mjs}

@@ -1,5 +1,4 @@
-import { n as Errors } from "./errors-CeqRahE-.mjs";
-
+import { n as Errors } from "./errors-B7yC-Jfw.mjs";
 //#region src/plugins/double-entry.plugin.ts
 function doubleEntryPlugin(options = {}) {
 	const { onlyOnPost = true, JournalEntryModel, AccountModel, orgField } = options;
@@ -81,12 +80,11 @@ function doubleEntryPlugin(options = {}) {
 					...existing
 				}, context);
 			};
-			repo.on("before:create", (payload) => validate(payload));
-			repo.on("before:update", (payload) => validateUpdate(payload));
+			repo.on("before:create", validate);
+			repo.on("before:update", validateUpdate);
 		}
 	};
 }
-
 //#endregion
 //#region src/plugins/fiscal-lock.plugin.ts
 function fiscalLockPlugin(options) {
@@ -134,12 +132,11 @@ function fiscalLockPlugin(options) {
 					throw Errors.fiscal(`Cannot post entry dated ${entryDate.toISOString().split("T")[0]}: fiscal period "${period.name}" is closed.`);
 				}
 			};
-			repo.on("before:create", (payload) => checkPeriod(payload, false));
-			repo.on("before:update", (payload) => checkPeriod(payload, true));
+			repo.on("before:create", (ctx) => checkPeriod(ctx, false));
+			repo.on("before:update", (ctx) => checkPeriod(ctx, true));
 		}
 	};
 }
-
 //#endregion
 //#region src/plugins/idempotency.plugin.ts
 function idempotencyPlugin(options) {
@@ -147,8 +144,7 @@ function idempotencyPlugin(options) {
 	return {
 		name: "accounting:idempotency",
 		apply(repo) {
-			repo.on("before:create", async (raw) => {
-				const context = raw;
+			repo.on("before:create", async (context) => {
 				const data = context.data;
 				if (!data?.idempotencyKey) return;
 				const query = { idempotencyKey: data.idempotencyKey };
@@ -159,7 +155,48 @@ function idempotencyPlugin(options) {
 		}
 	};
 }
-
 //#endregion
-export { fiscalLockPlugin as n, doubleEntryPlugin as r, idempotencyPlugin as t };
-//# sourceMappingURL=idempotency.plugin-C6r8RI8d.mjs.map
+//#region src/plugins/date-lock.plugin.ts
+function dateLockPlugin(options) {
+	const { getLockDate, JournalEntryModel, orgField } = options;
+	return {
+		name: "accounting:date-lock",
+		apply(repo) {
+			const checkLock = async (context, isUpdate) => {
+				const data = context.data;
+				if (!data) return;
+				if (data.state !== "posted") return;
+				const session = context.session ?? null;
+				let entryDate;
+				let persistedDoc = null;
+				if (data.date) entryDate = new Date(data.date);
+				else if (!isUpdate) entryDate = /* @__PURE__ */ new Date();
+				else {
+					if (!context.id) throw new Error("dateLockPlugin: update context is missing \"id\". Cannot validate date lock without document ID.");
+					const selectFields = orgField ? `date ${orgField}` : "date";
+					persistedDoc = await JournalEntryModel.findById(context.id).select(selectFields).session(session).lean();
+					if (persistedDoc?.date) entryDate = new Date(persistedDoc.date);
+				}
+				if (!entryDate) return;
+				let orgValue;
+				if (orgField) {
+					orgValue = data[orgField] ?? context[orgField];
+					if (!orgValue && isUpdate) {
+						if (persistedDoc) orgValue = persistedDoc[orgField];
+						else if (context.id) {
+							const persisted = await JournalEntryModel.findById(context.id).select(orgField).session(session).lean();
+							if (persisted) orgValue = persisted[orgField];
+						}
+					}
+				}
+				const lockDate = await getLockDate(orgValue, session ?? void 0);
+				if (!lockDate) return;
+				if (entryDate < lockDate) throw Errors.fiscal(`Cannot post entry dated ${entryDate.toISOString().split("T")[0]}: date is before lock date ${lockDate.toISOString().split("T")[0]}.`);
+			};
+			repo.on("before:create", (ctx) => checkLock(ctx, false));
+			repo.on("before:update", (ctx) => checkLock(ctx, true));
+		}
+	};
+}
+//#endregion
+export { doubleEntryPlugin as i, idempotencyPlugin as n, fiscalLockPlugin as r, dateLockPlugin as t };

package/dist/{engine-Cd73EOT6.d.mts → engine-Cn-9yerQ.d.mts}

@@ -1,5 +1,5 @@
-import { CountryPack } from "./country/index.mjs";
-import { t as Logger } from "./logger-Cv6VVc4r.mjs";
+import { t as CountryPack } from "./index-CxZqRaOU.mjs";
+import { t as Logger } from "./logger-CbHWZl7v.mjs";
 
 //#region src/types/engine.d.ts
 /** Multi-tenant configuration */
@@ -44,19 +44,50 @@ interface StrictnessConfig {
   /** If true, entries must have approvedBy/approvedAt set before posting */
   requireApproval?: boolean;
 }
+/**
+ * Multi-currency configuration.
+ * When enabled, adds currency and exchange rate fields to journal items
+ * and a currency field to accounts. Allows recording transactions in
+ * foreign currencies while maintaining a base (functional) currency.
+ *
+ * @example
+ * ```typescript
+ * const engine = createAccountingEngine({
+ *   country: canadaPack,
+ *   currency: 'CAD',          // base/functional currency
+ *   multiCurrency: {
+ *     enabled: true,
+ *     currencies: ['USD', 'GBP', 'BDT'],  // allowed foreign currencies
+ *   },
+ * });
+ * ```
+ */
+interface MultiCurrencyConfig {
+  /** Enable multi-currency fields on schemas */
+  enabled: boolean;
+  /** Allowed foreign currency codes. If omitted, any ISO 4217 code is accepted. */
+  currencies?: readonly string[];
+}
 /** Main engine configuration */
 interface AccountingEngineConfig {
   /** Country pack providing account types, tax codes, and templates */
   country: CountryPack;
-  /** Default ISO 4217 currency code (e.g., 'CAD', 'USD') */
+  /** Default ISO 4217 currency code — the functional/base currency (e.g., 'CAD', 'BDT') */
   currency: string;
   /** Multi-tenant configuration. Omit for single-tenant apps. */
   multiTenant?: MultiTenantConfig;
+  /** Multi-currency support. Omit for single-currency apps. */
+  multiCurrency?: MultiCurrencyConfig;
   /** Fiscal year start month (1-12, default: 1 = January) */
   fiscalYearStartMonth?: number;
-  /** Display code for prior retained earnings on balance sheet (default: '3660') */
-  retainedEarningsCode?: string;
-  /** Display code for current year net income on balance sheet (default: '3680') */
+  /**
+   * The retained earnings account code (e.g. '3600' CA, '3310' BD).
+   * Overrides the country pack value. See CountryPack.retainedEarningsAccountCode.
+   */
+  retainedEarningsAccountCode?: string;
+  /** Display code for the "Previous Years Retained Earnings" line. Overrides country pack. */
+  retainedEarningsDisplayCode?: string;
+  /** Display code for current year net income line. Overrides country pack. */
   currentYearEarningsCode?: string;
   /** Logger instance. Defaults to console-based logger. */
   logger?: Logger;
@@ -68,5 +99,4 @@ interface AccountingEngineConfig {
   strictness?: StrictnessConfig;
 }
 //#endregion
-export { SchemaOptions as a, MultiTenantConfig as i, AuditConfig as n, StrictnessConfig as o, JournalSchemaOptions as r, AccountingEngineConfig as t };
-//# sourceMappingURL=engine-Cd73EOT6.d.mts.map
+export { MultiTenantConfig as a, MultiCurrencyConfig as i, AuditConfig as n, SchemaOptions as o, JournalSchemaOptions as r, StrictnessConfig as s, AccountingEngineConfig as t };

package/dist/{errors-CeqRahE-.mjs → errors-B7yC-Jfw.mjs}

@@ -22,7 +22,5 @@ const Errors = {
 	immutable: (msg) => new AccountingError(msg, 403, "IMMUTABLE_ENTRY"),
 	fiscal: (msg) => new AccountingError(msg, 400, "FISCAL_ERROR")
 };
-
 //#endregion
 export { Errors as n, AccountingError as t };
-//# sourceMappingURL=errors-CeqRahE-.mjs.map

package/dist/exports/index.d.mts

@@ -1,2 +1,2 @@
-import { _ as PopulatedJournalEntry, a as exportToCsv, c as getHeaders, d as serializeCsv, f as CsvOptions, g as PopulatedAccount, h as FlatJournalRow, i as flattenJournalEntry, l as buildCsv, m as ExportFieldMap, n as quickbooksFieldMap, o as extractAllRows, p as ExportField, r as flattenJournalEntries, s as extractRow, t as universalFieldMap, u as escapeCell, v as PopulatedJournalItem } from "../universal-x33ZJODp.mjs";
-export { type CsvOptions, type ExportField, type ExportFieldMap, type FlatJournalRow, type PopulatedAccount, type PopulatedJournalEntry, type PopulatedJournalItem, buildCsv, escapeCell, exportToCsv, extractAllRows, extractRow, flattenJournalEntries, flattenJournalEntry, getHeaders, quickbooksFieldMap, serializeCsv, universalFieldMap };
+import { _ as PopulatedJournalEntry, a as exportToCsv, c as getHeaders, d as serializeCsv, f as CsvOptions, g as PopulatedAccount, h as FlatJournalRow, i as flattenJournalEntry, l as buildCsv, m as ExportFieldMap, n as quickbooksFieldMap, o as extractAllRows, p as ExportField, r as flattenJournalEntries, s as extractRow, t as universalFieldMap, u as escapeCell, v as PopulatedJournalItem } from "../index-BPukb3L8.mjs";
+export { CsvOptions, ExportField, ExportFieldMap, FlatJournalRow, PopulatedAccount, PopulatedJournalEntry, PopulatedJournalItem, buildCsv, escapeCell, exportToCsv, extractAllRows, extractRow, flattenJournalEntries, flattenJournalEntry, getHeaders, quickbooksFieldMap, serializeCsv, universalFieldMap };

package/dist/exports/index.mjs

@@ -1,3 +1,2 @@
-import { a as exportToCsv, c as getHeaders, d as serializeCsv, i as flattenJournalEntry, l as buildCsv, n as quickbooksFieldMap, o as extractAllRows, r as flattenJournalEntries, s as extractRow, t as universalFieldMap, u as escapeCell } from "../universal-CMfrZ2hG.mjs";
-
-export { buildCsv, escapeCell, exportToCsv, extractAllRows, extractRow, flattenJournalEntries, flattenJournalEntry, getHeaders, quickbooksFieldMap, serializeCsv, universalFieldMap };
+import { a as exportToCsv, c as getHeaders, d as serializeCsv, i as flattenJournalEntry, l as buildCsv, n as quickbooksFieldMap, o as extractAllRows, r as flattenJournalEntries, s as extractRow, t as universalFieldMap, u as escapeCell } from "../exports-I5Xkq-9_.mjs";
+export { buildCsv, escapeCell, exportToCsv, extractAllRows, extractRow, flattenJournalEntries, flattenJournalEntry, getHeaders, quickbooksFieldMap, serializeCsv, universalFieldMap };

package/dist/{universal-CMfrZ2hG.mjs → exports-I5Xkq-9_.mjs}

@@ -1,5 +1,4 @@
 import { Money } from "./money.mjs";
-
 //#region src/exports/csv-serializer.ts
 const NEEDS_QUOTING = /[",\r\n]/;
 /** Escape a single CSV cell value per RFC 4180. */
@@ -17,7 +16,6 @@ function buildCsv(headers, dataRows, options = {}) {
 	const { includeHeaders = true } = options;
 	return serializeCsv(includeHeaders ? [headers, ...dataRows] : [...dataRows], options);
 }
-
 //#endregion
 //#region src/exports/field-map.ts
 /** Extract headers from a field map. */
@@ -36,7 +34,6 @@ function extractAllRows(fieldMap, rows) {
 function exportToCsv(fieldMap, rows, options) {
 	return buildCsv(getHeaders(fieldMap), extractAllRows(fieldMap, rows), options);
 }
-
 //#endregion
 //#region src/exports/flatten-journal.ts
 function toDate(value) {
@@ -110,7 +107,6 @@ function flattenJournalEntries(entries) {
 	for (const entry of entries) rows.push(...flattenJournalEntry(entry));
 	return rows;
 }
-
 //#endregion
 //#region src/exports/field-maps/quickbooks.ts
 function formatQbDate(date) {
@@ -163,7 +159,6 @@ const quickbooksFieldMap = {
 		}
 	]
 };
-
 //#endregion
 //#region src/exports/field-maps/universal.ts
 function formatIsoDate(date) {
@@ -251,7 +246,5 @@ const universalFieldMap = {
 		}
 	]
 };
-
 //#endregion
 export { exportToCsv as a, getHeaders as c, serializeCsv as d, flattenJournalEntry as i, buildCsv as l, quickbooksFieldMap as n, extractAllRows as o, flattenJournalEntries as r, extractRow as s, universalFieldMap as t, escapeCell as u };
-//# sourceMappingURL=universal-CMfrZ2hG.mjs.map