@classytic/ledger 0.2.0 → 0.4.0

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,6 +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 };
-
-//# sourceMappingURL=exports-I5Xkq-9_.mjs.map
+//#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 };