@classytic/ledger 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Classytic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,108 @@
+# @classytic/ledger
+
+Production-grade double-entry accounting engine for MongoDB. Built on [@classytic/mongokit](../mongokit). Designed for multi-tenant SaaS, AI-powered finance, and global tax compliance.
+
+## Features
+
+- **Double-entry bookkeeping** with balance validation and posted-entry protection (optionally immutable via strictness config)
+- **Multi-tenant** isolation via configurable org field
+- **Country packs** for localized chart of accounts and tax codes
+- **Financial reports** — trial balance, balance sheet, income statement, general ledger, cash flow
+- **Fiscal period management** — close and reopen with automatic year-end entries, overlap protection
+- **CSV export** — QuickBooks-compatible and universal field maps
+- **Cents-based Money** arithmetic for precision
+- **Plugin system** — fiscal lock, double-entry validation, idempotency (via mongokit hooks)
+- **Dimension fields** — custom fields on journal items (departmentId, projectId, etc.) preserved through all workflows
+- **Dimension filters** — filter all reports by custom journal item fields
+- **Strictness controls** — configurable immutability, actor tracking, and approval requirements
+- **Subledger contracts** — typed interfaces for integrating billing, inventory, payroll, and other subledgers
+
+## Install
+
+```bash
+npm install @classytic/ledger @classytic/mongokit mongoose
+```
+
+## Quick Start
+
+```typescript
+import { createAccountingEngine } from '@classytic/ledger';
+import { canadaPack } from '@classytic/ledger-ca';
+import mongoose from 'mongoose';
+
+// 1. Create engine
+const accounting = createAccountingEngine({
+  country: canadaPack,
+  currency: 'CAD',
+  multiTenant: { orgField: 'business', orgRef: 'Business' },
+  audit: { trackActor: true },
+  idempotency: true,
+  strictness: { immutable: true, requireActor: true },
+});
+
+// 2. Create schemas & models
+const Account = mongoose.model('Account', accounting.createAccountSchema());
+const JournalEntry = mongoose.model('JournalEntry', accounting.createJournalEntrySchema('Account', {
+  extraItemFields: {
+    departmentId: { type: mongoose.Schema.Types.ObjectId, ref: 'Department' },
+  },
+}));
+const FiscalPeriod = mongoose.model('FiscalPeriod', accounting.createFiscalPeriodSchema());
+
+// 3. Wire repositories (adds post, reverse, duplicate, unpost, seedAccounts, bulkCreate)
+import { createRepository } from '@classytic/mongokit';
+
+const journalRepo = accounting.createJournalEntryRepository(
+  createRepository,
+  { JournalEntryModel: JournalEntry, AccountModel: Account, FiscalPeriodModel: FiscalPeriod },
+);
+
+const accountRepo = createRepository(Account, []);
+accounting.wireAccountRepository(accountRepo, Account);
+
+// 4. Generate reports (with optional dimension filters)
+const reports = accounting.createReports({ Account, JournalEntry });
+const bs = await reports.balanceSheet({
+  organizationId: orgId,
+  dateOption: 'year',
+  dateValue: 2025,
+  filters: { 'journalItems.departmentId': deptId },
+});
+```
+
+## Subpath Exports
+
+| Import path | Contents |
+|---|---|
+| `@classytic/ledger` | Engine, Money, schemas, plugins, reports, repositories, constants, types |
+| `@classytic/ledger/money` | `Money` class (cents-based arithmetic) |
+| `@classytic/ledger/schemas` | `createAccountSchema`, `createJournalEntrySchema`, `createFiscalPeriodSchema` |
+| `@classytic/ledger/reports` | Report generators (trial balance, balance sheet, etc.) |
+| `@classytic/ledger/plugins` | `doubleEntryPlugin`, `fiscalLockPlugin`, `idempotencyPlugin` |
+| `@classytic/ledger/repositories` | `wireJournalEntryMethods`, `wireAccountMethods` |
+| `@classytic/ledger/exports` | CSV export: `exportToCsv`, `flattenJournalEntries`, field maps |
+| `@classytic/ledger/constants` | Categories, journal types, currencies |
+| `@classytic/ledger/country` | `defineCountryPack`, `CountryPack` interface |
+
+## Documentation
+
+- [Engine & Configuration](docs/engine.md)
+- [Schemas](docs/schemas.md)
+- [Repositories](docs/repositories.md)
+- [Reports](docs/reports.md)
+- [Plugins](docs/plugins.md)
+- [Exports](docs/exports.md)
+- [Country Packs](docs/country-packs.md)
+- [Money](docs/money.md)
+- [Subledger Integration](docs/subledger-integration.md)
+
+## Requirements
+
+- Node.js >= 22
+- MongoDB (replica set recommended for transactions)
+- Mongoose >= 9
+- @classytic/mongokit >= 3.3.2
+
+## License
+
+MIT

package/dist/account.repository-1C2sZvB2.d.mts

@@ -0,0 +1,29 @@
+import { CountryPack } from "./country/index.mjs";
+import { o as StrictnessConfig } from "./engine-Cd73EOT6.mjs";
+import { Model } from "mongoose";
+
+//#region src/repositories/journal-entry.repository.d.ts
+/**
+ * Wire post/reverse onto an existing mongokit Repository.
+ *
+ * @param repository - A mongokit Repository instance (already created)
+ * @param JournalEntryModel - The Mongoose model for journal entries
+ * @param orgField - The multi-tenant field name (e.g. 'business')
+ * @param strictness - Strictness rules (immutable, requireActor, requireApproval)
+ */
+declare function wireJournalEntryMethods(repository: any, JournalEntryModel: Model<unknown>, orgField?: string, strictness?: StrictnessConfig): void;
+//#endregion
+//#region src/repositories/account.repository.d.ts
+/**
+ * Wire seedAccounts, bulkCreate and posting-account validation
+ * onto an existing mongokit Repository.
+ *
+ * @param repository - A mongokit Repository instance (already created)
+ * @param AccountModel - The Mongoose model for accounts
+ * @param country - The CountryPack for account type lookups
+ * @param orgField - The multi-tenant field name (e.g. 'business')
+ */
+declare function wireAccountMethods(repository: any, AccountModel: Model<unknown>, country: CountryPack, orgField?: string): void;
+//#endregion
+export { wireJournalEntryMethods as n, wireAccountMethods as t };
+//# sourceMappingURL=account.repository-1C2sZvB2.d.mts.map

