@classytic/ledger 0.7.0 → 0.9.0

package/dist/exports/index.mjs

@@ -1,2 +1,2 @@
-import { a as exportToCsv, c as getHeaders, d as serializeCsv, i as quickbooksFieldMap, l as buildCsv, n as flattenJournalEntry, o as extractAllRows, r as universalFieldMap, s as extractRow, t as flattenJournalEntries, u as escapeCell } from "../exports-BP-0Ni5W.mjs";
+import { a as exportToCsv, c as getHeaders, d as serializeCsv, i as quickbooksFieldMap, l as buildCsv, n as flattenJournalEntry, o as extractAllRows, r as universalFieldMap, s as extractRow, t as flattenJournalEntries, u as escapeCell } from "../exports-C30yRapf.mjs";
 export { buildCsv, escapeCell, exportToCsv, extractAllRows, extractRow, flattenJournalEntries, flattenJournalEntry, getHeaders, quickbooksFieldMap, serializeCsv, universalFieldMap };

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

@@ -1,4 +1,4 @@
-import { n as Errors, t as AccountingError } from "./errors-CSDQPNyt.mjs";
+import { a as IdempotencyConflictError, i as Errors, t as AccountingError } from "./errors-BI5k4iak.mjs";
 //#region src/plugins/double-entry.plugin.ts
 function doubleEntryPlugin(options = {}) {
 	const { onlyOnPost = true, JournalEntryModel, AccountModel, orgField } = options;
@@ -132,7 +132,23 @@ function doubleEntryPlugin(options = {}) {
 					...existing
 				}, context);
 			};
+			const validateMany = async (context) => {
+				const docs = context.dataArray;
+				if (!docs || docs.length === 0) return;
+				for (const data of docs) {
+					if (onlyOnPost && data.state !== "posted") continue;
+					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) continue;
+					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);
+					}
+				}
+			};
 			repo.on("before:create", validate);
+			repo.on("before:createMany", validateMany);
 			repo.on("before:update", validateUpdate);
 		}
 	};
