@classytic/ledger 0.3.0 → 0.4.1

package/README.md

@@ -1,6 +1,6 @@
 # @classytic/ledger
 
-Embeddable double-entry accounting engine for MongoDB. Integer-cents arithmetic, plugin-based, country-agnostic.
+Embeddable double-entry accounting engine for MongoDB. Integer-cents arithmetic, plugin-based, country-agnostic. Extensible journal types, multi-tenant isolation at every layer.
 
 Build QuickBooks, Xero, or TaxCycle-grade apps — the engine handles the accounting, you handle the UX.
 
@@ -15,23 +15,49 @@ npm install @classytic/ledger-bd  # Bangladesh (BFRS, VAT/TDS, Mushak)
 ## Quick Start
 
 ```typescript
+import mongoose from 'mongoose';
 import { createAccountingEngine } from '@classytic/ledger';
 import { canadaPack } from '@classytic/ledger-ca';
 
-const accounting = createAccountingEngine({
+// The engine owns the models — matches flow/promo pattern
+const engine = createAccountingEngine({
+  mongoose: mongoose.connection,
   country: canadaPack,
   currency: 'CAD',
-  multiTenant: { orgField: 'organization', orgRef: 'Organization' },
+  multiTenant: { orgField: 'organizationId', orgRef: 'Organization' },
 });
 
-// Schemas
-const Account = mongoose.model('Account', accounting.createAccountSchema());
-const JournalEntry = mongoose.model('JournalEntry', accounting.createJournalEntrySchema('Account'));
-const FiscalPeriod = mongoose.model('FiscalPeriod', accounting.createFiscalPeriodSchema());
+// Models, repositories, and reports are auto-created
+await engine.repositories.accounts.seedAccounts(orgId);
+const entry = await engine.repositories.journalEntries.post(entryId, orgId);
+const bs = await engine.reports.balanceSheet({ organizationId: orgId, dateOption: 'year', dateValue: 2025 });
+```
+
+### Engine-owned models (recommended)
+
+Pass `mongoose: connection` in config and the engine creates and wires everything:
+
+| Property | What it gives you |
+|----------|-------------------|
+| `engine.models.Account` / `JournalEntry` / `FiscalPeriod` / `Budget` / `Reconciliation` | Mongoose models, ready to query |
+| `engine.repositories.accounts.seedAccounts()` / `bulkCreate()` | Account repo with domain methods |
+| `engine.repositories.journalEntries.post()` / `reverse()` / `unpost()` / `duplicate()` | JE repo with plugins pre-wired (double-entry, fiscal-lock, idempotency) |
+| `engine.repositories.fiscalPeriods` / `budgets` | Plain CRUD repos |
+| `engine.repositories.reconciliations.reconcile()` / `unreconcile()` / `getUnreconciled()` | Reconciliation repo with domain methods |
+| `engine.reports.trialBalance()` / `balanceSheet()` / etc. | All 10 reports, bound to the owned models |
+
+This pattern unblocks framework auto-discovery (Arc `loadResources`, Fastify plugins, etc.) because resources can be defined at module top-level without factory wrappers.
+
+### Low-level (manual schema/model setup)
 
-// Reports
-const reports = accounting.createReports({ Account, JournalEntry });
-const bs = await reports.balanceSheet({ organizationId, dateOption: 'year', dateValue: 2025 });
+If you need custom naming or don't want the engine to own models, omit `mongoose` from config:
+
+```typescript
+const engine = createAccountingEngine({ country: canadaPack, currency: 'CAD' });
+const Account = mongoose.model('GLAccount', engine.createAccountSchema());
+const JournalEntry = mongoose.model('GLEntry', engine.createJournalEntrySchema('GLAccount'));
+const accountRepo = engine.wireAccountRepository(new Repository(Account), Account);
+const reports = engine.createReports({ Account, JournalEntry });
 ```
 
 ## Core Features