package/dist/account.repository-1C2sZvB2.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.repository-1C2sZvB2.d.mts","names":[],"sources":["../src/repositories/journal-entry.repository.ts","../src/repositories/account.repository.ts"],"mappings":";;;;;;;;;;;;;iBAgEgB,uBAAA,CAEd,UAAA,OACA,iBAAA,EAAmB,KAAA,WACnB,QAAA,WACA,UAAA,GAAa,gBAAA;;;;;;;;;;;;iBC3CC,kBAAA,CAEd,UAAA,OACA,YAAA,EAAc,KAAA,WACd,OAAA,EAAS,WAAA,EACT,QAAA"}

package/dist/account.repository-Crf5DGO4.mjs

@@ -0,0 +1,393 @@
+import { n as Errors } from "./errors-CeqRahE-.mjs";
+import { i as requireOrgScope, n as finalizeSession, t as acquireSession } from "./session-Dh0s6zG4.mjs";
+
+//#region src/repositories/journal-entry.repository.ts
+/** Keys that are either handled explicitly or must not be copied */
+const ITEM_CORE_KEYS = new Set([
+	"account",
+	"debit",
+	"credit",
+	"label",
+	"date",
+	"taxDetails",
+	"_id",
+	"id"
+]);
+/**
+* Wire post/reverse onto an existing mongokit Repository.
+*
+* @param repository - A mongokit Repository instance (already created)
+* @param JournalEntryModel - The Mongoose model for journal entries
+* @param orgField - The multi-tenant field name (e.g. 'business')
+* @param strictness - Strictness rules (immutable, requireActor, requireApproval)
+*/
+function wireJournalEntryMethods(repository, JournalEntryModel, orgField, strictness) {
+	/**
+	* Post an entry (draft → posted).
+	* Validates items, balance, and accounts before changing state.
+	*/
+	repository.post = async function(id, orgId, options = {}) {
+		if (strictness?.requireActor && !options.actorId) throw Errors.validation("actorId is required for post operations.");
+		requireOrgScope(orgField, orgId);
+		const query = { _id: id };
+		if (orgField && orgId != null) query[orgField] = orgId;
+		const entry = await JournalEntryModel.findOne(query).populate("journalItems.account").session(options.session || null);
+		if (!entry) throw Errors.notFound("Entry not found");
+		if (entry.idempotencyKey && entry.state === "posted") return entry;
+		if (entry.state !== "draft") throw Errors.validation("Only draft entries can be posted");
+		if (strictness?.requireApproval) {
+			if (!entry.approvedBy || !entry.approvedAt) throw Errors.validation("Entry must be approved before posting. Both approvedBy and approvedAt are required.");
+		}
+		if (!entry.journalItems || entry.journalItems.length < 2) throw Errors.validation("Journal entry must have at least 2 items to post");
+		const missing = entry.journalItems.filter((i) => !i.account || i.account === "");
+		if (missing.length > 0) throw Errors.validation(`${missing.length} item(s) missing an account`);
+		if (orgField && orgId != null) {
+			const crossTenant = entry.journalItems.filter((i) => {
+				const acct = i.account;
+				if (!acct || typeof acct !== "object") return false;
+				return String(acct[orgField]) !== String(orgId);
+			});
+			if (crossTenant.length > 0) throw Errors.validation(`${crossTenant.length} item(s) reference accounts from another organization`);
+		}
+		const zeroed = entry.journalItems.filter((i) => (i.debit || 0) === 0 && (i.credit || 0) === 0);
+		if (zeroed.length > 0) throw Errors.validation(`${zeroed.length} item(s) have both debit and credit as zero`);
+		const bothSet = entry.journalItems.filter((i) => (i.debit || 0) > 0 && (i.credit || 0) > 0);
+		if (bothSet.length > 0) throw Errors.validation(`${bothSet.length} item(s) have both debit and credit set — each line must be debit OR credit, not both`);
+		const totalDebit = entry.journalItems.reduce((s, i) => s + (i.debit || 0), 0);
+		const totalCredit = entry.journalItems.reduce((s, i) => s + (i.credit || 0), 0);
+		if (totalDebit !== totalCredit) throw Errors.validation(`Entry is not balanced. Debit: ${totalDebit}, Credit: ${totalCredit}`);
+		entry.state = "posted";
+		entry.stateChangedAt = /* @__PURE__ */ new Date();
+		if (options.actorId) entry.postedBy = options.actorId;
+		await entry.save({ session: options.session });
+		return entry;
+	};
+	/**
+	* Unpost an entry (posted → draft).
+	* Resets state to draft so the entry can be edited and re-posted.
+	* Also clears the reversed flag if set, allowing full re-editing.
+	*/
+	repository.unpost = async function(id, orgId, options = {}) {
+		if (strictness?.immutable) throw Errors.immutable("Unpost is disabled in strict mode. Use reverse() to correct posted entries.");
+		if (strictness?.requireActor && !options.actorId) throw Errors.validation("actorId is required for unpost operations.");
+		requireOrgScope(orgField, orgId);
+		const query = { _id: id };
+		if (orgField && orgId != null) query[orgField] = orgId;
+		const entry = await JournalEntryModel.findOne(query).session(options.session || null);
+		if (!entry) throw Errors.notFound("Entry not found");
+		if (entry.state !== "posted") throw Errors.validation("Only posted entries can be unposted");
+		entry.state = "draft";
+		entry.stateChangedAt = /* @__PURE__ */ new Date();
+		if (entry.reversed) {
+			entry.reversed = false;
+			entry.reversedBy = void 0;
+		}
+		await entry.save({ session: options.session });
+		return entry;
+	};
+	/**
+	* Archive a draft entry (draft → archived).
+	* Used to discard unneeded drafts without deleting them, preserving audit trail.
+	* Only draft entries can be archived. Posted entries must be reversed instead.
+	*/
+	repository.archive = async function(id, orgId, options = {}) {
+		if (strictness?.requireActor && !options.actorId) throw Errors.validation("actorId is required for archive operations.");
+		requireOrgScope(orgField, orgId);
+		const query = { _id: id };
+		if (orgField && orgId != null) query[orgField] = orgId;
+		const entry = await JournalEntryModel.findOne(query).session(options.session || null);
+		if (!entry) throw Errors.notFound("Entry not found");
+		if (entry.state !== "draft") throw Errors.validation("Only draft entries can be archived");
+		entry.state = "archived";
+		entry.stateChangedAt = /* @__PURE__ */ new Date();
+		await entry.save({ session: options.session });
+		return entry;
+	};
+	/**
+	* Duplicate an entry as a new draft.
+	* Copies journal items, journal type, and label. Assigns today's date.
+	*/
+	repository.duplicate = async function(id, orgId, options = {}) {
+		requireOrgScope(orgField, orgId);
+		const query = { _id: id };
+		if (orgField && orgId != null) query[orgField] = orgId;
+		const entry = await JournalEntryModel.findOne(query).session(options.session || null);
+		if (!entry) throw Errors.notFound("Entry not found");
+		const duplicateData = {
+			journalType: entry.journalType,
+			state: "draft",
+			date: /* @__PURE__ */ new Date(),
+			label: entry.label ? `Copy of ${entry.label}` : "Duplicated entry",
+			journalItems: entry.journalItems.map((item) => {
+				const accountId = typeof item.account === "object" && item.account !== null ? item.account._id : item.account;
+				const extra = {};
+				for (const key of Object.keys(item)) if (!ITEM_CORE_KEYS.has(key)) extra[key] = item[key];
+				return {
+					...extra,
+					account: accountId,
+					debit: item.debit ?? 0,
+					credit: item.credit ?? 0,
+					label: item.label,
+					date: /* @__PURE__ */ new Date(),
+					taxDetails: item.taxDetails ?? []
+				};
+			})
+		};
+		if (orgField && entry[orgField] != null) duplicateData[orgField] = entry[orgField];
+		return await repository.create(duplicateData, options.session ? { session: options.session } : {});
+	};
+	/**
+	* Reverse a posted entry by creating a mirror entry with flipped debits/credits.
+	* Marks the original as reversed and links both entries bidirectionally.
+	*
+	* Atomic: creates an internal transaction by default. Pass an external session
+	* to join a caller-managed transaction instead. On standalone MongoDB (no
+	* replica set), falls back to non-atomic execution with a warning.
+	*
+	* Routes the reversal through repository.create() so all plugins (fiscal-lock,
+	* double-entry) enforce policy on the reversal entry.
+	*/
+	repository.reverse = async function(id, orgId, options = {}) {
+		if (strictness?.requireActor && !options.actorId) throw Errors.validation("actorId is required for reverse operations.");
+		requireOrgScope(orgField, orgId);
+		const { session, ownSession } = await acquireSession(JournalEntryModel.db, options.session);
+		let success = false;
+		try {
+			const query = { _id: id };
+			if (orgField && orgId != null) query[orgField] = orgId;
+			const entry = await JournalEntryModel.findOne(query).populate("journalItems.account").session(session || null);
+			if (!entry) throw Errors.notFound("Entry not found");
+			if (entry.state !== "posted") throw Errors.validation("Only posted entries can be reversed");
+			if (entry.reversed) throw Errors.validation("Entry has already been reversed");
+			const reversalItems = entry.journalItems.map((item) => {
+				const accountId = typeof item.account === "object" && item.account !== null ? item.account._id : item.account;
+				const extra = {};
+				for (const key of Object.keys(item)) if (!ITEM_CORE_KEYS.has(key)) extra[key] = item[key];
+				return {
+					...extra,
+					account: accountId,
+					debit: item.credit ?? 0,
+					credit: item.debit ?? 0,
+					label: item.label ? `Reversal: ${item.label}` : void 0,
+					date: item.date,
+					taxDetails: item.taxDetails ?? []
+				};
+			});
+			const totalDebit = reversalItems.reduce((s, i) => s + i.debit, 0);
+			const totalCredit = reversalItems.reduce((s, i) => s + i.credit, 0);
+			const reversalData = {
+				journalType: entry.journalType ?? "MISC",
+				state: "posted",
+				date: options.reversalDate ?? /* @__PURE__ */ new Date(),
+				label: `Reversal of ${entry.referenceNumber ?? entry._id}`,
+				journalItems: reversalItems,
+				totalDebit,
+				totalCredit,
+				reversalOf: entry._id,
+				stateChangedAt: /* @__PURE__ */ new Date()
+			};
+			if (orgField && entry[orgField] != null) reversalData[orgField] = entry[orgField];
+			if (options.actorId) reversalData.postedBy = options.actorId;
+			const reversalEntry = await repository.create(reversalData, session ? { session } : {});
+			entry.reversed = true;
+			entry.reversedBy = reversalEntry._id;
+			if (options.actorId) entry.reversedByUser = options.actorId;
+			await entry.save({ session });
+			success = true;
+			return {
+				original: entry,
+				reversal: reversalEntry
+			};
+		} finally {
+			await finalizeSession(session, ownSession, success);
+		}
+	};
+}
+
+//#endregion
+//#region src/repositories/account.repository.ts
+/**
+* Wire seedAccounts, bulkCreate and posting-account validation
+* onto an existing mongokit Repository.
+*
+* @param repository - A mongokit Repository instance (already created)
+* @param AccountModel - The Mongoose model for accounts
+* @param country - The CountryPack for account type lookups
+* @param orgField - The multi-tenant field name (e.g. 'business')
+*/
+function wireAccountMethods(repository, AccountModel, country, orgField) {
+	repository.on("before:create", (ctx) => {
+		const code = ctx.data?.accountTypeCode;
+		if (code && !country.isPostingAccount(code)) throw Errors.validation(`Cannot create account with type "${code}" — it is a structural group or calculated total, not a posting account.`);
+	});
+	/**
+	* Seed standard posting accounts for an organization.
+	*/
+	repository.seedAccounts = async function(orgId, options = {}) {
+		requireOrgScope(orgField, orgId);
+		const postingTypes = country.getPostingAccountTypes();
+		const filter = {};
+		if (orgField && orgId != null) filter[orgField] = orgId;
+		const existing = await AccountModel.find(filter).select("accountNumber").lean();
+		const existingNumbers = new Set(existing.map((a) => a.accountNumber));
+		const toCreate = postingTypes.filter((at) => !existingNumbers.has(at.code)).map((at) => {
+			const doc = {
+				accountTypeCode: at.code,
+				accountNumber: at.code,
+				name: at.name
+			};
+			if (orgField && orgId != null) doc[orgField] = orgId;
+			return doc;
+		});
+		if (toCreate.length === 0) return {
+			created: 0,
+			skipped: existingNumbers.size
+		};
+		try {
+			return {
+				created: (await AccountModel.insertMany(toCreate, {
+					session: options.session ?? void 0,
+					ordered: false
+				})).length,
+				skipped: existingNumbers.size
+			};
+		} catch (err) {
+			const bulkError = err;
+			if (bulkError.code === 11e3 || bulkError.writeErrors) {
+				const insertedDocs = bulkError.insertedDocs ?? [];
+				return {
+					created: insertedDocs.length,
+					skipped: existingNumbers.size + (toCreate.length - insertedDocs.length)
+				};
+			}
+			throw err;
+		}
+	};
+	/**
+	* Bulk create accounts with validation and skip-if-exists logic.
+	*
+	* Uses a single batch query to check existing accounts (instead of N+1),
+	* and ordered: false on insertMany to handle concurrent race conditions
+	* gracefully (duplicate key errors on individual docs don't abort the batch).
+	*/
+	repository.bulkCreate = async function(accounts, orgId) {
+		requireOrgScope(orgField, orgId);
+		const results = {
+			created: [],
+			skipped: [],
+			errors: []
+		};
+		const validAccounts = [];
+		for (let i = 0; i < accounts.length; i++) {
+			const { accountTypeCode, accountNumber, name, active = true, isCashAccount = false } = accounts[i];
+			if (!accountTypeCode) {
+				results.errors.push({
+					index: i,
+					reason: "accountTypeCode is required"
+				});
+				continue;
+			}
+			const at = country.getAccountType(accountTypeCode);
+			if (!at) {
+				results.errors.push({
+					index: i,
+					accountTypeCode,
+					reason: "Invalid account type code"
+				});
+				continue;
+			}
+			if (!country.isPostingAccount(accountTypeCode)) {
+				results.errors.push({
+					index: i,
+					accountTypeCode,
+					reason: `Not a posting account (${at.isGroup ? "group" : "total"})`
+				});
+				continue;
+			}
+			const resolvedNumber = accountNumber ?? accountTypeCode;
+			const resolvedName = name ?? at.name ?? accountTypeCode;
+			validAccounts.push({
+				index: i,
+				accountTypeCode,
+				accountNumber: resolvedNumber,
+				name: resolvedName,
+				active: Boolean(active),
+				isCashAccount: Boolean(isCashAccount)
+			});
+		}
+		if (validAccounts.length === 0) return {
+			summary: {
+				total: accounts.length,
+				created: 0,
+				skipped: results.skipped.length,
+				errors: results.errors.length
+			},
+			...results
+		};
+		const existsFilter = { accountNumber: { $in: validAccounts.map((a) => a.accountNumber) } };
+		if (orgField && orgId != null) existsFilter[orgField] = orgId;
+		const existingDocs = await AccountModel.find(existsFilter).select("accountNumber").lean();
+		const existingNumbers = new Set(existingDocs.map((d) => d.accountNumber));
+		const toCreate = [];
+		for (const item of validAccounts) if (existingNumbers.has(item.accountNumber)) results.skipped.push({
+			index: item.index,
+			accountTypeCode: item.accountTypeCode,
+			reason: "Already exists"
+		});
+		else toCreate.push(item);
+		if (toCreate.length > 0) {
+			const docs = toCreate.map((item) => {
+				const doc = {
+					accountTypeCode: item.accountTypeCode,
+					accountNumber: item.accountNumber,
+					name: item.name,
+					active: item.active,
+					isCashAccount: item.isCashAccount
+				};
+				if (orgField && orgId != null) doc[orgField] = orgId;
+				return doc;
+			});
+			try {
+				const inserted = await AccountModel.insertMany(docs, { ordered: false });
+				results.created = toCreate.map((item, idx) => ({
+					accountTypeCode: item.accountTypeCode,
+					active: item.active,
+					isCashAccount: item.isCashAccount,
+					_id: inserted[idx]._id
+				}));
+			} catch (err) {
+				const bulkError = err;
+				if (bulkError.code === 11e3 || bulkError.writeErrors) {
+					const insertedDocs = bulkError.insertedDocs ?? [];
+					const insertedNumbers = new Set(insertedDocs.map((d) => d.accountNumber));
+					for (const item of toCreate) if (insertedNumbers.has(item.accountNumber)) {
+						const iDoc = insertedDocs.find((d) => d.accountNumber === item.accountNumber);
+						results.created.push({
+							accountTypeCode: item.accountTypeCode,
+							active: item.active,
+							isCashAccount: item.isCashAccount,
+							_id: iDoc?._id
+						});
+					} else results.skipped.push({
+						index: item.index,
+						accountTypeCode: item.accountTypeCode,
+						reason: "Already exists (concurrent insert)"
+					});
+				} else throw err;
+			}
+		}
+		return {
+			summary: {
+				total: accounts.length,
+				created: results.created.length,
+				skipped: results.skipped.length,
+				errors: results.errors.length
+			},
+			...results
+		};
+	};
+}
+
+//#endregion
+export { wireJournalEntryMethods as n, wireAccountMethods as t };
+//# sourceMappingURL=account.repository-Crf5DGO4.mjs.map

