@classytic/ledger 0.4.0 → 0.4.1

package/README.md

@@ -1,6 +1,6 @@
 # @classytic/ledger
 
-Embeddable double-entry accounting engine for MongoDB. Integer-cents arithmetic, plugin-based, country-agnostic.
+Embeddable double-entry accounting engine for MongoDB. Integer-cents arithmetic, plugin-based, country-agnostic. Extensible journal types, multi-tenant isolation at every layer.
 
 Build QuickBooks, Xero, or TaxCycle-grade apps — the engine handles the accounting, you handle the UX.
 
@@ -15,23 +15,49 @@ npm install @classytic/ledger-bd  # Bangladesh (BFRS, VAT/TDS, Mushak)
 ## Quick Start
 
 ```typescript
+import mongoose from 'mongoose';
 import { createAccountingEngine } from '@classytic/ledger';
 import { canadaPack } from '@classytic/ledger-ca';
 
-const accounting = createAccountingEngine({
+// The engine owns the models — matches flow/promo pattern
+const engine = createAccountingEngine({
+  mongoose: mongoose.connection,
   country: canadaPack,
   currency: 'CAD',
-  multiTenant: { orgField: 'organization', orgRef: 'Organization' },
+  multiTenant: { orgField: 'organizationId', orgRef: 'Organization' },
 });
 
-// Schemas
-const Account = mongoose.model('Account', accounting.createAccountSchema());
-const JournalEntry = mongoose.model('JournalEntry', accounting.createJournalEntrySchema('Account'));
-const FiscalPeriod = mongoose.model('FiscalPeriod', accounting.createFiscalPeriodSchema());
+// Models, repositories, and reports are auto-created
+await engine.repositories.accounts.seedAccounts(orgId);
+const entry = await engine.repositories.journalEntries.post(entryId, orgId);
+const bs = await engine.reports.balanceSheet({ organizationId: orgId, dateOption: 'year', dateValue: 2025 });
+```
+
+### Engine-owned models (recommended)
+
+Pass `mongoose: connection` in config and the engine creates and wires everything:
+
+| Property | What it gives you |
+|----------|-------------------|
+| `engine.models.Account` / `JournalEntry` / `FiscalPeriod` / `Budget` / `Reconciliation` | Mongoose models, ready to query |
+| `engine.repositories.accounts.seedAccounts()` / `bulkCreate()` | Account repo with domain methods |
+| `engine.repositories.journalEntries.post()` / `reverse()` / `unpost()` / `duplicate()` | JE repo with plugins pre-wired (double-entry, fiscal-lock, idempotency) |
+| `engine.repositories.fiscalPeriods` / `budgets` | Plain CRUD repos |
+| `engine.repositories.reconciliations.reconcile()` / `unreconcile()` / `getUnreconciled()` | Reconciliation repo with domain methods |
+| `engine.reports.trialBalance()` / `balanceSheet()` / etc. | All 10 reports, bound to the owned models |
+
+This pattern unblocks framework auto-discovery (Arc `loadResources`, Fastify plugins, etc.) because resources can be defined at module top-level without factory wrappers.
+
+### Low-level (manual schema/model setup)
 
-// Reports
-const reports = accounting.createReports({ Account, JournalEntry });
-const bs = await reports.balanceSheet({ organizationId, dateOption: 'year', dateValue: 2025 });
+If you need custom naming or don't want the engine to own models, omit `mongoose` from config:
+
+```typescript
+const engine = createAccountingEngine({ country: canadaPack, currency: 'CAD' });
+const Account = mongoose.model('GLAccount', engine.createAccountSchema());
+const JournalEntry = mongoose.model('GLEntry', engine.createJournalEntrySchema('GLAccount'));
+const accountRepo = engine.wireAccountRepository(new Repository(Account), Account);
+const reports = engine.createReports({ Account, JournalEntry });
 ```
 
 ## Core Features
