@classytic/ledger 0.5.0 → 0.6.0

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

@@ -1,253 +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;
-				if (JournalEntryModel) {
-					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-CK7LHnBn.d.mts

@@ -1,60 +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/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 };

package/dist/index-GmfEFxVn.d.mts

@@ -1,119 +0,0 @@
-import { t as AccountType } from "./core-BkGjuVZj.mjs";
-
-//#region src/country/index.d.ts
-interface TaxCode {
-  readonly code: string;
-  readonly name: string;
-  readonly taxType: string;
-  readonly rate: number;
-  readonly direction: 'collected' | 'recoverable' | 'paid';
-  readonly province?: string;
-  readonly reportLines?: readonly number[];
-  readonly description: string;
-  readonly active: boolean;
-}
-interface TaxCodesByRegion {
-  readonly [region: string]: readonly string[];
-}
-interface TaxReportLine {
-  readonly line: number | string;
-  readonly name: string;
-  readonly description: string;
-  readonly type: 'input' | 'calculated' | 'manual';
-  readonly calculate?: (data: Record<string | number, number>) => number;
-  readonly section: string;
-}
-interface TaxReportTemplate {
-  readonly name: string;
-  readonly lines: Readonly<Record<string | number, TaxReportLine>>;
-  calculate(inputData: Record<string | number, number>, manualData?: Record<string | number, number>): Record<string | number, number>;
-  summarize(calculated: Record<string | number, number>): Record<string, unknown>;
-}
-interface CountryPack {
-  /** ISO 3166-1 alpha-2 code (e.g., 'CA', 'US', 'GB') */
-  readonly code: string;
-  /** Country name */
-  readonly name: string;
-  /** Default currency code */
-  readonly defaultCurrency: string;
-  /**
-   * Full chart of accounts template — flat array of account type definitions.
-   * Includes both regular accounts and virtual tax sub-accounts.
-   */
-  readonly accountTypes: readonly AccountType[];
-  /** Tax codes indexed by code string */
-  readonly taxCodes: Readonly<Record<string, TaxCode>>;
-  /** Tax codes grouped by region/province/state */
-  readonly taxCodesByRegion: TaxCodesByRegion;
-  /** Available regions (provinces/states) */
-  readonly regions: readonly string[];
-  /** Tax report template (e.g., CRA GST/HST return) */
-  readonly taxReport?: TaxReportTemplate;
-  /**
-   * The retained earnings account code — the account that holds accumulated
-   * retained earnings (e.g. '3600' CA, '3310' BD).
-   *
-   * On the balance sheet, this account is excluded from normal equity grouping
-   * and its balance is folded into the computed "Retained Earnings" section
-   * (opening RE = RE account balance + prior-year unclosed P&L).
-   *
-   * Inspired by Odoo's `equity_unaffected` account type.
-   */
-  readonly retainedEarningsAccountCode?: string;
-  /**
-   * Display code for the "Previous Years Retained Earnings" line on the
-   * balance sheet (e.g. '3660' for CA GIFI). Defaults to retainedEarningsAccountCode.
-   */
-  readonly retainedEarningsDisplayCode?: string;
-  /** Display code for current year net income line (e.g. '3680' CA, '3311' BD) */
-  readonly currentYearEarningsCode?: string;
-  /** Group label code used to identify Cost of Sales in the income statement */
-  readonly cogsGroupCode?: string;
-  /** Override default English report section names */
-  readonly reportLabels?: {
-    readonly assets?: string;
-    readonly liabilities?: string;
-    readonly equity?: string;
-    readonly revenue?: string;
-    readonly expenses?: string;
-  };
-  /** Get all account types that can be posted to (not groups, not totals) */
-  getPostingAccountTypes(): readonly AccountType[];
-  /** Get account type by code */
-  getAccountType(code: string): AccountType | undefined;
-  /** Validate an account type code exists */
-  isValidAccountType(code: string): boolean;
-  /** Check if an account type can receive postings */
-  isPostingAccount(code: string): boolean;
-  /** Get tax codes for a specific region */
-  getTaxCodesForRegion(region: string): TaxCode[];
-  /** Flatten hierarchical accounts (if needed) */
-  flattenAccountTypes(): readonly AccountType[];
-}
-interface CountryPackInput {
-  code: string;
-  name: string;
-  defaultCurrency: string;
-  accountTypes: readonly AccountType[];
-  taxCodes: Readonly<Record<string, TaxCode>>;
-  taxCodesByRegion: TaxCodesByRegion;
-  regions: readonly string[];
-  taxReport?: TaxReportTemplate;
-  retainedEarningsAccountCode?: string;
-  retainedEarningsDisplayCode?: string;
-  currentYearEarningsCode?: string;
-  cogsGroupCode?: string;
-  reportLabels?: {
-    readonly assets?: string;
-    readonly liabilities?: string;
-    readonly equity?: string;
-    readonly revenue?: string;
-    readonly expenses?: string;
-  };
-}
-/**
- * Factory to create a CountryPack with auto-generated helper methods.
- */
-declare function defineCountryPack(input: CountryPackInput): CountryPack;
-//#endregion
-export { TaxReportLine as a, TaxCodesByRegion as i, CountryPackInput as n, TaxReportTemplate as o, TaxCode as r, defineCountryPack as s, CountryPack as t };