@classytic/ledger 0.3.0 → 0.4.0

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

@@ -121,16 +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 };
+//#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,14 +1,14 @@
 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 { 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, m as ExportFieldMap, n as quickbooksFieldMap, p as ExportField, r as flattenJournalEntries, t as universalFieldMap } from "./index-BPukb3L8.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 { $ as BudgetVsActualReport, A as generateGeneralLedger, B as GeneralLedgerAccount, E as reopenFiscalPeriod, G as ReportCategory, H as IncomeStatementReport, I as generateTrialBalance, J as TaxReturnSummary, K as ReportGroup, L as BalanceSheetReport, M as generateIncomeStatement, O as generateCashFlow, P as generateBalanceSheet, R as CashFlowReport, T as closeFiscalPeriod, U as LedgerEntry, V as GeneralLedgerReport, W as ReportAccount, X as TrialBalanceRow, Y as TrialBalanceReport, _ as DimensionBreakdownOptions, a as AccountForeignBalance, b as DimensionBreakdownRow, c as buildRevaluationEntry, d as AgedBalanceParams, f as AgedBalanceReport, g as generateAgedBalance, h as DEFAULT_BUCKETS, i as generateRevaluation, l as computeRevaluation, m as AgedBucketConfig, n as RevaluationParams, o as RevaluationRate, p as AgedBalanceRow, q as TaxReport, r as RevaluationReport, s as RevaluationResult, t as RevaluationOptions, u as AgedBalanceOptions, v as DimensionBreakdownParams, x as generateDimensionBreakdown, y as DimensionBreakdownReport, z as CashFlowSection } from "./revaluation-D9x0NE8w.mjs";
