@classytic/ledger 0.9.0 → 0.10.0

package/dist/index.mjs

@@ -1,15 +1,16 @@
-import { i as LEDGER_EVENTS, n as InProcessLedgerBus, r as createEvent, t as OutboxOwnershipError } from "./outbox-store-DQbL-KYT.mjs";
-import { a as IdempotencyConflictError, i as Errors, n as ConcurrencyError, o as ImmutableViolationError, r as DuplicateReferenceError, s as classifyDuplicateKey, t as AccountingError } from "./errors-BI5k4iak.mjs";
+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";
+import { a as IdempotencyConflictError, i as Errors, n as ConcurrencyError, o as ImmutableViolationError, r as DuplicateReferenceError, s as classifyDuplicateKey, t as AccountingError } from "./errors-vXd932rB.mjs";
 import { a as JOURNAL_CODES, c as getCustomJournalTypes, d as isValidJournalType, f as registerJournalType, i as isValidCurrency, l as getJournalType, n as getCurrency, o as JOURNAL_TYPES, r as getMinorUnit, s as _freezeJournalTypes, t as CURRENCIES, u as getJournalTypeCodes } from "./currencies-Jo5oaM_4.mjs";
 import { Money, add, allocate, format, formatPlain, fromDecimal, multiply, parseCents, percentage, splitTaxExclusive, splitTaxInclusive, subtract, toDecimal } from "./money.mjs";
-import { C as isVirtualTaxAccount, E as requireOrgScope, S as computeEndingBalance, T as generateAgedBalance, _ as buildItemFilters, a as finalizeSession, b as buildAccountTypeMap, c as generateRevaluation, d as generateIncomeStatement, f as generateGeneralLedger, g as generateBalanceSheet, h as generateBudgetVsActual, i as acquireSession, l as buildRevaluationEntry, m as generateCashFlow, n as closeFiscalPeriod, o as defaultLogger, p as generateDimensionBreakdown, r as reopenFiscalPeriod, s as generateTrialBalance, t as generatePartnerLedger, u as computeRevaluation, v as getDateRange, w as DEFAULT_BUCKETS, x as calculateTotal, y as getFiscalYearStart } from "./partner-ledger-BoebloHk.mjs";
+import { C as isVirtualTaxAccount, E as requireOrgScope, S as computeEndingBalance, T as generateAgedBalance, _ as buildItemFilters, a as finalizeSession, b as buildAccountTypeMap, c as generateRevaluation, d as generateIncomeStatement, f as generateGeneralLedger, g as generateBalanceSheet, h as generateBudgetVsActual, i as acquireSession, l as buildRevaluationEntry, m as generateCashFlow, n as closeFiscalPeriod, o as defaultLogger, p as generateDimensionBreakdown, r as reopenFiscalPeriod, s as generateTrialBalance, t as generatePartnerLedger, u as computeRevaluation, v as getDateRange, w as DEFAULT_BUCKETS, x as calculateTotal, y as getFiscalYearStart } from "./partner-ledger-CR0geilx.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 { a as watermarkResolver, c as idempotencyPlugin, i as fiscalLockPlugin, l as doubleEntryPlugin, n as creditLimitPlugin, o as periodResolver, r as dailyLockPlugin, s as createLockPlugin, t as fxRealizationPlugin } from "./fx-realization.plugin-Bxlb8cIx.mjs";
+import { a as watermarkResolver, c as idempotencyPlugin, i as fiscalLockPlugin, l as doubleEntryPlugin, n as creditLimitPlugin, o as periodResolver, r as dailyLockPlugin, s as createLockPlugin, t as fxRealizationPlugin } from "./fx-realization.plugin-Dzqzi3u0.mjs";
 import { t as buildOpeningBalanceEntry } from "./opening-balance-1cixYh6Y.mjs";
 import { defineCountryPack } from "./country/index.mjs";
 import { a as exportToCsv, i as quickbooksFieldMap, r as universalFieldMap, t as flattenJournalEntries } from "./exports-C30yRapf.mjs";
