@classytic/ledger 0.1.3

package/dist/fiscal-period.schema-CbALaaKl.mjs

@@ -0,0 +1,477 @@
+import { i as getJournalTypeCodes, t as JOURNAL_CODES } from "./journals-CI3Wb4EF.mjs";
+import mongoose from "mongoose";
+
+//#region src/schemas/account.schema.ts
+/**
+* Account Schema Factory
+*
+* Creates a Mongoose schema for Chart of Accounts that is:
+* - Multi-tenant aware (adds org field + compound indexes when configured)
+* - Validates accountTypeCode against the country pack
+* - Supports accountNumber (unique per org) and name (user-facing display)
+* - Lean: no cached balances — always computed from journal entries
+*/
+function createAccountSchema(config, options = {}) {
+	const { multiTenant, country } = config;
+	const { indexes = true, extraFields = {}, extraIndexes = [] } = options;
+	const fields = {
+		accountTypeCode: {
+			type: String,
+			required: true,
+			validate: {
+				validator: (code) => country.isValidAccountType(code),
+				message: (props) => `"${props.value}" is not a valid account type code for ${country.name}.`
+			}
+		},
+		accountNumber: {
+			type: String,
+			required: true,
+			trim: true
+		},
+		name: {
+			type: String,
+			required: true,
+			trim: true
+		},
+		active: {
+			type: Boolean,
+			default: true
+		},
+		isCashAccount: {
+			type: Boolean,
+			default: false
+		},
+		...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.accountNumber && doc.accountTypeCode) doc.accountNumber = doc.accountTypeCode;
+		if (!doc.name && doc.accountTypeCode) doc.name = country.getAccountType(doc.accountTypeCode)?.name ?? doc.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 {
+		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);
+	return schema;
+}
+
+//#endregion
+//#region src/schemas/journal-entry.schema.ts
+/**
+* Journal Entry Schema Factory
+*
+* Creates a Mongoose schema for double-entry journal entries.
+* - Multi-tenant aware
+* - Embedded journal items with account refs
+* - State machine: draft → posted, draft → archived
+* - Auto-generated reference numbers
+* - Double-entry validation on post
+* - Optimized indexes for high-load reporting
+*/
+function createJournalEntrySchema(config, accountModelName, options = {}) {
+	const { multiTenant } = config;
+	const { indexes = true, autoReference = true, textSearch = true, extraFields = {}, extraIndexes = [], extraItemFields = {} } = options;
+	const TaxDetailSchema = new mongoose.Schema({
+		taxCode: { type: String },
+		taxName: { type: String }
+	}, { _id: false });
+	const amountValidator = {
+		validator: (v) => Number.isInteger(v) && v >= 0,
+		message: "{PATH} must be a non-negative integer (cents), got {VALUE}"
+	};
+	const JournalItemSchema = new mongoose.Schema({
+		account: {
+			type: mongoose.Schema.Types.ObjectId,
+			ref: accountModelName,
+			required: true
+		},
+		label: { type: String },
+		date: { type: Date },
+		debit: {
+			type: Number,
+			default: 0,
+			min: 0,
+			validate: amountValidator
+		},
+		credit: {
+			type: Number,
+			default: 0,
+			min: 0,
+			validate: amountValidator
+		},
+		taxDetails: {
+			type: [TaxDetailSchema],
+			default: []
+		},
+		...extraItemFields
+	}, { _id: false });
+	const fields = {
+		journalType: {
+			type: String,
+			enum: getJournalTypeCodes(),
+			default: JOURNAL_CODES["MISC"],
+			required: true
+		},
+		referenceNumber: { type: String },
+		label: { type: String },
+		date: {
+			type: Date,
+			default: Date.now,
+			required: function() {
+				return this.state !== "draft";
+			}
+		},
+		journalItems: {
+			type: [JournalItemSchema],
+			default: []
+		},
+		totalDebit: {
+			type: Number,
+			required: true,
+			min: 0,
+			validate: {
+				validator: Number.isInteger,
+				message: "totalDebit must be an integer (cents)"
+			}
+		},
+		totalCredit: {
+			type: Number,
+			required: true,
+			min: 0,
+			validate: {
+				validator: Number.isInteger,
+				message: "totalCredit must be an integer (cents)"
+			}
+		},
+		state: {
+			type: String,
+			enum: [
+				"draft",
+				"posted",
+				"archived"
+			],
+			default: "draft",
+			required: true
+		},
+		stateChangedAt: {
+			type: Date,
+			default: Date.now
+		},
+		reversed: {
+			type: Boolean,
+			default: false
+		},
+		reversedBy: {
+			type: mongoose.Schema.Types.ObjectId,
+			ref: "JournalEntry",
+			default: null
+		},
+		reversalOf: {
+			type: mongoose.Schema.Types.ObjectId,
+			ref: "JournalEntry",
+			default: null
+		},
+		...extraFields
+	};
+	if (config.audit?.trackActor) {
+		fields.createdBy = {
+			type: mongoose.Schema.Types.ObjectId,
+			default: null
+		};
+		fields.postedBy = {
+			type: mongoose.Schema.Types.ObjectId,
+			default: null
+		};
+		fields.reversedByUser = {
+			type: mongoose.Schema.Types.ObjectId,
+			default: null
+		};
+	}
+	if (config.strictness?.requireApproval || config.audit?.trackActor) {
+		fields.approvedBy = {
+			type: mongoose.Schema.Types.ObjectId,
+			default: null
+		};
+		fields.approvedAt = {
+			type: Date,
+			default: null
+		};
+	}
+	if (config.idempotency) fields.idempotencyKey = {
+		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 });
+	schema.pre("validate", function() {
+		const doc = this;
+		for (const item of doc.journalItems) if (!item.date) item.date = doc.date;
+		for (let i = 0; i < doc.journalItems.length; i++) {
+			const d = doc.journalItems[i].debit || 0;
+			const c = doc.journalItems[i].credit || 0;
+			if (d > 0 && c > 0) throw new Error(`Journal item at index ${i}: cannot have both debit (${d}) and credit (${c}) greater than zero`);
+			if (doc.state === "posted" && d === 0 && c === 0) throw new Error(`Journal item at index ${i}: posted entries cannot have zero-value lines (both debit and credit are 0)`);
+		}
+		const totalDebit = doc.journalItems.reduce((s, i) => s + (i.debit || 0), 0);
+		const totalCredit = doc.journalItems.reduce((s, i) => s + (i.credit || 0), 0);
+		if (doc.state === "posted") {
+			if (doc.journalItems.length < 2) throw new Error("Posted entries must have at least 2 journal items");
+			if (totalDebit !== totalCredit) throw new Error("Total debit must equal total credit for posted entries");
+		}
+		doc.totalDebit = totalDebit;
+		doc.totalCredit = totalCredit;
+	});
+	if (autoReference) {
+		const generateReferenceNumber = async (doc, Model, session) => {
+			const jt = doc.journalType || "MISC";
+			const d = new Date(doc.date);
+			const prefix = `${jt}/${d.getFullYear()}/${String(d.getMonth() + 1).padStart(2, "0")}/`;
+			const matchFilter = { referenceNumber: { $regex: `^${prefix.replace(/\//g, "\\/")}` } };
+			if (multiTenant) matchFilter[multiTenant.orgField] = doc[multiTenant.orgField];
+			const pipeline = [
+				{ $match: matchFilter },
+				{ $addFields: { _refSeq: { $toInt: { $arrayElemAt: [{ $split: ["$referenceNumber", "/"] }, -1] } } } },
+				{ $sort: { _refSeq: -1 } },
+				{ $limit: 1 },
+				{ $project: { _refSeq: 1 } }
+			];
+			const results = await Model.aggregate(pipeline).session(session);
+			let seq = 1;
+			if (results.length > 0 && typeof results[0]._refSeq === "number") seq = results[0]._refSeq + 1;
+			return `${prefix}${String(seq).padStart(4, "0")}`;
+		};
+		schema.pre("save", async function() {
+			const doc = this;
+			if (doc.isModified("journalType")) doc.referenceNumber = void 0;
+			if (!doc.referenceNumber) {
+				const session = doc.$session?.() ?? null;
+				const Model = doc.constructor;
+				doc.referenceNumber = await generateReferenceNumber(doc, Model, session);
+			}
+		});
+		const MAX_REF_RETRIES = 3;
+		schema.post("save", async function(error, doc, next) {
+			const mongoError = error;
+			if (mongoError.code === 11e3 && mongoError.keyPattern?.referenceNumber) {
+				const entry = doc;
+				const retryCount = entry.__refRetries ?? 0;
+				if (retryCount >= MAX_REF_RETRIES) {
+					next(/* @__PURE__ */ new Error(`Failed to generate unique reference number after ${MAX_REF_RETRIES} retries. Too many concurrent inserts for this period.`));
+					return;
+				}
+				entry.__refRetries = retryCount + 1;
+				const session = entry.$session?.() ?? null;
+				const Model = entry.constructor;
+				entry.referenceNumber = await generateReferenceNumber(entry, Model, session);
+				try {
+					await entry.save({ session });
+					next();
+				} catch (retryError) {
+					next(retryError);
+				}
+			} else next(error);
+		});
+	}
+	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 (config.idempotency) {
+			const idempotencyIdx = {};
+			if (org) idempotencyIdx[org] = 1;
+			idempotencyIdx.idempotencyKey = 1;
+			schema.index(idempotencyIdx, {
+				unique: true,
+				partialFilterExpression: { idempotencyKey: {
+					$exists: true,
+					$ne: null
+				} }
+			});
+		}
+	}
+	if (textSearch) schema.index({
+		referenceNumber: "text",
+		label: "text"
+	}, {
+		weights: {
+			referenceNumber: 10,
+			label: 5
+		},
+		name: "journal_text_idx"
+	});
+	for (const idx of extraIndexes) schema.index(idx.fields, idx.options);
+	return schema;
+}
+
+//#endregion
+//#region src/schemas/fiscal-period.schema.ts
+/**
+* Fiscal Period Schema Factory
+*
+* Creates a Mongoose schema for tracking fiscal periods (months, quarters, years).
+* Supports closing periods to lock entries.
+*/
+function createFiscalPeriodSchema(config, options = {}) {
+	const { multiTenant } = config;
+	const { indexes = true, extraFields = {}, extraIndexes = [] } = options;
+	const fields = {
+		name: {
+			type: String,
+			required: true
+		},
+		startDate: {
+			type: Date,
+			required: true
+		},
+		endDate: {
+			type: Date,
+			required: true
+		},
+		closed: {
+			type: Boolean,
+			default: false
+		},
+		closedAt: {
+			type: Date,
+			default: null
+		},
+		closedBy: {
+			type: String,
+			default: null
+		},
+		closingEntryId: {
+			type: mongoose.Schema.Types.ObjectId,
+			default: null
+		},
+		reopenedAt: {
+			type: Date,
+			default: null
+		},
+		reopenedBy: {
+			type: String,
+			default: null
+		},
+		...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 {
+		schema.index({
+			startDate: 1,
+			endDate: 1
+		}, { unique: true });
+		schema.index({ closed: 1 });
+	}
+	for (const idx of extraIndexes) schema.index(idx.fields, idx.options);
+	schema.pre("validate", async function() {
+		const doc = this;
+		if (!doc.startDate || !doc.endDate) return;
+		const overlapQuery = {
+			_id: { $ne: doc._id },
+			startDate: { $lt: doc.endDate },
+			endDate: { $gt: doc.startDate }
+		};
+		if (multiTenant) overlapQuery[multiTenant.orgField] = doc[multiTenant.orgField];
+		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]}).`;
+			doc.invalidate("startDate", msg, doc.startDate, "overlap");
+		}
+	});
+	return schema;
+}
+
+//#endregion
+export { createJournalEntrySchema as n, createAccountSchema as r, createFiscalPeriodSchema as t };
+//# sourceMappingURL=fiscal-period.schema-CbALaaKl.mjs.map

package/dist/fiscal-period.schema-CbALaaKl.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fiscal-period.schema-CbALaaKl.mjs","names":[],"sources":["../src/schemas/account.schema.ts","../src/schemas/journal-entry.schema.ts","../src/schemas/fiscal-period.schema.ts"],"sourcesContent":["/**\r\n * Account Schema Factory\r\n *\r\n * Creates a Mongoose schema for Chart of Accounts that is:\r\n * - Multi-tenant aware (adds org field + compound indexes when configured)\r\n * - Validates accountTypeCode against the country pack\r\n * - Supports accountNumber (unique per org) and name (user-facing display)\r\n * - Lean: no cached balances — always computed from journal entries\r\n */\r\n\r\nimport mongoose from 'mongoose';\r\nimport type { AccountingEngineConfig, SchemaOptions } from '../types/engine.js';\r\n\r\nexport function createAccountSchema(\r\n  config: AccountingEngineConfig,\r\n  options: SchemaOptions = {},\r\n) {\r\n  const { multiTenant, country } = config;\r\n  const { indexes = true, extraFields = {}, extraIndexes = [] } = options;\r\n\r\n  // ── Base fields ──────────────────────────────────────────────────────────\r\n\r\n  const fields: Record<string, unknown> = {\r\n    accountTypeCode: {\r\n      type: String,\r\n      required: true,\r\n      validate: {\r\n        validator: (code: string) => country.isValidAccountType(code),\r\n        message: (props: { value: string }) =>\r\n          `\"${props.value}\" is not a valid account type code for ${country.name}.`,\r\n      },\r\n    },\r\n    accountNumber: {\r\n      type: String,\r\n      required: true,\r\n      trim: true,\r\n    },\r\n    name: {\r\n      type: String,\r\n      required: true,\r\n      trim: true,\r\n    },\r\n    active: { type: Boolean, default: true },\r\n    isCashAccount: { type: Boolean, default: false },\r\n    ...extraFields,\r\n  };\r\n\r\n  // ── Multi-tenant field ───────────────────────────────────────────────────\r\n\r\n  if (multiTenant) {\r\n    fields[multiTenant.orgField] = {\r\n      type: mongoose.Schema.Types.ObjectId,\r\n      ref: multiTenant.orgRef,\r\n      required: true,\r\n    };\r\n  }\r\n\r\n  // ── Schema ───────────────────────────────────────────────────────────────\r\n\r\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n  const schema = new mongoose.Schema(fields as any, { timestamps: true });\r\n\r\n  // ── Pre-validate: auto-default accountNumber and name ──────────────────\r\n\r\n  schema.pre('validate', function () {\r\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n    const doc = this as any;\r\n    if (!doc.accountNumber && doc.accountTypeCode) {\r\n      doc.accountNumber = doc.accountTypeCode;\r\n    }\r\n    if (!doc.name && doc.accountTypeCode) {\r\n      const at = country.getAccountType(doc.accountTypeCode);\r\n      doc.name = at?.name ?? doc.accountTypeCode;\r\n    }\r\n  });\r\n\r\n  // ── Indexes ──────────────────────────────────────────────────────────────\r\n\r\n  if (indexes) {\r\n    if (multiTenant) {\r\n      const org = multiTenant.orgField;\r\n      schema.index({ [org]: 1, active: 1 });\r\n      // accountNumber is the unique identity per org\r\n      schema.index({ [org]: 1, accountNumber: 1 }, { unique: true });\r\n      // accountTypeCode is non-unique — multiple accounts can share a classification\r\n      schema.index({ [org]: 1, accountTypeCode: 1 });\r\n    } else {\r\n      schema.index({ active: 1 });\r\n      schema.index({ accountNumber: 1 }, { unique: true });\r\n      schema.index({ accountTypeCode: 1 });\r\n    }\r\n  }\r\n\r\n  for (const idx of extraIndexes) {\r\n    schema.index(idx.fields, idx.options);\r\n  }\r\n\r\n  return schema;\r\n}\r\n","/**\r\n * Journal Entry Schema Factory\r\n *\r\n * Creates a Mongoose schema for double-entry journal entries.\r\n * - Multi-tenant aware\r\n * - Embedded journal items with account refs\r\n * - State machine: draft → posted, draft → archived\r\n * - Auto-generated reference numbers\r\n * - Double-entry validation on post\r\n * - Optimized indexes for high-load reporting\r\n */\r\n\r\nimport mongoose from 'mongoose';\r\nimport type { AccountingEngineConfig, JournalSchemaOptions } from '../types/engine.js';\r\nimport { getJournalTypeCodes, JOURNAL_CODES } from '../constants/journals.js';\r\n\r\nexport function createJournalEntrySchema(\r\n  config: AccountingEngineConfig,\r\n  accountModelName: string,\r\n  options: JournalSchemaOptions = {},\r\n) {\r\n  const { multiTenant } = config;\r\n  const {\r\n    indexes = true,\r\n    autoReference = true,\r\n    textSearch = true,\r\n    extraFields = {},\r\n    extraIndexes = [],\r\n    extraItemFields = {},\r\n  } = options;\r\n\r\n  // ── Tax Detail (audit reference only) ────────────────────────────────────\r\n\r\n  const TaxDetailSchema = new mongoose.Schema(\r\n    {\r\n      taxCode: { type: String },\r\n      taxName: { type: String },\r\n    },\r\n    { _id: false },\r\n  );\r\n\r\n  // ── Journal Item ─────────────────────────────────────────────────────────\r\n\r\n  const amountValidator = {\r\n    validator: (v: number) => Number.isInteger(v) && v >= 0,\r\n    message: '{PATH} must be a non-negative integer (cents), got {VALUE}',\r\n  };\r\n\r\n  const JournalItemSchema = new mongoose.Schema(\r\n    {\r\n      account: {\r\n        type: mongoose.Schema.Types.ObjectId,\r\n        ref: accountModelName,\r\n        required: true,\r\n      },\r\n      label: { type: String },\r\n      date: { type: Date },\r\n      debit: { type: Number, default: 0, min: 0, validate: amountValidator },\r\n      credit: { type: Number, default: 0, min: 0, validate: amountValidator },\r\n      taxDetails: { type: [TaxDetailSchema], default: [] },\r\n      ...extraItemFields,\r\n    },\r\n    { _id: false },\r\n  );\r\n\r\n  // ── Main fields ──────────────────────────────────────────────────────────\r\n\r\n  const fields: Record<string, unknown> = {\r\n    journalType: {\r\n      type: String,\r\n      enum: getJournalTypeCodes(),\r\n      default: JOURNAL_CODES['MISC'],\r\n      required: true,\r\n    },\r\n    referenceNumber: { type: String },\r\n    label: { type: String },\r\n    date: {\r\n      type: Date,\r\n      default: Date.now,\r\n      required: function (this: { state?: string }) {\r\n        return this.state !== 'draft';\r\n      },\r\n    },\r\n    journalItems: { type: [JournalItemSchema], default: [] },\r\n    totalDebit: { type: Number, required: true, min: 0, validate: { validator: Number.isInteger, message: 'totalDebit must be an integer (cents)' } },\r\n    totalCredit: { type: Number, required: true, min: 0, validate: { validator: Number.isInteger, message: 'totalCredit must be an integer (cents)' } },\r\n    state: {\r\n      type: String,\r\n      enum: ['draft', 'posted', 'archived'],\r\n      default: 'draft',\r\n      required: true,\r\n    },\r\n    stateChangedAt: { type: Date, default: Date.now },\r\n    reversed: { type: Boolean, default: false },\r\n    reversedBy: {\r\n      type: mongoose.Schema.Types.ObjectId,\r\n      ref: 'JournalEntry',\r\n      default: null,\r\n    },\r\n    reversalOf: {\r\n      type: mongoose.Schema.Types.ObjectId,\r\n      ref: 'JournalEntry',\r\n      default: null,\r\n    },\r\n    ...extraFields,\r\n  };\r\n\r\n  // ── Audit fields (conditional) ─────────────────────────────────────────\r\n\r\n  if (config.audit?.trackActor) {\r\n    fields.createdBy = { type: mongoose.Schema.Types.ObjectId, default: null };\r\n    fields.postedBy = { type: mongoose.Schema.Types.ObjectId, default: null };\r\n    fields.reversedByUser = { type: mongoose.Schema.Types.ObjectId, default: null };\r\n  }\r\n\r\n  // ── Approval fields (conditional) ──────────────────────────────────────\r\n\r\n  if (config.strictness?.requireApproval || config.audit?.trackActor) {\r\n    fields.approvedBy = { type: mongoose.Schema.Types.ObjectId, default: null };\r\n    fields.approvedAt = { type: Date, default: null };\r\n  }\r\n\r\n  // ── Idempotency key (conditional) ──────────────────────────────────────\r\n\r\n  if (config.idempotency) {\r\n    fields.idempotencyKey = { type: String, default: null };\r\n  }\r\n\r\n  // ── Multi-tenant field ───────────────────────────────────────────────────\r\n\r\n  if (multiTenant) {\r\n    fields[multiTenant.orgField] = {\r\n      type: mongoose.Schema.Types.ObjectId,\r\n      ref: multiTenant.orgRef,\r\n      required: true,\r\n    };\r\n  }\r\n\r\n  // ── Schema ───────────────────────────────────────────────────────────────\r\n\r\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n  const schema = new mongoose.Schema(fields as any, { timestamps: true });\r\n\r\n  // ── Pre-validate: double-entry enforcement ───────────────────────────────\r\n\r\n  schema.pre('validate', function () {\r\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n    const doc = this as any;\r\n\r\n    // Propagate entry date to items without a date\r\n    for (const item of doc.journalItems) {\r\n      if (!item.date) item.date = doc.date;\r\n    }\r\n\r\n    // Each line must be debit OR credit (not both), and posted entries cannot have zero-value lines\r\n    for (let i = 0; i < doc.journalItems.length; i++) {\r\n      const d = doc.journalItems[i].debit || 0;\r\n      const c = doc.journalItems[i].credit || 0;\r\n      if (d > 0 && c > 0) {\r\n        throw new Error(\r\n          `Journal item at index ${i}: cannot have both debit (${d}) and credit (${c}) greater than zero`,\r\n        );\r\n      }\r\n      if (doc.state === 'posted' && d === 0 && c === 0) {\r\n        throw new Error(\r\n          `Journal item at index ${i}: posted entries cannot have zero-value lines (both debit and credit are 0)`,\r\n        );\r\n      }\r\n    }\r\n\r\n    // Calculate totals\r\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n    const totalDebit = doc.journalItems.reduce((s: number, i: any) => s + (i.debit || 0), 0);\r\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n    const totalCredit = doc.journalItems.reduce((s: number, i: any) => s + (i.credit || 0), 0);\r\n\r\n    // Enforce minimum items and balance for posted entries\r\n    if (doc.state === 'posted') {\r\n      if (doc.journalItems.length < 2) {\r\n        throw new Error('Posted entries must have at least 2 journal items');\r\n      }\r\n      if (totalDebit !== totalCredit) {\r\n        throw new Error('Total debit must equal total credit for posted entries');\r\n      }\r\n    }\r\n\r\n    doc.totalDebit = totalDebit;\r\n    doc.totalCredit = totalCredit;\r\n  });\r\n\r\n  // ── Pre-save: auto-generate reference number ─────────────────────────────\r\n\r\n  if (autoReference) {\r\n    // Helper: compute next reference number from DB\r\n    // Uses aggregation pipeline to extract & sort the numeric suffix,\r\n    // avoiding lexicographic sort issues beyond sequence 9999.\r\n    const generateReferenceNumber = async (doc: Record<string, unknown>, Model: mongoose.Model<unknown>, session: unknown) => {\r\n      const jt = (doc.journalType as string) || 'MISC';\r\n      const d = new Date(doc.date as string | number | Date);\r\n      const year = d.getFullYear();\r\n      const month = String(d.getMonth() + 1).padStart(2, '0');\r\n      const prefix = `${jt}/${year}/${month}/`;\r\n\r\n      // Build match filter\r\n      const matchFilter: Record<string, unknown> = {\r\n        referenceNumber: { $regex: `^${prefix.replace(/\\//g, '\\\\/')}` },\r\n      };\r\n\r\n      // Add org field to query for multi-tenant\r\n      if (multiTenant) {\r\n        matchFilter[multiTenant.orgField] = doc[multiTenant.orgField];\r\n      }\r\n\r\n      // Extract numeric suffix via $split and sort numerically\r\n      const pipeline: mongoose.PipelineStage[] = [\r\n        { $match: matchFilter },\r\n        {\r\n          $addFields: {\r\n            _refSeq: {\r\n              $toInt: {\r\n                $arrayElemAt: [{ $split: ['$referenceNumber', '/'] }, -1],\r\n              },\r\n            },\r\n          },\r\n        },\r\n        { $sort: { _refSeq: -1 as const } },\r\n        { $limit: 1 },\r\n        { $project: { _refSeq: 1 } },\r\n      ];\r\n\r\n      const results = await Model.aggregate(pipeline)\r\n        .session(session as mongoose.mongo.ClientSession | null);\r\n\r\n      let seq = 1;\r\n      if (results.length > 0 && typeof results[0]._refSeq === 'number') {\r\n        seq = results[0]._refSeq + 1;\r\n      }\r\n\r\n      return `${prefix}${String(seq).padStart(4, '0')}`;\r\n    };\r\n\r\n    schema.pre('save', async function () {\r\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n      const doc = this as any;\r\n\r\n      if (doc.isModified('journalType')) {\r\n        doc.referenceNumber = undefined;\r\n      }\r\n\r\n      if (!doc.referenceNumber) {\r\n        const session = doc.$session?.() ?? null;\r\n        const Model = doc.constructor as mongoose.Model<unknown>;\r\n        doc.referenceNumber = await generateReferenceNumber(doc, Model, session);\r\n      }\r\n    });\r\n\r\n    // Retry on duplicate key error (race condition between concurrent inserts)\r\n    const MAX_REF_RETRIES = 3;\r\n    schema.post('save', async function (error: Error, doc: unknown, next: (err?: Error) => void) {\r\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n      const mongoError = error as any;\r\n      // 11000 = MongoDB duplicate key error\r\n      if (mongoError.code === 11000 && mongoError.keyPattern?.referenceNumber) {\r\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n        const entry = doc as any;\r\n        const retryCount: number = entry.__refRetries ?? 0;\r\n        if (retryCount >= MAX_REF_RETRIES) {\r\n          next(new Error(\r\n            `Failed to generate unique reference number after ${MAX_REF_RETRIES} retries. ` +\r\n            'Too many concurrent inserts for this period.',\r\n          ));\r\n          return;\r\n        }\r\n        entry.__refRetries = retryCount + 1;\r\n        const session = entry.$session?.() ?? null;\r\n        const Model = entry.constructor as mongoose.Model<unknown>;\r\n        entry.referenceNumber = await generateReferenceNumber(entry, Model, session);\r\n        try {\r\n          await entry.save({ session });\r\n          next();\r\n        } catch (retryError) {\r\n          next(retryError as Error);\r\n        }\r\n      } else {\r\n        next(error);\r\n      }\r\n    });\r\n  }\r\n\r\n  // ── Indexes ──────────────────────────────────────────────────────────────\r\n\r\n  if (indexes) {\r\n    const org = multiTenant?.orgField;\r\n\r\n    // Partial filter: unique constraint only applies to docs with a string\r\n    // referenceNumber — allows multiple entries without a ref when autoReference is off.\r\n    const refPartial = { partialFilterExpression: { referenceNumber: { $exists: true, $type: 'string' } } };\r\n\r\n    if (org) {\r\n      schema.index({ [org]: 1, referenceNumber: 1 }, { unique: true, ...refPartial });\r\n      schema.index({ [org]: 1, state: 1, date: 1 });\r\n      schema.index({ [org]: 1, date: -1 });\r\n      schema.index({ [org]: 1, journalType: 1 });\r\n      schema.index({ 'journalItems.account': 1, state: 1 });\r\n      schema.index({ [org]: 1, 'journalItems.account': 1, date: 1, state: 1 });\r\n    } else {\r\n      schema.index({ referenceNumber: 1 }, { unique: true, ...refPartial });\r\n      schema.index({ state: 1, date: 1 });\r\n      schema.index({ date: -1 });\r\n      schema.index({ journalType: 1 });\r\n      schema.index({ 'journalItems.account': 1, state: 1 });\r\n    }\r\n\r\n    schema.index({ reversed: 1 });\r\n\r\n    // Idempotency key: unique sparse index (only when enabled)\r\n    if (config.idempotency) {\r\n      const idempotencyIdx: Record<string, 1 | -1> = {};\r\n      if (org) idempotencyIdx[org] = 1;\r\n      idempotencyIdx.idempotencyKey = 1;\r\n      schema.index(idempotencyIdx, {\r\n        unique: true,\r\n        partialFilterExpression: { idempotencyKey: { $exists: true, $ne: null } },\r\n      });\r\n    }\r\n  }\r\n\r\n  if (textSearch) {\r\n    schema.index(\r\n      { referenceNumber: 'text', label: 'text' },\r\n      { weights: { referenceNumber: 10, label: 5 }, name: 'journal_text_idx' },\r\n    );\r\n  }\r\n\r\n  for (const idx of extraIndexes) {\r\n    schema.index(idx.fields, idx.options);\r\n  }\r\n\r\n  return schema;\r\n}\r\n","/**\r\n * Fiscal Period Schema Factory\r\n *\r\n * Creates a Mongoose schema for tracking fiscal periods (months, quarters, years).\r\n * Supports closing periods to lock entries.\r\n */\r\n\r\nimport mongoose from 'mongoose';\r\nimport type { AccountingEngineConfig, SchemaOptions } from '../types/engine.js';\r\n\r\nexport function createFiscalPeriodSchema(\r\n  config: AccountingEngineConfig,\r\n  options: SchemaOptions = {},\r\n) {\r\n  const { multiTenant } = config;\r\n  const { indexes = true, extraFields = {}, extraIndexes = [] } = options;\r\n\r\n  const fields: Record<string, unknown> = {\r\n    name: { type: String, required: true },\r\n    startDate: { type: Date, required: true },\r\n    endDate: { type: Date, required: true },\r\n    closed: { type: Boolean, default: false },\r\n    closedAt: { type: Date, default: null },\r\n    closedBy: { type: String, default: null },\r\n    closingEntryId: { type: mongoose.Schema.Types.ObjectId, default: null },\r\n    reopenedAt: { type: Date, default: null },\r\n    reopenedBy: { type: String, default: null },\r\n    ...extraFields,\r\n  };\r\n\r\n  if (multiTenant) {\r\n    fields[multiTenant.orgField] = {\r\n      type: mongoose.Schema.Types.ObjectId,\r\n      ref: multiTenant.orgRef,\r\n      required: true,\r\n    };\r\n  }\r\n\r\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n  const schema = new mongoose.Schema(fields as any, { timestamps: true });\r\n\r\n  if (indexes) {\r\n    if (multiTenant) {\r\n      const org = multiTenant.orgField;\r\n      schema.index({ [org]: 1, startDate: 1, endDate: 1 }, { unique: true });\r\n      schema.index({ [org]: 1, closed: 1 });\r\n    } else {\r\n      schema.index({ startDate: 1, endDate: 1 }, { unique: true });\r\n      schema.index({ closed: 1 });\r\n    }\r\n  }\r\n\r\n  for (const idx of extraIndexes) {\r\n    schema.index(idx.fields, idx.options);\r\n  }\r\n\r\n  // ── Overlap guard: prevent overlapping date ranges within a tenant ─────\r\n  schema.pre('validate', async function () {\r\n    const doc = this as mongoose.Document & { startDate: Date; endDate: Date; [key: string]: unknown };\r\n    if (!doc.startDate || !doc.endDate) return;\r\n\r\n    // A period overlaps if: existing.startDate < this.endDate AND existing.endDate > this.startDate\r\n    const overlapQuery: Record<string, unknown> = {\r\n      _id: { $ne: doc._id },\r\n      startDate: { $lt: doc.endDate },\r\n      endDate: { $gt: doc.startDate },\r\n    };\r\n\r\n    if (multiTenant) {\r\n      overlapQuery[multiTenant.orgField] = doc[multiTenant.orgField];\r\n    }\r\n\r\n    const overlap = await doc.collection.findOne(overlapQuery);\r\n    if (overlap) {\r\n      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]}).`;\r\n      doc.invalidate('startDate', msg, doc.startDate, 'overlap');\r\n    }\r\n  });\r\n\r\n  return schema;\r\n}\r\n"],"mappings":"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"}

