@classytic/ledger 0.10.1 → 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

@@ -2372,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 } };
@@ -2400,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.1",
+  "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"
   }
 }