@happyvertical/smrt-cli 0.57.1 → 0.57.3

package/dist/dist-CFZ0g7DU.js

@@ -0,0 +1,1633 @@
+import { a as isTenancyEnabled, d as getTenantId, f as isSuperAdminBypass, i as tenantId, l as withTenantGlobalRead, n as resolvePrompt, o as queryGlobal, r as TenantScoped, s as queryWithGlobals, t as definePrompt } from "./dist-Dj79J8vA.js";
+import { ObjectRegistry, SmrtCollection, SmrtHierarchical, SmrtObject, detectEngine, field, foreignKey, smrt } from "@happyvertical/smrt-core";
+import { BackfillTracker } from "@happyvertical/smrt-core/migrations";
+//#region ../ledgers/dist/chunks/Ledger-DwxK6NRF.js
+var __defProp$4 = Object.defineProperty;
+var __getOwnPropDesc$3 = Object.getOwnPropertyDescriptor;
+var __defNormalProp$3 = (obj, key, value) => key in obj ? __defProp$4(obj, key, {
+	enumerable: true,
+	configurable: true,
+	writable: true,
+	value
+}) : obj[key] = value;
+var __decorateClass$3 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$3(target, key) : target;
+	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+	if (kind && result) __defProp$4(target, key, result);
+	return result;
+};
+var __publicField$3 = (obj, key, value) => __defNormalProp$3(obj, typeof key !== "symbol" ? key + "" : key, value);
+var Ledger = class extends SmrtObject {
+	tenantId = null;
+	name = "";
+	currency = "USD";
+	balanceMode = "tolerant";
+	constructor(options = {}) {
+		super(options);
+		if (options.tenantId !== void 0) this.tenantId = options.tenantId;
+		if (options.name !== void 0) this.name = options.name;
+		if (options.currency !== void 0) this.currency = options.currency;
+		if (options.balanceMode !== void 0) this.balanceMode = options.balanceMode;
+	}
+	async delete() {
+		throw new Error("Ledgers cannot be deleted");
+	}
+	async validateBeforeSave() {
+		await super.validateBeforeSave();
+		this.requireInsertOnSave({ preserveDerivedSlug: true });
+		if (!["tolerant", "exact-integer"].includes(this.balanceMode)) throw new Error("Unknown ledger balance mode");
+		if (this.id) {
+			const stored = await this.db.get(this.tableName, { id: this.id });
+			if (stored && (stored.currency !== this.currency || stored.balance_mode !== this.balanceMode || stored.tenant_id !== this.tenantId)) throw new Error("Ledger currency, balance mode and owner are immutable");
+		}
+		if (!this.name.trim()) throw new Error("Ledger name is required");
+		if (!/^[A-Z]{3}$/.test(this.currency)) throw new Error("Ledger currency must be an uppercase ISO 4217 code");
+	}
+};
+__publicField$3(Ledger, "__smrtPackage__", "@happyvertical/smrt-ledgers");
+__decorateClass$3([tenantId({ nullable: true })], Ledger.prototype, "tenantId", 2);
+__decorateClass$3([field({ description: "The accounting scope name." })], Ledger.prototype, "name", 2);
+__decorateClass$3([field({ description: "ISO 4217 currency used by this ledger." })], Ledger.prototype, "currency", 2);
+__decorateClass$3([field({ description: "tolerant accepts decimal units; exact requires integer minor units." })], Ledger.prototype, "balanceMode", 2);
+Ledger = __decorateClass$3([TenantScoped({ mode: "optional" }), smrt({
+	api: { include: [
+		"list",
+		"get",
+		"create",
+		"update"
+	] },
+	mcp: { include: [
+		"list",
+		"get",
+		"create"
+	] },
+	cli: { skipApiCheck: true }
+})], Ledger);
+//#endregion
+//#region ../ledgers/dist/chunks/Account-IFuMKhPt.js
+var __defProp$3 = Object.defineProperty;
+var __getOwnPropDesc$2 = Object.getOwnPropertyDescriptor;
+var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$3(obj, key, {
+	enumerable: true,
+	configurable: true,
+	writable: true,
+	value
+}) : obj[key] = value;
+var __decorateClass$2 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$2(target, key) : target;
+	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+	if (kind && result) __defProp$3(target, key, result);
+	return result;
+};
+var __publicField$2 = (obj, key, value) => __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
+var Account = class extends SmrtHierarchical {
+	tenantId = null;
+	number = "";
+	name = "";
+	description = "";
+	type = "asset";
+	ledgerId = null;
+	active = true;
+	/**
+	* Extensible metadata
+	*/
+	metadata = {};
+	constructor(options = {}) {
+		super(options);
+		if (options.tenantId !== void 0) this.tenantId = options.tenantId;
+		if (options.number !== void 0) this.number = options.number;
+		if (options.name !== void 0) this.name = options.name;
+		if (options.description !== void 0) this.description = options.description;
+		if (options.type !== void 0) this.type = options.type;
+		if (options.ledgerId !== void 0) this.ledgerId = options.ledgerId;
+		if (options.parentId !== void 0) this.parentId = options.parentId;
+		if (options.active !== void 0) this.active = options.active;
+		if (options.metadata !== void 0) this.metadata = options.metadata;
+	}
+	async validateBeforeSave() {
+		await super.validateBeforeSave();
+		this.requireInsertOnSave({ preserveDerivedSlug: true });
+		if (this.ledgerId) {
+			const { LedgerCollection } = await import("./dist-CFZ0g7DU.js").then((n) => n.t);
+			const ledger = await (await LedgerCollection.create(this.options)).get({ id: this.ledgerId }, { cache: false });
+			const owner = this.tenantId ?? (isTenancyEnabled() && !isSuperAdminBypass() ? getTenantId() ?? null : null);
+			if (!ledger || ledger.tenantId !== owner) throw new Error("Scoped account requires an accessible ledger with the same owner");
+		}
+		if (this.id) {
+			const stored = await this.db.get(this.tableName, { id: this.id });
+			if (stored && (stored.ledger_id !== this.ledgerId || stored.ledger_id && (stored.tenant_id !== this.tenantId || stored.type !== this.type))) throw new Error("Ledger account scope, owner and type are immutable");
+		}
+	}
+	async delete(options = {}) {
+		if ((this.id ? await this.db.get(this.tableName, { id: this.id }) : null)?.ledger_id) throw new Error("Ledger accounts cannot be deleted; deactivate them instead");
+		await super.delete(options);
+	}
+	/**
+	* Check if this is a top-level account (no parent)
+	*/
+	isTopLevel() {
+		return this.parentId === null;
+	}
+	/**
+	* Check if this is a debit-normal account (Asset, Expense)
+	* Debit-normal accounts increase with debits
+	*/
+	isDebitNormal() {
+		return this.type === "asset" || this.type === "expense";
+	}
+	/**
+	* Check if this is a credit-normal account (Liability, Equity, Revenue)
+	* Credit-normal accounts increase with credits
+	*/
+	isCreditNormal() {
+		return this.type === "liability" || this.type === "equity" || this.type === "revenue";
+	}
+	/**
+	* Get full account path (e.g., "Assets > Current > Cash")
+	*/
+	async getFullPath() {
+		return [...(await this.getAncestors()).map((a) => a.name), this.name].join(" > ");
+	}
+	/**
+	* Build tree node for this account and its children
+	*/
+	async toTreeNode() {
+		const children = await this.getChildren();
+		const childNodes = await Promise.all(children.map((c) => c.toTreeNode()));
+		return {
+			account: this,
+			children: childNodes
+		};
+	}
+	/**
+	* Get the current balance of this account
+	*/
+	async getBalance(asOfDate) {
+		if (!this.id) return 0;
+		const { JournalEntryCollection } = await import("./dist-CFZ0g7DU.js").then((n) => n.n);
+		return await (await JournalEntryCollection.create(this.options)).getAccountBalance(this.id, asOfDate);
+	}
+	/**
+	* Create a sub-account under this account
+	*/
+	async createChild(options) {
+		if (!this.id) throw new Error("Account must be saved before creating children");
+		const { AccountCollection } = await import("./dist-CFZ0g7DU.js").then((n) => n.r);
+		const collection = await AccountCollection.create(this.options);
+		const parent = await collection.get({ id: this.id }, { cache: false });
+		if (!parent) throw new Error("Parent account must be persisted and accessible");
+		if (parent.ledgerId && (options.ledgerId !== void 0 && options.ledgerId !== parent.ledgerId || options.tenantId !== void 0 && options.tenantId !== parent.tenantId)) throw new Error("Scoped children must inherit the parent ledger and owner");
+		const account = await collection.create({
+			...options,
+			...parent.ledgerId ? {
+				ledgerId: parent.ledgerId,
+				tenantId: parent.tenantId
+			} : {},
+			parentId: parent.id,
+			type: parent.type
+		});
+		await account.save();
+		return account;
+	}
+};
+__publicField$2(Account, "__smrtPackage__", "@happyvertical/smrt-ledgers");
+__decorateClass$2([tenantId({ nullable: true })], Account.prototype, "tenantId", 2);
+__decorateClass$2([field({ description: "The account number in your chart of accounts." })], Account.prototype, "number", 2);
+__decorateClass$2([field({ description: "What the account is called." })], Account.prototype, "name", 2);
+__decorateClass$2([field({ description: "What the account is used for." })], Account.prototype, "description", 2);
+__decorateClass$2([field({ description: "asset, liability, equity, revenue or expense." })], Account.prototype, "type", 2);
+__decorateClass$2([field({
+	description: "The ledger policy this account belongs to.",
+	nullable: true
+}), foreignKey(Ledger)], Account.prototype, "ledgerId", 2);
+__decorateClass$2([field({ description: "Whether the account is in use; deactivate it instead of deleting it." })], Account.prototype, "active", 2);
+Account = __decorateClass$2([TenantScoped({ mode: "optional" }), smrt({
+	tableName: "ledger_accounts",
+	api: { include: [
+		"list",
+		"get",
+		"create",
+		"update",
+		"delete"
+	] },
+	mcp: { include: [
+		"list",
+		"get",
+		"create"
+	] },
+	cli: { skipApiCheck: true }
+})], Account);
+//#endregion
+//#region ../ledgers/dist/types.js
+var BALANCE_EPSILON = .001;
+//#endregion
+//#region ../ledgers/dist/index.js
+var __defProp$2 = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp$2(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp$2(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+ObjectRegistry.registerPackageManifest(JSON.parse(`{"version":"1.0.0","timestamp":0,"packageName":"@happyvertical/smrt-ledgers","packageVersion":"0.57.3","objects":{"@happyvertical/smrt-ledgers:AccountCollection":{"name":"accountcollection","className":"AccountCollection","qualifiedName":"@happyvertical/smrt-ledgers:AccountCollection","collection":"accounts","filePath":"/home/runner/work/smrt/smrt/packages/ledgers/src/collections/Accounts.ts","packageName":"@happyvertical/smrt-ledgers","fields":{},"methods":{"findByNumber":{"name":"findByNumber","async":true,"parameters":[{"name":"number","type":"string","optional":false}],"returnType":"Promise<Account | null>","isStatic":false,"isPublic":true},"findByType":{"name":"findByType","async":true,"parameters":[{"name":"type","type":"AccountType","optional":false}],"returnType":"Promise<Account[]>","isStatic":false,"isPublic":true},"findActive":{"name":"findActive","async":true,"parameters":[],"returnType":"Promise<Account[]>","isStatic":false,"isPublic":true},"findTopLevel":{"name":"findTopLevel","async":true,"parameters":[],"returnType":"Promise<Account[]>","isStatic":false,"isPublic":true},"findChildren":{"name":"findChildren","async":true,"parameters":[{"name":"parentId","type":"string","optional":false}],"returnType":"Promise<Account[]>","isStatic":false,"isPublic":true},"getTree":{"name":"getTree","async":true,"parameters":[],"returnType":"Promise<AccountTree>","isStatic":false,"isPublic":true},"getOrCreateByNumber":{"name":"getOrCreateByNumber","async":true,"parameters":[{"name":"number","type":"string","optional":false},{"name":"defaults","type":"Partial<object>","optional":true,"memberTypes":["string","AccountType","string | null"]}],"returnType":"Promise<Account>","isStatic":false,"isPublic":true},"groupByType":{"name":"groupByType","async":true,"parameters":[],"returnType":"Promise<Record<AccountType, Account[]>>","isStatic":false,"isPublic":true},"getDescendants":{"name":"getDescendants","async":true,"parameters":[{"name":"accountId","type":"string","optional":false}],"returnType":"Promise<Account[]>","isStatic":false,"isPublic":true},"findByTenant":{"name":"findByTenant","async":true,"parameters":[{"name":"tenantId","type":"string","optional":false}],"returnType":"Promise<Account[]>","isStatic":false,"isPublic":true},"findGlobal":{"name":"findGlobal","async":true,"parameters":[],"returnType":"Promise<Account[]>","isStatic":false,"isPublic":true},"findWithGlobals":{"name":"findWithGlobals","async":true,"parameters":[{"name":"tenantId","type":"string","optional":false}],"returnType":"Promise<Account[]>","isStatic":false,"isPublic":true}},"decoratorConfig":{"tableName":"ledger_accounts","api":{"include":["list","get","create","update","delete"]},"mcp":{"include":["list","get","create"]}},"extends":"SmrtCollection","extendsTypeArg":"Account","exportName":"AccountCollection","collectionExportName":"AccountCollectionCollection","schema":{"tableName":"ledger_accounts","ddl":"CREATE TABLE IF NOT EXISTS \\"ledger_accounts\\" (\\n  \\"id\\" UUID PRIMARY KEY NOT NULL,\\n  \\"slug\\" TEXT NOT NULL,\\n  \\"context\\" TEXT NOT NULL DEFAULT '',\\n  \\"created_at\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\"updated_at\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\"parent_id\\" UUID,\\n  \\"tenant_id\\" UUID,\\n  \\"number\\" TEXT DEFAULT '',\\n  \\"name\\" TEXT DEFAULT '',\\n  \\"description\\" TEXT DEFAULT '',\\n  \\"type\\" TEXT DEFAULT 'asset',\\n  \\"ledger_id\\" UUID,\\n  \\"active\\" BOOLEAN DEFAULT TRUE,\\n  \\"metadata\\" JSON DEFAULT '{}'\\n);","columns":{"id":{"type":"UUID","primaryKey":true,"referenceKind":"id","notNull":true},"slug":{"type":"TEXT","notNull":true},"context":{"type":"TEXT","notNull":true,"default":""},"created_at":{"type":"TIMESTAMP","notNull":true,"default":"current_timestamp"},"updated_at":{"type":"TIMESTAMP","notNull":true,"default":"current_timestamp"},"parent_id":{"type":"UUID","referenceKind":"foreignKey","notNull":false,"unique":false,"foreignKey":{"table":"ledger_accounts","column":"id","onDelete":"NO ACTION","onUpdate":"CASCADE"}},"tenant_id":{"type":"UUID","referenceKind":"tenantId","notNull":false,"unique":false},"number":{"type":"TEXT","notNull":false,"unique":false,"default":""},"name":{"type":"TEXT","notNull":false,"unique":false,"default":""},"description":{"type":"TEXT","notNull":false,"unique":false,"default":""},"type":{"type":"TEXT","notNull":false,"unique":false,"default":"asset"},"ledger_id":{"type":"UUID","referenceKind":"foreignKey","notNull":false,"unique":false,"foreignKey":{"table":"ledgers","column":"id","onDelete":"NO ACTION","onUpdate":"CASCADE"}},"active":{"type":"BOOLEAN","notNull":false,"unique":false,"default":true},"metadata":{"type":"JSON","notNull":false,"unique":false,"default":{}}},"indexes":[{"name":"ledger_accounts_slug_context_idx","columns":["tenant_id","slug","context"],"unique":true,"nullsNotDistinct":true},{"name":"ledger_accounts_tenant_id_created_at_idx","columns":["tenant_id","created_at"]},{"name":"ledger_accounts_parent_id_idx","columns":["parent_id"]},{"name":"ledger_accounts_ledger_id_idx","columns":["ledger_id"]}],"version":"caea63eb"},"importPath":"@happyvertical/smrt-ledgers"},"@happyvertical/smrt-ledgers:JournalEntryCollection":{"name":"journalentrycollection","className":"JournalEntryCollection","qualifiedName":"@happyvertical/smrt-ledgers:JournalEntryCollection","collection":"journalentries","filePath":"/home/runner/work/smrt/smrt/packages/ledgers/src/collections/JournalEntries.ts","packageName":"@happyvertical/smrt-ledgers","fields":{},"methods":{"findByJournal":{"name":"findByJournal","async":true,"parameters":[{"name":"journalId","type":"string","optional":false}],"returnType":"Promise<JournalEntry[]>","isStatic":false,"isPublic":true},"findByAccount":{"name":"findByAccount","async":true,"parameters":[{"name":"accountId","type":"string","optional":false}],"returnType":"Promise<JournalEntry[]>","isStatic":false,"isPublic":true},"getCounterpartyBalances":{"name":"getCounterpartyBalances","async":true,"parameters":[{"name":"options","type":"PostedJournalMovementOptions","optional":false}],"returnType":"Promise<CounterpartyBalance[]>","isStatic":false,"isPublic":true},"getCounterpartyAging":{"name":"getCounterpartyAging","async":true,"parameters":[{"name":"options","type":"PostedJournalMovementOptions","optional":false},{"name":"asOf","type":"Date","optional":false}],"returnType":"Promise<CounterpartyAgingRow[]>","isStatic":false,"isPublic":true},"getAccountBalance":{"name":"getAccountBalance","async":true,"parameters":[{"name":"accountId","type":"string","optional":false},{"name":"asOfDate","type":"Date","optional":true}],"returnType":"Promise<number>","isStatic":false,"isPublic":true},"getTrialBalance":{"name":"getTrialBalance","async":true,"parameters":[{"name":"asOfDate","type":"Date","optional":true}],"returnType":"Promise<TrialBalanceRow[]>","isStatic":false,"isPublic":true},"getTotalsForDateRange":{"name":"getTotalsForDateRange","async":true,"parameters":[{"name":"start","type":"Date","optional":false},{"name":"end","type":"Date","optional":false}],"returnType":"Promise<object>","isStatic":false,"isPublic":true},"findByAccounts":{"name":"findByAccounts","async":true,"parameters":[{"name":"accountIds","type":"string[]","optional":false}],"returnType":"Promise<JournalEntry[]>","isStatic":false,"isPublic":true},"listPostedMovements":{"name":"listPostedMovements","async":true,"parameters":[{"name":"options","type":"PostedJournalMovementOptions","optional":false}],"returnType":"Promise<PostedJournalMovement[]>","isStatic":false,"isPublic":true},"getAccountLedger":{"name":"getAccountLedger","async":true,"parameters":[{"name":"accountId","type":"string","optional":false}],"returnType":"Promise<Array<object>>","isStatic":false,"isPublic":true},"findByTenant":{"name":"findByTenant","async":true,"parameters":[{"name":"tenantId","type":"string","optional":false}],"returnType":"Promise<JournalEntry[]>","isStatic":false,"isPublic":true},"findGlobal":{"name":"findGlobal","async":true,"parameters":[],"returnType":"Promise<JournalEntry[]>","isStatic":false,"isPublic":true},"findWithGlobals":{"name":"findWithGlobals","async":true,"parameters":[{"name":"tenantId","type":"string","optional":false}],"returnType":"Promise<JournalEntry[]>","isStatic":false,"isPublic":true}},"decoratorConfig":{"api":{"include":["list","get"]},"mcp":{"include":["list","get"]}},"extends":"SmrtCollection","extendsTypeArg":"JournalEntry","exportName":"JournalEntryCollection","collectionExportName":"JournalEntryCollectionCollection","schema":{"tableName":"journal_entries","ddl":"CREATE TABLE IF NOT EXISTS \\"journal_entries\\" (\\n  \\"id\\" UUID PRIMARY KEY NOT NULL,\\n  \\"slug\\" TEXT NOT NULL,\\n  \\"context\\" TEXT NOT NULL DEFAULT '',\\n  \\"created_at\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\"updated_at\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\"tenant_id\\" UUID,\\n  \\"journal_id\\" UUID,\\n  \\"account_id\\" UUID,\\n  \\"counterparty_kind\\" TEXT,\\n  \\"counterparty_id\\" TEXT,\\n  \\"due_date\\" TIMESTAMP,\\n  \\"settles_source_ref\\" TEXT,\\n  \\"debit\\" REAL DEFAULT 0,\\n  \\"credit\\" REAL DEFAULT 0,\\n  \\"currency\\" TEXT DEFAULT 'USD',\\n  \\"exchange_rate\\" REAL DEFAULT 1,\\n  \\"memo\\" TEXT DEFAULT '',\\n  \\"metadata\\" JSON DEFAULT '{}'\\n);","columns":{"id":{"type":"UUID","primaryKey":true,"referenceKind":"id","notNull":true},"slug":{"type":"TEXT","notNull":true},"context":{"type":"TEXT","notNull":true,"default":""},"created_at":{"type":"TIMESTAMP","notNull":true,"default":"current_timestamp"},"updated_at":{"type":"TIMESTAMP","notNull":true,"default":"current_timestamp"},"tenant_id":{"type":"UUID","referenceKind":"tenantId","notNull":false,"unique":false},"journal_id":{"type":"UUID","referenceKind":"foreignKey","notNull":false,"unique":false,"foreignKey":{"table":"journals","column":"id","onDelete":"NO ACTION","onUpdate":"CASCADE"}},"account_id":{"type":"UUID","referenceKind":"foreignKey","notNull":false,"unique":false,"foreignKey":{"table":"ledger_accounts","column":"id","onDelete":"NO ACTION","onUpdate":"CASCADE"}},"counterparty_kind":{"type":"TEXT","notNull":false,"unique":false},"counterparty_id":{"type":"TEXT","notNull":false,"unique":false},"due_date":{"type":"TIMESTAMP","notNull":false,"unique":false},"settles_source_ref":{"type":"TEXT","notNull":false,"unique":false},"debit":{"type":"REAL","notNull":false,"unique":false,"default":0},"credit":{"type":"REAL","notNull":false,"unique":false,"default":0},"currency":{"type":"TEXT","notNull":false,"unique":false,"default":"USD"},"exchange_rate":{"type":"REAL","notNull":false,"unique":false,"default":1},"memo":{"type":"TEXT","notNull":false,"unique":false,"default":""},"metadata":{"type":"JSON","notNull":false,"unique":false,"default":{}}},"indexes":[{"name":"journal_entries_slug_context_idx","columns":["tenant_id","slug","context"],"unique":true,"nullsNotDistinct":true},{"name":"journal_entries_tenant_id_created_at_idx","columns":["tenant_id","created_at"]},{"name":"journal_entries_journal_id_idx","columns":["journal_id"]},{"name":"journal_entries_account_id_idx","columns":["account_id"]}],"version":"e96b76a2"},"importPath":"@happyvertical/smrt-ledgers"},"@happyvertical/smrt-ledgers:JournalCollection":{"name":"journalcollection","className":"JournalCollection","qualifiedName":"@happyvertical/smrt-ledgers:JournalCollection","collection":"journals","filePath":"/home/runner/work/smrt/smrt/packages/ledgers/src/collections/Journals.ts","packageName":"@happyvertical/smrt-ledgers","fields":{},"methods":{"findByNumber":{"name":"findByNumber","async":true,"parameters":[{"name":"number","type":"string","optional":false}],"returnType":"Promise<Journal | null>","isStatic":false,"isPublic":true},"findByDateRange":{"name":"findByDateRange","async":true,"parameters":[{"name":"start","type":"Date","optional":false},{"name":"end","type":"Date","optional":false}],"returnType":"Promise<Journal[]>","isStatic":false,"isPublic":true},"findBySource":{"name":"findBySource","async":true,"parameters":[{"name":"sourceModule","type":"string","optional":false}],"returnType":"Promise<Journal[]>","isStatic":false,"isPublic":true},"findByStatus":{"name":"findByStatus","async":true,"parameters":[{"name":"status","type":"JournalStatus","optional":false}],"returnType":"Promise<Journal[]>","isStatic":false,"isPublic":true},"findDrafts":{"name":"findDrafts","async":true,"parameters":[],"returnType":"Promise<Journal[]>","isStatic":false,"isPublic":true},"findPosted":{"name":"findPosted","async":true,"parameters":[],"returnType":"Promise<Journal[]>","isStatic":false,"isPublic":true},"createWithEntries":{"name":"createWithEntries","async":true,"parameters":[{"name":"data","type":"CreateJournalData","optional":false}],"returnType":"Promise<Journal>","isStatic":false,"isPublic":true},"post":{"name":"post","async":true,"parameters":[{"name":"journalId","type":"string","optional":false}],"returnType":"Promise<Journal>","isStatic":false,"isPublic":true},"void":{"name":"void","async":true,"parameters":[{"name":"journalId","type":"string","optional":false},{"name":"reason","type":"string","optional":false}],"returnType":"Promise<Journal>","isStatic":false,"isPublic":true},"findBySourceRef":{"name":"findBySourceRef","async":true,"parameters":[{"name":"sourceRef","type":"string","optional":false}],"returnType":"Promise<Journal[]>","isStatic":false,"isPublic":true},"findByMonth":{"name":"findByMonth","async":true,"parameters":[{"name":"year","type":"number","optional":false},{"name":"month","type":"number","optional":false}],"returnType":"Promise<Journal[]>","isStatic":false,"isPublic":true},"findByTenant":{"name":"findByTenant","async":true,"parameters":[{"name":"tenantId","type":"string","optional":false}],"returnType":"Promise<Journal[]>","isStatic":false,"isPublic":true},"findGlobal":{"name":"findGlobal","async":true,"parameters":[],"returnType":"Promise<Journal[]>","isStatic":false,"isPublic":true},"findWithGlobals":{"name":"findWithGlobals","async":true,"parameters":[{"name":"tenantId","type":"string","optional":false}],"returnType":"Promise<Journal[]>","isStatic":false,"isPublic":true}},"decoratorConfig":{"api":{"include":["list","get","create"]},"mcp":{"include":["list","get","create"]}},"extends":"SmrtCollection","extendsTypeArg":"Journal","exportName":"JournalCollection","collectionExportName":"JournalCollectionCollection","schema":{"tableName":"journals","ddl":"CREATE TABLE IF NOT EXISTS \\"journals\\" (\\n  \\"id\\" UUID PRIMARY KEY NOT NULL,\\n  \\"slug\\" TEXT NOT NULL,\\n  \\"context\\" TEXT NOT NULL DEFAULT '',\\n  \\"created_at\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\"updated_at\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\"tenant_id\\" UUID,\\n  \\"number\\" TEXT DEFAULT '',\\n  \\"date\\" TIMESTAMP,\\n  \\"description\\" TEXT DEFAULT '',\\n  \\"source_module\\" TEXT DEFAULT '',\\n  \\"source_ref\\" TEXT,\\n  \\"ledger_id\\" UUID,\\n  \\"idempotency_key\\" TEXT,\\n  \\"request_digest\\" TEXT,\\n  \\"status\\" TEXT DEFAULT 'draft',\\n  \\"posted_at\\" TIMESTAMP,\\n  \\"voided_at\\" TIMESTAMP,\\n  \\"void_reason\\" TEXT,\\n  \\"metadata\\" JSON DEFAULT '{}'\\n);","columns":{"id":{"type":"UUID","primaryKey":true,"referenceKind":"id","notNull":true},"slug":{"type":"TEXT","notNull":true},"context":{"type":"TEXT","notNull":true,"default":""},"created_at":{"type":"TIMESTAMP","notNull":true,"default":"current_timestamp"},"updated_at":{"type":"TIMESTAMP","notNull":true,"default":"current_timestamp"},"tenant_id":{"type":"UUID","referenceKind":"tenantId","notNull":false,"unique":false},"number":{"type":"TEXT","notNull":false,"unique":false,"default":""},"date":{"type":"TIMESTAMP","notNull":false,"unique":false},"description":{"type":"TEXT","notNull":false,"unique":false,"default":""},"source_module":{"type":"TEXT","notNull":false,"unique":false,"default":""},"source_ref":{"type":"TEXT","notNull":false,"unique":false},"ledger_id":{"type":"UUID","referenceKind":"foreignKey","notNull":false,"unique":false,"foreignKey":{"table":"ledgers","column":"id","onDelete":"NO ACTION","onUpdate":"CASCADE"}},"idempotency_key":{"type":"TEXT","notNull":false,"unique":false},"request_digest":{"type":"TEXT","notNull":false,"unique":false},"status":{"type":"TEXT","notNull":false,"unique":false,"default":"draft"},"posted_at":{"type":"TIMESTAMP","notNull":false,"unique":false},"voided_at":{"type":"TIMESTAMP","notNull":false,"unique":false},"void_reason":{"type":"TEXT","notNull":false,"unique":false},"metadata":{"type":"JSON","notNull":false,"unique":false,"default":{}}},"indexes":[{"name":"journals_slug_context_idx","columns":["tenant_id","slug","context"],"unique":true,"nullsNotDistinct":true},{"name":"journals_ledger_idempotency_key","columns":["tenant_id","ledger_id","idempotency_key"],"unique":true},{"name":"journals_tenant_id_created_at_idx","columns":["tenant_id","created_at"]},{"name":"journals_ledger_id_idx","columns":["ledger_id"]}],"version":"1e73dd60"},"importPath":"@happyvertical/smrt-ledgers"},"@happyvertical/smrt-ledgers:LedgerCollection":{"name":"ledgercollection","className":"LedgerCollection","qualifiedName":"@happyvertical/smrt-ledgers:LedgerCollection","collection":"ledgers","filePath":"/home/runner/work/smrt/smrt/packages/ledgers/src/collections/Ledgers.ts","packageName":"@happyvertical/smrt-ledgers","fields":{},"methods":{},"decoratorConfig":{"api":{"include":["list","get","create","update"]},"mcp":{"include":["list","get","create"]}},"extends":"SmrtCollection","extendsTypeArg":"Ledger","exportName":"LedgerCollection","collectionExportName":"LedgerCollectionCollection","schema":{"tableName":"ledgers","ddl":"CREATE TABLE IF NOT EXISTS \\"ledgers\\" (\\n  \\"id\\" UUID PRIMARY KEY NOT NULL,\\n  \\"slug\\" TEXT NOT NULL,\\n  \\"context\\" TEXT NOT NULL DEFAULT '',\\n  \\"created_at\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\"updated_at\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\"tenant_id\\" UUID,\\n  \\"name\\" TEXT,\\n  \\"currency\\" TEXT,\\n  \\"balance_mode\\" TEXT DEFAULT 'tolerant'\\n);","columns":{"id":{"type":"UUID","primaryKey":true,"referenceKind":"id","notNull":true},"slug":{"type":"TEXT","notNull":true},"context":{"type":"TEXT","notNull":true,"default":""},"created_at":{"type":"TIMESTAMP","notNull":true,"default":"current_timestamp"},"updated_at":{"type":"TIMESTAMP","notNull":true,"default":"current_timestamp"},"tenant_id":{"type":"UUID","referenceKind":"tenantId","notNull":false,"unique":false},"name":{"type":"TEXT","notNull":false,"unique":false},"currency":{"type":"TEXT","notNull":false,"unique":false},"balance_mode":{"type":"TEXT","notNull":false,"unique":false,"default":"tolerant"}},"indexes":[{"name":"ledgers_slug_context_idx","columns":["tenant_id","slug","context"],"unique":true,"nullsNotDistinct":true},{"name":"ledgers_tenant_id_created_at_idx","columns":["tenant_id","created_at"]}],"version":"be316e4f"},"importPath":"@happyvertical/smrt-ledgers"},"@happyvertical/smrt-ledgers:Account":{"name":"account","className":"Account","qualifiedName":"@happyvertical/smrt-ledgers:Account","collection":"accounts","filePath":"/home/runner/work/smrt/smrt/packages/ledgers/src/models/Account.ts","packageName":"@happyvertical/smrt-ledgers","fields":{"parentId":{"type":"foreignKey","required":false,"related":"Account","_meta":{"nullable":true}},"tenantId":{"type":"text","required":false,"_meta":{"sqlType":"UUID","nullable":true,"__tenancy":{"isTenantIdField":true,"autoFilter":true,"required":false,"autoPopulate":true,"nullable":true,"mode":"optional","field":"tenantId","allowSuperAdminBypass":false}}},"number":{"type":"text","required":false,"default":"","description":"The account number in your chart of accounts.","_meta":{"description":"The account number in your chart of accounts."}},"name":{"type":"text","required":false,"default":"","description":"What the account is called.","_meta":{"description":"What the account is called."}},"description":{"type":"text","required":false,"default":"","description":"What the account is used for.","_meta":{"description":"What the account is used for."}},"type":{"type":"text","required":false,"default":"asset","description":"asset, liability, equity, revenue or expense.","_meta":{"description":"asset, liability, equity, revenue or expense."},"enum":["asset","liability","equity","revenue","expense"]},"ledgerId":{"type":"foreignKey","required":false,"related":"Ledger","description":"The ledger policy this account belongs to.","_meta":{"description":"The ledger policy this account belongs to.","nullable":true}},"active":{"type":"boolean","required":false,"default":true,"description":"Whether the account is in use; deactivate it instead of deleting it.","_meta":{"description":"Whether the account is in use; deactivate it instead of deleting it."}},"metadata":{"type":"json","required":false,"default":{}}},"methods":{"getParent":{"name":"getParent","async":true,"parameters":[],"returnType":"Promise<this | null>","isStatic":false,"isPublic":true},"getChildren":{"name":"getChildren","async":true,"parameters":[],"returnType":"Promise<this[]>","isStatic":false,"isPublic":true},"getAncestors":{"name":"getAncestors","async":true,"parameters":[],"returnType":"Promise<this[]>","isStatic":false,"isPublic":true},"getDescendants":{"name":"getDescendants","async":true,"parameters":[],"returnType":"Promise<this[]>","isStatic":false,"isPublic":true},"getHierarchy":{"name":"getHierarchy","async":true,"parameters":[],"returnType":"Promise<HierarchyView<this>>","isStatic":false,"isPublic":true},"moveTo":{"name":"moveTo","async":true,"parameters":[{"name":"newParent","type":"this | string | null","optional":false,"unionBranches":[{"type":"this"},{"type":"string"},{"type":"null"}]}],"returnType":"Promise<void>","isStatic":false,"isPublic":true},"delete":{"name":"delete","async":true,"parameters":[{"name":"options","type":"any","optional":true,"typeUnresolved":true}],"returnType":"Promise<void>","isStatic":false,"isPublic":true},"isTopLevel":{"name":"isTopLevel","async":false,"parameters":[],"returnType":"boolean","isStatic":false,"isPublic":true},"isDebitNormal":{"name":"isDebitNormal","async":false,"parameters":[],"returnType":"boolean","isStatic":false,"isPublic":true},"isCreditNormal":{"name":"isCreditNormal","async":false,"parameters":[],"returnType":"boolean","isStatic":false,"isPublic":true},"getFullPath":{"name":"getFullPath","async":true,"parameters":[],"returnType":"Promise<string>","isStatic":false,"isPublic":true},"toTreeNode":{"name":"toTreeNode","async":true,"parameters":[],"returnType":"Promise<AccountTreeNode>","isStatic":false,"isPublic":true},"getBalance":{"name":"getBalance","async":true,"parameters":[{"name":"asOfDate","type":"Date","optional":true}],"returnType":"Promise<number>","isStatic":false,"isPublic":true},"createChild":{"name":"createChild","async":true,"parameters":[{"name":"options","type":"Omit<AccountOptions, 'parentId' | 'type'>","optional":false}],"returnType":"Promise<Account>","isStatic":false,"isPublic":true}},"decoratorConfig":{"tableName":"ledger_accounts","api":{"include":["list","get","create","update","delete"]},"mcp":{"include":["list","get","create"]},"cli":{"skipApiCheck":true},"tenantScoped":{"mode":"optional"},"conflictColumns":["tenant_id","slug","context"]},"extends":"SmrtHierarchical","exportName":"Account","collectionExportName":"AccountCollection","displayLabelField":"name","schema":{"tableName":"ledger_accounts","ddl":"CREATE TABLE IF NOT EXISTS \\"ledger_accounts\\" (\\n  \\"id\\" UUID PRIMARY KEY NOT NULL,\\n  \\"slug\\" TEXT NOT NULL,\\n  \\"context\\" TEXT NOT NULL DEFAULT '',\\n  \\"created_at\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\"updated_at\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\"parent_id\\" UUID,\\n  \\"tenant_id\\" UUID,\\n  \\"number\\" TEXT DEFAULT '',\\n  \\"name\\" TEXT DEFAULT '',\\n  \\"description\\" TEXT DEFAULT '',\\n  \\"type\\" TEXT DEFAULT 'asset',\\n  \\"ledger_id\\" UUID,\\n  \\"active\\" BOOLEAN DEFAULT TRUE,\\n  \\"metadata\\" JSON DEFAULT '{}'\\n);","columns":{"id":{"type":"UUID","primaryKey":true,"referenceKind":"id","notNull":true},"slug":{"type":"TEXT","notNull":true},"context":{"type":"TEXT","notNull":true,"default":""},"created_at":{"type":"TIMESTAMP","notNull":true,"default":"current_timestamp"},"updated_at":{"type":"TIMESTAMP","notNull":true,"default":"current_timestamp"},"parent_id":{"type":"UUID","referenceKind":"foreignKey","notNull":false,"unique":false,"foreignKey":{"table":"ledger_accounts","column":"id","onDelete":"NO ACTION","onUpdate":"CASCADE"}},"tenant_id":{"type":"UUID","referenceKind":"tenantId","notNull":false,"unique":false},"number":{"type":"TEXT","notNull":false,"unique":false,"default":""},"name":{"type":"TEXT","notNull":false,"unique":false,"default":""},"description":{"type":"TEXT","notNull":false,"unique":false,"default":""},"type":{"type":"TEXT","notNull":false,"unique":false,"default":"asset"},"ledger_id":{"type":"UUID","referenceKind":"foreignKey","notNull":false,"unique":false,"foreignKey":{"table":"ledgers","column":"id","onDelete":"NO ACTION","onUpdate":"CASCADE"}},"active":{"type":"BOOLEAN","notNull":false,"unique":false,"default":true},"metadata":{"type":"JSON","notNull":false,"unique":false,"default":{}}},"indexes":[{"name":"ledger_accounts_slug_context_idx","columns":["tenant_id","slug","context"],"unique":true,"nullsNotDistinct":true},{"name":"ledger_accounts_tenant_id_created_at_idx","columns":["tenant_id","created_at"]},{"name":"ledger_accounts_parent_id_idx","columns":["parent_id"]},{"name":"ledger_accounts_ledger_id_idx","columns":["ledger_id"]}],"version":"caea63eb"},"importPath":"@happyvertical/smrt-ledgers"},"@happyvertical/smrt-ledgers:Journal":{"name":"journal","className":"Journal","qualifiedName":"@happyvertical/smrt-ledgers:Journal","collection":"journals","filePath":"/home/runner/work/smrt/smrt/packages/ledgers/src/models/Journal.ts","packageName":"@happyvertical/smrt-ledgers","fields":{"tenantId":{"type":"text","required":false,"_meta":{"sqlType":"UUID","nullable":true,"__tenancy":{"isTenantIdField":true,"autoFilter":true,"required":false,"autoPopulate":true,"nullable":true,"mode":"optional","field":"tenantId","allowSuperAdminBypass":false}}},"number":{"type":"text","required":false,"default":"","description":"The journal's reference number.","_meta":{"description":"The journal's reference number."}},"date":{"type":"datetime","required":false,"description":"The date of the transaction.","_meta":{"description":"The date of the transaction."}},"description":{"type":"text","required":false,"default":"","description":"What the transaction was.","_meta":{"description":"What the transaction was."}},"sourceModule":{"type":"text","required":false,"default":""},"sourceRef":{"type":"text","required":false},"ledgerId":{"type":"foreignKey","required":false,"related":"Ledger","description":"The ledger policy that governs this journal.","_meta":{"description":"The ledger policy that governs this journal.","nullable":true}},"idempotencyKey":{"type":"text","required":false,"_meta":{"nullable":true}},"requestDigest":{"type":"text","required":false},"status":{"type":"text","required":false,"default":"draft","description":"draft until final, then posted, or voided.","_meta":{"description":"draft until final, then posted, or voided."},"enum":["draft","posted","voided"]},"postedAt":{"type":"datetime","required":false,"description":"When it was posted.","_meta":{"description":"When it was posted."}},"voidedAt":{"type":"datetime","required":false},"voidReason":{"type":"text","required":false},"metadata":{"type":"json","required":false,"default":{}}},"methods":{"isDraft":{"name":"isDraft","async":false,"parameters":[],"returnType":"boolean","isStatic":false,"isPublic":true},"isPosted":{"name":"isPosted","async":false,"parameters":[],"returnType":"boolean","isStatic":false,"isPublic":true},"isVoided":{"name":"isVoided","async":false,"parameters":[],"returnType":"boolean","isStatic":false,"isPublic":true},"isEditable":{"name":"isEditable","async":false,"parameters":[],"returnType":"boolean","isStatic":false,"isPublic":true},"getEntries":{"name":"getEntries","async":true,"parameters":[],"returnType":"any","isStatic":false,"isPublic":true},"getTotalDebits":{"name":"getTotalDebits","async":true,"parameters":[],"returnType":"Promise<number>","isStatic":false,"isPublic":true},"getTotalCredits":{"name":"getTotalCredits","async":true,"parameters":[],"returnType":"Promise<number>","isStatic":false,"isPublic":true},"isBalanced":{"name":"isBalanced","async":true,"parameters":[],"returnType":"Promise<boolean>","isStatic":false,"isPublic":true},"getLedger":{"name":"getLedger","async":true,"parameters":[],"returnType":"any","isStatic":false,"isPublic":true},"addEntry":{"name":"addEntry","async":true,"parameters":[{"name":"data","type":"JournalEntryData","optional":false}],"returnType":"Promise<void>","isStatic":false,"isPublic":true},"post":{"name":"post","async":true,"parameters":[],"returnType":"Promise<void>","isStatic":false,"isPublic":true},"void":{"name":"void","async":true,"parameters":[{"name":"reason","type":"string","optional":false}],"returnType":"Promise<void>","isStatic":false,"isPublic":true},"save":{"name":"save","async":true,"parameters":[{"name":"options","type":"any","optional":true,"typeUnresolved":true}],"returnType":"Promise<this>","isStatic":false,"isPublic":true},"delete":{"name":"delete","async":true,"parameters":[{"name":"options","type":"any","optional":true,"typeUnresolved":true}],"returnType":"Promise<void>","isStatic":false,"isPublic":true},"summarize":{"name":"summarize","async":true,"parameters":[],"returnType":"Promise<string>","isStatic":false,"isPublic":true}},"decoratorConfig":{"api":{"include":["list","get","create"]},"mcp":{"include":["list","get","create"]},"cli":{"skipApiCheck":true},"indexes":[{"name":"journals_ledger_idempotency_key","columns":["tenantId","ledgerId","idempotencyKey"],"unique":true}],"tenantScoped":{"mode":"optional"},"conflictColumns":["tenant_id","slug","context"]},"extends":"SmrtObject","exportName":"Journal","collectionExportName":"JournalCollection","schema":{"tableName":"journals","ddl":"CREATE TABLE IF NOT EXISTS \\"journals\\" (\\n  \\"id\\" UUID PRIMARY KEY NOT NULL,\\n  \\"slug\\" TEXT NOT NULL,\\n  \\"context\\" TEXT NOT NULL DEFAULT '',\\n  \\"created_at\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\"updated_at\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\"tenant_id\\" UUID,\\n  \\"number\\" TEXT DEFAULT '',\\n  \\"date\\" TIMESTAMP,\\n  \\"description\\" TEXT DEFAULT '',\\n  \\"source_module\\" TEXT DEFAULT '',\\n  \\"source_ref\\" TEXT,\\n  \\"ledger_id\\" UUID,\\n  \\"idempotency_key\\" TEXT,\\n  \\"request_digest\\" TEXT,\\n  \\"status\\" TEXT DEFAULT 'draft',\\n  \\"posted_at\\" TIMESTAMP,\\n  \\"voided_at\\" TIMESTAMP,\\n  \\"void_reason\\" TEXT,\\n  \\"metadata\\" JSON DEFAULT '{}'\\n);","columns":{"id":{"type":"UUID","primaryKey":true,"referenceKind":"id","notNull":true},"slug":{"type":"TEXT","notNull":true},"context":{"type":"TEXT","notNull":true,"default":""},"created_at":{"type":"TIMESTAMP","notNull":true,"default":"current_timestamp"},"updated_at":{"type":"TIMESTAMP","notNull":true,"default":"current_timestamp"},"tenant_id":{"type":"UUID","referenceKind":"tenantId","notNull":false,"unique":false},"number":{"type":"TEXT","notNull":false,"unique":false,"default":""},"date":{"type":"TIMESTAMP","notNull":false,"unique":false},"description":{"type":"TEXT","notNull":false,"unique":false,"default":""},"source_module":{"type":"TEXT","notNull":false,"unique":false,"default":""},"source_ref":{"type":"TEXT","notNull":false,"unique":false},"ledger_id":{"type":"UUID","referenceKind":"foreignKey","notNull":false,"unique":false,"foreignKey":{"table":"ledgers","column":"id","onDelete":"NO ACTION","onUpdate":"CASCADE"}},"idempotency_key":{"type":"TEXT","notNull":false,"unique":false},"request_digest":{"type":"TEXT","notNull":false,"unique":false},"status":{"type":"TEXT","notNull":false,"unique":false,"default":"draft"},"posted_at":{"type":"TIMESTAMP","notNull":false,"unique":false},"voided_at":{"type":"TIMESTAMP","notNull":false,"unique":false},"void_reason":{"type":"TEXT","notNull":false,"unique":false},"metadata":{"type":"JSON","notNull":false,"unique":false,"default":{}}},"indexes":[{"name":"journals_slug_context_idx","columns":["tenant_id","slug","context"],"unique":true,"nullsNotDistinct":true},{"name":"journals_ledger_idempotency_key","columns":["tenant_id","ledger_id","idempotency_key"],"unique":true},{"name":"journals_tenant_id_created_at_idx","columns":["tenant_id","created_at"]},{"name":"journals_ledger_id_idx","columns":["ledger_id"]}],"version":"1e73dd60"},"importPath":"@happyvertical/smrt-ledgers"},"@happyvertical/smrt-ledgers:JournalEntry":{"name":"journalentry","className":"JournalEntry","qualifiedName":"@happyvertical/smrt-ledgers:JournalEntry","collection":"journalentries","filePath":"/home/runner/work/smrt/smrt/packages/ledgers/src/models/JournalEntry.ts","packageName":"@happyvertical/smrt-ledgers","fields":{"tenantId":{"type":"text","required":false,"_meta":{"sqlType":"UUID","nullable":true,"__tenancy":{"isTenantIdField":true,"autoFilter":true,"required":false,"autoPopulate":true,"nullable":true,"mode":"optional","field":"tenantId","allowSuperAdminBypass":false}}},"journalId":{"type":"foreignKey","required":false,"related":"Journal","description":"The journal this entry belongs to.","_meta":{"description":"The journal this entry belongs to."}},"accountId":{"type":"foreignKey","required":false,"related":"Account","description":"The account this entry changes.","_meta":{"description":"The account this entry changes."}},"counterpartyKind":{"type":"text","required":false,"description":"Generic counterparty type.","_meta":{"description":"Generic counterparty type.","nullable":true}},"counterpartyId":{"type":"text","required":false,"description":"Generic counterparty identifier.","_meta":{"description":"Generic counterparty identifier.","nullable":true}},"dueDate":{"type":"datetime","required":false,"description":"When this open receivable or payable is due.","_meta":{"description":"When this open receivable or payable is due."}},"settlesSourceRef":{"type":"text","required":false},"debit":{"type":"decimal","required":false,"default":0,"description":"The amount debited. Zero on a credit entry.","_meta":{"description":"The amount debited. Zero on a credit entry."}},"credit":{"type":"decimal","required":false,"default":0,"description":"The amount credited. Zero on a debit entry.","_meta":{"description":"The amount credited. Zero on a debit entry."}},"currency":{"type":"text","required":false,"default":"USD","description":"The currency of the amounts.","_meta":{"description":"The currency of the amounts."}},"exchangeRate":{"type":"decimal","required":false,"default":1},"memo":{"type":"text","required":false,"default":"","description":"A note on this entry.","_meta":{"description":"A note on this entry."}},"metadata":{"type":"json","required":false,"default":{}}},"methods":{"save":{"name":"save","async":true,"parameters":[{"name":"options","type":"any","optional":true,"typeUnresolved":true}],"returnType":"Promise<this>","isStatic":false,"isPublic":true},"delete":{"name":"delete","async":true,"parameters":[{"name":"options","type":"any","optional":true,"typeUnresolved":true}],"returnType":"Promise<void>","isStatic":false,"isPublic":true},"isDebit":{"name":"isDebit","async":false,"parameters":[],"returnType":"boolean","isStatic":false,"isPublic":true},"isCredit":{"name":"isCredit","async":false,"parameters":[],"returnType":"boolean","isStatic":false,"isPublic":true},"getAmount":{"name":"getAmount","async":false,"parameters":[],"returnType":"number","isStatic":false,"isPublic":true},"getBaseAmount":{"name":"getBaseAmount","async":false,"parameters":[],"returnType":"number","isStatic":false,"isPublic":true},"getJournal":{"name":"getJournal","async":true,"parameters":[],"returnType":"any","isStatic":false,"isPublic":true},"getAccount":{"name":"getAccount","async":true,"parameters":[],"returnType":"any","isStatic":false,"isPublic":true},"getDescription":{"name":"getDescription","async":true,"parameters":[],"returnType":"Promise<string>","isStatic":false,"isPublic":true}},"decoratorConfig":{"api":{"include":["list","get"]},"mcp":{"include":["list","get"]},"cli":{"skipApiCheck":true},"tenantScoped":{"mode":"optional"},"conflictColumns":["tenant_id","slug","context"]},"extends":"SmrtObject","exportName":"JournalEntry","collectionExportName":"JournalEntryCollection","schema":{"tableName":"journal_entries","ddl":"CREATE TABLE IF NOT EXISTS \\"journal_entries\\" (\\n  \\"id\\" UUID PRIMARY KEY NOT NULL,\\n  \\"slug\\" TEXT NOT NULL,\\n  \\"context\\" TEXT NOT NULL DEFAULT '',\\n  \\"created_at\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\"updated_at\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\"tenant_id\\" UUID,\\n  \\"journal_id\\" UUID,\\n  \\"account_id\\" UUID,\\n  \\"counterparty_kind\\" TEXT,\\n  \\"counterparty_id\\" TEXT,\\n  \\"due_date\\" TIMESTAMP,\\n  \\"settles_source_ref\\" TEXT,\\n  \\"debit\\" REAL DEFAULT 0,\\n  \\"credit\\" REAL DEFAULT 0,\\n  \\"currency\\" TEXT DEFAULT 'USD',\\n  \\"exchange_rate\\" REAL DEFAULT 1,\\n  \\"memo\\" TEXT DEFAULT '',\\n  \\"metadata\\" JSON DEFAULT '{}'\\n);","columns":{"id":{"type":"UUID","primaryKey":true,"referenceKind":"id","notNull":true},"slug":{"type":"TEXT","notNull":true},"context":{"type":"TEXT","notNull":true,"default":""},"created_at":{"type":"TIMESTAMP","notNull":true,"default":"current_timestamp"},"updated_at":{"type":"TIMESTAMP","notNull":true,"default":"current_timestamp"},"tenant_id":{"type":"UUID","referenceKind":"tenantId","notNull":false,"unique":false},"journal_id":{"type":"UUID","referenceKind":"foreignKey","notNull":false,"unique":false,"foreignKey":{"table":"journals","column":"id","onDelete":"NO ACTION","onUpdate":"CASCADE"}},"account_id":{"type":"UUID","referenceKind":"foreignKey","notNull":false,"unique":false,"foreignKey":{"table":"ledger_accounts","column":"id","onDelete":"NO ACTION","onUpdate":"CASCADE"}},"counterparty_kind":{"type":"TEXT","notNull":false,"unique":false},"counterparty_id":{"type":"TEXT","notNull":false,"unique":false},"due_date":{"type":"TIMESTAMP","notNull":false,"unique":false},"settles_source_ref":{"type":"TEXT","notNull":false,"unique":false},"debit":{"type":"REAL","notNull":false,"unique":false,"default":0},"credit":{"type":"REAL","notNull":false,"unique":false,"default":0},"currency":{"type":"TEXT","notNull":false,"unique":false,"default":"USD"},"exchange_rate":{"type":"REAL","notNull":false,"unique":false,"default":1},"memo":{"type":"TEXT","notNull":false,"unique":false,"default":""},"metadata":{"type":"JSON","notNull":false,"unique":false,"default":{}}},"indexes":[{"name":"journal_entries_slug_context_idx","columns":["tenant_id","slug","context"],"unique":true,"nullsNotDistinct":true},{"name":"journal_entries_tenant_id_created_at_idx","columns":["tenant_id","created_at"]},{"name":"journal_entries_journal_id_idx","columns":["journal_id"]},{"name":"journal_entries_account_id_idx","columns":["account_id"]}],"version":"e96b76a2"},"importPath":"@happyvertical/smrt-ledgers"},"@happyvertical/smrt-ledgers:Ledger":{"name":"ledger","className":"Ledger","qualifiedName":"@happyvertical/smrt-ledgers:Ledger","collection":"ledgers","description":"A named accounting scope. Exact ledgers store one currency's minor units and reject fractional entries; legacy journals without a ledger retain the tolerant balance rule for backwards compatibility.","filePath":"/home/runner/work/smrt/smrt/packages/ledgers/src/models/Ledger.ts","packageName":"@happyvertical/smrt-ledgers","fields":{"tenantId":{"type":"text","required":false,"_meta":{"sqlType":"UUID","nullable":true,"__tenancy":{"isTenantIdField":true,"autoFilter":true,"required":false,"autoPopulate":true,"nullable":true,"mode":"optional","field":"tenantId","allowSuperAdminBypass":false}}},"name":{"type":"text","required":false,"description":"The accounting scope name.","_meta":{"description":"The accounting scope name."}},"currency":{"type":"text","required":false,"description":"ISO 4217 currency used by this ledger.","_meta":{"description":"ISO 4217 currency used by this ledger."}},"balanceMode":{"type":"text","required":false,"default":"tolerant","description":"tolerant accepts decimal units; exact requires integer minor units.","_meta":{"description":"tolerant accepts decimal units; exact requires integer minor units."},"enum":["tolerant","exact-integer"]}},"methods":{"delete":{"name":"delete","async":true,"parameters":[],"returnType":"Promise<void>","isStatic":false,"isPublic":true}},"decoratorConfig":{"api":{"include":["list","get","create","update"]},"mcp":{"include":["list","get","create"]},"cli":{"skipApiCheck":true},"tenantScoped":{"mode":"optional"},"conflictColumns":["tenant_id","slug","context"]},"extends":"SmrtObject","exportName":"Ledger","collectionExportName":"LedgerCollection","displayLabelField":"name","schema":{"tableName":"ledgers","ddl":"CREATE TABLE IF NOT EXISTS \\"ledgers\\" (\\n  \\"id\\" UUID PRIMARY KEY NOT NULL,\\n  \\"slug\\" TEXT NOT NULL,\\n  \\"context\\" TEXT NOT NULL DEFAULT '',\\n  \\"created_at\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\"updated_at\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\"tenant_id\\" UUID,\\n  \\"name\\" TEXT,\\n  \\"currency\\" TEXT,\\n  \\"balance_mode\\" TEXT DEFAULT 'tolerant'\\n);","columns":{"id":{"type":"UUID","primaryKey":true,"referenceKind":"id","notNull":true},"slug":{"type":"TEXT","notNull":true},"context":{"type":"TEXT","notNull":true,"default":""},"created_at":{"type":"TIMESTAMP","notNull":true,"default":"current_timestamp"},"updated_at":{"type":"TIMESTAMP","notNull":true,"default":"current_timestamp"},"tenant_id":{"type":"UUID","referenceKind":"tenantId","notNull":false,"unique":false},"name":{"type":"TEXT","notNull":false,"unique":false},"currency":{"type":"TEXT","notNull":false,"unique":false},"balance_mode":{"type":"TEXT","notNull":false,"unique":false,"default":"tolerant"}},"indexes":[{"name":"ledgers_slug_context_idx","columns":["tenant_id","slug","context"],"unique":true,"nullsNotDistinct":true},{"name":"ledgers_tenant_id_created_at_idx","columns":["tenant_id","created_at"]}],"version":"be316e4f"},"importPath":"@happyvertical/smrt-ledgers"}},"moduleType":"smrt","recipes":[{"id":"ledgers.bookkeeping","className":"BookkeepingRecipe","label":"Bookkeeping","summary":"Keep your books: a chart of accounts and double-entry journals.","synonyms":["accounting","ledger","general ledger","journals","chart of accounts"],"models":["@happyvertical/smrt-ledgers:Account","@happyvertical/smrt-ledgers:Journal","@happyvertical/smrt-ledgers:JournalEntry"],"nav":[{"label":"Accounts","model":"@happyvertical/smrt-ledgers:Account","icon":"bank","description":"The accounts your books are kept in, like sales, rent and bank."},{"label":"Journals","model":"@happyvertical/smrt-ledgers:Journal","icon":"book","description":"The entries behind your accounts, so every dollar has a trail."}],"requires":[],"section":{"id":"accounting","label":"Accounting","icon":"bank","description":"Your books: accounts, journals and balances."},"options":{"@happyvertical/smrt-ledgers:Account":{"fields":{"metadata":{"visibility":"hidden"},"parentId":{"visibility":"hidden"}}},"@happyvertical/smrt-ledgers:Journal":{"fields":{"sourceModule":{"visibility":"hidden"},"sourceRef":{"visibility":"hidden"},"idempotencyKey":{"visibility":"hidden"},"requestDigest":{"visibility":"hidden"},"voidedAt":{"visibility":"hidden"},"voidReason":{"visibility":"hidden"},"metadata":{"visibility":"hidden"}}},"@happyvertical/smrt-ledgers:JournalEntry":{"fields":{"exchangeRate":{"visibility":"hidden"},"settlesSourceRef":{"visibility":"hidden"},"metadata":{"visibility":"hidden"}}}},"help":{"markdown":"## Overview\\n\\nBookkeeping keeps your accounts. You list the accounts you use (your chart of\\naccounts) and record each transaction as a journal whose entries debit and\\ncredit those accounts.\\n\\n## Tasks\\n\\n### Set up your accounts\\n\\n1. Create a new account.\\n2. Give it a **{field:number}** and a **{field:name}**.\\n3. Choose its **{field:type}**: asset, liability, equity, revenue or expense.\\n\\n### Record a transaction\\n\\n1. Create a new journal and add a **{field:description}**.\\n2. Add entries: pick the account on each and enter a **{field:debit}** or a\\n   **{field:credit}**. They must add up to the same total.\\n3. Set the journal's **{field:status}** to posted when it is final. A posted\\n   journal is voided, not edited.\\n","fieldRefs":["credit","debit","description","name","number","status","type"]},"demo":{"mode":"server","reasons":["Needs a server because its package does not build for a browser: core migrations (node:os, node:crypto); and its package depends on @happyvertical/smrt-tenancy, which do not build for a browser (#3624, #3626)."]}}],"smrtDependencies":["@happyvertical/smrt-core","@happyvertical/smrt-prompts","@happyvertical/smrt-tenancy"],"browser":{"status":"server-only","issues":["#3624","#3626"],"reason":"core migrations (node:os, node:crypto)","via":["@happyvertical/smrt-tenancy"]},"stampsConstructors":true}`));
+var smrtLedgersJournalSummarizePrompt = definePrompt({
+	key: "smrtLedgers.journal.summarize",
+	template: `Summarize this accounting journal entry:
+Number: {journalNumber}
+Date: {journalDate}
+Description: {journalDescription}
+Status: {journalStatus}
+Total: {journalTotal}
+Entries: {entryCount}
+Balanced: {journalBalanced}`,
+	editable: {
+		template: true,
+		profile: true,
+		model: true,
+		params: true
+	}
+});
+function promptMessageOptions(ai) {
+	return {
+		...ai.params || {},
+		...ai.model ? { model: ai.model } : {},
+		...typeof ai.temperature === "number" ? { temperature: ai.temperature } : {},
+		...typeof ai.maxTokens === "number" ? { maxTokens: ai.maxTokens } : {}
+	};
+}
+var Accounts_exports = /* @__PURE__ */ __exportAll({ AccountCollection: () => AccountCollection });
+var AccountCollection = class extends SmrtCollection {
+	static _itemClass = Account;
+	/**
+	* Find account by number
+	*
+	* @param number - Account number
+	* @returns Account or null
+	*/
+	async findByNumber(number) {
+		return (await this.list({
+			where: { number },
+			limit: 1
+		}))[0] || null;
+	}
+	/**
+	* Find accounts by type
+	*
+	* @param type - Account type
+	* @returns Array of accounts
+	*/
+	async findByType(type) {
+		return await this.list({
+			where: { type },
+			orderBy: "number ASC"
+		});
+	}
+	/**
+	* Find all active accounts
+	*
+	* @returns Array of active accounts
+	*/
+	async findActive() {
+		return await this.list({
+			where: { active: true },
+			orderBy: "number ASC"
+		});
+	}
+	/**
+	* Find top-level accounts (no parent)
+	*
+	* @returns Array of top-level accounts
+	*/
+	async findTopLevel() {
+		return await this.list({
+			where: { parentId: null },
+			orderBy: "number ASC"
+		});
+	}
+	/**
+	* Find direct children of an account
+	*
+	* @param parentId - Parent account ID
+	* @returns Array of child accounts
+	*/
+	async findChildren(parentId) {
+		return await this.list({
+			where: { parentId },
+			orderBy: "number ASC"
+		});
+	}
+	/**
+	* Get the complete account tree
+	*
+	* @returns AccountTree structure
+	*/
+	async getTree() {
+		const allAccounts = await this.list({ orderBy: "number ASC" });
+		const accountMap = /* @__PURE__ */ new Map();
+		const childrenMap = /* @__PURE__ */ new Map();
+		for (const account of allAccounts) {
+			if (account.id) accountMap.set(account.id, account);
+			if (!childrenMap.has(account.parentId || "")) childrenMap.set(account.parentId || "", []);
+			childrenMap.get(account.parentId || "")?.push(account);
+		}
+		const buildNode = (account) => {
+			return {
+				account,
+				children: ((account.id ? childrenMap.get(account.id) : []) || []).map(buildNode)
+			};
+		};
+		return { roots: (childrenMap.get("") || []).map(buildNode) };
+	}
+	/**
+	* Get or create an account by number
+	*
+	* @param number - Account number
+	* @param defaults - Default values if creating
+	* @returns Account
+	*/
+	async getOrCreateByNumber(number, defaults = {}) {
+		const existing = await this.findByNumber(number);
+		if (existing) return existing;
+		const account = await this.create({
+			number,
+			name: defaults.name || number,
+			description: defaults.description || "",
+			type: defaults.type || "asset",
+			parentId: defaults.parentId || null
+		});
+		await account.save();
+		return account;
+	}
+	/**
+	* Find accounts grouped by type
+	*
+	* @returns Record of type to accounts array
+	*/
+	async groupByType() {
+		const accounts = await this.findActive();
+		const grouped = {
+			asset: [],
+			liability: [],
+			equity: [],
+			revenue: [],
+			expense: []
+		};
+		for (const account of accounts) grouped[account.type].push(account);
+		return grouped;
+	}
+	/**
+	* Get all descendants of an account recursively
+	*
+	* @param accountId - Account ID
+	* @returns Array of all descendant accounts
+	*/
+	async getDescendants(accountId) {
+		const descendants = [];
+		const queue = [accountId];
+		while (queue.length > 0) {
+			const currentId = queue.shift();
+			if (!currentId) continue;
+			const children = await this.findChildren(currentId);
+			for (const child of children) {
+				descendants.push(child);
+				if (child.id) queue.push(child.id);
+			}
+		}
+		return descendants;
+	}
+	/**
+	* Find all accounts belonging to a specific tenant
+	*
+	* @param tenantId - Tenant ID
+	* @returns Array of tenant's accounts
+	*/
+	async findByTenant(tenantId) {
+		return this.list({ where: { tenantId } });
+	}
+	/**
+	* Find all global accounts (no tenant association).
+	*
+	* Routes through the shared tenant-global helper so it does not throw under
+	* an active tenant context (an explicit `tenant_id IS NULL` filter would be
+	* flagged as an isolation violation). (#1600)
+	*
+	* @returns Array of global accounts
+	*/
+	async findGlobal() {
+		return queryGlobal(this);
+	}
+	/**
+	* Find accounts for a tenant plus all global accounts.
+	*
+	* Fails closed if an active tenant context requests a different tenant's
+	* rows; the admin/system path keeps the cross-tenant capability. (#1600)
+	*
+	* @param tenantId - Tenant ID
+	* @returns Array of tenant's accounts and global accounts
+	*/
+	async findWithGlobals(tenantId) {
+		return queryWithGlobals(this, tenantId, "Account.findWithGlobals");
+	}
+};
+var __defProp$1 = Object.defineProperty;
+var __getOwnPropDesc$1 = Object.getOwnPropertyDescriptor;
+var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, {
+	enumerable: true,
+	configurable: true,
+	writable: true,
+	value
+}) : obj[key] = value;
+var __decorateClass$1 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$1(target, key) : target;
+	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+	if (kind && result) __defProp$1(target, key, result);
+	return result;
+};
+var __publicField$1 = (obj, key, value) => __defNormalProp$1(obj, typeof key !== "symbol" ? key + "" : key, value);
+var JournalEntry = class extends SmrtObject {
+	tenantId = null;
+	journalId = "";
+	accountId = "";
+	counterpartyKind = null;
+	counterpartyId = null;
+	dueDate = null;
+	/** Source reference of the open item reduced by this settlement line. */
+	settlesSourceRef = null;
+	debit = 0;
+	credit = 0;
+	currency = "USD";
+	/**
+	* Exchange rate to base currency
+	*/
+	exchangeRate = 1;
+	memo = "";
+	/**
+	* Extensible metadata
+	*/
+	metadata = {};
+	constructor(options = {}) {
+		super(options);
+		if (options.tenantId !== void 0) this.tenantId = options.tenantId;
+		if (options.journalId !== void 0) this.journalId = options.journalId;
+		if (options.accountId !== void 0) this.accountId = options.accountId;
+		if (options.counterpartyKind !== void 0) this.counterpartyKind = options.counterpartyKind;
+		if (options.counterpartyId !== void 0) this.counterpartyId = options.counterpartyId;
+		if (options.dueDate !== void 0) this.dueDate = options.dueDate;
+		if (options.settlesSourceRef !== void 0) this.settlesSourceRef = options.settlesSourceRef;
+		if (options.debit !== void 0) this.debit = options.debit;
+		if (options.credit !== void 0) this.credit = options.credit;
+		if (options.currency !== void 0) this.currency = options.currency;
+		if (options.exchangeRate !== void 0) this.exchangeRate = options.exchangeRate;
+		if (options.memo !== void 0) this.memo = options.memo;
+		if (options.metadata !== void 0) this.metadata = options.metadata;
+	}
+	async save(options = {}) {
+		return this.withTransaction(async () => {
+			const journal = await this.getJournal();
+			if (!journal) throw new Error("Journal entry requires an accessible parent journal");
+			if (journal.ledgerId) {
+				if (!journal.isDraft() || !journal.updated_at) throw new Error("Ledger entries are immutable after posting");
+				await journal.claimRevision(journal.updated_at);
+			}
+			return super.save(options);
+		});
+	}
+	/**
+	* Validate entry before save
+	*/
+	async validateBeforeSave() {
+		await super.validateBeforeSave();
+		this.requireInsertOnSave({ preserveDerivedSlug: true });
+		const journal = await this.getJournal();
+		const owner = this.tenantId ?? (isTenancyEnabled() && !isSuperAdminBypass() ? getTenantId() ?? null : null);
+		if (!journal || journal.tenantId !== owner) throw new Error("Journal entry and parent must belong to the same tenant");
+		const account = await this.getAccount();
+		if (!account || account.ledgerId !== journal.ledgerId || journal.ledgerId && account.tenantId !== journal.tenantId) throw new Error("Journal entry account must belong to its journal ledger");
+		if (journal.ledgerId && !journal.isDraft()) throw new Error("Ledger entries are immutable after posting");
+		if (this.id) {
+			const stored = await this.db.get(this.tableName, { id: this.id });
+			if (stored && stored.journal_id !== this.journalId) throw new Error("Journal entry cannot be moved to another journal");
+			if (stored && stored.account_id !== this.accountId) {
+				const oldAccount = await this.loadAccount(String(stored.account_id));
+				if (!oldAccount || oldAccount.ledgerId !== journal.ledgerId) throw new Error("Stored entry account must belong to its journal ledger");
+			}
+		}
+		if (!Number.isFinite(this.debit) || !Number.isFinite(this.credit)) throw new Error("Entry amounts must be finite");
+		if (this.debit < 0) throw new Error("Debit amount cannot be negative");
+		if (this.credit < 0) throw new Error("Credit amount cannot be negative");
+		if (this.debit > 0 && this.credit > 0) throw new Error("Entry cannot have both debit and credit amounts");
+		if (this.debit === 0 && this.credit === 0) throw new Error("Entry must have either a debit or credit amount");
+		if (this.exchangeRate <= 0) throw new Error("Exchange rate must be positive");
+		if (!!this.counterpartyKind !== !!this.counterpartyId) throw new Error("Counterparty kind and ID must be provided together");
+		if (this.dueDate && (!this.counterpartyKind || !this.counterpartyId)) throw new Error("Due date requires a counterparty");
+	}
+	async delete(options = {}) {
+		await this.withTransaction(async () => {
+			const stored = this.id ? await this.db.get(this.tableName, { id: this.id }) : null;
+			if (stored) {
+				const { JournalCollection } = await Promise.resolve().then(() => Journals_exports);
+				const journal = await (await JournalCollection.create({ db: this.db })).get({ id: String(stored.journal_id) });
+				if (!journal || journal.tenantId !== stored.tenant_id) throw new Error("Journal entry requires its accessible same-tenant parent");
+				if (journal.ledgerId) {
+					if (!journal.isDraft() || !journal.updated_at) throw new Error("Ledger entries are immutable after posting");
+					await journal.claimRevision(journal.updated_at);
+				}
+			}
+			await super.delete(options);
+		});
+	}
+	/**
+	* Check if this is a debit entry
+	*/
+	isDebit() {
+		return this.debit > 0;
+	}
+	/**
+	* Check if this is a credit entry
+	*/
+	isCredit() {
+		return this.credit > 0;
+	}
+	/**
+	* Get the entry amount (positive value regardless of debit/credit)
+	*/
+	getAmount() {
+		return this.debit > 0 ? this.debit : this.credit;
+	}
+	/**
+	* Get the amount in base currency
+	*/
+	getBaseAmount() {
+		return this.getAmount() * this.exchangeRate;
+	}
+	/**
+	* Get the parent journal
+	*/
+	async getJournal() {
+		if (!this.journalId) return null;
+		const { JournalCollection } = await Promise.resolve().then(() => Journals_exports);
+		return await (await JournalCollection.create(this.options)).get({ id: this.journalId }, { cache: false });
+	}
+	/**
+	* Get the account
+	*/
+	async getAccount() {
+		if (!this.accountId) return null;
+		return this.loadAccount(this.accountId);
+	}
+	async loadAccount(accountId) {
+		const { AccountCollection } = await Promise.resolve().then(() => Accounts_exports);
+		const collection = await AccountCollection.create(this.options);
+		const account = await collection.get({ id: accountId }, { cache: false });
+		if (account) return account;
+		const tenant = getTenantId();
+		if (!tenant) return null;
+		return withTenantGlobalRead(tenant, async () => {
+			return (await collection.list({
+				where: {
+					id: accountId,
+					tenantId: null,
+					ledgerId: null
+				},
+				limit: 1
+			}))[0] ?? null;
+		});
+	}
+	/**
+	* Get a formatted description of this entry
+	*/
+	async getDescription() {
+		const accountName = (await this.getAccount())?.name || "Unknown Account";
+		return `${this.isDebit() ? "DR" : "CR"} ${accountName}: $${this.getAmount().toFixed(2)}${this.memo ? ` - ${this.memo}` : ""}`;
+	}
+};
+__publicField$1(JournalEntry, "__smrtPackage__", "@happyvertical/smrt-ledgers");
+__decorateClass$1([tenantId({ nullable: true })], JournalEntry.prototype, "tenantId", 2);
+__decorateClass$1([field({ description: "The journal this entry belongs to." }), foreignKey("Journal")], JournalEntry.prototype, "journalId", 2);
+__decorateClass$1([field({ description: "The account this entry changes." }), foreignKey(Account)], JournalEntry.prototype, "accountId", 2);
+__decorateClass$1([field({
+	description: "Generic counterparty type.",
+	nullable: true
+})], JournalEntry.prototype, "counterpartyKind", 2);
+__decorateClass$1([field({
+	description: "Generic counterparty identifier.",
+	nullable: true
+})], JournalEntry.prototype, "counterpartyId", 2);
+__decorateClass$1([field({ description: "When this open receivable or payable is due." })], JournalEntry.prototype, "dueDate", 2);
+__decorateClass$1([field({ description: "The amount debited. Zero on a credit entry." })], JournalEntry.prototype, "debit", 2);
+__decorateClass$1([field({ description: "The amount credited. Zero on a debit entry." })], JournalEntry.prototype, "credit", 2);
+__decorateClass$1([field({ description: "The currency of the amounts." })], JournalEntry.prototype, "currency", 2);
+__decorateClass$1([field({ description: "A note on this entry." })], JournalEntry.prototype, "memo", 2);
+JournalEntry = __decorateClass$1([TenantScoped({ mode: "optional" }), smrt({
+	api: { include: ["list", "get"] },
+	mcp: { include: ["list", "get"] },
+	cli: { skipApiCheck: true }
+})], JournalEntry);
+var JournalEntries_exports = /* @__PURE__ */ __exportAll({ JournalEntryCollection: () => JournalEntryCollection });
+var MAX_MOVEMENT_ACCOUNTS = 1e3;
+function storedUnit(value, label) {
+	const number = typeof value === "number" ? value : Number(value);
+	if (!Number.isFinite(number) || Math.abs(number) > Number.MAX_SAFE_INTEGER) throw new RangeError(`Posted journal ${label} is outside the supported numeric range.`);
+	return number;
+}
+var JournalEntryCollection = class extends SmrtCollection {
+	static _itemClass = JournalEntry;
+	/**
+	* Find entries by journal
+	*
+	* @param journalId - Journal ID
+	* @returns Array of entries
+	*/
+	async findByJournal(journalId) {
+		return await this.list({ where: { journalId } });
+	}
+	/**
+	* Find entries by account
+	*
+	* @param accountId - Account ID
+	* @returns Array of entries
+	*/
+	async findByAccount(accountId) {
+		return await this.list({ where: { accountId } });
+	}
+	/** Posted AR/AP net balances by opaque counterparty for selected accounts. */
+	async getCounterpartyBalances(options) {
+		const movements = await this.listPostedMovements(options);
+		const result = /* @__PURE__ */ new Map();
+		for (const movement of movements) {
+			const entry = await this.get({ id: movement.entryId });
+			if (!entry?.counterpartyKind || !entry.counterpartyId) continue;
+			const key = JSON.stringify([
+				entry.counterpartyKind,
+				entry.counterpartyId,
+				movement.currency
+			]);
+			const row = result.get(key) ?? {
+				counterpartyKind: entry.counterpartyKind,
+				counterpartyId: entry.counterpartyId,
+				currency: movement.currency,
+				balance: 0
+			};
+			row.balance = storedUnit(row.balance + (movement.debit - movement.credit) * (options.normalBalance === "credit" ? -1 : 1), "counterparty balance");
+			result.set(key, row);
+		}
+		return [...result.values()].filter((row) => row.balance !== 0);
+	}
+	/**
+	* Open-item aging. An invoice/allocation line needs a dueDate and sourceRef;
+	* a settlement line names that source in settlesSourceRef. This avoids
+	* pretending that net counterparty movements are aging.
+	*/
+	async getCounterpartyAging(options, asOf) {
+		const movements = await this.listPostedMovements({
+			...options,
+			to: asOf
+		});
+		const rows = /* @__PURE__ */ new Map();
+		const balances = /* @__PURE__ */ new Map();
+		for (const movement of movements) {
+			const entry = await this.get({ id: movement.entryId });
+			const source = entry?.settlesSourceRef ?? movement.sourceRef;
+			if (!entry?.counterpartyKind || !entry.counterpartyId || !source) continue;
+			const key = JSON.stringify([
+				entry.counterpartyKind,
+				entry.counterpartyId,
+				movement.currency,
+				source
+			]);
+			balances.set(key, storedUnit((balances.get(key) ?? 0) + (movement.debit - movement.credit) * (options.normalBalance === "credit" ? -1 : 1), "open item balance"));
+			if (!entry.settlesSourceRef && entry.dueDate) {
+				const prior = rows.get(key);
+				if (prior && prior.dueDate.getTime() !== entry.dueDate.getTime()) throw new Error("Open item source has conflicting due dates");
+				rows.set(key, {
+					counterpartyKind: entry.counterpartyKind,
+					counterpartyId: entry.counterpartyId,
+					currency: movement.currency,
+					sourceRef: source,
+					dueDate: entry.dueDate,
+					balance: 0,
+					current: 0,
+					days1To30: 0,
+					days31To60: 0,
+					days61To90: 0,
+					daysOver90: 0
+				});
+			}
+		}
+		for (const [key, row] of rows) row.balance = balances.get(key) ?? 0;
+		for (const row of rows.values()) {
+			if (row.balance <= 0) continue;
+			const days = Math.floor((asOf.getTime() - row.dueDate.getTime()) / 864e5);
+			if (days <= 0) row.current = row.balance;
+			else if (days <= 30) row.days1To30 = row.balance;
+			else if (days <= 60) row.days31To60 = row.balance;
+			else if (days <= 90) row.days61To90 = row.balance;
+			else row.daysOver90 = row.balance;
+		}
+		return [...rows.values()].filter((row) => row.balance > 0);
+	}
+	/**
+	* Get account balance
+	*
+	* For debit-normal accounts (Asset, Expense): balance = debits - credits
+	* For credit-normal accounts (Liability, Equity, Revenue): balance = credits - debits
+	*
+	* @param accountId - Account ID
+	* @param asOfDate - Optional date to calculate balance as of
+	* @returns Account balance
+	*/
+	async getAccountBalance(accountId, asOfDate) {
+		const { JournalCollection } = await Promise.resolve().then(() => Journals_exports);
+		const journalCollection = await JournalCollection.create(this.options);
+		const { AccountCollection } = await Promise.resolve().then(() => Accounts_exports);
+		const account = await (await AccountCollection.create(this.options)).get({ id: accountId });
+		if (!account) throw new Error(`Account not found: ${accountId}`);
+		const allEntries = await this.findByAccount(accountId);
+		let totalDebits = 0;
+		let totalCredits = 0;
+		for (const entry of allEntries) {
+			const journal = await journalCollection.get({ id: entry.journalId });
+			if (!journal) continue;
+			if (!journal.isPosted()) continue;
+			if (asOfDate && journal.date > asOfDate) continue;
+			totalDebits += entry.debit;
+			totalCredits += entry.credit;
+		}
+		if (account.isDebitNormal()) return totalDebits - totalCredits;
+		else return totalCredits - totalDebits;
+	}
+	/**
+	* Get trial balance
+	*
+	* @param asOfDate - Optional date for trial balance
+	* @returns Array of trial balance rows
+	*/
+	async getTrialBalance(asOfDate) {
+		const { AccountCollection } = await Promise.resolve().then(() => Accounts_exports);
+		const accounts = await (await AccountCollection.create(this.options)).findActive();
+		const rows = [];
+		for (const account of accounts) {
+			if (!account.id) continue;
+			const balance = await this.getAccountBalance(account.id, asOfDate);
+			if (Math.abs(balance) < .001) continue;
+			rows.push({
+				accountId: account.id,
+				accountNumber: account.number,
+				accountName: account.name,
+				accountType: account.type,
+				debitBalance: account.isDebitNormal() && balance > 0 ? balance : 0,
+				creditBalance: account.isCreditNormal() && balance > 0 ? balance : 0
+			});
+		}
+		rows.sort((a, b) => a.accountNumber.localeCompare(b.accountNumber));
+		return rows;
+	}
+	/**
+	* Get total debits and credits for a date range
+	*
+	* @param start - Start date
+	* @param end - End date
+	* @returns Object with totalDebits and totalCredits
+	*/
+	async getTotalsForDateRange(start, end) {
+		const { JournalCollection } = await Promise.resolve().then(() => Journals_exports);
+		const journals = await (await JournalCollection.create(this.options)).findByDateRange(start, end);
+		let totalDebits = 0;
+		let totalCredits = 0;
+		for (const journal of journals) {
+			if (!journal.isPosted()) continue;
+			const entries = await this.findByJournal(journal.id);
+			for (const entry of entries) {
+				totalDebits += entry.debit;
+				totalCredits += entry.credit;
+			}
+		}
+		return {
+			totalDebits,
+			totalCredits
+		};
+	}
+	/**
+	* Get entries for multiple accounts
+	*
+	* @param accountIds - Array of account IDs
+	* @returns Array of entries
+	*/
+	async findByAccounts(accountIds) {
+		if (accountIds.length === 0) return [];
+		return await this.list({ where: { accountId: accountIds } });
+	}
+	/**
+	* Read tenant-owned movements from posted journals only. Amounts deliberately
+	* remain raw ledger units; commerce validates its minor-unit convention at
+	* the reporting boundary.
+	*/
+	async listPostedMovements(options) {
+		if (getTenantId() && getTenantId() !== options.tenantId) throw new Error("Posted movements tenant differs from active context");
+		const accountIds = [...new Set(options.accountIds)];
+		if (!options.tenantId?.trim() || !options.currency?.trim() || !(options.from instanceof Date) || !(options.to instanceof Date) || !Number.isFinite(options.from.getTime()) || !Number.isFinite(options.to.getTime()) || options.from > options.to) throw new Error("Posted movements require tenant, currency and ordered dates.");
+		if (accountIds.length === 0) return [];
+		if (accountIds.length > MAX_MOVEMENT_ACCOUNTS) throw new RangeError(`Posted movements allow at most ${MAX_MOVEMENT_ACCOUNTS} accounts per query.`);
+		if (accountIds.some((id) => typeof id !== "string" || !id || id.trim() !== id)) throw new Error("Posted movement account IDs must be nonempty.");
+		const placeholders = accountIds.map(() => "?").join(", ");
+		return (await this.db.query(`SELECT e.id AS entry_id, e.journal_id, e.account_id, e.currency,
+              e.debit, e.credit, j.date AS journal_date, j.number AS journal_number,
+              j.source_module, j.source_ref
+         FROM journal_entries e
+         JOIN journals j ON j.id = e.journal_id AND j.tenant_id = e.tenant_id
+        WHERE e.tenant_id = ? AND e.account_id IN (${placeholders})
+          AND e.currency = ? AND j.status = 'posted'
+          AND j.date >= ? AND j.date <= ?
+        ORDER BY j.date ASC, j.id ASC, e.id ASC`, options.tenantId, ...accountIds, options.currency, options.from.toISOString(), options.to.toISOString())).rows.map((row) => {
+			const debit = storedUnit(row.debit, "debit");
+			const credit = storedUnit(row.credit, "credit");
+			const movement = credit - debit;
+			if (!Number.isFinite(movement) || Math.abs(movement) > Number.MAX_SAFE_INTEGER) throw new RangeError("Posted journal movement is outside the supported numeric range.");
+			return {
+				tenantId: options.tenantId,
+				entryId: String(row.entry_id),
+				journalId: String(row.journal_id),
+				accountId: String(row.account_id),
+				journalDate: new Date(String(row.journal_date)),
+				journalNumber: String(row.journal_number),
+				sourceModule: String(row.source_module),
+				sourceRef: row.source_ref == null ? null : String(row.source_ref),
+				currency: String(row.currency),
+				debit,
+				credit,
+				creditMinusDebit: movement
+			};
+		});
+	}
+	/**
+	* Get the running balance for an account (list of entries with running total)
+	*
+	* @param accountId - Account ID
+	* @returns Array of entries with running balance
+	*/
+	async getAccountLedger(accountId) {
+		const { JournalCollection } = await Promise.resolve().then(() => Journals_exports);
+		const { AccountCollection } = await Promise.resolve().then(() => Accounts_exports);
+		const journalCollection = await JournalCollection.create(this.options);
+		const account = await (await AccountCollection.create(this.options)).get({ id: accountId });
+		if (!account) throw new Error(`Account not found: ${accountId}`);
+		const entries = await this.findByAccount(accountId);
+		const ledger = [];
+		let runningBalance = 0;
+		const entriesWithJournals = await Promise.all(entries.map(async (entry) => ({
+			entry,
+			journal: await journalCollection.get({ id: entry.journalId })
+		})));
+		entriesWithJournals.sort((a, b) => {
+			if (!a.journal || !b.journal) return 0;
+			return a.journal.date.getTime() - b.journal.date.getTime();
+		});
+		for (const { entry, journal } of entriesWithJournals) {
+			if (!journal?.isPosted()) continue;
+			if (account.isDebitNormal()) runningBalance += entry.debit - entry.credit;
+			else runningBalance += entry.credit - entry.debit;
+			ledger.push({
+				entry,
+				runningBalance
+			});
+		}
+		return ledger;
+	}
+	/**
+	* Find all journal entries belonging to a specific tenant
+	*
+	* @param tenantId - Tenant ID
+	* @returns Array of tenant's journal entries
+	*/
+	async findByTenant(tenantId) {
+		return this.list({ where: { tenantId } });
+	}
+	/**
+	* Find all global journal entries (no tenant association).
+	*
+	* Routes through the shared tenant-global helper so it does not throw under
+	* an active tenant context. (#1600)
+	*
+	* @returns Array of global journal entries
+	*/
+	async findGlobal() {
+		return queryGlobal(this);
+	}
+	/**
+	* Find journal entries for a tenant plus all global entries.
+	*
+	* Fails closed if an active tenant context requests a different tenant's
+	* rows; the admin/system path keeps the cross-tenant capability. (#1600)
+	*
+	* @param tenantId - Tenant ID
+	* @returns Array of tenant's entries and global entries
+	*/
+	async findWithGlobals(tenantId) {
+		return queryWithGlobals(this, tenantId, "JournalEntry.findWithGlobals");
+	}
+};
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, {
+	enumerable: true,
+	configurable: true,
+	writable: true,
+	value
+}) : obj[key] = value;
+var __decorateClass = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+	if (kind && result) __defProp(target, key, result);
+	return result;
+};
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var Journal = class extends SmrtObject {
+	tenantId = null;
+	number = "";
+	date = /* @__PURE__ */ new Date();
+	description = "";
+	/**
+	* Source module that created this journal (e.g., "smrt-commerce", "manual")
+	*/
+	sourceModule = "";
+	/**
+	* External reference (e.g., order ID, invoice number)
+	*/
+	sourceRef = null;
+	ledgerId = null;
+	idempotencyKey = null;
+	requestDigest = null;
+	status = "draft";
+	postedAt = null;
+	/**
+	* When the journal was voided
+	*/
+	voidedAt = null;
+	/**
+	* Reason for voiding (if voided)
+	*/
+	voidReason = null;
+	/**
+	* Extensible metadata
+	*/
+	metadata = {};
+	constructor(options = {}) {
+		super(options);
+		if (options.tenantId !== void 0) this.tenantId = options.tenantId;
+		if (options.number !== void 0) this.number = options.number;
+		if (options.date !== void 0) this.date = options.date;
+		if (options.description !== void 0) this.description = options.description;
+		if (options.sourceModule !== void 0) this.sourceModule = options.sourceModule;
+		if (options.sourceRef !== void 0) this.sourceRef = options.sourceRef;
+		if (options.ledgerId !== void 0) this.ledgerId = options.ledgerId;
+		if (options.idempotencyKey !== void 0) this.idempotencyKey = options.idempotencyKey;
+		if (options.requestDigest !== void 0) this.requestDigest = options.requestDigest;
+		if (options.status !== void 0) this.status = options.status;
+		if (options.postedAt !== void 0) this.postedAt = options.postedAt;
+		if (options.voidedAt !== void 0) this.voidedAt = options.voidedAt;
+		if (options.voidReason !== void 0) this.voidReason = options.voidReason;
+		if (options.metadata !== void 0) this.metadata = options.metadata;
+	}
+	/**
+	* Check if journal is in draft status
+	*/
+	isDraft() {
+		return this.status === "draft";
+	}
+	/**
+	* Check if journal has been posted
+	*/
+	isPosted() {
+		return this.status === "posted";
+	}
+	/**
+	* Check if journal has been voided
+	*/
+	isVoided() {
+		return this.status === "voided";
+	}
+	/**
+	* Check if journal can be modified
+	*/
+	isEditable() {
+		return this.status === "draft";
+	}
+	/**
+	* Get all entries for this journal
+	*/
+	async getEntries() {
+		if (!this.id) return [];
+		const { JournalEntryCollection } = await Promise.resolve().then(() => JournalEntries_exports);
+		return await (await JournalEntryCollection.create(this.options)).findByJournal(this.id);
+	}
+	/**
+	* Calculate total debits
+	*/
+	async getTotalDebits() {
+		return (await this.getEntries()).reduce((sum, entry) => sum + entry.debit, 0);
+	}
+	/**
+	* Calculate total credits
+	*/
+	async getTotalCredits() {
+		return (await this.getEntries()).reduce((sum, entry) => sum + entry.credit, 0);
+	}
+	/**
+	* Check if journal entries are balanced (debits = credits)
+	*/
+	async isBalanced() {
+		const debits = await this.getTotalDebits();
+		const credits = await this.getTotalCredits();
+		const ledger = await this.getLedger();
+		if (!ledger || ledger.balanceMode === "tolerant") return Math.abs(debits - credits) < BALANCE_EPSILON;
+		const entries = await this.getEntries();
+		return Number.isSafeInteger(debits) && Number.isSafeInteger(credits) && entries.every((entry) => Number.isSafeInteger(entry.debit) && Number.isSafeInteger(entry.credit)) && debits === credits;
+	}
+	async getLedger() {
+		if (!this.ledgerId) return null;
+		const { LedgerCollection } = await Promise.resolve().then(() => Ledgers_exports);
+		return (await LedgerCollection.create(this.options)).get({ id: this.ledgerId });
+	}
+	/**
+	* Add an entry to this journal (only if draft)
+	*/
+	async addEntry(data) {
+		if (!this.id) throw new Error("Journal must be saved before adding entries");
+		if (!this.isEditable()) throw new Error("Cannot add entries to a posted or voided journal");
+		const { JournalEntryCollection } = await Promise.resolve().then(() => JournalEntries_exports);
+		const entry = await (await JournalEntryCollection.create(this.options)).create({
+			journalId: this.id,
+			tenantId: this.tenantId,
+			accountId: data.accountId,
+			counterpartyKind: data.counterpartyKind ?? null,
+			counterpartyId: data.counterpartyId ?? null,
+			dueDate: data.dueDate ?? null,
+			settlesSourceRef: data.settlesSourceRef ?? null,
+			debit: data.debit || 0,
+			credit: data.credit || 0,
+			currency: data.currency || "USD",
+			exchangeRate: data.exchangeRate || 1,
+			memo: data.memo || ""
+		});
+		await entry.save();
+		if (this.ledgerId) {
+			const parent = await entry.getJournal();
+			this.updated_at = parent?.updated_at ?? this.updated_at;
+		}
+	}
+	/**
+	* Post the journal (finalize and make immutable)
+	*/
+	async post() {
+		if (!this.isDraft()) throw new Error("Only draft journals can be posted");
+		await this.validatePosting();
+		this.status = "posted";
+		this.postedAt = /* @__PURE__ */ new Date();
+		await this.save();
+	}
+	/**
+	* Void the journal (mark as cancelled with reason)
+	*/
+	async void(reason) {
+		if (this.isVoided()) throw new Error("Journal is already voided");
+		this.status = "voided";
+		this.voidedAt = /* @__PURE__ */ new Date();
+		this.voidReason = reason;
+		await this.save();
+	}
+	async validatePosting() {
+		if (!await this.isBalanced()) {
+			const debits = await this.getTotalDebits();
+			const credits = await this.getTotalCredits();
+			throw new Error(`Journal is not balanced. Debits: ${debits}, Credits: ${credits}`);
+		}
+		const entries = await this.getEntries();
+		if (entries.length === 0) throw new Error("Journal must have at least one entry");
+		const ledger = await this.getLedger();
+		if (this.ledgerId && !ledger) throw new Error(`Ledger not found: ${this.ledgerId}`);
+		if (ledger) {
+			if (ledger.tenantId !== this.tenantId) throw new Error("Journal and ledger must belong to the same tenant");
+			if (entries.some((entry) => entry.currency !== ledger.currency)) throw new Error(`Journal entries must use ledger currency ${ledger.currency}`);
+		}
+		const { AccountCollection } = await Promise.resolve().then(() => Accounts_exports);
+		const accounts = await AccountCollection.create(this.options);
+		for (const entry of entries) {
+			const account = await accounts.get({ id: entry.accountId });
+			if ((this.ledgerId || account?.ledgerId) && (!account || !account.active || account.tenantId !== this.tenantId || entry.tenantId !== this.tenantId || account.ledgerId !== this.ledgerId)) throw new Error("Journal entries must use active accounts owned by the journal ledger");
+		}
+	}
+	async save(options = {}) {
+		return this.withTransaction(async () => {
+			if (this.isPersisted && this.updated_at) {
+				await this.claimRevision(options.expectedUpdatedAt ?? this.updated_at);
+				if (options.expectedUpdatedAt !== void 0) options = {
+					...options,
+					expectedUpdatedAt: this.updated_at
+				};
+			}
+			return super.save(options);
+		});
+	}
+	async validateBeforeSave() {
+		await super.validateBeforeSave();
+		this.requireInsertOnSave({ preserveDerivedSlug: true });
+		if (this.id) {
+			const stored = await this.db.get(this.tableName, { id: this.id });
+			if (stored && stored.ledger_id !== this.ledgerId) throw new Error("Journal ledger scope is immutable after creation");
+			if (stored?.ledger_id && stored.status !== "draft") throw new Error("Ledger journals are immutable after posting; use a compensating journal");
+		}
+		if (this.status === "posted") {
+			if (this.ledgerId) await this.validatePosting();
+			else for (const entry of await this.getEntries()) if ((await entry.getAccount())?.ledgerId) throw new Error("Scoped accounts require their journal ledger");
+		}
+	}
+	async delete(options = {}) {
+		await this.withTransaction(async () => {
+			if (this.isPersisted && this.updated_at) {
+				await this.claimRevision(options.expectedUpdatedAt ?? this.updated_at);
+				if (options.expectedUpdatedAt !== void 0) options = {
+					...options,
+					expectedUpdatedAt: this.updated_at
+				};
+			}
+			const stored = this.id ? await this.db.get(this.tableName, { id: this.id }) : null;
+			if (stored?.ledger_id && stored.status !== "draft") throw new Error("Ledger journals are immutable after posting");
+			await super.delete(options);
+		});
+	}
+	/**
+	* AI-powered: Generate a summary of this journal.
+	*
+	* Uses the `smrtLedgers.journal.summarize` prompt registered via
+	* `@happyvertical/smrt-prompts`, allowing tenant- or instance-level
+	* overrides of the template, model, and parameters at runtime.
+	*
+	* Only non-PII journal fields (number, date, description, status, balanced
+	* flag) plus aggregate totals and entry count are sent to the AI provider.
+	* Internal foreign-key fields (tenantId, sourceRef, individual entry
+	* account IDs) and the extensible `metadata` blob are intentionally
+	* excluded.
+	*
+	* @returns Generated summary text
+	*/
+	async summarize() {
+		const entries = await this.getEntries();
+		const debits = await this.getTotalDebits();
+		const balanced = await this.isBalanced();
+		const db = this.options.db ?? this.options.persistence;
+		const resolvedPrompt = await resolvePrompt(smrtLedgersJournalSummarizePrompt.key, {
+			db,
+			tenantId: this.tenantId,
+			variables: {
+				journalNumber: this.number || "",
+				journalDate: this.date.toISOString().split("T")[0],
+				journalDescription: this.description || "",
+				journalStatus: this.status || "",
+				journalTotal: `$${debits.toFixed(2)}`,
+				entryCount: String(entries.length),
+				journalBalanced: balanced ? "Yes" : "No"
+			}
+		});
+		return (await (await this.getAiClient()).message(resolvedPrompt.text, promptMessageOptions(resolvedPrompt.ai))).trim();
+	}
+};
+__publicField(Journal, "__smrtPackage__", "@happyvertical/smrt-ledgers");
+__decorateClass([tenantId({ nullable: true })], Journal.prototype, "tenantId", 2);
+__decorateClass([field({ description: "The journal's reference number." })], Journal.prototype, "number", 2);
+__decorateClass([field({ description: "The date of the transaction." })], Journal.prototype, "date", 2);
+__decorateClass([field({ description: "What the transaction was." })], Journal.prototype, "description", 2);
+__decorateClass([field({
+	description: "The ledger policy that governs this journal.",
+	nullable: true
+}), foreignKey(Ledger)], Journal.prototype, "ledgerId", 2);
+__decorateClass([field({ nullable: true })], Journal.prototype, "idempotencyKey", 2);
+__decorateClass([field({ description: "draft until final, then posted, or voided." })], Journal.prototype, "status", 2);
+__decorateClass([field({ description: "When it was posted." })], Journal.prototype, "postedAt", 2);
+Journal = __decorateClass([TenantScoped({ mode: "optional" }), smrt({
+	api: { include: [
+		"list",
+		"get",
+		"create"
+	] },
+	mcp: { include: [
+		"list",
+		"get",
+		"create"
+	] },
+	cli: { skipApiCheck: true },
+	indexes: [{
+		name: "journals_ledger_idempotency_key",
+		columns: [
+			"tenantId",
+			"ledgerId",
+			"idempotencyKey"
+		],
+		unique: true
+	}]
+})], Journal);
+var Journals_exports = /* @__PURE__ */ __exportAll({ JournalCollection: () => JournalCollection });
+var JournalCollection = class extends SmrtCollection {
+	static _itemClass = Journal;
+	/**
+	* Generate next journal number
+	*
+	* Uses timestamp and random component to avoid collisions
+	* in concurrent environments without relying on shared state.
+	*/
+	generateJournalNumber() {
+		return `JNL-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`;
+	}
+	/**
+	* Find journal by number
+	*
+	* @param number - Journal number
+	* @returns Journal or null
+	*/
+	async findByNumber(number) {
+		return (await this.list({
+			where: { number },
+			limit: 1
+		}))[0] || null;
+	}
+	/**
+	* Find journals by date range
+	*
+	* @param start - Start date
+	* @param end - End date
+	* @returns Array of journals
+	*/
+	async findByDateRange(start, end) {
+		return await this.list({
+			where: {
+				"date >=": start.toISOString(),
+				"date <=": end.toISOString()
+			},
+			orderBy: "date ASC"
+		});
+	}
+	/**
+	* Find journals by source module
+	*
+	* @param sourceModule - Source module name
+	* @returns Array of journals
+	*/
+	async findBySource(sourceModule) {
+		return await this.list({
+			where: { sourceModule },
+			orderBy: "date DESC"
+		});
+	}
+	/**
+	* Find journals by status
+	*
+	* @param status - Journal status
+	* @returns Array of journals
+	*/
+	async findByStatus(status) {
+		return await this.list({
+			where: { status },
+			orderBy: "date DESC"
+		});
+	}
+	/**
+	* Find draft journals
+	*
+	* @returns Array of draft journals
+	*/
+	async findDrafts() {
+		return await this.findByStatus("draft");
+	}
+	/**
+	* Find posted journals
+	*
+	* @returns Array of posted journals
+	*/
+	async findPosted() {
+		return await this.findByStatus("posted");
+	}
+	/**
+	* Create a complete journal with entries
+	*
+	* @param data - Journal data with entries
+	* @returns Created journal
+	*/
+	async createWithEntries(data) {
+		let totalDebits = 0;
+		let totalCredits = 0;
+		for (const entry of data.entries) {
+			totalDebits += entry.debit || 0;
+			totalCredits += entry.credit || 0;
+		}
+		if (Math.abs(totalDebits - totalCredits) >= .001) throw new Error(`Entries are not balanced. Debits: ${totalDebits}, Credits: ${totalCredits}`);
+		if (data.entries.length === 0) throw new Error("Journal must have at least one entry");
+		const journalNumber = await this.generateJournalNumber();
+		const journal = await this.create({
+			tenantId: data.tenantId ?? null,
+			number: journalNumber,
+			date: data.date || /* @__PURE__ */ new Date(),
+			description: data.description,
+			sourceModule: data.sourceModule || "manual",
+			sourceRef: data.sourceRef || null,
+			ledgerId: data.ledgerId ?? null,
+			idempotencyKey: data.idempotencyKey ?? null,
+			requestDigest: data.requestDigest ?? null,
+			metadata: data.metadata || {}
+		});
+		await journal.save();
+		for (const entryData of data.entries) await journal.addEntry(entryData);
+		return journal;
+	}
+	/**
+	* Post a journal by ID
+	*
+	* @param journalId - Journal ID
+	* @returns Posted journal
+	*/
+	async post(journalId) {
+		const journal = await this.get({ id: journalId });
+		if (!journal) throw new Error(`Journal not found: ${journalId}`);
+		await journal.post();
+		return journal;
+	}
+	/**
+	* Void a journal by ID
+	*
+	* @param journalId - Journal ID
+	* @param reason - Reason for voiding
+	* @returns Voided journal
+	*/
+	async void(journalId, reason) {
+		const journal = await this.get({ id: journalId });
+		if (!journal) throw new Error(`Journal not found: ${journalId}`);
+		await journal.void(reason);
+		return journal;
+	}
+	/**
+	* Find journals by source reference
+	*
+	* @param sourceRef - External reference
+	* @returns Array of journals
+	*/
+	async findBySourceRef(sourceRef) {
+		return await this.list({
+			where: { sourceRef },
+			orderBy: "date DESC"
+		});
+	}
+	/**
+	* Get journals for a specific month
+	*
+	* @param year - Year
+	* @param month - Month (1-12)
+	* @returns Array of journals
+	*/
+	async findByMonth(year, month) {
+		const start = new Date(year, month - 1, 1);
+		const end = new Date(year, month, 0, 23, 59, 59, 999);
+		return await this.findByDateRange(start, end);
+	}
+	/**
+	* Find all journals belonging to a specific tenant
+	*
+	* @param tenantId - Tenant ID
+	* @returns Array of tenant's journals
+	*/
+	async findByTenant(tenantId) {
+		return this.list({ where: { tenantId } });
+	}
+	/**
+	* Find all global journals (no tenant association).
+	*
+	* Routes through the shared tenant-global helper so it does not throw under
+	* an active tenant context. (#1600)
+	*
+	* @returns Array of global journals
+	*/
+	async findGlobal() {
+		return queryGlobal(this);
+	}
+	/**
+	* Find journals for a tenant plus all global journals.
+	*
+	* Fails closed if an active tenant context requests a different tenant's
+	* rows; the admin/system path keeps the cross-tenant capability. (#1600)
+	*
+	* @param tenantId - Tenant ID
+	* @returns Array of tenant's journals and global journals
+	*/
+	async findWithGlobals(tenantId) {
+		return queryWithGlobals(this, tenantId, "Journal.findWithGlobals");
+	}
+};
+var Ledgers_exports = /* @__PURE__ */ __exportAll({ LedgerCollection: () => LedgerCollection });
+var LedgerCollection = class extends SmrtCollection {
+	static _itemClass = Ledger;
+};
+var LEDGER_ACCOUNTS_TABLE = "ledger_accounts";
+var LEGACY_ACCOUNTS_TABLE = "accounts";
+var LEGACY_LEDGER_SIGNATURE = ["number", "type"];
+var STI_DISCRIMINATOR = "_meta_type";
+var MESSAGING_MARKERS = ["provider_type", "channel_type"];
+var LedgerAccountsTableMoveError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "LedgerAccountsTableMoveError";
+	}
+};
+function quote(identifier) {
+	return `"${identifier.replace(/"/g, "\"\"")}"`;
+}
+function timeout(value, fallback) {
+	const milliseconds = value ?? fallback;
+	if (!Number.isInteger(milliseconds) || milliseconds < 0) throw new LedgerAccountsTableMoveError("Migration timeout must be a non-negative integer");
+	return `${milliseconds}ms`;
+}
+function assertPostgres(db) {
+	const withConfig = db;
+	if (detectEngine(db.url || withConfig.config?.url || "", withConfig.type || withConfig.config?.type) !== "postgres") throw new LedgerAccountsTableMoveError("The ledger accounts table move supports PostgreSQL only. For a SQLite database whose `accounts` table holds only ledger accounts, run `ALTER TABLE accounts RENAME TO ledger_accounts` before `db:migrate`; see the smrt-ledgers README.");
+}
+async function readLegacyShape(db) {
+	const schema = await db.getTableSchema?.(LEGACY_ACCOUNTS_TABLE);
+	if (!schema) return null;
+	const columns = new Set(Object.keys(schema.columns));
+	if (!LEGACY_LEDGER_SIGNATURE.every((column) => columns.has(column))) return null;
+	return {
+		columns,
+		hasDiscriminator: columns.has(STI_DISCRIMINATOR)
+	};
+}
+function ledgerRowPredicate(shape) {
+	return shape.hasDiscriminator ? `(${quote(STI_DISCRIMINATOR)} IS NULL OR ${quote(STI_DISCRIMINATOR)} = '')` : "TRUE";
+}
+async function count(db, where) {
+	const result = await db.query(`SELECT COUNT(*) AS n FROM ${quote(LEGACY_ACCOUNTS_TABLE)} WHERE ${where}`);
+	return Number(result.rows[0].n);
+}
+async function classify(db, shape) {
+	const ledger = ledgerRowPredicate(shape);
+	const pending = await count(db, ledger);
+	const messagingRows = shape.hasDiscriminator ? await count(db, `NOT ${ledger}`) : 0;
+	if (shape.hasDiscriminator) {
+		const ledgerLooking = await count(db, `NOT ${ledger} AND COALESCE(${quote("number")}, '') <> ''`);
+		const markers = MESSAGING_MARKERS.filter((column) => shape.columns.has(column));
+		const messagingLooking = markers.length === 0 ? 0 : await count(db, `${ledger} AND (${markers.map((column) => `COALESCE(${quote(column)}, '') <> ''`).join(" OR ")})`);
+		if (ledgerLooking > 0 || messagingLooking > 0) throw new LedgerAccountsTableMoveError(`Refusing to move ledger accounts: ${ledgerLooking} messaging row(s) carry a ledger account number and ${messagingLooking} ledger row(s) carry a messaging provider or channel in "${LEGACY_ACCOUNTS_TABLE}". Resolve their ownership by hand, then rerun.`);
+	}
+	return {
+		pending,
+		messagingRows
+	};
+}
+function registeredReferenceColumns() {
+	const ledger = /* @__PURE__ */ new Set();
+	const accounts = /* @__PURE__ */ new Set();
+	const schemas = ObjectRegistry.getAllSchemasAsDefinitions();
+	for (const [tableName, schema] of Object.entries(schemas)) for (const [columnName, column] of Object.entries(schema.columns ?? {})) {
+		const target = column.foreignKey?.table;
+		if (target === "ledger_accounts") ledger.add(`${tableName}.${columnName}`);
+		else if (target === "accounts") accounts.add(`${tableName}.${columnName}`);
+	}
+	return {
+		ledger,
+		accounts
+	};
+}
+function classifyForeignKeys(inbound, references) {
+	const disposition = {
+		composite: [],
+		undeclared: [],
+		detach: [],
+		keep: []
+	};
+	for (const fk of inbound) {
+		const key = `${fk.table}.${fk.column}`;
+		if (fk.arity > 1) disposition.composite.push(fk);
+		else if (references.ledger.has(key)) disposition.detach.push(fk);
+		else if (fk.table === "accounts" || references.accounts.has(key)) disposition.keep.push(fk);
+		else disposition.undeclared.push(fk);
+	}
+	return disposition;
+}
+function foreignKeyRefusal(disposition) {
+	if (disposition.composite.length > 0) return `Composite foreign key(s) ${disposition.composite.map((fk) => `${fk.constraint} on ${fk.table} (${fk.arity} columns)`).join(", ")} reference "${LEGACY_ACCOUNTS_TABLE}"; no model can declare one, so the move cannot carry it. Nothing was moved. Drop it, or replace it with a single-column reference, then rerun.`;
+	if (disposition.undeclared.length > 0) return `Foreign key(s) ${disposition.undeclared.map((fk) => `${fk.table}.${fk.column}`).join(", ")} reference "${LEGACY_ACCOUNTS_TABLE}" but no registered model declares them; nothing was moved. Run the move from the application whose models declare them, or retarget each to "${LEDGER_ACCOUNTS_TABLE}" (or drop it) by hand, then rerun.`;
+}
+function copySelectList(columns, targetTypes, legacyTypes) {
+	return columns.map((column) => {
+		const to = targetTypes[column];
+		return sameType(legacyTypes[column], to) ? quote(column) : `CAST(CAST(${quote(column)} AS TEXT) AS ${targetType(to)})`;
+	}).join(", ");
+}
+async function legacyForeignKeys(db) {
+	return (await db.query(`SELECT con.conname AS constraint_name,
+            rel.relname AS table_name,
+            att.attname AS column_name,
+            array_length(con.conkey, 1) AS arity
+       FROM pg_constraint con
+       JOIN pg_class rel ON rel.oid = con.conrelid
+       JOIN pg_attribute att
+         ON att.attrelid = con.conrelid AND att.attnum = con.conkey[1]
+      WHERE con.contype = 'f'
+        AND con.confrelid = to_regclass(?)
+      ORDER BY rel.relname, con.conname`, quote(LEGACY_ACCOUNTS_TABLE))).rows.map((row) => ({
+		constraint: row.constraint_name,
+		table: row.table_name,
+		column: row.column_name,
+		arity: Number(row.arity)
+	}));
+}
+async function planLedgerAccountsTableMove(db) {
+	const shape = await readLegacyShape(db);
+	if (!shape) return {
+		legacyTable: false,
+		pending: 0,
+		messagingRows: 0
+	};
+	return {
+		legacyTable: true,
+		...await classify(db, shape)
+	};
+}
+async function migrateLedgerAccountsTable(db, options = {}) {
+	assertPostgres(db);
+	if (!db.transaction) throw new LedgerAccountsTableMoveError("The ledger accounts table move requires a transaction-capable PostgreSQL adapter");
+	const noop = (remainingLegacyRows = 0) => ({
+		ran: false,
+		moved: 0,
+		remainingLegacyRows,
+		detachedForeignKeys: []
+	});
+	const shape = await readLegacyShape(db);
+	if (!shape) return noop();
+	const target = await db.getTableSchema?.(LEDGER_ACCOUNTS_TABLE);
+	if (!target) throw new LedgerAccountsTableMoveError(`"${LEDGER_ACCOUNTS_TABLE}" does not exist; run db:migrate before moving ledger accounts`);
+	const legacy = await db.getTableSchema?.(LEGACY_ACCOUNTS_TABLE);
+	const copyColumns = Object.keys(target.columns).filter((column) => shape.columns.has(column));
+	const references = registeredReferenceColumns();
+	await new BackfillTracker({ db }).initialize();
+	const backfillName = options.backfillName ?? "@happyvertical/smrt-ledgers:ledger-accounts-table:v1";
+	return db.transaction(async (tx) => {
+		BackfillTracker.inheritInitialization(tx, db);
+		const transactionTracker = new BackfillTracker({ db: tx });
+		await tx.query(`SET LOCAL lock_timeout = '${timeout(options.lockTimeout, 3e4)}'`);
+		await tx.query(`SET LOCAL statement_timeout = '${timeout(options.statementTimeout, 6e4)}'`);
+		await tx.query(`LOCK TABLE ${quote(LEGACY_ACCOUNTS_TABLE)}, ${quote(LEDGER_ACCOUNTS_TABLE)} IN ACCESS EXCLUSIVE MODE`);
+		const { pending, messagingRows } = await classify(tx, shape);
+		if (await transactionTracker.isApplied(backfillName)) {
+			if (pending > 0) throw new LedgerAccountsTableMoveError(`The ledger accounts table move is recorded as applied but "${LEGACY_ACCOUNTS_TABLE}" still holds ${pending} ledger row(s); refusing inconsistent state`);
+			return noop(messagingRows);
+		}
+		const ledger = ledgerRowPredicate(shape);
+		const clash = await tx.query(`SELECT COUNT(*) AS n FROM ${quote(LEGACY_ACCOUNTS_TABLE)} legacy
+        WHERE ${ledger}
+          AND EXISTS (SELECT 1 FROM ${quote(LEDGER_ACCOUNTS_TABLE)} moved
+                       WHERE CAST(moved.id AS TEXT) = CAST(legacy.id AS TEXT))`);
+		if (Number(clash.rows[0].n) > 0) throw new LedgerAccountsTableMoveError(`"${LEDGER_ACCOUNTS_TABLE}" already holds ids of ledger rows still in "${LEGACY_ACCOUNTS_TABLE}"; refusing to overwrite`);
+		const disposition = classifyForeignKeys(await legacyForeignKeys(tx), references);
+		const refusal = foreignKeyRefusal(disposition);
+		if (refusal) throw new LedgerAccountsTableMoveError(refusal);
+		for (const fk of disposition.keep) {
+			const survivor = fk.table === "accounts" ? ` AND NOT ${ledger}` : "";
+			const pointing = await tx.query(`SELECT COUNT(*) AS n FROM ${quote(fk.table)}
+          WHERE ${quote(fk.column)} IN
+                (SELECT id FROM ${quote(LEGACY_ACCOUNTS_TABLE)} WHERE ${ledger})${survivor}`);
+			if (Number(pointing.rows[0].n) > 0) throw new LedgerAccountsTableMoveError(`${fk.table}.${fk.column} references ledger accounts in "${LEGACY_ACCOUNTS_TABLE}" but is not a ledger reference; nothing was moved. Resolve those rows by hand, then rerun.`);
+		}
+		const selectList = copySelectList(copyColumns, columnTypes(target), columnTypes(legacy));
+		await tx.query(`INSERT INTO ${quote(LEDGER_ACCOUNTS_TABLE)} (${copyColumns.map(quote).join(", ")})
+       SELECT ${selectList} FROM ${quote(LEGACY_ACCOUNTS_TABLE)} WHERE ${ledger}`);
+		const detached = [];
+		for (const foreignKey of disposition.detach) {
+			await tx.query(`ALTER TABLE ${quote(foreignKey.table)} DROP CONSTRAINT ${quote(foreignKey.constraint)}`);
+			detached.push(`${foreignKey.table}.${foreignKey.column}`);
+		}
+		await tx.query(`DELETE FROM ${quote(LEGACY_ACCOUNTS_TABLE)} WHERE ${ledger}`);
+		await transactionTracker.recordApplied(backfillName, {
+			description: "Moved ledger accounts from the shared accounts table to ledger_accounts (#3098).",
+			packageName: options.packageName ?? "@happyvertical/smrt-ledgers"
+		});
+		return {
+			ran: true,
+			moved: pending,
+			remainingLegacyRows: messagingRows,
+			detachedForeignKeys: detached
+		};
+	});
+}
+var SQL_TYPE = /^[A-Za-z][A-Za-z0-9 _]*(\(\d+(,\s*\d+)?\))?(\[\])?$/;
+function columnTypes(schema) {
+	return Object.fromEntries(Object.entries(schema?.columns ?? {}).map(([name, column]) => [name, column.type]));
+}
+function sameType(from, to) {
+	return from !== void 0 && to !== void 0 && from.trim().toLowerCase() === to.trim().toLowerCase();
+}
+function targetType(declared) {
+	const type = declared?.trim();
+	if (!type || !SQL_TYPE.test(type)) throw new LedgerAccountsTableMoveError(`Cannot copy into "${LEDGER_ACCOUNTS_TABLE}": unsupported live column type ${JSON.stringify(type)}`);
+	return type;
+}
+//#endregion
+export { migrateLedgerAccountsTable, JournalEntries_exports as n, planLedgerAccountsTableMove, Accounts_exports as r, Ledgers_exports as t };