@@ -150,7 +166,21 @@ function idempotencyPlugin(options) {
 				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}`);
+				if (existing) throw new IdempotencyConflictError(data.idempotencyKey, existing._id);
+			});
+			repo.on("before:createMany", async (context) => {
+				const docs = context.dataArray;
+				if (!docs || docs.length === 0) return;
+				const keys = docs.map((d) => d.idempotencyKey).filter((k) => !!k);
+				if (keys.length === 0) return;
+				const query = { idempotencyKey: { $in: keys } };
+				const firstOrg = orgField && docs[0]?.[orgField];
+				if (orgField && firstOrg) query[orgField] = firstOrg;
+				const existingDocs = await JournalEntryModel.find(query).select("idempotencyKey").session(context.session ?? null).lean();
+				if (existingDocs.length > 0) {
+					const existingKeys = existingDocs.map((d) => d.idempotencyKey);
+					throw Errors.conflict(`Duplicate idempotency keys: ${existingKeys.join(", ")}. ${existingDocs.length} entries already exist.`);
+				}
 			});
 		}
 	};
@@ -215,7 +245,20 @@ function createLockPlugin(options) {
 				const refPart = hit.externalRef ? ` (ref: ${hit.externalRef})` : "";
 				throw Errors.locked(hit.scope, `Cannot post entry dated ${datePart}: ${hit.scope}${subTypePart} period "${hit.label}" is closed${refPart}.`);
 			};
+			const runMany = async (context) => {
+				const docs = context.dataArray;
+				if (!docs || docs.length === 0) return;
+				for (const data of docs) {
+					if (data.state !== "posted") continue;
+					await run({
+						...context,
+						data,
+						dataArray: void 0
+					}, false);
+				}
+			};
 			repo.on("before:create", (ctx) => run(ctx, false));
+			repo.on("before:createMany", runMany);
 			repo.on("before:update", (ctx) => run(ctx, true));
 		}
 	};

package/dist/{index-BX8miYdu.d.mts → index-08IpHhrU.d.mts}

@@ -1,4 +1,4 @@
-import { t as AccountType } from "./core-BkGjuVZj.mjs";
+import { t as AccountType } from "./core-DwjkrRkJ.mjs";
 
 //#region src/country/index.d.ts
 /**
@@ -72,6 +72,16 @@ interface CountryPack {
   readonly retainedEarningsDisplayCode?: string;
   /** Display code for current year net income line (e.g. '3680' CA, '3311' BD) */
   readonly currentYearEarningsCode?: string;
+  /**
+   * Account code used as the equity contra for opening balance entries.
+   * Defaults to `retainedEarningsAccountCode` when not set.
+   *
+   * Following Odoo convention, this is typically the retained earnings
+   * account itself (not a temporary "Opening Balance Equity" account).
+   * Country packs that prefer a separate temporary account (like ERPNext)
+   * can override this.
+   */
+  readonly openingBalanceEquityCode?: string;
   /** Group label code used to identify Cost of Sales in the income statement */
   readonly cogsGroupCode?: string;
   /** Override default English report section names */
@@ -102,6 +112,7 @@ interface CountryPackInput {
   retainedEarningsAccountCode?: string;
   retainedEarningsDisplayCode?: string;
   currentYearEarningsCode?: string;
+  openingBalanceEquityCode?: string;
   cogsGroupCode?: string;
   reportLabels?: {
     readonly assets?: string;

package/dist/{index-Bl0_ak5w.d.mts → index-Db0n_6Z8.d.mts}

@@ -1,6 +1,6 @@
-import { ClientSession, Model } from "mongoose";
 import * as _classytic_mongokit0 from "@classytic/mongokit";
 import { Repository, RepositoryContext, RepositoryInstance } from "@classytic/mongokit";
+import { ClientSession, Model } from "mongoose";
 
 //#region src/types/repositories.d.ts
 interface PostOptions {

package/dist/index-dqkjgpII.d.mts

@@ -0,0 +1,104 @@
+//#region src/bridges/notification.bridge.d.ts
+/**
+ * NotificationBridge — host-implemented delivery for ledger-originated alerts.
+ *
+ * The ledger generates operational alerts that hosts may want to route to
+ * email, Slack, in-app notifications, or an audit/compliance system:
+ *
+ *   - `periodLocked` — a fiscal period was locked (audit sign-off)
+ *   - `periodUnlocked` — a locked period was re-opened (requires elevated role)
+ *   - `entryReversed` — a posted entry was reversed (accounting correction)
+ *   - `reconciliationMismatch` — match debit/credit totals differ (FX gain/loss)
+ *
+ * This is deliberately thin — richer integrations should subscribe to the
+ * EventTransport (§11-14) and route via their own notification stack.
+ * NotificationBridge exists for hosts that want a direct callback without
+ * owning an event bus.
+ *
+ * All methods are optional. Skip the bridge entirely if the host uses events.
+ */
+interface NotificationBridgeContext {
+  organizationId?: unknown;
+  actorId?: unknown;
+  correlationId?: string;
+}
+interface PeriodLockedNotification {
+  periodId: unknown;
+  startDate: Date;
+  endDate: Date;
+  lockedBy?: unknown;
+}
+interface EntryReversedNotification {
+  originalEntryId: unknown;
+  reversalEntryId: unknown;
+  reversalDate: Date;
+  reversedBy?: unknown;
+  reason?: string;
+}
+interface ReconciliationMismatchNotification {
+  matchingNumber: string;
+  account: unknown;
+  debitTotal: number;
+  creditTotal: number;
+  difference: number;
+  currency: string | null;
+}
+interface NotificationBridge {
+  onPeriodLocked?(payload: PeriodLockedNotification, ctx: NotificationBridgeContext): Promise<void>;
+  onPeriodUnlocked?(payload: PeriodLockedNotification, ctx: NotificationBridgeContext): Promise<void>;
+  onEntryReversed?(payload: EntryReversedNotification, ctx: NotificationBridgeContext): Promise<void>;
+  onReconciliationMismatch?(payload: ReconciliationMismatchNotification, ctx: NotificationBridgeContext): Promise<void>;
+}
+//#endregion
+//#region src/bridges/source.bridge.d.ts
+/**
+ * SourceBridge — host-implemented resolver for polymorphic external references.
+ *
+ * Ledger journal entries commonly carry a `reference`/`externalRef` pointing
+ * at a source document that lives outside the ledger package — an Invoice,
+ * Payment, Payroll Run, Stripe Charge, ERP voucher, etc. Storing these as
+ * opaque `String + sourceModel` (per PACKAGE_RULES §7) keeps the ledger
+ * transport-agnostic: the same schema works whether the source lives in the
+ * same Mongo, a different Mongo, Postgres, or an external REST API.
+ *
+ * Hosts implement `SourceBridge` to hydrate those refs when building
+ * enriched views (partner ledger with invoice details, audit trail with
+ * payment metadata, reconciliation UI with source documents, etc.).
+ *
+ * All methods are optional. Features that need resolution degrade gracefully
+ * when a bridge is not provided.
+ */
+interface SourceRef {
+  sourceId: string;
+  sourceModel: string;
+}
+interface SourceBridgeContext {
+  organizationId?: unknown;
+  actorId?: unknown;
+  [key: string]: unknown;
+}
+interface SourceBridge {
+  /**
+   * Resolve a single external reference.
+   *
+   * Return `null` when the source cannot be found (deleted, permission
+   * denied, wrong model). Do not throw for missing sources — callers
+   * expect `null` for graceful degradation.
+   */
+  resolve?(sourceId: string, sourceModel: string, ctx: SourceBridgeContext): Promise<unknown | null>;
+  /**
+   * Batch resolver — avoids N+1 round-trips when enriching a list.
+   * Key the returned map by `sourceId`. Missing sources may be omitted or
+   * mapped to `null` at the implementer's discretion.
+   */
+  resolveMany?(refs: ReadonlyArray<SourceRef>, ctx: SourceBridgeContext): Promise<Map<string, unknown>>;
+}
+//#endregion
+//#region src/bridges/index.d.ts
+/** Collected bridges exposed as `engine.bridges`. */
+interface LedgerBridges {
+  source?: SourceBridge;
+  notification?: NotificationBridge;
+}
+//#endregion
+export { EntryReversedNotification as a, PeriodLockedNotification as c, SourceRef as i, ReconciliationMismatchNotification as l, SourceBridge as n, NotificationBridge as o, SourceBridgeContext as r, NotificationBridgeContext as s, LedgerBridges as t };