-import { QueryParser, Repository, getNextSequence, multiTenantPlugin } from "@classytic/mongokit";
+import { QueryParser, Repository, getNextSequence, multiTenantPlugin, withTransaction } from "@classytic/mongokit";
 import mongoose, { Schema } from "mongoose";
+import { resolveTenantConfig } from "@classytic/primitives/tenant";
 //#region src/plugins/immutable-guard.plugin.ts
 /**
 * Returns a mongokit plugin function. Install only when
@@ -37,6 +38,77 @@ function immutableGuardPlugin(options) {
 	};
 }
 //#endregion
+//#region src/models/inject-tenant.ts
+/**
+* Mongoose-specific adapter around `resolveTenantConfig()` from
+* `@classytic/primitives/tenant`. The pure resolution lives in primitives
+* (zero runtime deps) — this file only handles the Mongoose schema
+* mutations (add field, prepend tenant onto compound indexes) that
+* primitives can't own without a mongoose dependency.
+*
+* Prior to consolidation, each ledger schema (account, budget,
+* fiscal-period, journal, journal-entry, reconciliation) inlined the same
+* `if (multiTenant) { fields[multiTenant.tenantField] = { type: ObjectId,
+* ref, required: true } }` block. That logic now lives here — schemas call
+* `injectTenantField(schema, scope)` where `scope` is a
+* `ResolvedTenantConfig` produced by `resolveLedgerTenant()`.
+*/
+/**
+* Translate ledger's `AccountingEngineConfig` into a `ResolvedTenantConfig`.
+*
+* Ledger's `MultiTenantConfig` tightens primitives' optionals (`tenantField`
+* and `ref` are required in ledger — no default org-collection name) and
+* carries a ledger-specific `plugin` knob for `multiTenantPlugin` adoption
+* that primitives doesn't own. We merge those with `config.tenantFieldType`
+* (engine-level field-type override) and produce a pure
+* `ResolvedTenantConfig` suitable for `injectTenantField()`.
+*
+* When `config.multiTenant` is absent, scoping is disabled (strategy =
+* `'none'`) and no tenant field is added to schemas.
+*/
+function resolveLedgerTenant(config) {
+	const mt = config.multiTenant;
+	if (!mt) return resolveTenantConfig(false);
+	return resolveTenantConfig({
+		enabled: true,
+		strategy: "field",
+		tenantField: mt.tenantField,
+		ref: mt.ref,
+		fieldType: config.tenantFieldType ?? "objectId",
+		required: true
+	});
+}
+/**
+* Inject the tenant field into a Mongoose schema and (when
+* `strategy === 'field'` is active) prepend the tenant field onto every
+* existing compound index so queries are index-efficient under multi-tenant
+* scoping. Matches the order/people/revenue pattern (PACKAGE_RULES §9.2).
+*
+* Schemas should declare their compound indexes WITHOUT a tenant prefix
+* and then call this helper once — the prefix is added here.
+*/
+function injectTenantField(schema, scope) {
+	const isFieldStrategy = scope.strategy === "field";
+	const isObjectId = scope.fieldType === "objectId";
+	if (isFieldStrategy) {
+		const fieldDef = {
+			type: isObjectId ? mongoose.Schema.Types.ObjectId : String,
+			...scope.enabled && scope.required ? { required: true } : {}
+		};
+		if (isObjectId && scope.ref) fieldDef.ref = scope.ref;
+		schema.add({ [scope.tenantField]: fieldDef });
+	}
+	if (!scope.enabled || !isFieldStrategy) return;
+	const existingIndexes = schema._indexes;
+	if (existingIndexes && existingIndexes.length > 0) for (const indexEntry of existingIndexes) {
+		const fields = indexEntry[0];
+		if (fields[scope.tenantField] !== void 0) continue;
+		const newFields = { [scope.tenantField]: 1 };
+		for (const [key, val] of Object.entries(fields)) newFields[key] = val;
+		indexEntry[0] = newFields;
+	}
+}
+//#endregion
 //#region src/schemas/currency-field.ts
 /**
 * Build the Mongoose currency field definition.
@@ -67,7 +139,8 @@ function buildCurrencyField(config) {
 * - Lean: no cached balances — always computed from journal entries
 */
 function createAccountSchema(config, options = {}) {
-	const { multiTenant, country } = config;
+	const { country } = config;
+	const scope = resolveLedgerTenant(config);
 	const { indexes = true, extraFields = {}, extraIndexes = [] } = options;
 	const fields = {
 		accountTypeCode: {
@@ -100,36 +173,21 @@ function createAccountSchema(config, options = {}) {
 	const currencyField = buildCurrencyField(config);
 	if (currencyField) fields.currency = currencyField;
 	Object.assign(fields, extraFields);
-	if (multiTenant) fields[multiTenant.orgField] = {
-		type: mongoose.Schema.Types.ObjectId,
-		ref: multiTenant.orgRef,
-		required: true
-	};
 	const schema = new mongoose.Schema(fields, { timestamps: true });
 	schema.pre("validate", function() {
 		if (!this.accountNumber && this.accountTypeCode) this.accountNumber = this.accountTypeCode;
-		if (!this.name && this.accountTypeCode) this.name = country.getAccountType(this.accountTypeCode)?.name ?? this.accountTypeCode;
+		if (!this.name && this.accountTypeCode) {
+			const at = country.getAccountType(this.accountTypeCode);
+			this.name = at?.name ?? this.accountTypeCode;
+		}
 	});
-	if (indexes) if (multiTenant) {
-		const org = multiTenant.orgField;
-		schema.index({
-			[org]: 1,
-			active: 1
-		});
-		schema.index({
-			[org]: 1,
-			accountNumber: 1
-		}, { unique: true });
-		schema.index({
-			[org]: 1,
-			accountTypeCode: 1
-		});
-	} else {
+	if (indexes) {
 		schema.index({ active: 1 });
 		schema.index({ accountNumber: 1 }, { unique: true });
 		schema.index({ accountTypeCode: 1 });
 	}
 	for (const idx of extraIndexes) schema.index(idx.fields, idx.options);
+	injectTenantField(schema, scope);
 	return schema;
 }
 //#endregion
@@ -142,7 +200,7 @@ function createAccountSchema(config, options = {}) {
 * All monetary amounts are in integer cents.
 */
 function createBudgetSchema(config, options = {}) {
-	const { multiTenant } = config;
+	const scope = resolveLedgerTenant(config);
 	const { indexes = true, extraFields = {}, extraIndexes = [] } = options;
 	const fields = {
 		account: {
@@ -172,30 +230,12 @@ function createBudgetSchema(config, options = {}) {
 		},
 		...extraFields
 	};
-	if (multiTenant) fields[multiTenant.orgField] = {
-		type: mongoose.Schema.Types.ObjectId,
-		ref: multiTenant.orgRef,
-		required: true
-	};
 	const schema = new mongoose.Schema(fields, { timestamps: true });
 	schema.pre("validate", function() {
 		const doc = this;
 		if (doc.periodStart && doc.periodEnd && doc.periodEnd <= doc.periodStart) doc.invalidate("periodEnd", "periodEnd must be after periodStart.", doc.periodEnd, "periodEnd");
 	});
-	if (indexes) if (multiTenant) {
-		const org = multiTenant.orgField;
-		schema.index({
-			[org]: 1,
-			account: 1,
-			periodStart: 1,
-			periodEnd: 1
-		}, { unique: true });
-		schema.index({
-			[org]: 1,
-			periodStart: 1,
-			periodEnd: 1
-		});
-	} else {
+	if (indexes) {
 		schema.index({
 			account: 1,
 			periodStart: 1,
@@ -207,6 +247,7 @@ function createBudgetSchema(config, options = {}) {
 		});
 	}
 	for (const idx of extraIndexes) schema.index(idx.fields, idx.options);
+	injectTenantField(schema, scope);
 	return schema;
 }
 //#endregion
@@ -219,6 +260,7 @@ function createBudgetSchema(config, options = {}) {
 */
 function createFiscalPeriodSchema(config, options = {}) {
 	const { multiTenant } = config;
+	const scope = resolveLedgerTenant(config);
 	const { indexes = true, extraFields = {}, extraIndexes = [] } = options;
 	const fields = {
 		name: {
@@ -259,24 +301,8 @@ function createFiscalPeriodSchema(config, options = {}) {
 		},
 		...extraFields
 	};
-	if (multiTenant) fields[multiTenant.orgField] = {
-		type: mongoose.Schema.Types.ObjectId,
-		ref: multiTenant.orgRef,
-		required: true
-	};
 	const schema = new mongoose.Schema(fields, { timestamps: true });
-	if (indexes) if (multiTenant) {
-		const org = multiTenant.orgField;
-		schema.index({
-			[org]: 1,
-			startDate: 1,
-			endDate: 1
-		}, { unique: true });
-		schema.index({
-			[org]: 1,
-			closed: 1
-		});
-	} else {
+	if (indexes) {
 		schema.index({
 			startDate: 1,
 			endDate: 1
@@ -284,6 +310,7 @@ function createFiscalPeriodSchema(config, options = {}) {
 		schema.index({ closed: 1 });
 	}
 	for (const idx of extraIndexes) schema.index(idx.fields, idx.options);
+	injectTenantField(schema, scope);
 	schema.pre("validate", async function() {
 		const doc = this;
 		if (!doc.startDate || !doc.endDate) return;
@@ -292,7 +319,7 @@ function createFiscalPeriodSchema(config, options = {}) {
 			startDate: { $lt: doc.endDate },
 			endDate: { $gt: doc.startDate }
 		};
-		if (multiTenant) overlapQuery[multiTenant.orgField] = doc[multiTenant.orgField];
+		if (multiTenant) overlapQuery[multiTenant.tenantField] = doc[multiTenant.tenantField];
 		const overlap = await doc.collection.findOne(overlapQuery);
 		if (overlap) {
 			const msg = `Fiscal period overlaps with existing period "${overlap.name}" (${new Date(overlap.startDate).toISOString().split("T")[0]} – ${new Date(overlap.endDate).toISOString().split("T")[0]}).`;
@@ -324,23 +351,33 @@ function createFiscalPeriodSchema(config, options = {}) {
 * `engine.repositories.journals.seedDefaults(orgId)`.
 */
 function createJournalSchema(config, accountModelName, options = {}) {
-	const { multiTenant } = config;
+	const scope = resolveLedgerTenant(config);
 	const { indexes = true, extraFields = {}, extraIndexes = [] } = options;
 	const fields = {
+		/** Short stable identifier — e.g. `'SALES'`, `'BANK'`. */
 		code: {
 			type: String,
 			required: true,
 			trim: true
 		},
+		/** Display name. */
 		name: {
 			type: String,
 			required: true,
 			trim: true
 		},
+		/**
+		* One of the registered `JOURNAL_TYPES` codes. Connects this journal
+		* to the engine's posting contracts and reference-number generator.
+		*/
 		journalType: {
 			type: String,
 			required: true
 		},
+		/**
+		* Logical source — drives future lock-date buckets (sale-lock-date,
+		* purchase-lock-date) and bank-statement import wiring.
+		*/
 		kind: {
 			type: String,
 			enum: [
@@ -354,15 +391,18 @@ function createJournalSchema(config, accountModelName, options = {}) {
 			default: "general",
 			required: true
 		},
+		/** Reference-number prefix — defaults to `code` when omitted. */
 		sequencePrefix: {
 			type: String,
 			default: null
 		},
+		/** Next sequence number (monotonic within this journal). */
 		sequenceNextNum: {
 			type: Number,
 			default: 1,
 			min: 1
 		},
+		/** Optional default debit/credit account for quick data entry. */
 		defaultDebitAccount: {
 			type: mongoose.Schema.Types.ObjectId,
 			ref: accountModelName,
@@ -373,10 +413,15 @@ function createJournalSchema(config, accountModelName, options = {}) {
 			ref: accountModelName,
 			default: null
 		},
+		/** Free-form payment-method identifiers allowed on entries in this journal. */
 		allowedPaymentMethods: {
 			type: [String],
 			default: []
 		},
+		/**
+		* Opaque source id — `'manual'`, `'stripe'`, bank connector id, etc.
+		* Used by bank-statement and external-integration plugins.
+		*/
 		source: {
 			type: String,
 			default: "manual"
@@ -387,33 +432,16 @@ function createJournalSchema(config, accountModelName, options = {}) {
 		},
 		...extraFields
 	};
-	if (multiTenant) fields[multiTenant.orgField] = {
-		type: mongoose.Schema.Types.ObjectId,
-		ref: multiTenant.orgRef,
-		required: true
-	};
 	const schema = new mongoose.Schema(fields, { timestamps: true });
 	if (indexes) {
-		const org = multiTenant?.orgField;
-		if (org) {
-			schema.index({
-				[org]: 1,
-				code: 1
-			}, { unique: true });
-			schema.index({
-				[org]: 1,
-				kind: 1,
-				active: 1
-			});
-		} else {
-			schema.index({ code: 1 }, { unique: true });
-			schema.index({
-				kind: 1,
-				active: 1
-			});
-		}
+		schema.index({ code: 1 }, { unique: true });
+		schema.index({
+			kind: 1,
+			active: 1
+		});
 	}
 	for (const idx of extraIndexes) schema.index(idx.fields, idx.options);
+	injectTenantField(schema, scope);
 	return schema;
 }
 //#endregion
@@ -431,6 +459,7 @@ function createJournalSchema(config, accountModelName, options = {}) {
 */
 function createJournalEntrySchema(config, accountModelName, options = {}) {
 	const { multiTenant } = config;
+	const scope = resolveLedgerTenant(config);
 	const { indexes = true, autoReference = true, textSearch = true, extraFields = {}, extraIndexes = [], extraItemFields = {} } = options;
 	const TaxDetailSchema = new mongoose.Schema({
 		taxCode: { type: String },
@@ -603,11 +632,6 @@ function createJournalEntrySchema(config, accountModelName, options = {}) {
 		type: String,
 		default: null
 	};
-	if (multiTenant) fields[multiTenant.orgField] = {
-		type: mongoose.Schema.Types.ObjectId,
-		ref: multiTenant.orgRef,
-		required: true
-	};
 	const schema = new mongoose.Schema(fields, {
 		timestamps: true,
 		optimisticConcurrency: true
@@ -640,7 +664,7 @@ function createJournalEntrySchema(config, accountModelName, options = {}) {
 			const month = String(date.getMonth() + 1).padStart(2, "0");
 			let orgScope = "global";
 			if (multiTenant) {
-				const raw = this.get(multiTenant.orgField);
+				const raw = this.get(multiTenant.tenantField);
 				if (raw != null) orgScope = typeof raw.toHexString === "function" ? raw.toHexString() : String(raw);
 				else orgScope = "unscoped";
 			}
@@ -649,72 +673,38 @@ function createJournalEntrySchema(config, accountModelName, options = {}) {
 		}
 	});
 	if (indexes) {
-		const org = multiTenant?.orgField;
-		const refPartial = { partialFilterExpression: { referenceNumber: {
-			$exists: true,
-			$type: "string"
-		} } };
-		if (org) {
-			schema.index({
-				[org]: 1,
-				referenceNumber: 1
-			}, {
-				unique: true,
-				...refPartial
-			});
-			schema.index({
-				[org]: 1,
-				state: 1,
-				date: 1
-			});
-			schema.index({
-				[org]: 1,
-				date: -1
-			});
-			schema.index({
-				[org]: 1,
-				journalType: 1
-			});
-			schema.index({
-				"journalItems.account": 1,
-				state: 1
-			});
-			schema.index({
-				[org]: 1,
-				"journalItems.account": 1,
-				date: 1,
-				state: 1
-			});
-		} else {
-			schema.index({ referenceNumber: 1 }, {
-				unique: true,
-				...refPartial
-			});
-			schema.index({
-				state: 1,
-				date: 1
-			});
-			schema.index({ date: -1 });
-			schema.index({ journalType: 1 });
-			schema.index({
-				"journalItems.account": 1,
-				state: 1
-			});
-		}
-		schema.index({ reversed: 1 });
-		if (org) schema.index({
-			[org]: 1,
-			"journalItems.matchingNumber": 1
+		schema.index({ referenceNumber: 1 }, {
+			unique: true,
+			partialFilterExpression: { referenceNumber: {
+				$exists: true,
+				$type: "string"
+			} }
 		});
-		else schema.index({ "journalItems.matchingNumber": 1 });
+		schema.index({
+			state: 1,
+			date: 1
+		});
+		schema.index({ date: -1 });
+		schema.index({ journalType: 1 });
+		if (scope.enabled) schema.index({
+			"journalItems.account": 1,
+			date: 1,
+			state: 1
+		});
+		schema.index({ "journalItems.matchingNumber": 1 });
+		if (config.idempotency) schema.index({ idempotencyKey: 1 }, {
+			unique: true,
+			partialFilterExpression: { idempotencyKey: { $type: "string" } }
+		});
+	}
+	injectTenantField(schema, scope);
+	if (indexes) {
+		schema.index({
+			"journalItems.account": 1,
+			state: 1
+		});
+		schema.index({ reversed: 1 });
 		if (config.idempotency) {
-			const idempotencyIdx = {};
-			if (org) idempotencyIdx[org] = 1;
-			idempotencyIdx.idempotencyKey = 1;
-			schema.index(idempotencyIdx, {
-				unique: true,
-				partialFilterExpression: { idempotencyKey: { $type: "string" } }
-			});
 			const ttlSeconds = typeof config.idempotencyTtlSeconds === "number" && config.idempotencyTtlSeconds > 0 ? config.idempotencyTtlSeconds : 86400;
 			schema.index({ createdAt: 1 }, {
 				name: "idempotency_ttl_idx",
@@ -758,7 +748,7 @@ function createJournalEntrySchema(config, accountModelName, options = {}) {
 * `updatedAt` timestamps.
 */
 function createReconciliationSchema(config, accountModelName, journalEntryModelName, options = {}) {
-	const { multiTenant } = config;
+	const scope = resolveLedgerTenant(config);
 	const { indexes = true, extraFields = {}, extraIndexes = [] } = options;
 	const MatchedItemRefSchema = new mongoose.Schema({
 		entry: {
@@ -775,16 +765,19 @@ function createReconciliationSchema(config, accountModelName, journalEntryModelN
 				message: "itemIndex must be a non-negative integer"
 			}
 		},
+		/** Snapshot of the debit side of the item in cents, for audit. */
 		debit: {
 			type: Number,
 			default: 0,
 			min: 0
 		},
+		/** Snapshot of the credit side of the item in cents, for audit. */
 		credit: {
 			type: Number,
 			default: 0,
 			min: 0
 		},
+		/** Optional snapshot of the item's foreign amount for FX realization. */
 		amountCurrency: {
 			type: Number,
 			default: null
@@ -795,6 +788,10 @@ function createReconciliationSchema(config, accountModelName, journalEntryModelN
 		}
 	}, { _id: false });
 	const fields = {
+		/**
+		* Stable identifier shared by every matched item, also stamped onto
+		* `journalItems[i].matchingNumber` for cheap open-item lookups.
+		*/
 		matchingNumber: {
 			type: String,
 			required: true
@@ -822,6 +819,7 @@ function createReconciliationSchema(config, accountModelName, journalEntryModelN
 			required: true,
 			min: 0
 		},
+		/** `debitTotal - creditTotal` in cents — zero ⇒ full reconcile. */
 		difference: {
 			type: Number,
 			default: 0
@@ -830,6 +828,11 @@ function createReconciliationSchema(config, accountModelName, journalEntryModelN
 			type: Boolean,
 			default: false
 		},
+		/**
+		* Optional currency stamp — when all matched items share a single
+		* foreign currency, this records it so the FX realization plugin can
+		* compute realized gain/loss against the base currency rates.
+		*/
 		currency: {
 			type: String,
 			default: null
@@ -840,6 +843,7 @@ function createReconciliationSchema(config, accountModelName, journalEntryModelN
 			type: Date,
 			default: Date.now
 		},
+		/** Audit ref to the FX realization entry when the plugin fires. */
 		fxRealizationEntry: {
 			type: mongoose.Schema.Types.ObjectId,
 			ref: journalEntryModelName,
@@ -847,40 +851,18 @@ function createReconciliationSchema(config, accountModelName, journalEntryModelN
 		},
 		...extraFields
 	};
-	if (multiTenant) fields[multiTenant.orgField] = {
-		type: mongoose.Schema.Types.ObjectId,
-		ref: multiTenant.orgRef,
-		required: true
-	};
 	const schema = new mongoose.Schema(fields, { timestamps: true });
 	if (indexes) {
-		const org = multiTenant?.orgField;
-		if (org) {
-			schema.index({
-				[org]: 1,
-				matchingNumber: 1
-			}, { unique: true });
-			schema.index({
-				[org]: 1,
-				account: 1,
-				isFullReconcile: 1,
-				reconciledAt: 1
-			});
-			schema.index({
-				[org]: 1,
-				"items.entry": 1
-			});
-		} else {
-			schema.index({ matchingNumber: 1 }, { unique: true });
-			schema.index({
-				account: 1,
-				isFullReconcile: 1,
-				reconciledAt: 1
-			});
-			schema.index({ "items.entry": 1 });
-		}
+		schema.index({ matchingNumber: 1 }, { unique: true });
+		schema.index({
+			account: 1,
+			isFullReconcile: 1,
+			reconciledAt: 1
+		});
+		schema.index({ "items.entry": 1 });
 	}
 	for (const idx of extraIndexes) schema.index(idx.fields, idx.options);
+	injectTenantField(schema, scope);
 	return schema;
 }
 //#endregion
@@ -1304,7 +1286,7 @@ function wireJournalEntryMethods(repository, _JournalEntryModel, orgField, stric
 	const getByQuery = repository.getByQuery.bind(repository);
 	const baseCreate = repository.create.bind(repository);
 	const update = repository.update.bind(repository);
-	const withTransaction = repository.withTransaction.bind(repository);
+	const withTransaction$1 = (fn, opts) => withTransaction(repository.Model.db, fn, opts);
 	const raceSafeCreate = async (data, options) => {
 		const input = data;
 		const idempotencyKey = typeof input.idempotencyKey === "string" && input.idempotencyKey.length > 0 ? input.idempotencyKey : void 0;
@@ -1672,7 +1654,7 @@ function wireJournalEntryMethods(repository, _JournalEntryModel, orgField, stric
 			};
 		};
 		if (options.session) return await doReverse(options.session);
-		if (withTransaction) return await withTransaction((session) => doReverse(session), { allowFallback: true });
+		if (withTransaction$1) return await withTransaction$1((session) => doReverse(session), { allowFallback: true });
 		return await doReverse();
 	};
 	const methodNames = [
@@ -1967,7 +1949,7 @@ function wireReconciliationMethods(repository, ReconciliationModel, JournalEntry
 * Build all ledger repositories with plugins + domain methods pre-wired.
 */
 function createRepositories(models, config, plugins = {}, pagination = {}, integrations = {}) {
-	const orgField = config.multiTenant?.orgField;
+	const orgField = config.multiTenant?.tenantField;
 	const strictness = config.strictness;
 	const country = config.country;
 	const { events, bridges, outboxStore } = integrations;
@@ -2301,7 +2283,7 @@ const REPORT_CATALOG = Object.freeze([
 function buildIntrospectAPI({ models, country, config }) {
 	const AccountModel = models.Account;
 	const FiscalPeriodModel = models.FiscalPeriod;
-	const orgField = config.multiTenant?.orgField;
+	const orgField = config.multiTenant?.tenantField;
 	const normalBalanceFor = (category) => {
 		if (category.endsWith("Asset") || category.endsWith("Expense")) return "debit";
 		return "credit";
@@ -2363,7 +2345,7 @@ function buildIntrospectAPI({ models, country, config }) {
 //#region src/semantic/record.ts
 function buildRecordAPI({ models, repositories, config }) {
 	const AccountModel = models.Account;
-	const orgField = config.multiTenant?.orgField;
+	const orgField = config.multiTenant?.tenantField;
 	const resolveAccounts = async (organizationId, codes, path, session) => {
 		const unique = Array.from(new Set(codes));
 		const filter = { accountTypeCode: { $in: unique } };
@@ -2591,7 +2573,7 @@ function buildRecordAPI({ models, repositories, config }) {
 *   mongoose: mongoose.connection,
 *   country: canadaPack,
 *   currency: 'CAD',
-*   multiTenant: { orgField: 'organizationId', orgRef: 'Organization' },
+*   multiTenant: { tenantField: 'organizationId', ref: 'Organization' },
 * });
 *
 * // Models — auto-created Mongoose models
@@ -2669,6 +2651,21 @@ var AccountingEngine = class {
 		});
 	}
 	/**
+	* Explicitly sync indexes on all managed models.
+	* Call this in deploy-time scripts — NOT on every boot.
+	* See PACKAGE_RULES section 32.
+	*/
+	async syncIndexes() {
+		await Promise.all([
+			this.models.Account.syncIndexes(),
+			this.models.JournalEntry.syncIndexes(),
+			this.models.FiscalPeriod.syncIndexes(),
+			this.models.Budget.syncIndexes(),
+			this.models.Reconciliation.syncIndexes(),
+			this.models.Journal.syncIndexes()
+		]);
+	}
+	/**
 	* Pre-built reports bound to the engine's owned models.
 	* Lazy-initialized on first access.
 	*/
@@ -2747,7 +2744,7 @@ var AccountingEngine = class {
 		const JournalEntryModel = this.models.JournalEntry;
 		const BudgetModel = this.models.Budget;
 		const { country, config } = this;
-		const orgField = config.multiTenant?.orgField;
+		const orgField = config.multiTenant?.tenantField;
 		const fiscalYearStartMonth = config.fiscalYearStartMonth ?? 1;
 		const retainedEarningsAccountCode = config.retainedEarningsAccountCode;
 		const retainedEarningsDisplayCode = config.retainedEarningsDisplayCode;
@@ -2881,4 +2878,4 @@ function buildDimensionIndexes(dimensions, orgField) {
 	});
 }
 //#endregion
-export { AccountingEngine, AccountingError, CATEGORIES, CATEGORY_KEYS, CURRENCIES, ConcurrencyError, DEFAULT_BUCKETS, DuplicateReferenceError, Errors, IdempotencyConflictError, ImmutableViolationError, InProcessLedgerBus, JOURNAL_CODES, JOURNAL_TYPES, LEDGER_EVENTS, Money, OutboxOwnershipError, 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, AccountSeeded, AccountingEngine, AccountingError, CATEGORIES, CATEGORY_KEYS, CURRENCIES, ConcurrencyError, DEFAULT_BUCKETS, DuplicateReferenceError, EntryArchived, EntryCreated, EntryDuplicated, EntryPosted, EntryReversed, EntryUnposted, Errors, IdempotencyConflictError, ImmutableViolationError, InProcessLedgerBus, InvalidOutboxEventError, JOURNAL_CODES, JOURNAL_TYPES, JournalSeeded, LEDGER_EVENTS, Money, OutboxOwnershipError, ReconciliationMatched, ReconciliationUnmatched, 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 };