package/dist/account.repository-Crf5DGO4.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.repository-Crf5DGO4.mjs","names":[],"sources":["../src/repositories/journal-entry.repository.ts","../src/repositories/account.repository.ts"],"sourcesContent":["/**\r\n * Journal Entry Repository Factory\r\n *\r\n * Creates a mongokit Repository with post/reverse domain logic baked in.\r\n * Used by AccountingEngine.createJournalEntryRepository().\r\n */\r\n\r\nimport type { Model, ClientSession } from 'mongoose';\r\nimport type { StrictnessConfig } from '../types/engine.js';\r\nimport { Errors } from '../utils/errors.js';\r\nimport { requireOrgScope } from '../utils/tenant-guard.js';\r\nimport { acquireSession, finalizeSession } from '../utils/session.js';\r\n\r\ninterface PostOptions {\r\n  session?: ClientSession | null;\r\n  /** Actor performing this operation (required when strictness.requireActor is enabled) */\r\n  actorId?: unknown;\r\n}\r\n\r\ninterface JournalItem {\r\n  account?: unknown;\r\n  debit?: number;\r\n  credit?: number;\r\n}\r\n\r\ninterface JournalItemWithLabel extends JournalItem {\r\n  label?: string;\r\n  date?: Date;\r\n  taxDetails?: unknown[];\r\n  [key: string]: unknown;\r\n}\r\n\r\n/** Keys that are either handled explicitly or must not be copied */\r\nconst ITEM_CORE_KEYS = new Set(['account', 'debit', 'credit', 'label', 'date', 'taxDetails', '_id', 'id']);\r\n\r\ninterface JournalEntryDoc {\r\n  _id: unknown;\r\n  state: string;\r\n  stateChangedAt?: Date;\r\n  journalType?: string;\r\n  referenceNumber?: string;\r\n  label?: string;\r\n  date?: Date;\r\n  reversed?: boolean;\r\n  reversedBy?: unknown;\r\n  reversalOf?: unknown;\r\n  journalItems: JournalItemWithLabel[];\r\n  save(options?: { session?: ClientSession | null }): Promise<this>;\r\n  [key: string]: unknown;\r\n}\r\n\r\ninterface ReverseOptions extends PostOptions {\r\n  /** Date for the reversal entry (defaults to now) */\r\n  reversalDate?: Date;\r\n}\r\n\r\n/**\r\n * Wire post/reverse onto an existing mongokit Repository.\r\n *\r\n * @param repository - A mongokit Repository instance (already created)\r\n * @param JournalEntryModel - The Mongoose model for journal entries\r\n * @param orgField - The multi-tenant field name (e.g. 'business')\r\n * @param strictness - Strictness rules (immutable, requireActor, requireApproval)\r\n */\r\nexport function wireJournalEntryMethods(\r\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n  repository: any,\r\n  JournalEntryModel: Model<unknown>,\r\n  orgField?: string,\r\n  strictness?: StrictnessConfig,\r\n): void {\r\n  /**\r\n   * Post an entry (draft → posted).\r\n   * Validates items, balance, and accounts before changing state.\r\n   */\r\n  repository.post = async function (id: unknown, orgId?: unknown, options: PostOptions = {}) {\r\n    if (strictness?.requireActor && !options.actorId) {\r\n      throw Errors.validation('actorId is required for post operations.');\r\n    }\r\n    requireOrgScope(orgField, orgId);\r\n    const query: Record<string, unknown> = { _id: id };\r\n    if (orgField && orgId != null) query[orgField] = orgId;\r\n\r\n    const entry = (await JournalEntryModel.findOne(query)\r\n      .populate('journalItems.account')\r\n      .session(options.session || null)) as JournalEntryDoc | null;\r\n\r\n    if (!entry) {\r\n      throw Errors.notFound('Entry not found');\r\n    }\r\n\r\n    // Idempotency: if already posted with same idempotency key, return as-is\r\n    if (entry.idempotencyKey && entry.state === 'posted') {\r\n      return entry;\r\n    }\r\n\r\n    if (entry.state !== 'draft') {\r\n      throw Errors.validation('Only draft entries can be posted');\r\n    }\r\n\r\n    // Approval requirement — both approvedBy and approvedAt must be set\r\n    if (strictness?.requireApproval) {\r\n      if (!entry.approvedBy || !entry.approvedAt) {\r\n        throw Errors.validation('Entry must be approved before posting. Both approvedBy and approvedAt are required.');\r\n      }\r\n    }\r\n\r\n    // Must have >= 2 items\r\n    if (!entry.journalItems || entry.journalItems.length < 2) {\r\n      throw Errors.validation('Journal entry must have at least 2 items to post');\r\n    }\r\n\r\n    // Every item must have a valid account\r\n    const missing = entry.journalItems.filter((i: JournalItem) => !i.account || i.account === '');\r\n    if (missing.length > 0) {\r\n      throw Errors.validation(`${missing.length} item(s) missing an account`);\r\n    }\r\n\r\n    // Verify all populated accounts belong to the same org (multi-tenant integrity)\r\n    if (orgField && orgId != null) {\r\n      const crossTenant = entry.journalItems.filter((i: JournalItem) => {\r\n        const acct = i.account as Record<string, unknown> | null;\r\n        if (!acct || typeof acct !== 'object') return false;\r\n        return String(acct[orgField]) !== String(orgId);\r\n      });\r\n      if (crossTenant.length > 0) {\r\n        throw Errors.validation(\r\n          `${crossTenant.length} item(s) reference accounts from another organization`,\r\n        );\r\n      }\r\n    }\r\n\r\n    // Every item must have debit or credit > 0\r\n    const zeroed = entry.journalItems.filter((i: JournalItem) => (i.debit || 0) === 0 && (i.credit || 0) === 0);\r\n    if (zeroed.length > 0) {\r\n      throw Errors.validation(`${zeroed.length} item(s) have both debit and credit as zero`);\r\n    }\r\n\r\n    // Each line must be debit OR credit, not both\r\n    const bothSet = entry.journalItems.filter((i: JournalItem) => (i.debit || 0) > 0 && (i.credit || 0) > 0);\r\n    if (bothSet.length > 0) {\r\n      throw Errors.validation(\r\n        `${bothSet.length} item(s) have both debit and credit set — each line must be debit OR credit, not both`,\r\n      );\r\n    }\r\n\r\n    // Must be balanced — integer cents, exact comparison\r\n    const totalDebit = entry.journalItems.reduce((s: number, i: JournalItem) => s + (i.debit || 0), 0);\r\n    const totalCredit = entry.journalItems.reduce((s: number, i: JournalItem) => s + (i.credit || 0), 0);\r\n    if (totalDebit !== totalCredit) {\r\n      throw Errors.validation(\r\n        `Entry is not balanced. Debit: ${totalDebit}, Credit: ${totalCredit}`,\r\n      );\r\n    }\r\n\r\n    entry.state = 'posted';\r\n    entry.stateChangedAt = new Date();\r\n    if (options.actorId) {\r\n      entry.postedBy = options.actorId;\r\n    }\r\n    await entry.save({ session: options.session });\r\n\r\n    return entry;\r\n  };\r\n\r\n  /**\r\n   * Unpost an entry (posted → draft).\r\n   * Resets state to draft so the entry can be edited and re-posted.\r\n   * Also clears the reversed flag if set, allowing full re-editing.\r\n   */\r\n  repository.unpost = async function (id: unknown, orgId?: unknown, options: PostOptions = {}) {\r\n    if (strictness?.immutable) {\r\n      throw Errors.immutable('Unpost is disabled in strict mode. Use reverse() to correct posted entries.');\r\n    }\r\n    if (strictness?.requireActor && !options.actorId) {\r\n      throw Errors.validation('actorId is required for unpost operations.');\r\n    }\r\n    requireOrgScope(orgField, orgId);\r\n    const query: Record<string, unknown> = { _id: id };\r\n    if (orgField && orgId != null) query[orgField] = orgId;\r\n\r\n    const entry = (await JournalEntryModel.findOne(query)\r\n      .session(options.session || null)) as JournalEntryDoc | null;\r\n\r\n    if (!entry) {\r\n      throw Errors.notFound('Entry not found');\r\n    }\r\n    if (entry.state !== 'posted') {\r\n      throw Errors.validation('Only posted entries can be unposted');\r\n    }\r\n\r\n    entry.state = 'draft';\r\n    entry.stateChangedAt = new Date();\r\n    // Clear reversal flags so the entry is fully editable as a draft\r\n    if (entry.reversed) {\r\n      entry.reversed = false;\r\n      entry.reversedBy = undefined;\r\n    }\r\n    await entry.save({ session: options.session });\r\n\r\n    return entry;\r\n  };\r\n\r\n  /**\r\n   * Archive a draft entry (draft → archived).\r\n   * Used to discard unneeded drafts without deleting them, preserving audit trail.\r\n   * Only draft entries can be archived. Posted entries must be reversed instead.\r\n   */\r\n  repository.archive = async function (id: unknown, orgId?: unknown, options: PostOptions = {}) {\r\n    if (strictness?.requireActor && !options.actorId) {\r\n      throw Errors.validation('actorId is required for archive operations.');\r\n    }\r\n    requireOrgScope(orgField, orgId);\r\n    const query: Record<string, unknown> = { _id: id };\r\n    if (orgField && orgId != null) query[orgField] = orgId;\r\n\r\n    const entry = (await JournalEntryModel.findOne(query)\r\n      .session(options.session || null)) as JournalEntryDoc | null;\r\n\r\n    if (!entry) {\r\n      throw Errors.notFound('Entry not found');\r\n    }\r\n    if (entry.state !== 'draft') {\r\n      throw Errors.validation('Only draft entries can be archived');\r\n    }\r\n\r\n    entry.state = 'archived';\r\n    entry.stateChangedAt = new Date();\r\n    await entry.save({ session: options.session });\r\n\r\n    return entry;\r\n  };\r\n\r\n  /**\r\n   * Duplicate an entry as a new draft.\r\n   * Copies journal items, journal type, and label. Assigns today's date.\r\n   */\r\n  repository.duplicate = async function (id: unknown, orgId?: unknown, options: PostOptions = {}) {\r\n    requireOrgScope(orgField, orgId);\r\n    const query: Record<string, unknown> = { _id: id };\r\n    if (orgField && orgId != null) query[orgField] = orgId;\r\n\r\n    const entry = (await JournalEntryModel.findOne(query)\r\n      .session(options.session || null)) as JournalEntryDoc | null;\r\n\r\n    if (!entry) {\r\n      throw Errors.notFound('Entry not found');\r\n    }\r\n\r\n    const duplicateData: Record<string, unknown> = {\r\n      journalType: entry.journalType,\r\n      state: 'draft',\r\n      date: new Date(),\r\n      label: entry.label ? `Copy of ${entry.label}` : 'Duplicated entry',\r\n      journalItems: entry.journalItems.map((item: JournalItemWithLabel) => {\r\n        const accountId = typeof item.account === 'object' && item.account !== null\r\n          ? (item.account as Record<string, unknown>)._id\r\n          : item.account;\r\n\r\n        // Preserve dimension/extra fields (departmentId, projectId, locationId, etc.)\r\n        const extra: Record<string, unknown> = {};\r\n        for (const key of Object.keys(item)) {\r\n          if (!ITEM_CORE_KEYS.has(key)) extra[key] = item[key];\r\n        }\r\n\r\n        return {\r\n          ...extra,\r\n          account: accountId,\r\n          debit: item.debit ?? 0,\r\n          credit: item.credit ?? 0,\r\n          label: item.label,\r\n          date: new Date(),\r\n          taxDetails: item.taxDetails ?? [],\r\n        };\r\n      }),\r\n    };\r\n\r\n    // Carry over org field\r\n    if (orgField && entry[orgField] != null) {\r\n      duplicateData[orgField] = entry[orgField];\r\n    }\r\n\r\n    const duplicated = await repository.create(duplicateData, options.session ? { session: options.session } : {});\r\n    return duplicated;\r\n  };\r\n\r\n  /**\r\n   * Reverse a posted entry by creating a mirror entry with flipped debits/credits.\r\n   * Marks the original as reversed and links both entries bidirectionally.\r\n   *\r\n   * Atomic: creates an internal transaction by default. Pass an external session\r\n   * to join a caller-managed transaction instead. On standalone MongoDB (no\r\n   * replica set), falls back to non-atomic execution with a warning.\r\n   *\r\n   * Routes the reversal through repository.create() so all plugins (fiscal-lock,\r\n   * double-entry) enforce policy on the reversal entry.\r\n   */\r\n  repository.reverse = async function (id: unknown, orgId?: unknown, options: ReverseOptions = {}) {\r\n    if (strictness?.requireActor && !options.actorId) {\r\n      throw Errors.validation('actorId is required for reverse operations.');\r\n    }\r\n    requireOrgScope(orgField, orgId);\r\n    const { session, ownSession } = await acquireSession(\r\n      JournalEntryModel.db,\r\n      options.session,\r\n    );\r\n    let success = false;\r\n\r\n    try {\r\n      const query: Record<string, unknown> = { _id: id };\r\n      if (orgField && orgId != null) query[orgField] = orgId;\r\n\r\n      const entry = (await JournalEntryModel.findOne(query)\r\n        .populate('journalItems.account')\r\n        .session(session || null)) as JournalEntryDoc | null;\r\n\r\n      if (!entry) {\r\n        throw Errors.notFound('Entry not found');\r\n      }\r\n      if (entry.state !== 'posted') {\r\n        throw Errors.validation('Only posted entries can be reversed');\r\n      }\r\n      if (entry.reversed) {\r\n        throw Errors.validation('Entry has already been reversed');\r\n      }\r\n\r\n      // Build reversal items — swap debit ↔ credit for each line\r\n      const reversalItems = entry.journalItems.map((item: JournalItemWithLabel) => {\r\n        const accountId = typeof item.account === 'object' && item.account !== null\r\n          ? (item.account as Record<string, unknown>)._id\r\n          : item.account;\r\n\r\n        // Preserve dimension/extra fields (departmentId, projectId, locationId, etc.)\r\n        const extra: Record<string, unknown> = {};\r\n        for (const key of Object.keys(item)) {\r\n          if (!ITEM_CORE_KEYS.has(key)) extra[key] = item[key];\r\n        }\r\n\r\n        return {\r\n          ...extra,\r\n          account: accountId,\r\n          debit: item.credit ?? 0,\r\n          credit: item.debit ?? 0,\r\n          label: item.label ? `Reversal: ${item.label}` : undefined,\r\n          date: item.date,\r\n          taxDetails: item.taxDetails ?? [],\r\n        };\r\n      });\r\n\r\n      const totalDebit = reversalItems.reduce((s: number, i: { debit: number }) => s + i.debit, 0);\r\n      const totalCredit = reversalItems.reduce((s: number, i: { credit: number }) => s + i.credit, 0);\r\n\r\n      // Build reversal entry data\r\n      const reversalData: Record<string, unknown> = {\r\n        journalType: entry.journalType ?? 'MISC',\r\n        state: 'posted',\r\n        date: options.reversalDate ?? new Date(),\r\n        label: `Reversal of ${entry.referenceNumber ?? entry._id}`,\r\n        journalItems: reversalItems,\r\n        totalDebit,\r\n        totalCredit,\r\n        reversalOf: entry._id,\r\n        stateChangedAt: new Date(),\r\n      };\r\n\r\n      // Carry over org field\r\n      if (orgField && entry[orgField] != null) {\r\n        reversalData[orgField] = entry[orgField];\r\n      }\r\n\r\n      // Stamp actor on reversal entry\r\n      if (options.actorId) {\r\n        reversalData.postedBy = options.actorId;\r\n      }\r\n\r\n      // Create reversal via repository so plugins (fiscal-lock, double-entry) run\r\n      const reversalEntry = await repository.create(\r\n        reversalData,\r\n        session ? { session } : {},\r\n      );\r\n\r\n      // Mark original as reversed (bidirectional link)\r\n      entry.reversed = true;\r\n      entry.reversedBy = reversalEntry._id;\r\n      if (options.actorId) {\r\n        entry.reversedByUser = options.actorId;\r\n      }\r\n      await entry.save({ session });\r\n\r\n      success = true;\r\n      return { original: entry, reversal: reversalEntry };\r\n    } finally {\r\n      await finalizeSession(session, ownSession, success);\r\n    }\r\n  };\r\n}\r\n","/**\r\n * Account Repository Factory\r\n *\r\n * Creates a mongokit Repository with seedAccounts/bulkCreate and\r\n * posting-account validation baked in.\r\n * Used by AccountingEngine.createAccountRepository().\r\n */\r\n\r\nimport type { Model, ClientSession } from 'mongoose';\r\nimport type { CountryPack } from '../country/index.js';\r\nimport { Errors } from '../utils/errors.js';\r\nimport { requireOrgScope } from '../utils/tenant-guard.js';\r\n\r\ninterface SeedOptions {\r\n  session?: ClientSession | null;\r\n}\r\n\r\n/**\r\n * Wire seedAccounts, bulkCreate and posting-account validation\r\n * onto an existing mongokit Repository.\r\n *\r\n * @param repository - A mongokit Repository instance (already created)\r\n * @param AccountModel - The Mongoose model for accounts\r\n * @param country - The CountryPack for account type lookups\r\n * @param orgField - The multi-tenant field name (e.g. 'business')\r\n */\r\nexport function wireAccountMethods(\r\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n  repository: any,\r\n  AccountModel: Model<unknown>,\r\n  country: CountryPack,\r\n  orgField?: string,\r\n): void {\r\n  // Validate posting accounts on create\r\n  repository.on('before:create', (ctx: Record<string, unknown>) => {\r\n    const data = ctx.data as Record<string, unknown> | undefined;\r\n    const code = data?.accountTypeCode as string | undefined;\r\n    if (code && !country.isPostingAccount(code)) {\r\n      throw Errors.validation(\r\n        `Cannot create account with type \"${code}\" — it is a structural group or calculated total, not a posting account.`,\r\n      );\r\n    }\r\n  });\r\n\r\n  /**\r\n   * Seed standard posting accounts for an organization.\r\n   */\r\n  repository.seedAccounts = async function (orgId: unknown, options: SeedOptions = {}) {\r\n    requireOrgScope(orgField, orgId);\r\n    const postingTypes = country.getPostingAccountTypes();\r\n    const filter: Record<string, unknown> = {};\r\n    if (orgField && orgId != null) filter[orgField] = orgId;\r\n\r\n    const existing = await AccountModel.find(filter).select('accountNumber').lean() as unknown as Array<{ accountNumber: string }>;\r\n    const existingNumbers = new Set(existing.map(a => a.accountNumber));\r\n\r\n    const toCreate = postingTypes\r\n      .filter(at => !existingNumbers.has(at.code))\r\n      .map(at => {\r\n        const doc: Record<string, unknown> = {\r\n          accountTypeCode: at.code,\r\n          accountNumber: at.code,\r\n          name: at.name,\r\n        };\r\n        if (orgField && orgId != null) doc[orgField] = orgId;\r\n        return doc;\r\n      });\r\n\r\n    if (toCreate.length === 0) return { created: 0, skipped: existingNumbers.size };\r\n\r\n    try {\r\n      // ordered: false ensures a dup-key on one doc doesn't abort the rest\r\n      // (handles concurrent seed calls hitting the unique accountNumber index)\r\n      const inserted = await AccountModel.insertMany(toCreate, {\r\n        session: options.session ?? undefined,\r\n        ordered: false,\r\n      });\r\n      return { created: inserted.length, skipped: existingNumbers.size };\r\n    } catch (err: unknown) {\r\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n      const bulkError = err as any;\r\n      if (bulkError.code === 11000 || bulkError.writeErrors) {\r\n        // Partial success: some docs inserted, some hit dup-key from concurrent caller\r\n        const insertedDocs = bulkError.insertedDocs ?? [];\r\n        return {\r\n          created: insertedDocs.length,\r\n          skipped: existingNumbers.size + (toCreate.length - insertedDocs.length),\r\n        };\r\n      }\r\n      throw err;\r\n    }\r\n  };\r\n\r\n  /**\r\n   * Bulk create accounts with validation and skip-if-exists logic.\r\n   *\r\n   * Uses a single batch query to check existing accounts (instead of N+1),\r\n   * and ordered: false on insertMany to handle concurrent race conditions\r\n   * gracefully (duplicate key errors on individual docs don't abort the batch).\r\n   */\r\n  repository.bulkCreate = async function (\r\n    accounts: Array<{ accountTypeCode?: string; accountNumber?: string; name?: string; active?: boolean; isCashAccount?: boolean }>,\r\n    orgId: unknown,\r\n  ) {\r\n    requireOrgScope(orgField, orgId);\r\n    const results: {\r\n      created: Array<Record<string, unknown>>;\r\n      skipped: Array<Record<string, unknown>>;\r\n      errors: Array<Record<string, unknown>>;\r\n    } = { created: [], skipped: [], errors: [] };\r\n\r\n    // Validate all accounts first (no DB calls)\r\n    const validAccounts: Array<{ index: number; accountTypeCode: string; accountNumber: string; name: string; active: boolean; isCashAccount: boolean }> = [];\r\n\r\n    for (let i = 0; i < accounts.length; i++) {\r\n      const { accountTypeCode, accountNumber, name, active = true, isCashAccount = false } = accounts[i];\r\n\r\n      if (!accountTypeCode) {\r\n        results.errors.push({ index: i, reason: 'accountTypeCode is required' });\r\n        continue;\r\n      }\r\n\r\n      const at = country.getAccountType(accountTypeCode);\r\n      if (!at) {\r\n        results.errors.push({ index: i, accountTypeCode, reason: 'Invalid account type code' });\r\n        continue;\r\n      }\r\n\r\n      if (!country.isPostingAccount(accountTypeCode)) {\r\n        results.errors.push({\r\n          index: i,\r\n          accountTypeCode,\r\n          reason: `Not a posting account (${(at as unknown as Record<string, unknown>).isGroup ? 'group' : 'total'})`,\r\n        });\r\n        continue;\r\n      }\r\n\r\n      const resolvedNumber = accountNumber ?? accountTypeCode;\r\n      const resolvedName = name ?? (at as unknown as Record<string, unknown>).name as string ?? accountTypeCode;\r\n      validAccounts.push({ index: i, accountTypeCode, accountNumber: resolvedNumber, name: resolvedName, active: Boolean(active), isCashAccount: Boolean(isCashAccount) });\r\n    }\r\n\r\n    if (validAccounts.length === 0) {\r\n      return {\r\n        summary: { total: accounts.length, created: 0, skipped: results.skipped.length, errors: results.errors.length },\r\n        ...results,\r\n      };\r\n    }\r\n\r\n    // Single batch query to find all existing accounts by accountNumber for this org\r\n    const numbersToCheck = validAccounts.map(a => a.accountNumber);\r\n    const existsFilter: Record<string, unknown> = { accountNumber: { $in: numbersToCheck } };\r\n    if (orgField && orgId != null) existsFilter[orgField] = orgId;\r\n\r\n    const existingDocs = await AccountModel.find(existsFilter)\r\n      .select('accountNumber')\r\n      .lean() as Array<Record<string, unknown>>;\r\n    const existingNumbers = new Set(existingDocs.map(d => d.accountNumber as string));\r\n\r\n    // Partition into create vs skip\r\n    const toCreate: Array<{ index: number; accountTypeCode: string; accountNumber: string; name: string; active: boolean; isCashAccount: boolean }> = [];\r\n    for (const item of validAccounts) {\r\n      if (existingNumbers.has(item.accountNumber)) {\r\n        results.skipped.push({ index: item.index, accountTypeCode: item.accountTypeCode, reason: 'Already exists' });\r\n      } else {\r\n        toCreate.push(item);\r\n      }\r\n    }\r\n\r\n    if (toCreate.length > 0) {\r\n      const docs = toCreate.map(item => {\r\n        const doc: Record<string, unknown> = {\r\n          accountTypeCode: item.accountTypeCode,\r\n          accountNumber: item.accountNumber,\r\n          name: item.name,\r\n          active: item.active,\r\n          isCashAccount: item.isCashAccount,\r\n        };\r\n        if (orgField && orgId != null) doc[orgField] = orgId;\r\n        return doc;\r\n      });\r\n\r\n      try {\r\n        // ordered: false ensures a dup-key on one doc doesn't abort the rest\r\n        const inserted = await AccountModel.insertMany(docs, { ordered: false });\r\n        results.created = toCreate.map((item, idx) => ({\r\n          accountTypeCode: item.accountTypeCode,\r\n          active: item.active,\r\n          isCashAccount: item.isCashAccount,\r\n          _id: (inserted[idx] as unknown as Record<string, unknown>)._id,\r\n        }));\r\n      } catch (err: unknown) {\r\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n        const bulkError = err as any;\r\n        if (bulkError.code === 11000 || bulkError.writeErrors) {\r\n          // Partial success: some docs inserted, some hit dup-key from concurrent caller\r\n          const insertedDocs = bulkError.insertedDocs ?? [];\r\n          const insertedNumbers = new Set(\r\n            insertedDocs.map((d: Record<string, unknown>) => d.accountNumber as string),\r\n          );\r\n          for (const item of toCreate) {\r\n            if (insertedNumbers.has(item.accountNumber)) {\r\n              const iDoc = insertedDocs.find(\r\n                (d: Record<string, unknown>) => d.accountNumber === item.accountNumber,\r\n              );\r\n              results.created.push({\r\n                accountTypeCode: item.accountTypeCode,\r\n                active: item.active,\r\n                isCashAccount: item.isCashAccount,\r\n                _id: iDoc?._id,\r\n              });\r\n            } else {\r\n              results.skipped.push({\r\n                index: item.index,\r\n                accountTypeCode: item.accountTypeCode,\r\n                reason: 'Already exists (concurrent insert)',\r\n              });\r\n            }\r\n          }\r\n        } else {\r\n          throw err;\r\n        }\r\n      }\r\n    }\r\n\r\n    return {\r\n      summary: {\r\n        total: accounts.length,\r\n        created: results.created.length,\r\n        skipped: results.skipped.length,\r\n        errors: results.errors.length,\r\n      },\r\n      ...results,\r\n    };\r\n  };\r\n}\r\n"],"mappings":"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"}