package/dist/fiscal-period.schema-DI2scngu.d.mts

@@ -0,0 +1,38 @@
+import { a as SchemaOptions, r as JournalSchemaOptions, t as AccountingEngineConfig } from "./engine-Cd73EOT6.mjs";
+import mongoose from "mongoose";
+
+//#region src/schemas/account.schema.d.ts
+declare function createAccountSchema(config: AccountingEngineConfig, options?: SchemaOptions): mongoose.Schema<any, mongoose.Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
+  timestamps: true;
+}, any, any, unknown, {
+  [x: string]: any;
+} & Required<{
+  _id: unknown;
+}> & {
+  __v: number;
+}>;
+//#endregion
+//#region src/schemas/journal-entry.schema.d.ts
+declare function createJournalEntrySchema(config: AccountingEngineConfig, accountModelName: string, options?: JournalSchemaOptions): mongoose.Schema<any, mongoose.Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
+  timestamps: true;
+}, any, any, unknown, {
+  [x: string]: any;
+} & Required<{
+  _id: unknown;
+}> & {
+  __v: number;
+}>;
+//#endregion
+//#region src/schemas/fiscal-period.schema.d.ts
+declare function createFiscalPeriodSchema(config: AccountingEngineConfig, options?: SchemaOptions): mongoose.Schema<any, mongoose.Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
+  timestamps: true;
+}, any, any, unknown, {
+  [x: string]: any;
+} & Required<{
+  _id: unknown;
+}> & {
+  __v: number;
+}>;
+//#endregion
+export { createJournalEntrySchema as n, createAccountSchema as r, createFiscalPeriodSchema as t };
+//# sourceMappingURL=fiscal-period.schema-DI2scngu.d.mts.map