-import { n as defaultLogger, t as Logger } from "./logger-CbHWZl7v.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-Cn-9yerQ.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 wireAccountMethods, o as BulkCreateResult, p as SeedOptions, r as wireJournalEntryMethods, s as JournalEntryRepository, t as wireReconciliationMethods, u as ReconciliationRepository } from "./reconciliation.repository-CW4-8q90.mjs";
-import { n as createJournalEntrySchema, r as createAccountSchema, t as createFiscalPeriodSchema } from "./fiscal-period.schema-BMnlI9H5.mjs";
-import { c as dateLockPlugin, i as fiscalLockPlugin, n as idempotencyPlugin, o as doubleEntryPlugin } from "./idempotency.plugin-B_CNsInz.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-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";
@@ -53,9 +53,9 @@ declare class AccountingEngine {
     [x: string]: any;
   } & mongoose$1.DefaultTimestampProps, {
     id: string;
-  }, mongoose$1.MergeType<mongoose$1.DefaultSchemaOptions, {
+  }, Omit<mongoose$1.DefaultSchemaOptions, "timestamps"> & {
     timestamps: true;
-  }>> & Omit<{
+  }> & Omit<{
     [x: number]: any;
     [x: string]: any;
   } & mongoose$1.DefaultTimestampProps & {
@@ -84,9 +84,9 @@ declare class AccountingEngine {
     [x: string]: any;
   } & mongoose$1.DefaultTimestampProps, {
     id: string;
-  }, mongoose$1.MergeType<mongoose$1.DefaultSchemaOptions, {
+  }, Omit<mongoose$1.DefaultSchemaOptions, "timestamps"> & {
     timestamps: true;
-  }>> & Omit<{
+  }> & Omit<{
     [x: number]: any;
     [x: string]: any;
   } & mongoose$1.DefaultTimestampProps & {
@@ -115,9 +115,9 @@ declare class AccountingEngine {
     [x: string]: any;
   } & mongoose$1.DefaultTimestampProps, {
     id: string;
-  }, mongoose$1.MergeType<mongoose$1.DefaultSchemaOptions, {
+  }, Omit<mongoose$1.DefaultSchemaOptions, "timestamps"> & {
     timestamps: true;
-  }>> & Omit<{
+  }> & Omit<{
     [x: number]: any;
     [x: string]: any;
   } & mongoose$1.DefaultTimestampProps & {
@@ -146,9 +146,9 @@ declare class AccountingEngine {
     [x: string]: any;
   } & mongoose$1.DefaultTimestampProps, {
     id: string;
-  }, mongoose$1.MergeType<mongoose$1.DefaultSchemaOptions, {
+  }, Omit<mongoose$1.DefaultSchemaOptions, "timestamps"> & {
     timestamps: true;
-  }>> & Omit<{
+  }> & Omit<{
     [x: number]: any;
     [x: string]: any;
   } & mongoose$1.DefaultTimestampProps & {
@@ -177,9 +177,9 @@ declare class AccountingEngine {
     [x: string]: any;
   } & mongoose$1.DefaultTimestampProps, {
     id: string;
-  }, mongoose$1.MergeType<mongoose$1.DefaultSchemaOptions, {
+  }, Omit<mongoose$1.DefaultSchemaOptions, "timestamps"> & {
     timestamps: true;
-  }>> & Omit<{
+  }> & Omit<{
     [x: number]: any;
     [x: string]: any;
   } & mongoose$1.DefaultTimestampProps & {
@@ -337,22 +337,6 @@ declare class AccountingEngine {
 }
 declare function createAccountingEngine(config: AccountingEngineConfig): AccountingEngine;
 //#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/account-helpers.d.ts
 /**
  * Check if an account type is a virtual tax sub-account.
@@ -379,60 +363,21 @@ declare function computeEndingBalance(category: CategoryKey, totalDebit: number,
  */
 declare function buildAccountTypeMap(accountTypes: readonly AccountType[]): Map<string, AccountType>;
 //#endregion
-//#region src/utils/errors.d.ts
-/**
- * Typed error for the accounting package.
- * Carries HTTP status + machine-readable code.
- * Replaces all ad-hoc `(error as ...).status = N` patterns.
- */
-declare class AccountingError extends Error {
-  readonly status: number;
-  readonly code: string;
-  constructor(message: string, status?: number, code?: string);
-}
-/** Convenience factory functions */
-declare const Errors: {
-  readonly validation: (msg: string) => AccountingError;
-  readonly notFound: (msg: string) => AccountingError;
-  readonly conflict: (msg: string) => AccountingError;
-  readonly immutable: (msg: string) => AccountingError;
-  readonly fiscal: (msg: string) => AccountingError;
-};
-//#endregion
-//#region src/utils/session.d.ts
-interface SessionResult {
-  session: ClientSession | null;
-  ownSession: boolean;
-}
-/**
- * Acquire a session: uses external if provided, otherwise creates an internal one.
- * Returns { session, ownSession } so callers can commit/abort/end appropriately.
- *
- * When transactions are unavailable (no replica set / standalone), returns
- * session=null and the function runs without transactional safety.
- */
-declare function acquireSession(db: Connection, externalSession: ClientSession | undefined | null, logger?: Logger): Promise<SessionResult>;
-/**
- * Finalize an owned session: commit or abort, then always end.
- */
-declare function finalizeSession(session: ClientSession | null, ownSession: boolean, success: boolean): Promise<void>;
-//#endregion
-//#region src/utils/filter-builder.d.ts
+//#region src/utils/date-range.d.ts
 /**
- * Filter Builder — Sanitizes user-supplied dimension filters for aggregation pipelines.
+ * Compute start/end dates from a date option + value.
  *
- * 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.).
+ * @throws {Error} If value is null/undefined/invalid for the given option
  *
- * @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
+ * 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 buildItemFilters(filters?: Record<string, unknown>): Record<string, unknown>;
+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
 /**
@@ -483,6 +428,61 @@ declare function buildDimensionIndexes(dimensions: DimensionDefinition[], orgFie
   options?: Record<string, unknown>;
 }>;
 //#endregion
+//#region src/utils/errors.d.ts
+/**
+ * Typed error for the accounting package.
+ * Carries HTTP status + machine-readable code.
+ * Replaces all ad-hoc `(error as ...).status = N` patterns.
+ */
+declare class AccountingError extends Error {
+  readonly status: number;
+  readonly code: string;
+  constructor(message: string, status?: number, code?: string);
+}
+/** Convenience factory functions */
+declare const Errors: {
+  readonly validation: (msg: string) => AccountingError;
+  readonly notFound: (msg: string) => AccountingError;
+  readonly conflict: (msg: string) => AccountingError;
+  readonly immutable: (msg: string) => AccountingError;
+  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;
+  ownSession: boolean;
+}
+/**
+ * Acquire a session: uses external if provided, otherwise creates an internal one.
+ * Returns { session, ownSession } so callers can commit/abort/end appropriately.
+ *
+ * When transactions are unavailable (no replica set / standalone), returns
+ * session=null and the function runs without transactional safety.
+ */
+declare function acquireSession(db: Connection, externalSession: ClientSession | undefined | null, logger?: Logger): Promise<SessionResult>;
+/**
+ * Finalize an owned session: commit or abort, then always end.
+ */
+declare function finalizeSession(session: ClientSession | null, ownSession: boolean, success: boolean): Promise<void>;
+//#endregion
 //#region src/types/contracts.d.ts
 /** A single line produced by a subledger for posting */
 interface SubledgerJournalItem {
@@ -527,4 +527,4 @@ interface PostingResult {
   idempotencyKeys?: string[];
 }
 //#endregion
-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 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, 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 };
+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 };

package/dist/index.mjs

@@ -1,14 +1,14 @@
-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 { i as doubleEntryPlugin, n as idempotencyPlugin, r as fiscalLockPlugin, t as dateLockPlugin } from "./date-lock.plugin-eYAJ9h_u.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 {
@@ -265,4 +265,4 @@ function buildDimensionIndexes(dimensions, orgField) {
 	});
 }
 //#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 };
+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/{fiscal-period.schema-BMnlI9H5.d.mts → journal-entry.schema-B1CzLwC3.d.mts}

@@ -1,4 +1,4 @@
-import { o as SchemaOptions, r as JournalSchemaOptions, t as AccountingEngineConfig } from "./engine-Cn-9yerQ.mjs";
+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
@@ -12,9 +12,9 @@ declare function createAccountSchema(config: AccountingEngineConfig, options?: S
   [x: string]: any;
 } & mongoose.DefaultTimestampProps, {
   id: string;
-}, mongoose.MergeType<mongoose.DefaultSchemaOptions, {
+}, Omit<mongoose.DefaultSchemaOptions, "timestamps"> & {
   timestamps: true;
-}>> & Omit<{
+}> & Omit<{
   [x: number]: any;
   [x: string]: any;
 } & mongoose.DefaultTimestampProps & {
@@ -34,8 +34,8 @@ declare function createAccountSchema(config: AccountingEngineConfig, options?: S
   __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>, {}, {}, {}, {}, {
+//#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;
@@ -45,9 +45,9 @@ declare function createJournalEntrySchema(config: AccountingEngineConfig, accoun
   [x: string]: any;
 } & mongoose.DefaultTimestampProps, {
   id: string;
-}, mongoose.MergeType<mongoose.DefaultSchemaOptions, {
+}, Omit<mongoose.DefaultSchemaOptions, "timestamps"> & {
   timestamps: true;
-}>> & Omit<{
+}> & Omit<{
   [x: number]: any;
   [x: string]: any;
 } & mongoose.DefaultTimestampProps & {
@@ -67,8 +67,8 @@ declare function createJournalEntrySchema(config: AccountingEngineConfig, accoun
   __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>, {}, {}, {}, {}, {
+//#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;
@@ -78,9 +78,9 @@ declare function createFiscalPeriodSchema(config: AccountingEngineConfig, option
   [x: string]: any;
 } & mongoose.DefaultTimestampProps, {
   id: string;
-}, mongoose.MergeType<mongoose.DefaultSchemaOptions, {
+}, Omit<mongoose.DefaultSchemaOptions, "timestamps"> & {
   timestamps: true;
-}>> & Omit<{
+}> & Omit<{
   [x: number]: any;
   [x: string]: any;
 } & mongoose.DefaultTimestampProps & {
@@ -100,4 +100,4 @@ declare function createFiscalPeriodSchema(config: AccountingEngineConfig, option
   __v: number;
 }>;
 //#endregion
-export { createJournalEntrySchema as n, createAccountSchema as r, createFiscalPeriodSchema as t };
+export { createFiscalPeriodSchema as n, createAccountSchema as r, createJournalEntrySchema as t };

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

@@ -77,14 +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 };
+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,17 +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 };
+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/money.mjs

@@ -93,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]
@@ -166,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 = {

package/dist/plugins/index.d.mts

@@ -1,4 +1,4 @@
-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 { 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

package/dist/plugins/index.mjs

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

package/dist/{reconciliation.repository-CW4-8q90.d.mts → reconciliation.repository-DEybU_Ok.d.mts}

@@ -1,5 +1,5 @@
 import { t as CountryPack } from "./index-CxZqRaOU.mjs";
-import { s as StrictnessConfig } from "./engine-Cn-9yerQ.mjs";
+import { s as StrictnessConfig } from "./engine-DF-MtsEr.mjs";
 import { ClientSession, Model } from "mongoose";
 import { Repository } from "@classytic/mongokit";
 
@@ -96,6 +96,18 @@ interface ReconciliationRepository<TDoc = unknown> extends Repository<TDoc> {
   }): Promise<Record<string, unknown>[]>;
 }
 //#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/journal-entry.repository.d.ts
 /**
  * Wire post/reverse onto an existing mongokit Repository.
@@ -110,18 +122,6 @@ interface ReconciliationRepository<TDoc = unknown> extends Repository<TDoc> {
  */
 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.
@@ -132,4 +132,4 @@ declare function wireAccountMethods<TDoc = unknown>(repository: Repository<TDoc>
  */
 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 };
+export { BulkCreateInput as a, PostOptions as c, ReverseOptions as d, ReverseResult as f, AccountRepository as i, ReconcileParams as l, SeedResult as m, wireJournalEntryMethods as n, BulkCreateResult as o, SeedOptions as p, wireAccountMethods as r, JournalEntryRepository as s, wireReconciliationMethods as t, ReconciliationRepository as u };