@@ -41,8 +67,9 @@ const bs = await reports.balanceSheet({ organizationId, dateOption: 'year', date
 - Integer-cents storage — zero floating-point drift
 - Draft → Posted → Reversed state machine
 - Configurable immutability (corrections only via reversal)
-- Multi-tenant isolation at every layer
+- Multi-tenant isolation at every layer (reports, schemas, repositories)
 - Country packs for localized charts of accounts and tax codes
+- Extensible journal type registry — add domain-specific types (POS, E-Commerce, Payroll) at startup
 
 **10 Reports**
 - Trial Balance (3-column: initial + period + ending)
@@ -155,7 +182,36 @@ taxHookPlugin({
 | `@classytic/ledger/repositories` | Repository wiring |
 | `@classytic/ledger/exports` | CSV export + QuickBooks field maps |
 | `@classytic/ledger/country` | `defineCountryPack`, `CountryPack` interface |
-| `@classytic/ledger/constants` | Categories, journal types, currencies |
+| `@classytic/ledger/constants` | Categories, journal types (+ registry), currencies |
+
+## Extensible Journal Types
+
+The 15 built-in journal types (SALES, PURCHASES, GENERAL, PAYROLL, etc.) cover standard accounting. For domain-specific needs, register custom types **before** schema creation:
+
+```typescript
+import { registerJournalType, getJournalTypeCodes, isValidJournalType } from '@classytic/ledger';
+
+// Register at startup, before createJournalEntrySchema()
+registerJournalType('POS_SALES', {
+  code: 'POS_SALES',
+  name: 'POS Sales Journal',
+  description: 'Daily aggregated point-of-sale transactions',
+});
+
+registerJournalType('ECOM_SALES', {
+  code: 'ECOM_SALES',
+  name: 'E-Commerce Sales Journal',
+  description: 'Per-order online transactions',
+});
+
+// Custom types pass Mongoose enum validation, appear in all lookups
+isValidJournalType('POS_SALES');  // true
+getJournalTypeCodes();            // [...15 built-in, 'POS_SALES', 'ECOM_SALES']
+
+// Reference numbers use the custom type prefix: POS_SALES/2025/03/0001
+```
+
+The registry freezes when `createJournalEntrySchema()` is called. Late registration throws. Built-in types cannot be overridden.
 
 ## Country Packs
 
@@ -180,25 +236,31 @@ Available packs: `@classytic/ledger-ca` (Canada), `@classytic/ledger-bd` (Bangla
 
 ## Testing
 
-949 tests covering unit, integration, and end-to-end scenarios:
-
 ```bash
-npm test                    # run all
-npx vitest run tests/e2e/   # e2e scenarios only
+npm test                           # run all
+npx vitest run tests/e2e/          # e2e scenarios only
+npx vitest run tests/scenarios/    # integration scenarios
+npx vitest run tests/hardening/    # edge cases & invariants
 ```
 
-E2E suites include:
+Test suites cover:
 - Canadian small business full-year lifecycle
 - Multi-currency trading with FX revaluation
-- All plugins + dimensions + budgets + fiscal close
+- Multi-tenant report isolation (org A cannot see org B)
+- Posting pipeline → Trial Balance → Income Statement → Balance Sheet
+- Reversal & correction workflows with audit trail
+- Custom journal type registry → schema → posting pipeline
+- Double-entry conservation law (debit = credit across all entries)
+- Money arithmetic hardening (overflow, penny-leak, float traps)
+- Public API surface & subpath export verification
 - O-Level / A-Level / university textbook accounting problems
 
 ## Requirements
 
 - Node.js >= 22
 - MongoDB (replica set recommended for transactions)
-- Mongoose >= 9
-- @classytic/mongokit >= 3
+- Mongoose >= 9.4.1
+- @classytic/mongokit >= 3.5.3
 
 ## License
 

package/dist/constants/index.d.mts

@@ -1,2 +1,2 @@
-import { _ as getNormalBalance, a as JOURNAL_CODES, b as isValidCategory, c as getJournalTypeCodes, d as CATEGORY_KEYS, f as categoryKey, g as getCategoryStatementType, h as getCategoryMainType, i as isValidCurrency, l as isValidJournalType, m as extractStatementType, n as getCurrency, o as JOURNAL_TYPES, p as extractMainType, r as getMinorUnit, s as getJournalType, t as CURRENCIES, u as CATEGORIES, v as isBalanceSheet, y as isIncomeStatement } from "../currencies-4WAbFRlw.mjs";
-export { CATEGORIES, CATEGORY_KEYS, CURRENCIES, JOURNAL_CODES, JOURNAL_TYPES, categoryKey, extractMainType, extractStatementType, getCategoryMainType, getCategoryStatementType, getCurrency, getJournalType, getJournalTypeCodes, getMinorUnit, getNormalBalance, isBalanceSheet, isIncomeStatement, isValidCategory, isValidCurrency, isValidJournalType };
+import { S as isValidCategory, _ as getCategoryMainType, a as getJournalTypeCodes, b as isBalanceSheet, c as CURRENCIES, d as isValidCurrency, f as CATEGORIES, g as extractStatementType, h as extractMainType, i as getJournalType, l as getCurrency, m as categoryKey, n as JOURNAL_TYPES, o as isValidJournalType, p as CATEGORY_KEYS, r as getCustomJournalTypes, s as registerJournalType, t as JOURNAL_CODES, u as getMinorUnit, v as getCategoryStatementType, x as isIncomeStatement, y as getNormalBalance } from "../journals-DTipb_rz.mjs";
+export { CATEGORIES, CATEGORY_KEYS, CURRENCIES, JOURNAL_CODES, JOURNAL_TYPES, categoryKey, extractMainType, extractStatementType, getCategoryMainType, getCategoryStatementType, getCurrency, getCustomJournalTypes, getJournalType, getJournalTypeCodes, getMinorUnit, getNormalBalance, isBalanceSheet, isIncomeStatement, isValidCategory, isValidCurrency, isValidJournalType, registerJournalType };

package/dist/constants/index.mjs

@@ -1,4 +1,4 @@
-import { a as isValidJournalType, i as getJournalTypeCodes, n as JOURNAL_TYPES, r as getJournalType, t as JOURNAL_CODES } from "../journals-oH-FK3g8.mjs";
-import { a as extractStatementType, c as getNormalBalance, d as isValidCategory, i as extractMainType, l as isBalanceSheet, n as CATEGORY_KEYS, o as getCategoryMainType, r as categoryKey, s as getCategoryStatementType, t as CATEGORIES, u as isIncomeStatement } from "../categories-CclX7Q94.mjs";
+import { a as getJournalType, c as registerJournalType, i as getCustomJournalTypes, n as JOURNAL_TYPES, o as getJournalTypeCodes, s as isValidJournalType, t as JOURNAL_CODES } from "../journals-BfwnCFam.mjs";
+import { a as extractStatementType, c as getNormalBalance, d as isValidCategory, i as extractMainType, l as isBalanceSheet, n as CATEGORY_KEYS, o as getCategoryMainType, r as categoryKey, s as getCategoryStatementType, t as CATEGORIES, u as isIncomeStatement } from "../categories-DWogBUgQ.mjs";
 import { i as isValidCurrency, n as getCurrency, r as getMinorUnit, t as CURRENCIES } from "../currencies-W8kQAkm0.mjs";
-export { CATEGORIES, CATEGORY_KEYS, CURRENCIES, JOURNAL_CODES, JOURNAL_TYPES, categoryKey, extractMainType, extractStatementType, getCategoryMainType, getCategoryStatementType, getCurrency, getJournalType, getJournalTypeCodes, getMinorUnit, getNormalBalance, isBalanceSheet, isIncomeStatement, isValidCategory, isValidCurrency, isValidJournalType };
+export { CATEGORIES, CATEGORY_KEYS, CURRENCIES, JOURNAL_CODES, JOURNAL_TYPES, categoryKey, extractMainType, extractStatementType, getCategoryMainType, getCategoryStatementType, getCurrency, getCustomJournalTypes, getJournalType, getJournalTypeCodes, getMinorUnit, getNormalBalance, isBalanceSheet, isIncomeStatement, isValidCategory, isValidCurrency, isValidJournalType, registerJournalType };

package/dist/{date-lock.plugin-eYAJ9h_u.mjs → date-lock.plugin-DL6pe24p.mjs}

@@ -1,4 +1,4 @@
-import { n as Errors } from "./errors-B7yC-Jfw.mjs";
+import { n as Errors } from "./errors-B_dyYZc_.mjs";
 //#region src/plugins/double-entry.plugin.ts
 function doubleEntryPlugin(options = {}) {
 	const { onlyOnPost = true, JournalEntryModel, AccountModel, orgField } = options;
@@ -36,7 +36,7 @@ function doubleEntryPlugin(options = {}) {
 				const accountIds = items.map((i) => i.account).filter((a) => a != null && a !== "");
 				if (accountIds.length === 0) throw Errors.validation("Posted entry has items with missing accounts.");
 				const selectFields = orgField ? `_id ${orgField}` : "_id";
-				const accounts = await AccountModel.find({ _id: { $in: accountIds } }).select(selectFields).session(context.session ?? null).lean();
+				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 missingCount = accountIds.filter((id) => !foundIds.has(String(id))).length;
 				if (missingCount > 0) throw Errors.validation(`${missingCount} item(s) reference non-existent accounts.`);

package/dist/{engine-Cn-9yerQ.d.mts → engine-scgOvxHJ.d.mts}

@@ -1,5 +1,6 @@
 import { t as CountryPack } from "./index-CxZqRaOU.mjs";
-import { t as Logger } from "./logger-CbHWZl7v.mjs";
+import { t as Logger } from "./logger-UbTdBb1x.mjs";
+import { Connection } from "mongoose";
 
 //#region src/types/engine.d.ts
 /** Multi-tenant configuration */
@@ -68,8 +69,35 @@ interface MultiCurrencyConfig {
   /** Allowed foreign currency codes. If omitted, any ISO 4217 code is accepted. */
   currencies?: readonly string[];
 }
+/**
+ * Override default model names. Useful when you want to avoid collisions
+ * with existing models or use custom naming conventions.
+ */
+interface ModelNames {
+  account?: string;
+  journalEntry?: string;
+  fiscalPeriod?: string;
+  budget?: string;
+  reconciliation?: string;
+}
 /** Main engine configuration */
 interface AccountingEngineConfig {
+  /**
+   * Mongoose connection. Required for `engine.models` and `engine.repositories`
+   * to be auto-populated. If omitted, you must use the low-level schema
+   * factories (`engine.createAccountSchema()`) and register models yourself.
+   */
+  mongoose?: Connection;
+  /** Override default model names (e.g. 'Account' → 'GLAccount') */
+  modelNames?: ModelNames;
+  /** Extra fields / indexes per model */
+  schemaOptions?: {
+    account?: SchemaOptions;
+    journalEntry?: JournalSchemaOptions;
+    fiscalPeriod?: SchemaOptions;
+    budget?: SchemaOptions;
+    reconciliation?: SchemaOptions;
+  };
   /** Country pack providing account types, tax codes, and templates */
   country: CountryPack;
   /** Default ISO 4217 currency code — the functional/base currency (e.g., 'CAD', 'BDT') */
@@ -99,4 +127,4 @@ interface AccountingEngineConfig {
   strictness?: StrictnessConfig;
 }
 //#endregion
-export { MultiTenantConfig as a, MultiCurrencyConfig as i, AuditConfig as n, SchemaOptions as o, JournalSchemaOptions as r, StrictnessConfig as s, AccountingEngineConfig as t };
+export { MultiCurrencyConfig as a, StrictnessConfig as c, ModelNames as i, AuditConfig as n, MultiTenantConfig as o, JournalSchemaOptions as r, SchemaOptions as s, AccountingEngineConfig as t };

package/dist/exports/index.d.mts

@@ -1,2 +1,2 @@
-import { _ as PopulatedJournalEntry, a as exportToCsv, c as getHeaders, d as serializeCsv, f as CsvOptions, g as PopulatedAccount, h as FlatJournalRow, i as flattenJournalEntry, l as buildCsv, m as ExportFieldMap, n as quickbooksFieldMap, o as extractAllRows, p as ExportField, r as flattenJournalEntries, s as extractRow, t as universalFieldMap, u as escapeCell, v as PopulatedJournalItem } from "../index-BPukb3L8.mjs";
+import { _ as PopulatedJournalEntry, a as exportToCsv, c as getHeaders, d as serializeCsv, f as CsvOptions, g as PopulatedAccount, h as FlatJournalRow, i as quickbooksFieldMap, l as buildCsv, m as ExportFieldMap, n as flattenJournalEntry, o as extractAllRows, p as ExportField, r as universalFieldMap, s as extractRow, t as flattenJournalEntries, u as escapeCell, v as PopulatedJournalItem } from "../index-J-XIbXH-.mjs";
 export { CsvOptions, ExportField, ExportFieldMap, FlatJournalRow, PopulatedAccount, PopulatedJournalEntry, PopulatedJournalItem, buildCsv, escapeCell, exportToCsv, extractAllRows, extractRow, flattenJournalEntries, flattenJournalEntry, getHeaders, quickbooksFieldMap, serializeCsv, universalFieldMap };

package/dist/exports/index.mjs

@@ -1,2 +1,2 @@
-import { a as exportToCsv, c as getHeaders, d as serializeCsv, i as flattenJournalEntry, l as buildCsv, n as quickbooksFieldMap, o as extractAllRows, r as flattenJournalEntries, s as extractRow, t as universalFieldMap, u as escapeCell } from "../exports-I5Xkq-9_.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-DoGQQtMQ.mjs";
 export { buildCsv, escapeCell, exportToCsv, extractAllRows, extractRow, flattenJournalEntries, flattenJournalEntry, getHeaders, quickbooksFieldMap, serializeCsv, universalFieldMap };

package/dist/{exports-I5Xkq-9_.mjs → exports-DoGQQtMQ.mjs}

@@ -3,7 +3,7 @@ import { Money } from "./money.mjs";
 const NEEDS_QUOTING = /[",\r\n]/;
 /** Escape a single CSV cell value per RFC 4180. */
 function escapeCell(value) {
-	if (NEEDS_QUOTING.test(value)) return "\"" + value.replace(/"/g, "\"\"") + "\"";
+	if (NEEDS_QUOTING.test(value)) return `"${value.replace(/"/g, "\"\"")}"`;
 	return value;
 }
 /** Serialize a 2D array of strings into a CSV string. */
@@ -18,6 +18,11 @@ function buildCsv(headers, dataRows, options = {}) {
 }
 //#endregion
 //#region src/exports/field-map.ts
+/**
+* Field Map Application — Applies an ExportFieldMap to data rows.
+*
+* @module @classytic/ledger/exports
+*/
 /** Extract headers from a field map. */
 function getHeaders(fieldMap) {
 	return fieldMap.fields.map((f) => f.header);
@@ -35,80 +40,15 @@ function exportToCsv(fieldMap, rows, options) {
 	return buildCsv(getHeaders(fieldMap), extractAllRows(fieldMap, rows), options);
 }
 //#endregion
-//#region src/exports/flatten-journal.ts
-function toDate(value) {
-	if (!value) return /* @__PURE__ */ new Date(0);
-	if (value instanceof Date) return value;
-	return new Date(value);
-}
-function resolveAccount(account) {
-	if (!account) return {
-		id: "",
-		name: "",
-		typeCode: ""
-	};
-	if (typeof account === "string") return {
-		id: account,
-		name: "",
-		typeCode: ""
-	};
-	return {
-		id: String(account._id ?? ""),
-		name: account.name ?? "",
-		typeCode: account.accountTypeCode ?? ""
-	};
-}
-/** Flatten a single journal entry into one FlatJournalRow per journal item. */
-function flattenJournalEntry(entry) {
-	const entryDate = toDate(entry.date);
-	const items = entry.journalItems ?? [];
-	const itemCount = items.length;
-	const KNOWN_ITEM_KEYS = new Set([
-		"account",
-		"label",
-		"date",
-		"debit",
-		"credit",
-		"taxDetails"
-	]);
-	return items.map((item, index) => {
-		const acct = resolveAccount(item.account);
-		const firstTax = item.taxDetails?.[0];
-		const extraItemFields = {};
-		for (const key of Object.keys(item)) if (!KNOWN_ITEM_KEYS.has(key)) extraItemFields[key] = item[key];
-		return {
-			entryId: String(entry._id ?? ""),
-			journalType: entry.journalType ?? "",
-			referenceNumber: entry.referenceNumber ?? "",
-			entryLabel: entry.label ?? "",
-			entryDate,
-			state: entry.state,
-			reversed: entry.reversed ?? false,
-			totalDebit: entry.totalDebit ?? 0,
-			totalCredit: entry.totalCredit ?? 0,
-			accountId: acct.id,
-			accountName: acct.name,
-			accountTypeCode: acct.typeCode,
-			itemLabel: item.label ?? "",
-			itemDate: item.date ? toDate(item.date) : entryDate,
-			debit: item.debit ?? 0,
-			credit: item.credit ?? 0,
-			taxCode: firstTax?.taxCode ?? "",
-			taxName: firstTax?.taxName ?? "",
-			itemIndex: index,
-			itemCount,
-			...extraItemFields
-		};
-	});
-}
-/** Flatten multiple journal entries into a single flat row array. */
-function flattenJournalEntries(entries) {
-	const rows = [];
-	for (const entry of entries) rows.push(...flattenJournalEntry(entry));
-	return rows;
-}
-//#endregion
 //#region src/exports/field-maps/quickbooks.ts
+/**
+* QuickBooks General Journal Import Field Map
+*
+* Produces CSV compatible with QuickBooks Desktop and Online
+* "Import General Journal Entries" feature.
+*
+* @module @classytic/ledger/exports
+*/
 function formatQbDate(date) {
 	return `${String(date.getMonth() + 1).padStart(2, "0")}/${String(date.getDate()).padStart(2, "0")}/${date.getFullYear()}`;
 }
@@ -161,6 +101,14 @@ const quickbooksFieldMap = {
 };
 //#endregion
 //#region src/exports/field-maps/universal.ts
+/**
+* Universal Export Field Map
+*
+* Comprehensive CSV export with all available fields.
+* Useful for data portability, auditing, or spreadsheet import.
+*
+* @module @classytic/ledger/exports
+*/
 function formatIsoDate(date) {
 	return date.toISOString().split("T")[0];
 }
@@ -247,4 +195,77 @@ const universalFieldMap = {
 	]
 };
 //#endregion
-export { exportToCsv as a, getHeaders as c, serializeCsv as d, flattenJournalEntry as i, buildCsv as l, quickbooksFieldMap as n, extractAllRows as o, flattenJournalEntries as r, extractRow as s, universalFieldMap as t, escapeCell as u };
+//#region src/exports/flatten-journal.ts
+function toDate(value) {
+	if (!value) return /* @__PURE__ */ new Date(0);
+	if (value instanceof Date) return value;
+	return new Date(value);
+}
+function resolveAccount(account) {
+	if (!account) return {
+		id: "",
+		name: "",
+		typeCode: ""
+	};
+	if (typeof account === "string") return {
+		id: account,
+		name: "",
+		typeCode: ""
+	};
+	return {
+		id: String(account._id ?? ""),
+		name: account.name ?? "",
+		typeCode: account.accountTypeCode ?? ""
+	};
+}
+/** Flatten a single journal entry into one FlatJournalRow per journal item. */
+function flattenJournalEntry(entry) {
+	const entryDate = toDate(entry.date);
+	const items = entry.journalItems ?? [];
+	const itemCount = items.length;
+	const KNOWN_ITEM_KEYS = new Set([
+		"account",
+		"label",
+		"date",
+		"debit",
+		"credit",
+		"taxDetails"
+	]);
+	return items.map((item, index) => {
+		const acct = resolveAccount(item.account);
+		const firstTax = item.taxDetails?.[0];
+		const extraItemFields = {};
+		for (const key of Object.keys(item)) if (!KNOWN_ITEM_KEYS.has(key)) extraItemFields[key] = item[key];
+		return {
+			entryId: String(entry._id ?? ""),
+			journalType: entry.journalType ?? "",
+			referenceNumber: entry.referenceNumber ?? "",
+			entryLabel: entry.label ?? "",
+			entryDate,
+			state: entry.state,
+			reversed: entry.reversed ?? false,
+			totalDebit: entry.totalDebit ?? 0,
+			totalCredit: entry.totalCredit ?? 0,
+			accountId: acct.id,
+			accountName: acct.name,
+			accountTypeCode: acct.typeCode,
+			itemLabel: item.label ?? "",
+			itemDate: item.date ? toDate(item.date) : entryDate,
+			debit: item.debit ?? 0,
+			credit: item.credit ?? 0,
+			taxCode: firstTax?.taxCode ?? "",
+			taxName: firstTax?.taxName ?? "",
+			itemIndex: index,
+			itemCount,
+			...extraItemFields
+		};
+	});
+}
+/** Flatten multiple journal entries into a single flat row array. */
+function flattenJournalEntries(entries) {
+	const rows = [];
+	for (const entry of entries) rows.push(...flattenJournalEntry(entry));
+	return rows;
+}
+//#endregion
+export { exportToCsv as a, getHeaders as c, serializeCsv as d, quickbooksFieldMap as i, buildCsv as l, flattenJournalEntry as n, extractAllRows as o, universalFieldMap as r, extractRow as s, flattenJournalEntries as t, escapeCell as u };