@classytic/ledger 0.5.1 → 0.7.0

package/dist/date-lock.plugin-B6WyvqNG.mjs

@@ -1,254 +0,0 @@
-import { n as Errors } from "./errors-BmRjW38t.mjs";
-//#region src/plugins/double-entry.plugin.ts
-function doubleEntryPlugin(options = {}) {
-	const { onlyOnPost = true, JournalEntryModel, AccountModel, orgField } = options;
-	function validateItems(items, data) {
-		const lineErrors = [];
-		for (let i = 0; i < items.length; i++) {
-			const d = items[i].debit ?? 0;
-			const c = items[i].credit ?? 0;
-			if (d > 0 && c > 0) lineErrors.push({
-				path: `journalItems.${i}`,
-				issue: "line cannot have both debit and credit greater than zero",
-				value: {
-					debit: d,
-					credit: c
-				}
-			});
-			if (d === 0 && c === 0) lineErrors.push({
-				path: `journalItems.${i}`,
-				issue: "line cannot have both debit and credit equal to zero",
-				value: {
-					debit: 0,
-					credit: 0
-				}
-			});
-		}
-		if (lineErrors.length > 0) throw Errors.validation(`Invalid journal line(s): ${lineErrors.map((e) => `${e.path} — ${e.issue}`).join("; ")}`, lineErrors);
-		const totalDebit = items.reduce((s, i) => s + (i.debit ?? 0), 0);
-		const totalCredit = items.reduce((s, i) => s + (i.credit ?? 0), 0);
-		if (totalDebit !== totalCredit) throw Errors.validation(`Double-entry violation: debits (${totalDebit}) ≠ credits (${totalCredit}). Difference: ${Math.abs(totalDebit - totalCredit)}`, [{
-			path: "journalItems",
-			issue: "debits must equal credits",
-			value: {
-				totalDebit,
-				totalCredit,
-				difference: totalDebit - totalCredit
-			}
-		}]);
-		data.totalDebit = totalDebit;
-		data.totalCredit = totalCredit;
-	}
-	return {
-		name: "accounting:double-entry",
-		apply(repo) {
-			const validate = async (context) => {
-				const data = context.data;
-				if (!data) return;
-				if (onlyOnPost && data.state !== "posted") return;
-				const items = data.journalItems;
-				if (data.state === "posted" && (!items || items.length < 2)) throw Errors.validation(`Cannot post entry: at least 2 journal items required, got ${items?.length ?? 0}.`);
-				if (!items || items.length === 0) return;
-				validateItems(items, data);
-				if (data.state === "posted") {
-					if (!AccountModel) throw new Error("doubleEntryPlugin: AccountModel is required to validate posted entries. Pass AccountModel in plugin options to enable account existence and tenant integrity checks.");
-					await validateAccounts(items, data, context);
-				}
-			};
-			/** Verify all journal item accounts exist and belong to the same org */
-			const validateAccounts = async (items, data, context) => {
-				const missingIdxs = [];
-				items.forEach((item, idx) => {
-					if (item.account == null || item.account === "") missingIdxs.push(idx);
-				});
-				if (missingIdxs.length > 0) throw Errors.validation(`Posted entry has items with missing accounts at index(es): ${missingIdxs.join(", ")}.`, missingIdxs.map((i) => ({
-					path: `journalItems.${i}.account`,
-					issue: "account is required on posted entries"
-				})));
-				const accountIds = items.map((i) => i.account);
-				const selectFields = orgField ? `_id ${orgField}` : "_id";
-				const accounts = await AccountModel?.find({ _id: { $in: accountIds } }).select(selectFields).session(context.session ?? null).lean();
-				const foundIds = new Set(accounts.map((a) => String(a._id)));
-				const missingFieldErrors = [];
-				items.forEach((item, idx) => {
-					if (!foundIds.has(String(item.account))) missingFieldErrors.push({
-						path: `journalItems.${idx}.account`,
-						issue: "account does not exist",
-						value: item.account
-					});
-				});
-				if (missingFieldErrors.length > 0) throw Errors.validation(`${missingFieldErrors.length} item(s) reference non-existent accounts.`, missingFieldErrors);
-				if (orgField && data[orgField] != null) {
-					const dataOrg = String(data[orgField]);
-					const accountOrgById = new Map(accounts.map((a) => [String(a._id), String(a[orgField])]));
-					const crossTenantFieldErrors = [];
-					items.forEach((item, idx) => {
-						const acctOrg = accountOrgById.get(String(item.account));
-						if (acctOrg !== void 0 && acctOrg !== dataOrg) crossTenantFieldErrors.push({
-							path: `journalItems.${idx}.account`,
-							issue: "account belongs to another organization",
-							value: {
-								account: item.account,
-								expectedOrg: dataOrg,
-								actualOrg: acctOrg
-							}
-						});
-					});
-					if (crossTenantFieldErrors.length > 0) throw Errors.validation(`${crossTenantFieldErrors.length} item(s) reference accounts from another organization.`, crossTenantFieldErrors);
-				}
-			};
-			const validateUpdate = async (context) => {
-				const data = context.data;
-				if (!data) return;
-				const internalOp = context._ledgerInternal;
-				if (JournalEntryModel && !internalOp) {
-					const id = context.id;
-					if (id) {
-						if ((await JournalEntryModel.findById(id).select("state").session(context.session ?? null).lean())?.state === "posted") {
-							if (data.state !== void 0 && data.state !== "posted") throw Errors.immutable("Cannot change state of a posted journal entry. Posted entries are immutable.");
-							const allowedKeys = new Set(["state"]);
-							if (Object.keys(data).some((k) => !allowedKeys.has(k))) throw Errors.immutable("Cannot modify a posted journal entry. Use reverse() to create a correcting entry instead.");
-						}
-					}
-				}
-				if (onlyOnPost && data.state !== "posted") return;
-				const items = data.journalItems;
-				if (items !== void 0) {
-					if (items.length < 2) throw Errors.validation(`Cannot post entry: at least 2 journal items required, got ${items.length}.`);
-					validateItems(items, data);
-					if (AccountModel) await validateAccounts(items, data, context);
-					return;
-				}
-				if (!JournalEntryModel) throw new Error("doubleEntryPlugin: JournalEntryModel is required to validate partial updates that set state to \"posted\". Pass JournalEntryModel in plugin options.");
-				const id = context.id;
-				if (!id) throw new Error("doubleEntryPlugin: update context is missing \"id\". Cannot validate partial post without document ID.");
-				const existing = await JournalEntryModel.findById(id).select("journalItems").session(context.session ?? null).lean();
-				if (!existing) return;
-				const persistedItems = existing.journalItems;
-				if (!persistedItems || persistedItems.length < 2) throw Errors.validation(`Cannot post entry: at least 2 journal items required, got ${persistedItems?.length ?? 0}.`);
-				validateItems(persistedItems, data);
-				if (AccountModel) await validateAccounts(persistedItems, {
-					...data,
-					...existing
-				}, context);
-			};
-			repo.on("before:create", validate);
-			repo.on("before:update", validateUpdate);
-		}
-	};
-}
-//#endregion
-//#region src/plugins/fiscal-lock.plugin.ts
-function fiscalLockPlugin(options) {
-	const { FiscalPeriodModel, JournalEntryModel, orgField } = options;
-	return {
-		name: "accounting:fiscal-lock",
-		apply(repo) {
-			const checkPeriod = async (context, isUpdate) => {
-				const data = context.data;
-				if (!data) return;
-				if (data.state !== "posted") return;
-				const session = context.session ?? null;
-				let entryDate;
-				let persistedDoc = null;
-				if (data.date) entryDate = new Date(data.date);
-				else if (!isUpdate) entryDate = /* @__PURE__ */ new Date();
-				else {
-					if (!context.id) throw new Error("fiscalLockPlugin: update context is missing \"id\". Cannot validate fiscal lock without document ID.");
-					if (!JournalEntryModel) throw new Error("fiscalLockPlugin: JournalEntryModel is required to validate partial updates that set state to \"posted\". Pass JournalEntryModel in plugin options.");
-					const selectFields = orgField ? `date ${orgField}` : "date";
-					persistedDoc = await JournalEntryModel.findById(context.id).select(selectFields).session(session).lean();
-					if (persistedDoc?.date) entryDate = new Date(persistedDoc.date);
-				}
-				if (!entryDate) return;
-				const query = {
-					startDate: { $lte: entryDate },
-					endDate: { $gte: entryDate },
-					closed: true
-				};
-				if (orgField) {
-					let orgValue = data[orgField] ?? context[orgField];
-					if (!orgValue && isUpdate) {
-						if (persistedDoc) orgValue = persistedDoc[orgField];
-						else if (context.id && JournalEntryModel) {
-							const persisted = await JournalEntryModel.findById(context.id).select(orgField).session(session).lean();
-							if (persisted) orgValue = persisted[orgField];
-						}
-					}
-					if (!orgValue) throw new Error(`fiscalLockPlugin: orgField "${orgField}" is configured but could not be resolved from payload, context, or persisted document. Refusing to run unscoped fiscal period query.`);
-					query[orgField] = orgValue;
-				}
-				const closedPeriod = await FiscalPeriodModel.findOne(query).session(session).lean();
-				if (closedPeriod) {
-					const period = closedPeriod;
-					throw Errors.fiscal(`Cannot post entry dated ${entryDate.toISOString().split("T")[0]}: fiscal period "${period.name}" is closed.`);
-				}
-			};
-			repo.on("before:create", (ctx) => checkPeriod(ctx, false));
-			repo.on("before:update", (ctx) => checkPeriod(ctx, true));
-		}
-	};
-}
-//#endregion
-//#region src/plugins/idempotency.plugin.ts
-function idempotencyPlugin(options) {
-	const { JournalEntryModel, orgField } = options;
-	return {
-		name: "accounting:idempotency",
-		apply(repo) {
-			repo.on("before:create", async (context) => {
-				const data = context.data;
-				if (!data?.idempotencyKey) return;
-				const query = { idempotencyKey: data.idempotencyKey };
-				if (orgField && data[orgField]) query[orgField] = data[orgField];
-				const existing = await JournalEntryModel.findOne(query).select("_id").session(context.session ?? null).lean();
-				if (existing) throw Errors.conflict(`Duplicate idempotency key: "${data.idempotencyKey}". Existing entry: ${existing._id}`);
-			});
-		}
-	};
-}
-//#endregion
-//#region src/plugins/date-lock.plugin.ts
-function dateLockPlugin(options) {
-	const { getLockDate, JournalEntryModel, orgField } = options;
-	return {
-		name: "accounting:date-lock",
-		apply(repo) {
-			const checkLock = async (context, isUpdate) => {
-				const data = context.data;
-				if (!data) return;
-				if (data.state !== "posted") return;
-				const session = context.session ?? null;
-				let entryDate;
-				let persistedDoc = null;
-				if (data.date) entryDate = new Date(data.date);
-				else if (!isUpdate) entryDate = /* @__PURE__ */ new Date();
-				else {
-					if (!context.id) throw new Error("dateLockPlugin: update context is missing \"id\". Cannot validate date lock without document ID.");
-					const selectFields = orgField ? `date ${orgField}` : "date";
-					persistedDoc = await JournalEntryModel.findById(context.id).select(selectFields).session(session).lean();
-					if (persistedDoc?.date) entryDate = new Date(persistedDoc.date);
-				}
-				if (!entryDate) return;
-				let orgValue;
-				if (orgField) {
-					orgValue = data[orgField] ?? context[orgField];
-					if (!orgValue && isUpdate) {
-						if (persistedDoc) orgValue = persistedDoc[orgField];
-						else if (context.id) {
-							const persisted = await JournalEntryModel.findById(context.id).select(orgField).session(session).lean();
-							if (persisted) orgValue = persisted[orgField];
-						}
-					}
-				}
-				const lockDate = await getLockDate(orgValue, session ?? void 0);
-				if (!lockDate) return;
-				if (entryDate < lockDate) throw Errors.fiscal(`Cannot post entry dated ${entryDate.toISOString().split("T")[0]}: date is before lock date ${lockDate.toISOString().split("T")[0]}.`);
-			};
-			repo.on("before:create", (ctx) => checkLock(ctx, false));
-			repo.on("before:update", (ctx) => checkLock(ctx, true));
-		}
-	};
-}
-//#endregion
-export { doubleEntryPlugin as i, idempotencyPlugin as n, fiscalLockPlugin as r, dateLockPlugin as t };

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