@@ -41,8 +67,9 @@ const bs = await reports.balanceSheet({ organizationId, dateOption: 'year', date
 - Integer-cents storage — zero floating-point drift
 - Draft → Posted → Reversed state machine
 - Configurable immutability (corrections only via reversal)
-- Multi-tenant isolation at every layer
+- Multi-tenant isolation at every layer (reports, schemas, repositories)
 - Country packs for localized charts of accounts and tax codes
+- Extensible journal type registry — add domain-specific types (POS, E-Commerce, Payroll) at startup
 
 **10 Reports**
 - Trial Balance (3-column: initial + period + ending)
@@ -155,7 +182,36 @@ taxHookPlugin({
 | `@classytic/ledger/repositories` | Repository wiring |
 | `@classytic/ledger/exports` | CSV export + QuickBooks field maps |
 | `@classytic/ledger/country` | `defineCountryPack`, `CountryPack` interface |
-| `@classytic/ledger/constants` | Categories, journal types, currencies |
+| `@classytic/ledger/constants` | Categories, journal types (+ registry), currencies |
+
+## Extensible Journal Types
+
+The 15 built-in journal types (SALES, PURCHASES, GENERAL, PAYROLL, etc.) cover standard accounting. For domain-specific needs, register custom types **before** schema creation:
+
+```typescript
+import { registerJournalType, getJournalTypeCodes, isValidJournalType } from '@classytic/ledger';
+
+// Register at startup, before createJournalEntrySchema()
+registerJournalType('POS_SALES', {
+  code: 'POS_SALES',
+  name: 'POS Sales Journal',
+  description: 'Daily aggregated point-of-sale transactions',
+});
+
+registerJournalType('ECOM_SALES', {
+  code: 'ECOM_SALES',
+  name: 'E-Commerce Sales Journal',
+  description: 'Per-order online transactions',
+});
+
+// Custom types pass Mongoose enum validation, appear in all lookups
+isValidJournalType('POS_SALES');  // true
+getJournalTypeCodes();            // [...15 built-in, 'POS_SALES', 'ECOM_SALES']
+
+// Reference numbers use the custom type prefix: POS_SALES/2025/03/0001
+```
+
+The registry freezes when `createJournalEntrySchema()` is called. Late registration throws. Built-in types cannot be overridden.
 
 ## Country Packs
 
@@ -180,25 +236,31 @@ Available packs: `@classytic/ledger-ca` (Canada), `@classytic/ledger-bd` (Bangla
 
 ## Testing
 
-949 tests covering unit, integration, and end-to-end scenarios:
-
 ```bash
-npm test                    # run all
-npx vitest run tests/e2e/   # e2e scenarios only
+npm test                           # run all
+npx vitest run tests/e2e/          # e2e scenarios only
+npx vitest run tests/scenarios/    # integration scenarios
+npx vitest run tests/hardening/    # edge cases & invariants
 ```
 
-E2E suites include:
+Test suites cover:
 - Canadian small business full-year lifecycle
 - Multi-currency trading with FX revaluation
-- All plugins + dimensions + budgets + fiscal close
+- Multi-tenant report isolation (org A cannot see org B)
+- Posting pipeline → Trial Balance → Income Statement → Balance Sheet
+- Reversal & correction workflows with audit trail
+- Custom journal type registry → schema → posting pipeline
+- Double-entry conservation law (debit = credit across all entries)
+- Money arithmetic hardening (overflow, penny-leak, float traps)
+- Public API surface & subpath export verification
 - O-Level / A-Level / university textbook accounting problems
 
 ## Requirements
 
 - Node.js >= 22
 - MongoDB (replica set recommended for transactions)
-- Mongoose >= 9
-- @classytic/mongokit >= 3
+- Mongoose >= 9.4.1
+- @classytic/mongokit >= 3.5.3
 
 ## License
 

package/dist/constants/index.mjs

@@ -1,4 +1,4 @@
-import { a as extractStatementType, c as getNormalBalance, d as isValidCategory, i as extractMainType, l as isBalanceSheet, n as CATEGORY_KEYS, o as getCategoryMainType, r as categoryKey, s as getCategoryStatementType, t as CATEGORIES, u as isIncomeStatement } from "../categories-FJlrvzcl.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 { 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-BfwnCFam.mjs";
+import { a as extractStatementType, c as getNormalBalance, d as isValidCategory, i as extractMainType, l as isBalanceSheet, n as CATEGORY_KEYS, o as getCategoryMainType, r as categoryKey, s as getCategoryStatementType, t as CATEGORIES, u as isIncomeStatement } from "../categories-DWogBUgQ.mjs";
 import { i as isValidCurrency, n as getCurrency, r as getMinorUnit, t as CURRENCIES } from "../currencies-W8kQAkm0.mjs";
 export { CATEGORIES, CATEGORY_KEYS, CURRENCIES, JOURNAL_CODES, JOURNAL_TYPES, categoryKey, extractMainType, extractStatementType, getCategoryMainType, getCategoryStatementType, getCurrency, getCustomJournalTypes, getJournalType, getJournalTypeCodes, getMinorUnit, getNormalBalance, isBalanceSheet, isIncomeStatement, isValidCategory, isValidCurrency, isValidJournalType, registerJournalType };

package/dist/{date-lock.plugin-C8kqPBjh.mjs → date-lock.plugin-DL6pe24p.mjs}

@@ -1,4 +1,4 @@
-import { n as Errors } from "./errors-BoGUSUYL.mjs";
+import { n as Errors } from "./errors-B_dyYZc_.mjs";
 //#region src/plugins/double-entry.plugin.ts
 function doubleEntryPlugin(options = {}) {
 	const { onlyOnPost = true, JournalEntryModel, AccountModel, orgField } = options;

package/dist/{engine-DF-MtsEr.d.mts → engine-scgOvxHJ.d.mts}

@@ -1,5 +1,6 @@
 import { t as CountryPack } from "./index-CxZqRaOU.mjs";
 import { t as Logger } from "./logger-UbTdBb1x.mjs";
+import { Connection } from "mongoose";
 
 //#region src/types/engine.d.ts
 /** Multi-tenant configuration */
@@ -68,8 +69,35 @@ interface MultiCurrencyConfig {
   /** Allowed foreign currency codes. If omitted, any ISO 4217 code is accepted. */
   currencies?: readonly string[];
 }
+/**
+ * Override default model names. Useful when you want to avoid collisions
+ * with existing models or use custom naming conventions.
+ */
+interface ModelNames {
+  account?: string;
+  journalEntry?: string;
+  fiscalPeriod?: string;
+  budget?: string;
+  reconciliation?: string;
+}
 /** Main engine configuration */
 interface AccountingEngineConfig {
+  /**
+   * Mongoose connection. Required for `engine.models` and `engine.repositories`
+   * to be auto-populated. If omitted, you must use the low-level schema
+   * factories (`engine.createAccountSchema()`) and register models yourself.
+   */
+  mongoose?: Connection;
+  /** Override default model names (e.g. 'Account' → 'GLAccount') */
+  modelNames?: ModelNames;
+  /** Extra fields / indexes per model */
+  schemaOptions?: {
+    account?: SchemaOptions;
+    journalEntry?: JournalSchemaOptions;
+    fiscalPeriod?: SchemaOptions;
+    budget?: SchemaOptions;
+    reconciliation?: SchemaOptions;
+  };
   /** Country pack providing account types, tax codes, and templates */
   country: CountryPack;
   /** Default ISO 4217 currency code — the functional/base currency (e.g., 'CAD', 'BDT') */
@@ -99,4 +127,4 @@ interface AccountingEngineConfig {
   strictness?: StrictnessConfig;
 }
 //#endregion
-export { MultiTenantConfig as a, MultiCurrencyConfig as i, AuditConfig as n, SchemaOptions as o, JournalSchemaOptions as r, StrictnessConfig as s, AccountingEngineConfig as t };
+export { MultiCurrencyConfig as a, StrictnessConfig as c, ModelNames as i, AuditConfig as n, MultiTenantConfig as o, JournalSchemaOptions as r, SchemaOptions as s, AccountingEngineConfig as t };

package/dist/{fiscal-close-DmPV82e4.mjs → fiscal-close-B2_7WMTe.mjs}

@@ -1,6 +1,6 @@
-import { n as Errors } from "./errors-BoGUSUYL.mjs";
-import { t as requireOrgScope } from "./tenant-guard-CAxXoWuS.mjs";
-import { i as extractMainType } from "./categories-FJlrvzcl.mjs";
+import { n as Errors } from "./errors-B_dyYZc_.mjs";
+import { t as requireOrgScope } from "./tenant-guard-r17Se3Bb.mjs";
+import { i as extractMainType } from "./categories-DWogBUgQ.mjs";
 import mongoose from "mongoose";
 //#region src/reports/aged-balance.ts
 const DEFAULT_BUCKETS = [

package/dist/index.d.mts

@@ -4,15 +4,66 @@ import { a as TaxReportLine, i as TaxCodesByRegion, n as CountryPackInput, o as
 import { _ as PopulatedJournalEntry, a as exportToCsv, h as FlatJournalRow, i as quickbooksFieldMap, m as ExportFieldMap, p as ExportField, r as universalFieldMap, t as flattenJournalEntries } from "./index-J-XIbXH-.mjs";
 import { Money, abs, add, allocate, equals, format, formatPlain, fromDecimal, isNegative, isPositive, isValid, isZero, max, min, multiply, negate, parseCents, percentage, round, splitTaxExclusive, splitTaxInclusive, subtract, toDecimal } from "./money.mjs";
 import { n as defaultLogger, t as Logger } from "./logger-UbTdBb1x.mjs";
-import { a as MultiTenantConfig, i as MultiCurrencyConfig, n as AuditConfig, o as SchemaOptions, r as JournalSchemaOptions, s as StrictnessConfig, t as AccountingEngineConfig } from "./engine-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 { a as MultiCurrencyConfig, c as StrictnessConfig, i as ModelNames, n as AuditConfig, o as MultiTenantConfig, r as JournalSchemaOptions, s as SchemaOptions, t as AccountingEngineConfig } from "./engine-scgOvxHJ.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-D-D_ITL-.mjs";
+import { n as createFiscalPeriodSchema, r as createAccountSchema, t as createJournalEntrySchema } from "./journal-entry.schema-JqrfbvB4.mjs";
 import { c as dateLockPlugin, i as fiscalLockPlugin, n as idempotencyPlugin, o as doubleEntryPlugin } from "./idempotency.plugin-zU-GKJ0-.mjs";
 import { $ as AgedBucketConfig, A as BudgetVsActualReport, B as IncomeStatementReport, C as DimensionBreakdownReport, D as generateCashFlow, F as BalanceSheetReport, G as TaxReport, H as ReportAccount, I as CashFlowReport, J as TrialBalanceRow, K as TaxReturnSummary, L as CashFlowSection, M as generateBudgetVsActual, O as BudgetVsActualOptions, P as generateBalanceSheet, Q as AgedBalanceRow, R as GeneralLedgerAccount, S as DimensionBreakdownParams, T as generateDimensionBreakdown, U as ReportCategory, V as LedgerEntry, W as ReportGroup, X as AgedBalanceParams, Y as AgedBalanceOptions, Z as AgedBalanceReport, a as RevaluationReport, b as reopenFiscalPeriod, c as RevaluationRate, d as computeRevaluation, et as DEFAULT_BUCKETS, h as generateGeneralLedger, i as RevaluationParams, j as BudgetVsActualRow, k as BudgetVsActualParams, l as RevaluationResult, n as generateTrialBalance, o as generateRevaluation, p as generateIncomeStatement, q as TrialBalanceReport, r as RevaluationOptions, s as AccountForeignBalance, tt as generateAgedBalance, u as buildRevaluationEntry, w as DimensionBreakdownRow, x as DimensionBreakdownOptions, y as closeFiscalPeriod, z as GeneralLedgerReport } from "./trial-balance-DcQ0xj_4.mjs";
 import * as mongoose$1 from "mongoose";
 import { ClientSession, Connection, Model } from "mongoose";
 import { PluginType, Repository } from "@classytic/mongokit";
 
+//#region src/models/factory.d.ts
+interface LedgerModels {
+  Account: Model<unknown>;
+  JournalEntry: Model<unknown>;
+  FiscalPeriod: Model<unknown>;
+  Budget: Model<unknown>;
+  Reconciliation: Model<unknown>;
+}
+interface ResolvedModelNames {
+  account: string;
+  journalEntry: string;
+  fiscalPeriod: string;
+  budget: string;
+  reconciliation: string;
+}
+declare function resolveModelNames(overrides?: ModelNames): ResolvedModelNames;
+/**
+ * Create (or reuse) all ledger models on the given connection.
+ *
+ * If a model with the same name is already registered on the connection,
+ * the existing model is reused — this allows multiple engine instances
+ * to share models and prevents "OverwriteModelError".
+ */
+declare function createModels(connection: Connection, config: AccountingEngineConfig): LedgerModels;
+//#endregion
+//#region src/repositories/factory.d.ts
+interface LedgerRepositoryPlugins {
+  account?: PluginType[];
+  journalEntry?: PluginType[];
+  fiscalPeriod?: PluginType[];
+  budget?: PluginType[];
+  reconciliation?: PluginType[];
+}
+interface LedgerRepositories {
+  accounts: AccountRepository<unknown>;
+  journalEntries: JournalEntryRepository<unknown>;
+  fiscalPeriods: Repository<unknown>;
+  budgets: Repository<unknown>;
+  reconciliations: ReconciliationRepository<unknown>;
+}
+/**
+ * Build all ledger repositories with plugins + domain methods pre-wired.
+ *
+ * - `accounts` — has seedAccounts(), bulkCreate()
+ * - `journalEntries` — has post(), unpost(), reverse(), duplicate() + double-entry + fiscal-lock (+ idempotency if enabled)
+ * - `fiscalPeriods` — plain CRUD
+ * - `budgets` — plain CRUD
+ * - `reconciliations` — has reconcile(), unreconcile(), getUnreconciled()
+ */
+declare function createRepositories(models: LedgerModels, config: AccountingEngineConfig, plugins?: LedgerRepositoryPlugins): LedgerRepositories;
+//#endregion
 //#region src/engine.d.ts
 declare class AccountingEngine {
   readonly config: AccountingEngineConfig;
@@ -42,7 +93,102 @@ declare class AccountingEngine {
     readonly isValid: typeof isValid;
     readonly parseCents: typeof parseCents;
   };
-  constructor(config: AccountingEngineConfig);
+  private _models?;
+  private _repositories?;
+  private _reports?;
+  constructor(config: AccountingEngineConfig, plugins?: LedgerRepositoryPlugins);
+  /**
+   * Auto-created Mongoose models. Requires `mongoose` in config.
+   *
+   * @throws if `mongoose` was not provided in config
+   */
+  get models(): LedgerModels;
+  /**
+   * Auto-wired repositories with plugins + domain methods (post, reverse, etc.).
+   * Requires `mongoose` in config.
+   *
+   * @throws if `mongoose` was not provided in config
+   */
+  get repositories(): LedgerRepositories;
+  /**
+   * Pre-built reports bound to auto-created models. Requires `mongoose` in config.
+   * For custom models, use `engine.createReports({ Account, JournalEntry, Budget })`.
+   */
+  get reports(): {
+    trialBalance: (params: {
+      organizationId?: unknown;
+      dateOption: "month" | "quarter" | "year" | "custom";
+      dateValue: unknown;
+      accountId?: string;
+      filters?: Record<string, unknown>;
+    }) => Promise<TrialBalanceReport>;
+    balanceSheet: (params: {
+      organizationId?: unknown;
+      dateOption: "month" | "quarter" | "year" | "custom";
+      dateValue: unknown;
+      businessName?: string;
+      filters?: Record<string, unknown>;
+    }) => Promise<BalanceSheetReport>;
+    incomeStatement: (params: {
+      organizationId?: unknown;
+      dateOption: "month" | "quarter" | "year" | "custom";
+      dateValue: unknown;
+      businessName?: string;
+      filters?: Record<string, unknown>;
+    }) => Promise<IncomeStatementReport>;
+    generalLedger: (params: {
+      organizationId?: unknown;
+      dateOption: "month" | "quarter" | "year" | "custom";
+      dateValue: unknown;
+      accountId?: string;
+      filters?: Record<string, unknown>;
+    }) => Promise<GeneralLedgerReport>;
+    cashFlow: (params: {
+      organizationId?: unknown;
+      dateOption: "month" | "quarter" | "year" | "custom";
+      dateValue: unknown;
+      businessName?: string;
+      filters?: Record<string, unknown>;
+    }) => Promise<CashFlowReport>;
+    agedBalance: (params: {
+      organizationId?: unknown;
+      asOfDate?: Date;
+      type: "receivable" | "payable";
+      accountIds?: unknown[];
+      dueDateField?: string;
+      contactField?: string;
+      buckets?: {
+        label: string;
+        minDays: number;
+        maxDays: number;
+      }[] | undefined;
+    }) => Promise<AgedBalanceReport>;
+    dimensionBreakdown: (params: {
+      organizationId?: unknown;
+      dateOption: "month" | "quarter" | "year" | "custom";
+      dateValue: unknown;
+      dimension: string;
+      accountCategory?: string;
+      filters?: Record<string, unknown>;
+    }) => Promise<DimensionBreakdownReport>;
+    budgetVsActual: (params: {
+      organizationId?: unknown;
+      dateOption: "month" | "quarter" | "year" | "custom";
+      dateValue: unknown;
+      accountIds?: unknown[];
+      filters?: Record<string, unknown>;
+    }) => Promise<BudgetVsActualReport>;
+    revaluation: (params: {
+      organizationId?: unknown;
+      asOfDate: Date;
+      rates: {
+        currency: string;
+        rate: number;
+      }[];
+      unrealizedGainLossAccountId: unknown;
+      generateEntry?: boolean;
+    }) => Promise<RevaluationReport>;
+  };
   createAccountSchema(options?: SchemaOptions): mongoose$1.Schema<any, Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
     timestamps: true;
   }, {
@@ -198,6 +344,11 @@ declare class AccountingEngine {
   } & {
     __v: number;
   }>;
+  /**
+   * Build a reports object bound to the given models. Use this when you
+   * need custom/external models. Prefer `engine.reports` when the engine
+   * owns the models (via `mongoose` in config).
+   */
   createReports(models: {
     Account: Model<unknown>;
     JournalEntry: Model<unknown>;
@@ -277,6 +428,7 @@ declare class AccountingEngine {
       generateEntry?: boolean;
     }) => Promise<RevaluationReport>;
   };
+  private _buildReports;
   /** Get all posting account types (accounts you can post transactions to) */
   getPostingAccountTypes(): readonly AccountType[];
   /** Validate an account type code */
@@ -335,7 +487,7 @@ declare class AccountingEngine {
    */
   wireReconciliationRepository<TDoc = unknown>(repository: Repository<TDoc>, ReconciliationModel: Model<unknown>, JournalEntryModel: Model<unknown>): ReconciliationRepository<TDoc>;
 }
-declare function createAccountingEngine(config: AccountingEngineConfig): AccountingEngine;
+declare function createAccountingEngine(config: AccountingEngineConfig, plugins?: LedgerRepositoryPlugins): AccountingEngine;
 //#endregion
 //#region src/utils/account-helpers.d.ts
 /**
@@ -527,4 +679,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 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 };
+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 LedgerModels, type LedgerRepositories, type LedgerRepositoryPlugins, type Logger, type MainType, type ModelNames, 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 ResolvedModelNames, 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, createModels, createRepositories, 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, resolveModelNames, splitTaxExclusive, splitTaxInclusive, subtract, toDecimal, universalFieldMap, wireAccountMethods, wireJournalEntryMethods, wireReconciliationMethods };

package/dist/index.mjs

@@ -1,25 +1,154 @@
+import { a as createAccountSchema, i as createBudgetSchema, n as createJournalEntrySchema, r as createFiscalPeriodSchema, t as createReconciliationSchema } from "./reconciliation.schema-BA1lPv4t.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-BfwnCFam.mjs";
 import { Money, add, allocate, format, formatPlain, fromDecimal, multiply, parseCents, percentage, splitTaxExclusive, splitTaxInclusive, subtract, toDecimal } from "./money.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 { n as Errors, t as AccountingError } from "./errors-B_dyYZc_.mjs";
+import { i as doubleEntryPlugin, n as idempotencyPlugin, r as fiscalLockPlugin, t as dateLockPlugin } from "./date-lock.plugin-DL6pe24p.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-B2_7WMTe.mjs";
+import { c as getNormalBalance, d as isValidCategory, l as isBalanceSheet, n as CATEGORY_KEYS, t as CATEGORIES, u as isIncomeStatement } from "./categories-DWogBUgQ.mjs";
+import { n as wireJournalEntryMethods, r as wireAccountMethods, t as wireReconciliationMethods } from "./reconciliation.repository-fPwFKvrk.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, i as quickbooksFieldMap, r as universalFieldMap, t as flattenJournalEntries } from "./exports-DoGQQtMQ.mjs";
 import { Schema } from "mongoose";
+import { Repository } from "@classytic/mongokit";
+//#region src/models/factory.ts
+function resolveModelNames(overrides) {
+	return {
+		account: overrides?.account ?? "Account",
+		journalEntry: overrides?.journalEntry ?? "JournalEntry",
+		fiscalPeriod: overrides?.fiscalPeriod ?? "FiscalPeriod",
+		budget: overrides?.budget ?? "Budget",
+		reconciliation: overrides?.reconciliation ?? "Reconciliation"
+	};
+}
+/**
+* Create (or reuse) all ledger models on the given connection.
+*
+* If a model with the same name is already registered on the connection,
+* the existing model is reused — this allows multiple engine instances
+* to share models and prevents "OverwriteModelError".
+*/
+function createModels(connection, config) {
+	const names = resolveModelNames(config.modelNames);
+	const so = config.schemaOptions ?? {};
+	const existing = connection.models;
+	if (existing[names.account] && existing[names.journalEntry] && existing[names.fiscalPeriod] && existing[names.budget] && existing[names.reconciliation]) return {
+		Account: existing[names.account],
+		JournalEntry: existing[names.journalEntry],
+		FiscalPeriod: existing[names.fiscalPeriod],
+		Budget: existing[names.budget],
+		Reconciliation: existing[names.reconciliation]
+	};
+	return {
+		Account: existing[names.account] ?? connection.model(names.account, createAccountSchema(config, so.account)),
+		JournalEntry: existing[names.journalEntry] ?? connection.model(names.journalEntry, createJournalEntrySchema(config, names.account, so.journalEntry)),
+		FiscalPeriod: existing[names.fiscalPeriod] ?? connection.model(names.fiscalPeriod, createFiscalPeriodSchema(config, so.fiscalPeriod)),
+		Budget: existing[names.budget] ?? connection.model(names.budget, createBudgetSchema(config, so.budget)),
+		Reconciliation: existing[names.reconciliation] ?? connection.model(names.reconciliation, createReconciliationSchema(config, names.account, names.journalEntry, so.reconciliation))
+	};
+}
+//#endregion
+//#region src/repositories/factory.ts
+/**
+* Repositories Factory — wires fully-configured repositories.
+*
+* Matches the flow/promo pattern: engine owns the repositories with all
+* plugins (double-entry, fiscal-lock, idempotency) pre-wired.
+*
+* Consumer never constructs Repository, never calls wireXxx methods.
+* Just uses `engine.repositories.accounts.seedAccounts(orgId)`.
+*/
+/**
+* Build all ledger repositories with plugins + domain methods pre-wired.
+*
+* - `accounts` — has seedAccounts(), bulkCreate()
+* - `journalEntries` — has post(), unpost(), reverse(), duplicate() + double-entry + fiscal-lock (+ idempotency if enabled)
+* - `fiscalPeriods` — plain CRUD
+* - `budgets` — plain CRUD
+* - `reconciliations` — has reconcile(), unreconcile(), getUnreconciled()
+*/
+function createRepositories(models, config, plugins = {}) {
+	const orgField = config.multiTenant?.orgField;
+	const strictness = config.strictness;
+	const country = config.country;
+	const accounts = wireAccountMethods(new Repository(models.Account, plugins.account ?? []), models.Account, country, orgField);
+	const jePlugins = [
+		...plugins.journalEntry ?? [],
+		doubleEntryPlugin({
+			JournalEntryModel: models.JournalEntry,
+			AccountModel: models.Account,
+			orgField
+		}),
+		fiscalLockPlugin({
+			FiscalPeriodModel: models.FiscalPeriod,
+			JournalEntryModel: models.JournalEntry,
+			orgField
+		})
+	];
+	if (config.idempotency) jePlugins.push(idempotencyPlugin({
+		JournalEntryModel: models.JournalEntry,
+		orgField
+	}));
+	return {
+		accounts,
+		journalEntries: wireJournalEntryMethods(new Repository(models.JournalEntry, jePlugins), models.JournalEntry, orgField, strictness),
+		fiscalPeriods: new Repository(models.FiscalPeriod, plugins.fiscalPeriod ?? []),
+		budgets: new Repository(models.Budget, plugins.budget ?? []),
+		reconciliations: wireReconciliationMethods(new Repository(models.Reconciliation, plugins.reconciliation ?? []), models.Reconciliation, models.JournalEntry, orgField)
+	};
+}
+//#endregion
 //#region src/engine.ts
 var AccountingEngine = class {
 	config;
 	country;
 	currency;
 	money = Money;
-	constructor(config) {
+	_models;
+	_repositories;
+	_reports;
+	constructor(config, plugins = {}) {
 		this.config = config;
 		this.country = config.country;
 		this.currency = config.currency;
+		if (config.mongoose) {
+			this._models = createModels(config.mongoose, config);
+			this._repositories = createRepositories(this._models, config, plugins);
+		}
+	}
+	/**
+	* Auto-created Mongoose models. Requires `mongoose` in config.
+	*
+	* @throws if `mongoose` was not provided in config
+	*/
+	get models() {
+		if (!this._models) throw new Error("engine.models requires a Mongoose connection. Pass `mongoose: connection` in createAccountingEngine config.");
+		return this._models;
+	}
+	/**
+	* Auto-wired repositories with plugins + domain methods (post, reverse, etc.).
+	* Requires `mongoose` in config.
+	*
+	* @throws if `mongoose` was not provided in config
+	*/
+	get repositories() {
+		if (!this._repositories) throw new Error("engine.repositories requires a Mongoose connection. Pass `mongoose: connection` in createAccountingEngine config.");
+		return this._repositories;
+	}
+	/**
+	* Pre-built reports bound to auto-created models. Requires `mongoose` in config.
+	* For custom models, use `engine.createReports({ Account, JournalEntry, Budget })`.
+	*/
+	get reports() {
+		if (!this._reports) {
+			if (!this._models) throw new Error("engine.reports requires a Mongoose connection. Pass `mongoose: connection` in createAccountingEngine config, or use engine.createReports({ Account, JournalEntry }) for manual models.");
+			this._reports = this._buildReports({
+				Account: this._models.Account,
+				JournalEntry: this._models.JournalEntry,
+				Budget: this._models.Budget
+			});
+		}
+		return this._reports;
 	}
 	createAccountSchema(options) {
 		return createAccountSchema(this.config, options);
@@ -36,7 +165,15 @@ var AccountingEngine = class {
 	createReconciliationSchema(accountModelName, journalEntryModelName, options) {
 		return createReconciliationSchema(this.config, accountModelName, journalEntryModelName, options);
 	}
+	/**
+	* Build a reports object bound to the given models. Use this when you
+	* need custom/external models. Prefer `engine.reports` when the engine
+	* owns the models (via `mongoose` in config).
+	*/
 	createReports(models) {
+		return this._buildReports(models);
+	}
+	_buildReports(models) {
 		const { Account: AccountModel, JournalEntry: JournalEntryModel, Budget: BudgetModel } = models;
 		const { country, config } = this;
 		const orgField = config.multiTenant?.orgField;
@@ -202,8 +339,8 @@ var AccountingEngine = class {
 		return wireReconciliationMethods(repository, ReconciliationModel, JournalEntryModel, orgField);
 	}
 };
-function createAccountingEngine(config) {
-	return new AccountingEngine(config);
+function createAccountingEngine(config, plugins = {}) {
+	return new AccountingEngine(config, plugins);
 }
 //#endregion
 //#region src/utils/dimensions.ts
@@ -265,4 +402,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, 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 };
+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, createModels, createRepositories, 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, resolveModelNames, splitTaxExclusive, splitTaxInclusive, subtract, toDecimal, universalFieldMap, wireAccountMethods, wireJournalEntryMethods, wireReconciliationMethods };

package/dist/{journal-entry.schema-B1CzLwC3.d.mts → journal-entry.schema-JqrfbvB4.d.mts}

@@ -1,4 +1,4 @@
-import { o as SchemaOptions, r as JournalSchemaOptions, t as AccountingEngineConfig } from "./engine-DF-MtsEr.mjs";
+import { r as JournalSchemaOptions, s as SchemaOptions, t as AccountingEngineConfig } from "./engine-scgOvxHJ.mjs";
 import mongoose from "mongoose";
 
 //#region src/schemas/account.schema.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-C8kqPBjh.mjs";
+import { i as doubleEntryPlugin, n as idempotencyPlugin, r as fiscalLockPlugin, t as dateLockPlugin } from "../date-lock.plugin-DL6pe24p.mjs";
 //#region src/utils/tax-hooks.ts
 /**
 * Apply a tax hook to journal items.

package/dist/{reconciliation.repository-DEybU_Ok.d.mts → reconciliation.repository-D-D_ITL-.d.mts}

@@ -1,5 +1,5 @@
 import { t as CountryPack } from "./index-CxZqRaOU.mjs";
-import { s as StrictnessConfig } from "./engine-DF-MtsEr.mjs";
+import { c as StrictnessConfig } from "./engine-scgOvxHJ.mjs";
 import { ClientSession, Model } from "mongoose";
 import { Repository } from "@classytic/mongokit";
 

package/dist/{reconciliation.repository-DgJEDVS-.mjs → reconciliation.repository-fPwFKvrk.mjs}

@@ -1,5 +1,5 @@
-import { n as Errors } from "./errors-BoGUSUYL.mjs";
-import { t as requireOrgScope } from "./tenant-guard-CAxXoWuS.mjs";
+import { n as Errors } from "./errors-B_dyYZc_.mjs";
+import { t as requireOrgScope } from "./tenant-guard-r17Se3Bb.mjs";
 //#region src/repositories/account.repository.ts
 /**
 * Wire seedAccounts, bulkCreate and posting-account validation

package/dist/{reconciliation.schema-KScbsXbY.mjs → reconciliation.schema-BA1lPv4t.mjs}

@@ -1,4 +1,4 @@
-import { o as getJournalTypeCodes, r as _freezeJournalTypes, t as JOURNAL_CODES } from "./journals-BcMn71Cq.mjs";
+import { o as getJournalTypeCodes, r as _freezeJournalTypes, t as JOURNAL_CODES } from "./journals-BfwnCFam.mjs";
 import mongoose from "mongoose";
 //#region src/schemas/currency-field.ts
 /**

package/dist/reports/index.mjs

@@ -1,2 +1,2 @@
-import { C as DEFAULT_BUCKETS, d as generateGeneralLedger, f as generateDimensionBreakdown, h as generateBalanceSheet, m as generateBudgetVsActual, n as reopenFiscalPeriod, o as generateTrialBalance, p as generateCashFlow, s as generateRevaluation, t as closeFiscalPeriod, u as generateIncomeStatement, w as generateAgedBalance } from "../fiscal-close-DmPV82e4.mjs";
+import { C as DEFAULT_BUCKETS, d as generateGeneralLedger, f as generateDimensionBreakdown, h as generateBalanceSheet, m as generateBudgetVsActual, n as reopenFiscalPeriod, o as generateTrialBalance, p as generateCashFlow, s as generateRevaluation, t as closeFiscalPeriod, u as generateIncomeStatement, w as generateAgedBalance } from "../fiscal-close-B2_7WMTe.mjs";
 export { DEFAULT_BUCKETS, closeFiscalPeriod, generateAgedBalance, generateBalanceSheet, generateBudgetVsActual, generateCashFlow, generateDimensionBreakdown, generateGeneralLedger, generateIncomeStatement, generateRevaluation, generateTrialBalance, reopenFiscalPeriod };

package/dist/repositories/index.d.mts

@@ -1,2 +1,2 @@
-import { n as wireJournalEntryMethods, r as wireAccountMethods, t as wireReconciliationMethods } from "../reconciliation.repository-DEybU_Ok.mjs";
+import { n as wireJournalEntryMethods, r as wireAccountMethods, t as wireReconciliationMethods } from "../reconciliation.repository-D-D_ITL-.mjs";
 export { wireAccountMethods, wireJournalEntryMethods, wireReconciliationMethods };

package/dist/repositories/index.mjs

@@ -1,2 +1,2 @@
-import { n as wireJournalEntryMethods, r as wireAccountMethods, t as wireReconciliationMethods } from "../reconciliation.repository-DgJEDVS-.mjs";
+import { n as wireJournalEntryMethods, r as wireAccountMethods, t as wireReconciliationMethods } from "../reconciliation.repository-fPwFKvrk.mjs";
 export { wireAccountMethods, wireJournalEntryMethods, wireReconciliationMethods };

package/dist/schemas/index.d.mts

@@ -1,5 +1,5 @@
-import { o as SchemaOptions, t as AccountingEngineConfig } from "../engine-DF-MtsEr.mjs";
-import { n as createFiscalPeriodSchema, r as createAccountSchema, t as createJournalEntrySchema } from "../journal-entry.schema-B1CzLwC3.mjs";
+import { s as SchemaOptions, t as AccountingEngineConfig } from "../engine-scgOvxHJ.mjs";
+import { n as createFiscalPeriodSchema, r as createAccountSchema, t as createJournalEntrySchema } from "../journal-entry.schema-JqrfbvB4.mjs";
 import mongoose from "mongoose";
 
 //#region src/schemas/budget.schema.d.ts

package/dist/schemas/index.mjs

@@ -1,2 +1,2 @@
-import { a as createAccountSchema, i as createBudgetSchema, n as createJournalEntrySchema, r as createFiscalPeriodSchema, t as createReconciliationSchema } from "../reconciliation.schema-KScbsXbY.mjs";
+import { a as createAccountSchema, i as createBudgetSchema, n as createJournalEntrySchema, r as createFiscalPeriodSchema, t as createReconciliationSchema } from "../reconciliation.schema-BA1lPv4t.mjs";
 export { createAccountSchema, createBudgetSchema, createFiscalPeriodSchema, createJournalEntrySchema, createReconciliationSchema };

package/dist/{tenant-guard-CAxXoWuS.mjs → tenant-guard-r17Se3Bb.mjs}

@@ -1,4 +1,4 @@
-import { n as Errors } from "./errors-BoGUSUYL.mjs";
+import { n as Errors } from "./errors-B_dyYZc_.mjs";
 //#region src/utils/tenant-guard.ts
 /**
 * Multi-tenant scope guard.

package/docs/schemas.md

@@ -52,8 +52,8 @@ const JournalEntry = mongoose.model('JournalEntry', JournalEntrySchema);
 
 | Field | Type | Required | Description |
 |---|---|---|---|
-| `journalType` | String | Yes | One of: `GENERAL`, `SALES`, `PURCHASE`, `CASH_RECEIPT`, `CASH_DISBURSEMENT`, `PAYROLL`, `ADJUSTMENT`, `YEAR_END`, `MISC` |
-| `referenceNumber` | String | Auto | Auto-generated (e.g. `GJ-0001`). Unique per org |
+| `journalType` | String | Yes | Built-in: `SALES`, `PURCHASES`, `CASH_RECEIPTS`, `CASH_PAYMENTS`, `PAYROLL`, `GENERAL`, `INVENTORY`, `FIXED_ASSETS`, `BANK_RECONCILIATION`, `DEPRECIATION`, `YEAR_END`, `ACCOUNTS_RECEIVABLE`, `ACCOUNTS_PAYABLE`, `TAX`, `MISC`. Extensible via `registerJournalType()` before schema creation. |
+| `referenceNumber` | String | Auto | Auto-generated as `{JOURNAL_TYPE}/{YYYY}/{MM}/{NNNN}` (e.g. `SALES/2025/03/0001`). Unique per org. Sequence increments per journal type per month. |
 | `label` | String | No | Description/memo |
 | `date` | Date | No | Defaults to `new Date()` |
 | `state` | String | No | `draft` (default), `posted`, or `archived` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/ledger",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Production-grade double-entry accounting engine for MongoDB — schemas, reports, tax, multi-tenant",
   "type": "module",
   "sideEffects": false,