package/dist/fiscal-period.schema-DI2scngu.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fiscal-period.schema-DI2scngu.d.mts","names":[],"sources":["../src/schemas/account.schema.ts","../src/schemas/journal-entry.schema.ts","../src/schemas/fiscal-period.schema.ts"],"mappings":";;;;iBAagB,mBAAA,CACd,MAAA,EAAQ,sBAAA,EACR,OAAA,GAAS,aAAA,GAAkB,QAAA,CAAA,MAAA,MAAA,QAAA,CAAA,KAAA;;;;;;;;;;;iBCCb,wBAAA,CACd,MAAA,EAAQ,sBAAA,EACR,gBAAA,UACA,OAAA,GAAS,oBAAA,GAAyB,QAAA,CAAA,MAAA,MAAA,QAAA,CAAA,KAAA;;;;;;;;;;;iBCTpB,wBAAA,CACd,MAAA,EAAQ,sBAAA,EACR,OAAA,GAAS,aAAA,GAAkB,QAAA,CAAA,MAAA,MAAA,QAAA,CAAA,KAAA"}

package/dist/idempotency.plugin-BESs9YPD.d.mts

@@ -0,0 +1,58 @@
+import { Model } from "mongoose";
+
+//#region src/plugins/double-entry.plugin.d.ts
+/** Minimal interface matching @classytic/mongokit RepositoryInstance */
+interface RepositoryInstance$2 {
+  on(event: string, listener: (data: unknown) => void | Promise<void>): unknown;
+}
+interface DoubleEntryPluginOptions {
+  /** Only enforce on posted entries (default: true) */
+  onlyOnPost?: boolean;
+  /** Mongoose model — required to validate partial updates that only set state */
+  JournalEntryModel?: Model<unknown>;
+  /** Account model — when provided, posted creates verify account existence + tenant scoping */
+  AccountModel?: Model<unknown>;
+  /** Multi-tenant org field name (e.g. 'business'). Required for tenant-account integrity checks. */
+  orgField?: string;
+}
+declare function doubleEntryPlugin(options?: DoubleEntryPluginOptions): {
+  name: string;
+  apply(repo: RepositoryInstance$2): void;
+};
+//#endregion
+//#region src/plugins/fiscal-lock.plugin.d.ts
+/** Minimal interface matching @classytic/mongokit RepositoryInstance */
+interface RepositoryInstance$1 {
+  on(event: string, listener: (data: unknown) => void | Promise<void>): unknown;
+}
+interface FiscalLockPluginOptions {
+  /** Mongoose model for fiscal periods */
+  FiscalPeriodModel: Model<unknown>;
+  /** Mongoose model for journal entries — needed to look up persisted date on partial updates */
+  JournalEntryModel?: Model<unknown>;
+  /** Organization field name (for multi-tenant) */
+  orgField?: string;
+}
+declare function fiscalLockPlugin(options: FiscalLockPluginOptions): {
+  name: string;
+  apply(repo: RepositoryInstance$1): void;
+};
+//#endregion
+//#region src/plugins/idempotency.plugin.d.ts
+/** Minimal interface matching @classytic/mongokit RepositoryInstance */
+interface RepositoryInstance {
+  on(event: string, listener: (data: unknown) => void | Promise<void>): unknown;
+}
+interface IdempotencyPluginOptions {
+  /** Mongoose model for journal entries */
+  JournalEntryModel: Model<unknown>;
+  /** Multi-tenant org field name */
+  orgField?: string;
+}
+declare function idempotencyPlugin(options: IdempotencyPluginOptions): {
+  name: string;
+  apply(repo: RepositoryInstance): void;
+};
+//#endregion
+export { DoubleEntryPluginOptions as a, fiscalLockPlugin as i, idempotencyPlugin as n, doubleEntryPlugin as o, FiscalLockPluginOptions as r, IdempotencyPluginOptions as t };
+//# sourceMappingURL=idempotency.plugin-BESs9YPD.d.mts.map

