@classytic/ledger 0.9.1 → 0.10.1

package/dist/bridges/index.d.mts

@@ -1,2 +1,2 @@
-import { a as EntryReversedNotification, c as PeriodLockedNotification, i as SourceRef, l as ReconciliationMismatchNotification, n as SourceBridge, o as NotificationBridge, r as SourceBridgeContext, s as NotificationBridgeContext, t as LedgerBridges, u as ExchangeRateBridge } from "../index-Dih0lM65.mjs";
+import { a as EntryReversedNotification, c as PeriodLockedNotification, i as SourceRef, l as ReconciliationMismatchNotification, n as SourceBridge, o as NotificationBridge, r as SourceBridgeContext, s as NotificationBridgeContext, t as LedgerBridges, u as ExchangeRateBridge } from "../index-Bl0gP9lD.mjs";
 export { EntryReversedNotification, ExchangeRateBridge, LedgerBridges, NotificationBridge, NotificationBridgeContext, PeriodLockedNotification, ReconciliationMismatchNotification, SourceBridge, SourceBridgeContext, SourceRef };

package/dist/{errors-BI5k4iak.mjs → errors-vXd932rB.mjs}

@@ -109,7 +109,7 @@ function classifyDuplicateKey(err) {
 	let keyPattern = e.keyPattern;
 	if (!keyPattern && Array.isArray(e.writeErrors)) keyPattern = e.writeErrors.find((w) => w?.code === 11e3)?.keyPattern;
 	if (!keyPattern && wrappedMsgMatch) {
-		const fields = wrappedMsgMatch[1].split(",").map((f) => f.trim()).filter(Boolean);
+		const fields = wrappedMsgMatch[1]?.split(",").map((f) => f.trim()).filter(Boolean);
 		keyPattern = Object.fromEntries(fields.map((f) => [f, 1]));
 	}
 	return {

package/dist/events/index.d.mts

@@ -1,2 +1,3 @@
-import { C as EntryReversedPayload, D as ReconciliationUnmatchedPayload, E as ReconciliationMatchedPayload, O as LEDGER_EVENTS, S as EntryPostedPayload, T as JournalSeededPayload, _ as AccountBulkCreatedPayload, a as OutboxOwnershipError, b as EntryCreatedPayload, c as InProcessLedgerBus, d as createEvent, f as DomainEvent, g as PublishManyResult, h as EventTransport, i as OutboxFailOptions, k as LedgerEventName, l as InProcessLedgerBusOptions, m as EventLogger, n as OutboxClaimOptions, o as OutboxStore, p as EventHandler, r as OutboxErrorInfo, s as OutboxWriteOptions, t as OutboxAcknowledgeOptions, u as EventContext, v as AccountSeededPayload, w as EntryUnpostedPayload, x as EntryDuplicatedPayload, y as EntryArchivedPayload } from "../outbox-store-UYC4eZpI.mjs";
-export { type AccountBulkCreatedPayload, type AccountSeededPayload, type DomainEvent, type EntryArchivedPayload, type EntryCreatedPayload, type EntryDuplicatedPayload, type EntryPostedPayload, type EntryReversedPayload, type EntryUnpostedPayload, type EventContext, type EventHandler, type EventLogger, type EventTransport, InProcessLedgerBus, type InProcessLedgerBusOptions, type JournalSeededPayload, LEDGER_EVENTS, type LedgerEventName, type OutboxAcknowledgeOptions, type OutboxClaimOptions, type OutboxErrorInfo, type OutboxFailOptions, OutboxOwnershipError, type OutboxStore, type OutboxWriteOptions, type PublishManyResult, type ReconciliationMatchedPayload, type ReconciliationUnmatchedPayload, createEvent };
+import { $ as ReconciliationUnmatchedPayload, A as LedgerEventDefinition, B as InProcessLedgerBusOptions, C as EntryPostedPayloadSchema, D as EntryUnpostedPayloadSchema, E as EntryUnposted, F as ReconciliationUnmatched, G as EntryArchivedPayload, H as createEvent, I as ReconciliationUnmatchedPayloadSchema, J as EntryPostedPayload, K as EntryCreatedPayload, L as ledgerEventDefinitions, M as LedgerEventSchema, N as ReconciliationMatched, O as JournalSeeded, P as ReconciliationMatchedPayloadSchema, Q as ReconciliationMatchedPayload, R as EventLogger, S as EntryPosted, T as EntryReversedPayloadSchema, U as AccountBulkCreatedPayload, V as EventContext, W as AccountSeededPayload, X as EntryUnpostedPayload, Y as EntryReversedPayload, Z as JournalSeededPayload, _ as EntryArchivedPayloadSchema, a as OutboxFailOptions, b as EntryDuplicated, c as OutboxFailurePolicy, d as OutboxWriteOptions, et as LEDGER_EVENTS, f as AccountBulkCreated, g as EntryArchived, h as AccountSeededPayloadSchema, i as OutboxErrorInfo, j as LedgerEventPayloadOf, k as JournalSeededPayloadSchema, l as OutboxOwnershipError, m as AccountSeeded, n as OutboxAcknowledgeOptions, o as OutboxFailureContext, p as AccountBulkCreatedPayloadSchema, q as EntryDuplicatedPayload, r as OutboxClaimOptions, s as OutboxFailureDecision, t as InvalidOutboxEventError, tt as LedgerEventName, u as OutboxStore, v as EntryCreated, w as EntryReversed, x as EntryDuplicatedPayloadSchema, y as EntryCreatedPayloadSchema, z as InProcessLedgerBus } from "../outbox-store-BcCiHMPw.mjs";
+import { DomainEvent, EventHandler, EventTransport, PublishManyResult } from "@classytic/primitives/events";
+export { AccountBulkCreated, type AccountBulkCreatedPayload, type AccountBulkCreatedPayloadSchema, AccountSeeded, type AccountSeededPayload, type AccountSeededPayloadSchema, type DomainEvent, EntryArchived, type EntryArchivedPayload, type EntryArchivedPayloadSchema, EntryCreated, type EntryCreatedPayload, type EntryCreatedPayloadSchema, EntryDuplicated, type EntryDuplicatedPayload, type EntryDuplicatedPayloadSchema, EntryPosted, type EntryPostedPayload, type EntryPostedPayloadSchema, EntryReversed, type EntryReversedPayload, type EntryReversedPayloadSchema, EntryUnposted, type EntryUnpostedPayload, type EntryUnpostedPayloadSchema, type EventContext, type EventHandler, type EventLogger, type EventTransport, InProcessLedgerBus, type InProcessLedgerBusOptions, InvalidOutboxEventError, JournalSeeded, type JournalSeededPayload, type JournalSeededPayloadSchema, LEDGER_EVENTS, type LedgerEventDefinition, type LedgerEventName, type LedgerEventPayloadOf, type LedgerEventSchema, type OutboxAcknowledgeOptions, type OutboxClaimOptions, type OutboxErrorInfo, type OutboxFailOptions, type OutboxFailureContext, type OutboxFailureDecision, type OutboxFailurePolicy, OutboxOwnershipError, type OutboxStore, type OutboxWriteOptions, type PublishManyResult, ReconciliationMatched, type ReconciliationMatchedPayload, type ReconciliationMatchedPayloadSchema, ReconciliationUnmatched, type ReconciliationUnmatchedPayload, type ReconciliationUnmatchedPayloadSchema, createEvent, ledgerEventDefinitions };

package/dist/events/index.mjs

@@ -1,2 +1,2 @@
-import { i as LEDGER_EVENTS, n as InProcessLedgerBus, r as createEvent, t as OutboxOwnershipError } from "../outbox-store-DQbL-KYT.mjs";
-export { InProcessLedgerBus, LEDGER_EVENTS, OutboxOwnershipError, createEvent };
+import { _ as LEDGER_EVENTS, a as EntryArchived, c as EntryPosted, d as JournalSeeded, f as ReconciliationMatched, g as createEvent, h as InProcessLedgerBus, i as AccountSeeded, l as EntryReversed, m as ledgerEventDefinitions, n as OutboxOwnershipError, o as EntryCreated, p as ReconciliationUnmatched, r as AccountBulkCreated, s as EntryDuplicated, t as InvalidOutboxEventError, u as EntryUnposted } from "../outbox-store-BbKdQ2eT.mjs";
+export { AccountBulkCreated, AccountSeeded, EntryArchived, EntryCreated, EntryDuplicated, EntryPosted, EntryReversed, EntryUnposted, InProcessLedgerBus, InvalidOutboxEventError, JournalSeeded, LEDGER_EVENTS, OutboxOwnershipError, ReconciliationMatched, ReconciliationUnmatched, createEvent, ledgerEventDefinitions };

package/dist/{fx-realization.plugin-Bxlb8cIx.mjs → fx-realization.plugin-Dzqzi3u0.mjs}

@@ -1,4 +1,4 @@
-import { a as IdempotencyConflictError, i as Errors, t as AccountingError } from "./errors-BI5k4iak.mjs";
+import { a as IdempotencyConflictError, i as Errors, t as AccountingError } from "./errors-vXd932rB.mjs";
 //#region src/plugins/double-entry.plugin.ts
 function doubleEntryPlugin(options = {}) {
 	const { onlyOnPost = true, JournalEntryModel, AccountModel, orgField } = options;

package/dist/{index-Dih0lM65.d.mts → index-Bl0gP9lD.d.mts}

@@ -161,9 +161,9 @@ interface SourceBridge {
 //#region src/bridges/index.d.ts
 /** Collected bridges exposed as `engine.bridges`. All optional per PACKAGE_RULES §23. */
 interface LedgerBridges {
-  source?: SourceBridge;
-  notification?: NotificationBridge;
-  exchangeRate?: ExchangeRateBridge;
+  source?: SourceBridge | undefined;
+  notification?: NotificationBridge | undefined;
+  exchangeRate?: ExchangeRateBridge | undefined;
 }
 //#endregion
 export { EntryReversedNotification as a, PeriodLockedNotification as c, SourceRef as i, ReconciliationMismatchNotification as l, SourceBridge as n, NotificationBridge as o, SourceBridgeContext as r, NotificationBridgeContext as s, LedgerBridges as t, ExchangeRateBridge as u };

package/dist/index.d.mts

@@ -1,14 +1,16 @@
-import { a as EntryReversedNotification, c as PeriodLockedNotification, i as SourceRef, l as ReconciliationMismatchNotification, n as SourceBridge, o as NotificationBridge, r as SourceBridgeContext, s as NotificationBridgeContext, t as LedgerBridges, u as ExchangeRateBridge } from "./index-Dih0lM65.mjs";
+import { a as EntryReversedNotification, c as PeriodLockedNotification, i as SourceRef, l as ReconciliationMismatchNotification, n as SourceBridge, o as NotificationBridge, r as SourceBridgeContext, s as NotificationBridgeContext, t as LedgerBridges, u as ExchangeRateBridge } from "./index-Bl0gP9lD.mjs";
 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-DwjkrRkJ.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-DUpWwFt1.mjs";
 import { i as defineCountryPack, n as CountryPackInput, r as JournalTemplate, t as CountryPack } from "./index-08IpHhrU.mjs";
-import { C as EntryReversedPayload, D as ReconciliationUnmatchedPayload, E as ReconciliationMatchedPayload, O as LEDGER_EVENTS, S as EntryPostedPayload, T as JournalSeededPayload, _ as AccountBulkCreatedPayload, a as OutboxOwnershipError, b as EntryCreatedPayload, c as InProcessLedgerBus, d as createEvent, f as DomainEvent, g as PublishManyResult, h as EventTransport, i as OutboxFailOptions, k as LedgerEventName, l as InProcessLedgerBusOptions, m as EventLogger, n as OutboxClaimOptions, o as OutboxStore, p as EventHandler, r as OutboxErrorInfo, s as OutboxWriteOptions, t as OutboxAcknowledgeOptions, u as EventContext, v as AccountSeededPayload, w as EntryUnpostedPayload, x as EntryDuplicatedPayload, y as EntryArchivedPayload } from "./outbox-store-UYC4eZpI.mjs";
+import { $ as ReconciliationUnmatchedPayload, A as LedgerEventDefinition, B as InProcessLedgerBusOptions, E as EntryUnposted, F as ReconciliationUnmatched, G as EntryArchivedPayload, H as createEvent, J as EntryPostedPayload, K as EntryCreatedPayload, L as ledgerEventDefinitions, M as LedgerEventSchema, N as ReconciliationMatched, O as JournalSeeded, Q as ReconciliationMatchedPayload, R as EventLogger, S as EntryPosted, U as AccountBulkCreatedPayload, V as EventContext, W as AccountSeededPayload, X as EntryUnpostedPayload, Y as EntryReversedPayload, Z as JournalSeededPayload, a as OutboxFailOptions, b as EntryDuplicated, c as OutboxFailurePolicy, d as OutboxWriteOptions, et as LEDGER_EVENTS, f as AccountBulkCreated, g as EntryArchived, i as OutboxErrorInfo, j as LedgerEventPayloadOf, l as OutboxOwnershipError, m as AccountSeeded, n as OutboxAcknowledgeOptions, o as OutboxFailureContext, q as EntryDuplicatedPayload, r as OutboxClaimOptions, s as OutboxFailureDecision, t as InvalidOutboxEventError, tt as LedgerEventName, u as OutboxStore, v as EntryCreated, w as EntryReversed, z as InProcessLedgerBus } from "./outbox-store-BcCiHMPw.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 AgedBalanceParams, A as generateDimensionBreakdown, B as BalanceSheetReport, D as DimensionBreakdownParams, E as DimensionBreakdownOptions, F as BudgetVsActualReport, G as IncomeStatementReport, H as CashFlowSection, I as BudgetVsActualRow, J as ReportCategory, K as LedgerEntry, L as generateBudgetVsActual, M as generateCashFlow, N as BudgetVsActualOptions, O as DimensionBreakdownReport, P as BudgetVsActualParams, Q as AgedBalanceOptions, T as reopenFiscalPeriod, U as GeneralLedgerAccount, V as CashFlowReport, W as GeneralLedgerReport, X as TrialBalanceReport, Y as ReportGroup, Z as TrialBalanceRow, a as RevaluationReport, at as Logger, b as generateGeneralLedger, c as RevaluationRate, d as computeRevaluation, et as AgedBalanceReport, f as PartnerLedgerLine, g as generatePartnerLedger, h as PartnerLedgerReport, i as RevaluationParams, it as generateAgedBalance, k as DimensionBreakdownRow, l as RevaluationResult, m as PartnerLedgerParams, n as generateTrialBalance, nt as AgedBucketConfig, o as generateRevaluation, ot as defaultLogger, p as PartnerLedgerOptions, q as ReportAccount, r as RevaluationOptions, rt as DEFAULT_BUCKETS, s as AccountForeignBalance, tt as AgedBalanceRow, u as buildRevaluationEntry, v as generateIncomeStatement, w as closeFiscalPeriod, z as generateBalanceSheet } from "./trial-balance-DyNm5bFu.mjs";
 import { A as OpenItem, C as AccountRepository, D as JournalItemRef, E as JournalEntryRepository, F as SeedOptions, I as SeedResult, M as ReconciliationRepository, N as ReverseOptions, O as JournalRepository, P as ReverseResult, S as creditLimitPlugin, T as BulkCreateResult, _ as FxRealizationPluginOptions, a as dailyLockPlugin, b as doubleEntryPlugin, c as periodResolver, d as LockAccountSelector, f as LockHit, g as idempotencyPlugin, i as FiscalLockPluginOptions, j as PostOptions, k as MatchInput, l as createLockPlugin, m as LockResolverContext, n as watermarkResolver, o as fiscalLockPlugin, p as LockResolver, r as DailyLockPluginOptions, s as PeriodResolverOptions, t as WatermarkResolverOptions, u as CreateLockPluginOptions, v as fxRealizationPlugin, w as BulkCreateInput, x as CreditLimitPluginOptions } from "./index-ClLwzNRF.mjs";
+import { DomainEvent, EventHandler, EventTransport, EventTransport as EventTransport$1, PublishManyResult } from "@classytic/primitives/events";
 import { PaginationConfig, PluginFunction, PluginType, QueryParser, QueryParserOptions, Repository } from "@classytic/mongokit";
 import { ClientSession, Connection, Model } from "mongoose";
+import { TenantConfig } from "@classytic/primitives/tenant";
 
 //#region src/plugins/immutable-guard.plugin.d.ts
 interface ImmutableGuardOptions {
@@ -126,79 +128,97 @@ declare function classifyDuplicateKey(err: unknown): {
 //#region src/types/engine.d.ts
 /** Mongokit plugins to install per repository (composes with engine built-ins). */
 interface LedgerRepositoryPlugins {
-  account?: PluginType[];
-  journalEntry?: PluginType[];
-  fiscalPeriod?: PluginType[];
-  budget?: PluginType[];
-  reconciliation?: PluginType[];
-  journal?: PluginType[];
+  account?: PluginType[] | undefined;
+  journalEntry?: PluginType[] | undefined;
+  fiscalPeriod?: PluginType[] | undefined;
+  budget?: PluginType[] | undefined;
+  reconciliation?: PluginType[] | undefined;
+  journal?: PluginType[] | undefined;
 }
 /** Pagination caps per repository. Omit a key to use mongokit defaults. */
 interface LedgerPaginationConfig {
-  account?: PaginationConfig;
-  journalEntry?: PaginationConfig;
-  fiscalPeriod?: PaginationConfig;
-  budget?: PaginationConfig;
-  reconciliation?: PaginationConfig;
-  journal?: PaginationConfig;
+  account?: PaginationConfig | undefined;
+  journalEntry?: PaginationConfig | undefined;
+  fiscalPeriod?: PaginationConfig | undefined;
+  budget?: PaginationConfig | undefined;
+  reconciliation?: PaginationConfig | undefined;
+  journal?: PaginationConfig | undefined;
 }
-/** Multi-tenant configuration */
-interface MultiTenantConfig {
-  /** Field name for the organization reference (e.g., 'business', 'organization', 'company') */
-  orgField: string;
-  /** Mongoose model name the org field references (e.g., 'Business', 'Organization') */
-  orgRef: string;
+/**
+ * Multi-tenant configuration.
+ *
+ * Extends `@classytic/primitives/tenant` `TenantConfig` — field names match
+ * across primitives, mongokit's `MultiTenantOptions`, and ledger so hosts
+ * don't learn three shapes for the same idea. Ledger tightens the
+ * primitives' optional `tenantField` and `ref` into required (ledger has
+ * no sensible default — the host must name its organization collection).
+ */
+interface MultiTenantConfig extends TenantConfig {
+  /**
+   * Field name for the organization reference (e.g., 'business',
+   * 'organization', 'company'). Required — ledger has no default here.
+   */
+  tenantField: string;
+  /**
+   * Mongoose model name the tenant field references (e.g., 'Business',
+   * 'Organization'). Required.
+   */
+  ref: string;
   /**
-   * Enable mongokit's `multiTenantPlugin` on every ledger repository. The plugin
-   * injects the tenant filter at POLICY priority (before cache/audit) whenever
-   * `ctx.organizationId` is present on a call. When `false` (default), only
-   * manual `orgField` filters inside domain verbs enforce scoping.
+   * Enable mongokit's `multiTenantPlugin` on every ledger repository. The
+   * plugin injects the tenant filter at POLICY priority (before cache/audit)
+   * whenever `ctx.organizationId` is present on a call. When `false`
+   * (default), only manual `tenantField` filters inside domain verbs enforce
+   * scoping.
    *
    * Recommended: `true` for new hosts. Keep `false` if your app has not yet
    * migrated to context-based scoping.
    */
-  plugin?: boolean;
+  plugin?: boolean | undefined;
   /**
    * Fail closed when `ctx.organizationId` is missing on a plugin-scoped call.
    * Only applies when `plugin: true`. Default: `false` (skip injection when
    * context is empty — matches historical ledger behavior).
+   *
+   * Note: this is *plugin-level* fail-closed; the schema-level required flag
+   * on the tenant field is always `true` when multi-tenant is on.
    */
-  required?: boolean;
+  required?: boolean | undefined;
 }
 /** Options passed to schema factory functions */
 interface SchemaOptions {
   /** Add recommended indexes (default: true) */
-  indexes?: boolean;
+  indexes?: boolean | undefined;
   /** Extra Mongoose schema fields to merge in */
-  extraFields?: Record<string, unknown>;
+  extraFields?: Record<string, unknown> | undefined;
   /** Extra indexes to add */
   extraIndexes?: Array<{
     fields: Record<string, 1 | -1>;
-    options?: Record<string, unknown>;
-  }>;
+    options?: Record<string, unknown> | undefined;
+  }> | undefined;
 }
 /** Journal entry schema-specific options */
 interface JournalSchemaOptions extends SchemaOptions {
   /** Auto-generate reference numbers (default: true) */
-  autoReference?: boolean;
+  autoReference?: boolean | undefined;
   /** Enable text search index on reference + label (default: true) */
-  textSearch?: boolean;
+  textSearch?: boolean | undefined;
   /** Extra Mongoose schema fields to merge into the JournalItem subdocument */
-  extraItemFields?: Record<string, unknown>;
+  extraItemFields?: Record<string, unknown> | undefined;
 }
 /** Audit trail configuration */
 interface AuditConfig {
   /** Track actor (user) who performs each operation (post, reverse, approve) */
-  trackActor?: boolean;
+  trackActor?: boolean | undefined;
 }
 /** Strictness rules for the ledger */
 interface StrictnessConfig {
   /** If true, unpost() is disabled — correction only via reverse() (immutable ledger) */
-  immutable?: boolean;
+  immutable?: boolean | undefined;
   /** If true, actorId is required on post/reverse/unpost operations */
-  requireActor?: boolean;
+  requireActor?: boolean | undefined;
   /** If true, entries must have approvedBy/approvedAt set before posting */
-  requireApproval?: boolean;
+  requireApproval?: boolean | undefined;
 }
 /**
  * Multi-currency configuration.
@@ -222,19 +242,19 @@ interface MultiCurrencyConfig {
   /** Enable multi-currency fields on schemas */
   enabled: boolean;
   /** Allowed foreign currency codes. If omitted, any ISO 4217 code is accepted. */
-  currencies?: readonly string[];
+  currencies?: readonly string[] | undefined;
 }
 /**
  * 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;
-  journal?: string;
+  account?: string | undefined;
+  journalEntry?: string | undefined;
+  fiscalPeriod?: string | undefined;
+  budget?: string | undefined;
+  reconciliation?: string | undefined;
+  journal?: string | undefined;
 }
 /** Main engine configuration */
 interface AccountingEngineConfig {
@@ -244,61 +264,61 @@ interface AccountingEngineConfig {
    */
   mongoose: Connection;
   /** Override default model names (e.g. 'Account' → 'GLAccount') */
-  modelNames?: ModelNames;
+  modelNames?: ModelNames | undefined;
   /** Extra fields / indexes per model */
   schemaOptions?: {
-    account?: SchemaOptions;
-    journalEntry?: JournalSchemaOptions;
-    fiscalPeriod?: SchemaOptions;
-    budget?: SchemaOptions;
-    reconciliation?: SchemaOptions;
-    journal?: SchemaOptions;
-  };
+    account?: SchemaOptions | undefined;
+    journalEntry?: JournalSchemaOptions | undefined;
+    fiscalPeriod?: SchemaOptions | undefined;
+    budget?: SchemaOptions | undefined;
+    reconciliation?: SchemaOptions | undefined;
+    journal?: SchemaOptions | undefined;
+  } | undefined;
   /** Country pack providing account types, tax codes, and templates */
   country: CountryPack;
   /** Default ISO 4217 currency code — the functional/base currency (e.g., 'CAD', 'BDT') */
   currency: string;
   /** Multi-tenant configuration. Omit for single-tenant apps. */
-  multiTenant?: MultiTenantConfig;
+  multiTenant?: MultiTenantConfig | undefined;
   /** Multi-currency support. Omit for single-currency apps. */
-  multiCurrency?: MultiCurrencyConfig;
+  multiCurrency?: MultiCurrencyConfig | undefined;
   /** Fiscal year start month (1-12, default: 1 = January) */
-  fiscalYearStartMonth?: number;
+  fiscalYearStartMonth?: number | undefined;
   /**
    * The retained earnings account code (e.g. '3600' CA, '3310' BD).
    * Overrides the country pack value. See CountryPack.retainedEarningsAccountCode.
    */
-  retainedEarningsAccountCode?: string;
+  retainedEarningsAccountCode?: string | undefined;
   /** Display code for the "Previous Years Retained Earnings" line. Overrides country pack. */
-  retainedEarningsDisplayCode?: string;
+  retainedEarningsDisplayCode?: string | undefined;
   /** Display code for current year net income line. Overrides country pack. */
-  currentYearEarningsCode?: string;
+  currentYearEarningsCode?: string | undefined;
   /** Logger instance. Defaults to console-based logger. */
-  logger?: Logger;
+  logger?: Logger | undefined;
   /** Audit trail configuration */
-  audit?: AuditConfig;
+  audit?: AuditConfig | undefined;
   /** Enable built-in idempotency key field on journal entries */
-  idempotency?: boolean;
+  idempotency?: boolean | undefined;
   /**
    * TTL in seconds for idempotency records — stale replay keys auto-expire
    * via a partial TTL index so they don't collide with legitimate reuse
    * after the window closes. Default: 86400 (24h). Matches Stripe / Saleor
    * convention. Only applies when `idempotency: true`.
    */
-  idempotencyTtlSeconds?: number;
+  idempotencyTtlSeconds?: number | undefined;
   /**
    * Automatically call `Model.syncIndexes()` on every managed model right
    * after the engine boots. Ensures new partial/TTL indexes (0.9.0+) are
    * present in MongoDB before the first write. Default: `false` — hosts
    * that run migrations themselves should leave this off.
    */
-  syncIndexes?: boolean;
+  syncIndexes?: boolean | undefined;
   /** Strictness rules for the ledger */
-  strictness?: StrictnessConfig;
+  strictness?: StrictnessConfig | undefined;
   /** Mongokit plugins to install per repository. */
-  plugins?: LedgerRepositoryPlugins;
+  plugins?: LedgerRepositoryPlugins | undefined;
   /** Pagination caps per repository. */
-  pagination?: LedgerPaginationConfig;
+  pagination?: LedgerPaginationConfig | undefined;
   /**
    * Mongoose type for the multi-tenant field on all ledger schemas.
    *
@@ -315,14 +335,14 @@ interface AccountingEngineConfig {
    * `multiTenant.plugin: true`. Schema-level type switching is applied
    * by the models factory when it supports dynamic type declaration.
    */
-  tenantFieldType?: 'objectId' | 'string';
+  tenantFieldType?: 'objectId' | 'string' | undefined;
   /**
    * Optional event transport — structurally identical to `@classytic/arc`'s
    * `EventTransport`. Drop in any arc transport (Memory, Redis, Kafka, BullMQ)
    * or provide a custom one. When omitted, the engine uses an in-process bus
    * (`InProcessLedgerBus`) that is NOT suitable for multi-instance deployments.
    */
-  eventTransport?: EventTransport;
+  eventTransport?: EventTransport$1 | undefined;
   /**
    * Optional host-owned outbox store — structurally identical to
    * `@classytic/arc`'s `OutboxStore`. When provided, domain events are
@@ -336,13 +356,13 @@ interface AccountingEngineConfig {
    * host picks `MongoOutboxStore` (arc), a SQL store, a Redis store,
    * etc. See `src/events/outbox-store.ts` for the interface contract.
    */
-  outboxStore?: OutboxStore;
+  outboxStore?: OutboxStore | undefined;
   /**
    * Host-provided bridges for external integrations (source resolution,
    * notifications). All bridges and all methods are optional — features
    * degrade gracefully when a bridge is missing.
    */
-  bridges?: LedgerBridges;
+  bridges?: LedgerBridges | undefined;
 }
 //#endregion
 //#region src/models/factory.d.ts
@@ -380,7 +400,7 @@ interface LedgerRepositories {
  * consumers without events/bridges see no behavioral change.
  */
 interface LedgerRepositoryIntegrations {
-  events?: EventTransport;
+  events?: EventTransport$1;
   bridges?: LedgerBridges;
   outboxStore?: OutboxStore;
 }
@@ -699,7 +719,7 @@ declare class AccountingEngine {
    * `InProcessLedgerBus` (suitable for single-instance deployments only).
    * Subscribe with glob patterns: `ledger:entry.*`, `ledger:reconciliation.*`, `*`.
    */
-  readonly events: EventTransport;
+  readonly events: EventTransport$1;
   /**
    * Host-provided bridges. Empty object when none supplied. Callers should
    * optional-chain every method (`engine.bridges.source?.resolve?.(...)`).
@@ -1049,4 +1069,4 @@ interface PostingResult {
   idempotencyKeys?: string[];
 }
 //#endregion
-export { type AccountBulkCreatedPayload, type AccountCode, type AccountForeignBalance, type AccountRepository, type AccountSeededPayload, type AccountSummary, type AccountType, AccountingEngine, type AccountingEngineConfig, AccountingError, type ActorContext, 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, ConcurrencyError, type CountryPack, type CountryPackInput, type CreateLockPluginOptions, type CreditLimitPluginOptions, type Currency, DEFAULT_BUCKETS, type DailyLockPluginOptions, type DateOption, type DateRange, type DimensionBreakdownOptions, type DimensionBreakdownParams, type DimensionBreakdownReport, type DimensionBreakdownRow, type DimensionDefinition, type DomainEvent, DuplicateReferenceError, type EntryArchivedPayload, type EntryCreatedPayload, type EntryDuplicatedPayload, type EntryPostedPayload, type EntryReversedNotification, type EntryReversedPayload, type EntryState, type EntryUnpostedPayload, Errors, type EventContext, type EventHandler, type EventLogger, type EventTransport, type ExchangeRateBridge, type ExportField, type ExportFieldMap, type FieldError, type FiscalLockPluginOptions, type FiscalPeriodSummary, type FlatJournalRow, type FxRealizationPluginOptions, type GeneralLedgerAccount, type GeneralLedgerReport, IdempotencyConflictError, type ImmutableGuardOptions, ImmutableViolationError, InProcessLedgerBus, type InProcessLedgerBusOptions, type IncomeStatementReport, type IntrospectAPI, JOURNAL_CODES, JOURNAL_TYPES, type JournalEntryRepository, type JournalItem, type JournalItemRef, type JournalRepository, type JournalSchemaOptions, type JournalSeededPayload, type JournalTemplate, type JournalType, LEDGER_EVENTS, type LedgerBridges, type LedgerEntry, type LedgerEventName, type LedgerModels, type LedgerPaginationConfig, type LedgerRepositories, type LedgerRepositoryPlugins, type LockAccountSelector, type LockHit, type LockResolver, type LockResolverContext, type Logger, type MainType, type MatchHookContext, type MatchHookItem, type MatchInput, type ModelNames, Money, type MultiCurrencyConfig, type MultiTenantConfig, type NormalBalance, type NotificationBridge, type NotificationBridgeContext, type OpenItem, type OutboxAcknowledgeOptions, type OutboxClaimOptions, type OutboxErrorInfo, type OutboxFailOptions, OutboxOwnershipError, type OutboxStore, type OutboxWriteOptions, type PartnerLedgerLine, type PartnerLedgerOptions, type PartnerLedgerParams, type PartnerLedgerReport, type PeriodLockedNotification, type PeriodResolverOptions, type PopulatedJournalEntry, type PostOptions, type PostingContract, type PostingResult, type PublishManyResult, type ReconciliationMatchedPayload, type ReconciliationMismatchNotification, type ReconciliationRepository, type ReconciliationUnmatchedPayload, type RecordAPI, type RecordAdjustmentInput, type RecordAdjustmentLine, type RecordExpenseInput, type RecordOptions, type RecordPaymentInput, type RecordSaleInput, type RecordTransferInput, type ReportAccount, type ReportCategory, type ReportDescriptor, 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 Cents$1 as SemanticCents, type SessionResult, type SourceBridge, type SourceBridgeContext, type SourceRef, type StatementType, type StrictnessConfig, type SubledgerJournalItem, type SubledgerPostingInput, type TaxDetail, type TaxMetadata, type TotalAccountOp, type TrialBalanceReport, type TrialBalanceRow, type UnmatchHookContext, type WatermarkResolverOptions, acquireSession, add, allocate, buildAccountTypeMap, buildDimensionFields, buildDimensionIndexes, buildItemFilters, buildRevaluationEntry, calculateTotal, classifyDuplicateKey, closeFiscalPeriod, computeEndingBalance, computeRevaluation, createAccountingEngine, createEvent, createLockPlugin, createModels, createRepositories, creditLimitPlugin, dailyLockPlugin, defaultLogger, defineCountryPack, doubleEntryPlugin, exportToCsv, finalizeSession, fiscalLockPlugin, flattenJournalEntries, format, formatPlain, fromDecimal, fxRealizationPlugin, generateAgedBalance, generateBalanceSheet, generateBudgetVsActual, generateCashFlow, generateDimensionBreakdown, generateGeneralLedger, generateIncomeStatement, generatePartnerLedger, generateRevaluation, generateTrialBalance, getCurrency, getCustomJournalTypes, getDateRange, getFiscalYearStart, getJournalType, getJournalTypeCodes, getMinorUnit, getNormalBalance, idempotencyPlugin, immutableGuardPlugin, isBalanceSheet, isIncomeStatement, isValidCategory, isValidCurrency, isValidJournalType, isVirtualTaxAccount, multiply, parseCents, percentage, periodResolver, quickbooksFieldMap, registerJournalType, reopenFiscalPeriod, resolveModelNames, splitTaxExclusive, splitTaxInclusive, subtract, toDecimal, universalFieldMap, watermarkResolver };
+export { AccountBulkCreated, type AccountBulkCreatedPayload, type AccountCode, type AccountForeignBalance, type AccountRepository, AccountSeeded, type AccountSeededPayload, type AccountSummary, type AccountType, AccountingEngine, type AccountingEngineConfig, AccountingError, type ActorContext, 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, ConcurrencyError, type CountryPack, type CountryPackInput, type CreateLockPluginOptions, type CreditLimitPluginOptions, type Currency, DEFAULT_BUCKETS, type DailyLockPluginOptions, type DateOption, type DateRange, type DimensionBreakdownOptions, type DimensionBreakdownParams, type DimensionBreakdownReport, type DimensionBreakdownRow, type DimensionDefinition, type DomainEvent, DuplicateReferenceError, EntryArchived, type EntryArchivedPayload, EntryCreated, type EntryCreatedPayload, EntryDuplicated, type EntryDuplicatedPayload, EntryPosted, type EntryPostedPayload, EntryReversed, type EntryReversedNotification, type EntryReversedPayload, type EntryState, EntryUnposted, type EntryUnpostedPayload, Errors, type EventContext, type EventHandler, type EventLogger, type EventTransport, type ExchangeRateBridge, type ExportField, type ExportFieldMap, type FieldError, type FiscalLockPluginOptions, type FiscalPeriodSummary, type FlatJournalRow, type FxRealizationPluginOptions, type GeneralLedgerAccount, type GeneralLedgerReport, IdempotencyConflictError, type ImmutableGuardOptions, ImmutableViolationError, InProcessLedgerBus, type InProcessLedgerBusOptions, type IncomeStatementReport, type IntrospectAPI, InvalidOutboxEventError, JOURNAL_CODES, JOURNAL_TYPES, type JournalEntryRepository, type JournalItem, type JournalItemRef, type JournalRepository, type JournalSchemaOptions, JournalSeeded, type JournalSeededPayload, type JournalTemplate, type JournalType, LEDGER_EVENTS, type LedgerBridges, type LedgerEntry, type LedgerEventDefinition, type LedgerEventName, type LedgerEventPayloadOf, type LedgerEventSchema, type LedgerModels, type LedgerPaginationConfig, type LedgerRepositories, type LedgerRepositoryPlugins, type LockAccountSelector, type LockHit, type LockResolver, type LockResolverContext, type Logger, type MainType, type MatchHookContext, type MatchHookItem, type MatchInput, type ModelNames, Money, type MultiCurrencyConfig, type MultiTenantConfig, type NormalBalance, type NotificationBridge, type NotificationBridgeContext, type OpenItem, type OutboxAcknowledgeOptions, type OutboxClaimOptions, type OutboxErrorInfo, type OutboxFailOptions, type OutboxFailureContext, type OutboxFailureDecision, type OutboxFailurePolicy, OutboxOwnershipError, type OutboxStore, type OutboxWriteOptions, type PartnerLedgerLine, type PartnerLedgerOptions, type PartnerLedgerParams, type PartnerLedgerReport, type PeriodLockedNotification, type PeriodResolverOptions, type PopulatedJournalEntry, type PostOptions, type PostingContract, type PostingResult, type PublishManyResult, ReconciliationMatched, type ReconciliationMatchedPayload, type ReconciliationMismatchNotification, type ReconciliationRepository, ReconciliationUnmatched, type ReconciliationUnmatchedPayload, type RecordAPI, type RecordAdjustmentInput, type RecordAdjustmentLine, type RecordExpenseInput, type RecordOptions, type RecordPaymentInput, type RecordSaleInput, type RecordTransferInput, type ReportAccount, type ReportCategory, type ReportDescriptor, 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 Cents$1 as SemanticCents, type SessionResult, type SourceBridge, type SourceBridgeContext, type SourceRef, type StatementType, type StrictnessConfig, type SubledgerJournalItem, type SubledgerPostingInput, type TaxDetail, type TaxMetadata, type TotalAccountOp, type TrialBalanceReport, type TrialBalanceRow, type UnmatchHookContext, type WatermarkResolverOptions, acquireSession, add, allocate, buildAccountTypeMap, buildDimensionFields, buildDimensionIndexes, buildItemFilters, buildRevaluationEntry, calculateTotal, classifyDuplicateKey, closeFiscalPeriod, computeEndingBalance, computeRevaluation, createAccountingEngine, createEvent, createLockPlugin, createModels, createRepositories, creditLimitPlugin, dailyLockPlugin, defaultLogger, defineCountryPack, doubleEntryPlugin, exportToCsv, finalizeSession, fiscalLockPlugin, flattenJournalEntries, format, formatPlain, fromDecimal, fxRealizationPlugin, generateAgedBalance, generateBalanceSheet, generateBudgetVsActual, generateCashFlow, generateDimensionBreakdown, generateGeneralLedger, generateIncomeStatement, generatePartnerLedger, generateRevaluation, generateTrialBalance, getCurrency, getCustomJournalTypes, getDateRange, getFiscalYearStart, getJournalType, getJournalTypeCodes, getMinorUnit, getNormalBalance, idempotencyPlugin, immutableGuardPlugin, isBalanceSheet, isIncomeStatement, isValidCategory, isValidCurrency, isValidJournalType, isVirtualTaxAccount, ledgerEventDefinitions, multiply, parseCents, percentage, periodResolver, quickbooksFieldMap, registerJournalType, reopenFiscalPeriod, resolveModelNames, splitTaxExclusive, splitTaxInclusive, subtract, toDecimal, universalFieldMap, watermarkResolver };