@@ -1,98 +0,0 @@
-import { ClientSession, Model } from "mongoose";
-import { RepositoryInstance } from "@classytic/mongokit";
-
-//#region src/plugins/date-lock.plugin.d.ts
-interface DateLockPluginOptions {
-  /** Async function to resolve the lock date for a given org. Return null for no lock. */
-  getLockDate: (orgId?: unknown, session?: ClientSession) => Promise<Date | null>;
-  /** Mongoose model for journal entries (needed for partial updates) */
-  JournalEntryModel: Model<unknown>;
-  /** Org field name */
-  orgField?: string;
-}
-declare function dateLockPlugin(options: DateLockPluginOptions): {
-  name: string;
-  apply(repo: RepositoryInstance): void;
-};
-//#endregion
-//#region src/types/mongokit-augmentation.d.ts
-/**
- * Module augmentation for `@classytic/mongokit`.
- *
- * Ledger's state-transition methods (post, unpost, archive, reverseMark) tag
- * their `repository.update()` call with a `_ledgerInternal` flag so the
- * double-entry immutability guard can distinguish legitimate transitions from
- * arbitrary edits. This file types that flag onto both `RepositoryContext`
- * (what plugins observe) and `SessionOptions` (what callers pass) so consumers
- * and plugin authors get full IntelliSense without casts.
- *
- * This file is side-effect only — importing it anywhere in the package is
- * enough to activate the augmentation. `src/types/index.ts` re-exports it.
- */
-type LedgerInternalOp = 'post' | 'unpost' | 'archive' | 'reverseMark';
-declare module '@classytic/mongokit' {
-  interface RepositoryContext {
-    /**
-     * Set by ledger's repository methods (post, unpost, archive, reverseMark)
-     * to signal a legitimate internal state transition. Plugins observing
-     * `before:update` can read this to distinguish from arbitrary edits.
-     *
-     * External `repository.update()` callers cannot spoof this flag because
-     * it is only set by ledger's own repo methods, never surfaced in the
-     * public API.
-     */
-    _ledgerInternal?: LedgerInternalOp;
-  }
-  interface SessionOptions {
-    /**
-     * Ledger-internal flag — see `RepositoryContext._ledgerInternal`.
-     * Typed here so ledger's repo methods can pass it without casts.
-     * Consumers should never set this directly.
-     */
-    _ledgerInternal?: LedgerInternalOp;
-  }
-}
-//#endregion
-//#region src/plugins/double-entry.plugin.d.ts
-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): void;
-};
-//#endregion
-//#region src/plugins/fiscal-lock.plugin.d.ts
-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): void;
-};
-//#endregion
-//#region src/plugins/idempotency.plugin.d.ts
-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, dateLockPlugin as c, fiscalLockPlugin as i, idempotencyPlugin as n, doubleEntryPlugin as o, FiscalLockPluginOptions as r, DateLockPluginOptions as s, IdempotencyPluginOptions as t };