package/dist/idempotency.plugin-BESs9YPD.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.plugin-BESs9YPD.d.mts","names":[],"sources":["../src/plugins/double-entry.plugin.ts","../src/plugins/fiscal-lock.plugin.ts","../src/plugins/idempotency.plugin.ts"],"mappings":";;;;UAaU,oBAAA;EACR,EAAA,CAAG,KAAA,UAAe,QAAA,GAAW,IAAA,qBAAyB,OAAA;AAAA;AAAA,UAGvC,wBAAA;EAAA;EAEf,UAAA;;EAEA,iBAAA,GAAoB,KAAA;EAFpB;EAIA,YAAA,GAAe,KAAA;EAFK;EAIpB,QAAA;AAAA;AAAA,iBAGc,iBAAA,CAAkB,OAAA,GAAS,wBAAA;;cAyC3B,oBAAA;AAAA;;;;UCxDN,oBAAA;EACR,EAAA,CAAG,KAAA,UAAe,QAAA,GAAW,IAAA,qBAAyB,OAAA;AAAA;AAAA,UAGvC,uBAAA;EDAA;ECEf,iBAAA,EAAmB,KAAA;;EAEnB,iBAAA,GAAoB,KAAA;EDFpB;ECIA,QAAA;AAAA;AAAA,iBAGc,gBAAA,CAAiB,OAAA,EAAS,uBAAA;;cAK1B,oBAAA;AAAA;;;;UCpBN,kBAAA;EACR,EAAA,CAAG,KAAA,UAAe,QAAA,GAAW,IAAA,qBAAyB,OAAA;AAAA;AAAA,UAGvC,wBAAA;EFDoD;EEGnE,iBAAA,EAAmB,KAAA;EFAJ;EEEf,QAAA;AAAA;AAAA,iBAGc,iBAAA,CAAkB,OAAA,EAAS,wBAAA;;cAK3B,kBAAA;AAAA"}