@classytic/ledger 0.10.0 → 0.10.2

package/dist/index.d.mts

@@ -280,6 +280,39 @@ interface AccountingEngineConfig {
   currency: string;
   /** Multi-tenant configuration. Omit for single-tenant apps. */
   multiTenant?: MultiTenantConfig | undefined;
+  /**
+   * Field name used to stamp every journal entry with the originating
+   * organization / branch — *without* scoping the chart of accounts or any
+   * other collection. Use this for single-company-multi-branch deployments
+   * where Account / FiscalPeriod stay company-wide but each posting needs a
+   * branch attribution for partition-style reports (per-branch P&L, AR aging,
+   * partner ledger).
+   *
+   * When `multiTenant` is set, that takes precedence — `multiTenant.tenantField`
+   * already provides the same stamp and additionally scopes every repository.
+   *
+   * The host MUST declare the field on the JournalEntry schema via
+   * `schemaOptions.journalEntry.extraFields.<field>` (the engine doesn't add
+   * the schema path for you — keeps schema mutation explicit).
+   *
+   * Example:
+   *
+   *   createAccountingEngine({
+   *     // ...no multiTenant — accounts are company-wide
+   *     journalEntryOrgField: 'organizationId',
+   *     schemaOptions: {
+   *       journalEntry: {
+   *         extraFields: {
+   *           organizationId: { type: ObjectId, ref: 'organization', default: null, index: true },
+   *         },
+   *       },
+   *     },
+   *   });
+   *
+   *   await engine.record.sale(branchId, { ... });
+   *   // → JE doc: { organizationId: branchId, ... }
+   */
+  journalEntryOrgField?: string | undefined;
   /** Multi-currency support. Omit for single-currency apps. */
   multiCurrency?: MultiCurrencyConfig | undefined;
   /** Fiscal year start month (1-12, default: 1 = January) */

package/dist/index.mjs

@@ -909,6 +909,14 @@ async function safePublish$3(events, outboxStore, type, payload, ctx) {
 		await events.publish(event);
 	} catch {}
 }
+function isDuplicateKeyBulkError(err) {
+	if (!err || typeof err !== "object") return false;
+	const e = err;
+	if (e.code === 11e3) return true;
+	if (Array.isArray(e.writeErrors) && e.writeErrors.length > 0) return true;
+	if (e.status === 409 && e.duplicate !== void 0) return true;
+	return false;
+}
 /**
 * Wire seedAccounts, bulkCreate and posting-account validation
 * onto an existing mongokit Repository.
@@ -1075,24 +1083,42 @@ function wireAccountMethods(repository, country, orgField, integrations = {}) {
 					_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,
+				if (!isDuplicateKeyBulkError(err)) throw err;
+				const insertedDocs = err.insertedDocs ?? [];
+				const insertedNumbers = new Set(insertedDocs.map((d) => d.accountNumber));
+				const stillUnknown = toCreate.filter((t) => !insertedNumbers.has(t.accountNumber));
+				const concurrentlyPersistedById = /* @__PURE__ */ new Map();
+				if (stillUnknown.length > 0) {
+					const concurrentFilter = { accountNumber: { $in: stillUnknown.map((t) => t.accountNumber) } };
+					if (orgField && orgId != null) concurrentFilter[orgField] = orgId;
+					const persisted = await repository.findAll(concurrentFilter, {
+						select: {
+							_id: 1,
+							accountNumber: 1
+						},
+						lean: true
+					});
+					for (const p of persisted) concurrentlyPersistedById.set(p.accountNumber, p._id);
+				}
+				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,
-						reason: "Already exists (concurrent insert)"
+						active: item.active,
+						isCashAccount: item.isCashAccount,
+						_id: iDoc?._id
 					});
-				} else throw err;
+				} else if (concurrentlyPersistedById.has(item.accountNumber)) results.skipped.push({
+					index: item.index,
+					accountTypeCode: item.accountTypeCode,
+					reason: "Already exists (concurrent insert)",
+					_id: concurrentlyPersistedById.get(item.accountNumber)
+				});
+				else results.skipped.push({
+					index: item.index,
+					accountTypeCode: item.accountTypeCode,
+					reason: "Already exists (concurrent insert)"
+				});
 			}
 		}
 		const summary = {
@@ -2346,6 +2372,7 @@ function buildIntrospectAPI({ models, country, config }) {
 function buildRecordAPI({ models, repositories, config }) {
 	const AccountModel = models.Account;
 	const orgField = config.multiTenant?.tenantField;
+	const journalTagField = orgField ?? config.journalEntryOrgField;
 	const resolveAccounts = async (organizationId, codes, path, session) => {
 		const unique = Array.from(new Set(codes));
 		const filter = { accountTypeCode: { $in: unique } };
@@ -2374,7 +2401,7 @@ function buildRecordAPI({ models, repositories, config }) {
 		}]);
 	};
 	const postEntry = async (organizationId, payload, options) => {
-		if (orgField && organizationId != null) payload[orgField] = organizationId;
+		if (journalTagField && organizationId != null) payload[journalTagField] = organizationId;
 		const actorId = options?.actorId ?? (options?.user ? options.user._id?.toString() ?? options.user.id?.toString() : void 0);
 		if (actorId) {
 			payload.createdBy = actorId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/ledger",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "description": "Production-grade double-entry accounting engine for MongoDB — schemas, reports, tax, multi-tenant",
   "type": "module",
   "sideEffects": false,
@@ -107,6 +107,7 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.12",
+    "@classytic/dev-tools": "^0.2.0",
     "@classytic/fin-io": ">=0.1.0",
     "@classytic/mongokit": ">=3.11.0",
     "@classytic/primitives": ">=0.1.0",
@@ -139,8 +140,10 @@
     "format": "biome format src/ --write",
     "check": "biome ci src/ --diagnostic-level=error",
     "knip": "knip",
+    "push": "classytic-push",
     "smoke": "node scripts/smoke.mjs",
     "prepublishOnly": "npm run check && npm run build && npm run typecheck && npm test && npm run smoke",
-    "release": "npm run check && npm run build && npm run typecheck && npm test && npm run smoke && npm publish --access public"
+    "release:tag": "node -e \"require('child_process').execSync('npm run push -- v'+require('./package.json').version,{stdio:'inherit'})\"",
+    "release": "npm run push -- main && npm run release:tag && npm publish"
   }
 }