@happyvertical/smrt-expenses 0.0.0-stage → 0.53.0

package/dist/chunks/Expense-C1uUZbAr.js

@@ -0,0 +1,513 @@
+import { ExpenseError } from "../types.js";
+import { ObjectRegistry, SmrtObject, crossPackageRef, field, foreignKey, isUniqueViolationError, smrt } from "@happyvertical/smrt-core";
+import { ContractCollection, ContractLineItemCollection, VendorCollection } from "@happyvertical/smrt-commerce";
+import { TenantScoped, getTenantId, tenantId } from "@happyvertical/smrt-tenancy";
+import { createHash } from "node:crypto";
+//#region src/validation.ts
+var CATEGORY_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+var ISO_CURRENCY = /^[A-Z]{3}$/;
+var ISO_DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
+var QUALIFIED_CLASS = /^[^\s:]+:[A-Za-z_$][\w$]*$/;
+var SHA256_HEX = /^[0-9a-f]{64}$/;
+function assertMinorUnits(model, label, fieldName, value, code = "EXPENSE_INVALID") {
+	if (!Number.isSafeInteger(value) || value < 0) throw new ExpenseError(code, `${model} ${label}: ${fieldName} must be a non-negative integer number of minor units (cents) \u2014 got ${value}. $19.99 is 1999.`);
+}
+function assertIsoCurrency(model, label, value) {
+	if (!ISO_CURRENCY.test(value)) throw new ExpenseError("EXPENSE_INVALID", `${model} ${label}: currency must be a three-letter ISO 4217 code (for example 'USD'), got '${value}'.`);
+}
+function assertIsoDate(model, label, fieldName, value) {
+	const match = ISO_DATE.exec(value);
+	if (!(match !== null && (() => {
+		const [year, month, day] = match.slice(1).map(Number);
+		const date = new Date(Date.UTC(year, month - 1, day));
+		return date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day;
+	})())) throw new ExpenseError("EXPENSE_INVALID", `${model} ${label}: ${fieldName} must be a calendar date written YYYY-MM-DD, got '${value}'.`);
+}
+function assertQualifiedClassName(model, label, value) {
+	if (!QUALIFIED_CLASS.test(value)) throw new ExpenseError("EXPENSE_INVALID", `${model} ${label}: costObjectType must be a qualified class name such as '@happyvertical/smrt-projects:Project', got '${value}'.`);
+}
+function normalizeSha256(model, label, value) {
+	const digest = String(value ?? "").trim().toLowerCase();
+	if (!SHA256_HEX.test(digest)) throw new ExpenseError("EXPENSE_RECEIPT_INVALID", `${model} ${label}: contentSha256 must be a 64-character hex SHA-256 digest of the file bytes.`);
+	return digest;
+}
+function computeContentSha256(data) {
+	return createHash("sha256").update(data).digest("hex");
+}
+function instantMs(value) {
+	if (value === null || value === void 0 || value === "") return null;
+	const ms = value instanceof Date ? value.getTime() : new Date(String(value)).getTime();
+	return Number.isNaN(ms) ? null : ms;
+}
+async function pinNaturalKey(model, object, persisted) {
+	await object.getSlug();
+	if (!object.isPersisted) {
+		if (persisted) throw new ExpenseError("EXPENSE_IDENTITY_CONFLICT", `${model} ${object.id} already exists; load it and save the loaded instance instead of creating one with its id.`);
+		object.requireInsertOnSave();
+		return true;
+	}
+	if (persisted && (String(persisted.slug ?? "") !== String(object.slug ?? "") || String(persisted.context ?? "") !== String(object.context ?? ""))) throw new ExpenseError("EXPENSE_IDENTITY_CONFLICT", `${model} ${object.id}: slug and context cannot change; they would point the save at a different row.`);
+	return false;
+}
+function identityConflict(model, object, cause) {
+	return new ExpenseError("EXPENSE_IDENTITY_CONFLICT", `${model} ${object.id}: another row already uses slug '${object.slug}' in this tenant; a new ${model} cannot take it over.`, { cause });
+}
+function effectiveTenant(tenantId) {
+	return tenantId || getTenantId() || null;
+}
+function normalizeTenantId(tenantId) {
+	return tenantId || null;
+}
+//#endregion
+//#region src/models/Expense.ts
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+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 PROFILE = "@happyvertical/smrt-profiles:Profile";
+var REVIEW_TRANSITIONS = {
+	review: {
+		from: ["unreviewed"],
+		to: "reviewed"
+	},
+	reject: {
+		from: ["unreviewed", "reviewed"],
+		to: "rejected"
+	},
+	markDuplicate: {
+		from: ["unreviewed", "reviewed"],
+		to: "rejected"
+	},
+	reopen: {
+		from: ["reviewed", "rejected"],
+		to: "unreviewed"
+	}
+};
+var LOCKED_WHEN_REVIEWED = [
+	["amount", "amount"],
+	["currency", "currency"],
+	["incurredOn", "incurred_on"],
+	["recordedAt", "recorded_at"],
+	["category", "category"],
+	["costObjectType", "cost_object_type"],
+	["costObjectId", "cost_object_id"],
+	["vendorId", "vendor_id"],
+	["commitmentId", "commitment_id"],
+	["commitmentLineId", "commitment_line_id"],
+	["paidBy", "paid_by"],
+	["paidByProfileId", "paid_by_profile_id"]
+];
+var authorizedTransition = /* @__PURE__ */ new WeakMap();
+function sameReviewState(a, b) {
+	return a.status === b.status && a.reviewer === b.reviewer && a.reviewedAtMs === b.reviewedAtMs && a.note === b.note && a.duplicateOf === b.duplicateOf;
+}
+function asNullableString(value) {
+	return value === null || value === void 0 || value === "" ? null : String(value);
+}
+var Expense = class extends SmrtObject {
+	tenantId = null;
+	costObjectType = "";
+	costObjectId = "";
+	category = "other";
+	description = "";
+	amount = 0;
+	currency = "";
+	incurredOn = "";
+	/** When the expense was recorded; set on first save when empty. */
+	recordedAt = null;
+	recordedByProfileId = null;
+	paidBy = "company";
+	paidByProfileId = null;
+	vendorId = null;
+	commitmentId = null;
+	commitmentLineId = null;
+	reviewStatus = "unreviewed";
+	reviewedByProfileId = null;
+	reviewedAt = null;
+	reviewNote = "";
+	duplicateOfId = null;
+	reimbursable = false;
+	/** When the person was paid back; set by {@link Expense.markReimbursed}. */
+	reimbursedAt = null;
+	reimbursementReference = "";
+	constructor(options = {}) {
+		super(options);
+		if (options.tenantId !== void 0) this.tenantId = options.tenantId;
+		if (options.costObjectType !== void 0) this.costObjectType = options.costObjectType;
+		if (options.costObjectId !== void 0) this.costObjectId = options.costObjectId;
+		if (options.category !== void 0) this.category = options.category;
+		if (options.description !== void 0) this.description = options.description;
+		if (options.amount !== void 0) this.amount = options.amount;
+		if (options.currency !== void 0) this.currency = options.currency;
+		if (options.incurredOn !== void 0) this.incurredOn = options.incurredOn;
+		if (options.recordedAt !== void 0) this.recordedAt = options.recordedAt;
+		if (options.recordedByProfileId !== void 0) this.recordedByProfileId = options.recordedByProfileId;
+		if (options.paidBy !== void 0) this.paidBy = options.paidBy;
+		if (options.paidByProfileId !== void 0) this.paidByProfileId = options.paidByProfileId;
+		if (options.vendorId !== void 0) this.vendorId = options.vendorId;
+		if (options.commitmentId !== void 0) this.commitmentId = options.commitmentId;
+		if (options.commitmentLineId !== void 0) this.commitmentLineId = options.commitmentLineId;
+		if (options.reimbursable !== void 0) this.reimbursable = options.reimbursable;
+		if (options.reimbursedAt !== void 0) this.reimbursedAt = options.reimbursedAt;
+		if (options.reimbursementReference !== void 0) this.reimbursementReference = options.reimbursementReference;
+	}
+	/** True when the person who paid has been paid back. */
+	isReimbursed() {
+		return this.reimbursedAt !== null && this.reimbursedAt !== void 0;
+	}
+	/** True when this expense counts toward reviewed totals and drawdown. */
+	isCountable() {
+		return this.reviewStatus === "reviewed" && !this.duplicateOfId;
+	}
+	/**
+	* Accept the expense as a real cost: `unreviewed → reviewed`.
+	*
+	* This is the separately authorizable review action: gate it in your route
+	* or service (for example on `expenses.review`). The expense must already
+	* be saved and must not be marked a duplicate.
+	*
+	* @throws {ExpenseError} `EXPENSE_REVIEW_TRANSITION` from any other state.
+	*/
+	async review(input) {
+		const reviewer = requireReviewer(input?.reviewerProfileId);
+		return this.transition("review", () => {
+			this.reviewStatus = "reviewed";
+			this.reviewedByProfileId = reviewer;
+			this.reviewedAt = input.at ?? /* @__PURE__ */ new Date();
+			this.reviewNote = input.note ?? "";
+			this.duplicateOfId = null;
+		});
+	}
+	/**
+	* Refuse the expense: `unreviewed | reviewed → rejected`. A rejected
+	* expense is kept and shown, and never counted.
+	*
+	* @throws {ExpenseError} `EXPENSE_REVIEW_TRANSITION` from `rejected`, or
+	*   `EXPENSE_INVALID` without a reason.
+	*/
+	async reject(input) {
+		const reviewer = requireReviewer(input?.reviewerProfileId);
+		const reason = (input.reason ?? "").trim();
+		if (!reason) throw new ExpenseError("EXPENSE_INVALID", "A rejection needs a reason.");
+		return this.transition("reject", () => {
+			this.reviewStatus = "rejected";
+			this.reviewedByProfileId = reviewer;
+			this.reviewedAt = input.at ?? /* @__PURE__ */ new Date();
+			this.reviewNote = reason;
+			this.duplicateOfId = null;
+		});
+	}
+	/**
+	* Mark this expense a duplicate of another expense in the same tenant:
+	* `unreviewed | reviewed → rejected` with {@link Expense.duplicateOfId}
+	* set. A duplicate never counts toward any total.
+	*
+	* @throws {ExpenseError} `EXPENSE_INVALID` when the target is this expense
+	*   or is not visible in this expense's tenant.
+	*/
+	async markDuplicate(input) {
+		const reviewer = requireReviewer(input?.reviewerProfileId);
+		const targetId = String(input.duplicateOfId ?? "").trim();
+		if (!targetId || targetId === this.id) throw new ExpenseError("EXPENSE_INVALID", "An expense can only be a duplicate of a different expense.");
+		const { ExpenseCollection } = await import("../index.js").then((n) => n.t);
+		const target = await (await ExpenseCollection.create({ db: this.db })).get({ id: targetId });
+		if (!target || (target.tenantId ?? null) !== (this.tenantId ?? null)) throw new ExpenseError("EXPENSE_INVALID", `Expense ${targetId} was not found in this expense's tenant.`);
+		return this.transition("markDuplicate", () => {
+			this.reviewStatus = "rejected";
+			this.reviewedByProfileId = reviewer;
+			this.reviewedAt = input.at ?? /* @__PURE__ */ new Date();
+			this.reviewNote = `Duplicate of expense ${targetId}`;
+			this.duplicateOfId = targetId;
+		});
+	}
+	/**
+	* Send the expense back for review: `reviewed | rejected → unreviewed`.
+	* Clears the reviewer, the review time and any duplicate marker.
+	*
+	* @throws {ExpenseError} `EXPENSE_REVIEW_TRANSITION` from `unreviewed`.
+	*/
+	async reopen(input) {
+		requireReviewer(input?.reviewerProfileId);
+		return this.transition("reopen", () => {
+			this.reviewStatus = "unreviewed";
+			this.reviewedByProfileId = null;
+			this.reviewedAt = null;
+			this.reviewNote = input.note ?? "";
+			this.duplicateOfId = null;
+		});
+	}
+	/**
+	* Record that the person who paid has been paid back. Recording only:
+	* paying happens in payroll or payables, and this never changes the review
+	* state.
+	*
+	* @throws {ExpenseError} `EXPENSE_INVALID` unless the expense is
+	*   `reimbursable`.
+	*/
+	async markReimbursed(input = {}) {
+		if (!this.reimbursable) throw new ExpenseError("EXPENSE_INVALID", `Expense ${this.id} is not owed back to anyone.`);
+		this.reimbursedAt = input.at ?? /* @__PURE__ */ new Date();
+		if (input.reference !== void 0) this.reimbursementReference = input.reference;
+		return this.save();
+	}
+	/**
+	* Load the cost object this expense is charged to, through its registered
+	* collection (so tenant interceptors apply). Returns `null` when unset,
+	* when the type is not registered, when the row is gone, or when the row
+	* belongs to a different tenant than this expense.
+	*/
+	async getCostObject() {
+		if (!this.costObjectType || !this.costObjectId) return null;
+		let registered = ObjectRegistry.getClassByQualifiedName(this.costObjectType);
+		if (!registered) {
+			if (!await ObjectRegistry.tryLoadFromExternalPackage(this.costObjectType)) return null;
+			registered = ObjectRegistry.getClassByQualifiedName(this.costObjectType);
+		}
+		if (!registered) return null;
+		const target = await (await ObjectRegistry.getCollection(registered.qualifiedName ?? this.costObjectType, { db: this.db })).get({ id: this.costObjectId });
+		if (!target) return null;
+		const targetTenant = target.tenantId;
+		if (targetTenant !== void 0 && targetTenant !== null && this.tenantId !== null && targetTenant !== this.tenantId) return null;
+		return target;
+	}
+	/**
+	* Validate, enforce the review and reviewed-field locks, check the
+	* commitment, then persist.
+	*/
+	async save() {
+		this.normalize();
+		this.validateShape();
+		const persisted = await this.readPersisted();
+		const inserting = await pinNaturalKey("Expense", this, persisted);
+		if (persisted && String(persisted.tenant_id ?? "") !== String(effectiveTenant(this.tenantId) ?? "")) throw new ExpenseError("EXPENSE_INVALID", `Expense ${this.id}: its tenant cannot change after it is recorded.`);
+		this.assertReviewFields(persisted);
+		this.assertReviewedLock(persisted);
+		await this.assertCommitment(persisted);
+		await this.assertVendor(persisted);
+		if (!this.recordedAt) this.recordedAt = /* @__PURE__ */ new Date();
+		try {
+			return await super.save();
+		} catch (error) {
+			if (inserting && isUniqueViolationError(error)) throw identityConflict("Expense", this, error);
+			throw error;
+		}
+	}
+	normalize() {
+		this.tenantId = normalizeTenantId(this.tenantId);
+		this.currency = String(this.currency ?? "").trim().toUpperCase();
+		this.category = String(this.category ?? "").trim();
+		this.costObjectType = String(this.costObjectType ?? "").trim();
+		this.costObjectId = String(this.costObjectId ?? "").trim();
+		this.incurredOn = String(this.incurredOn ?? "").trim();
+		this.vendorId = asNullableString(this.vendorId);
+		this.commitmentId = asNullableString(this.commitmentId);
+		this.commitmentLineId = asNullableString(this.commitmentLineId);
+		this.paidByProfileId = asNullableString(this.paidByProfileId);
+		this.recordedByProfileId = asNullableString(this.recordedByProfileId);
+	}
+	validateShape() {
+		const label = this.id || "<new>";
+		assertMinorUnits("Expense", label, "amount", this.amount);
+		assertIsoCurrency("Expense", label, this.currency);
+		assertIsoDate("Expense", label, "incurredOn", this.incurredOn);
+		if (!CATEGORY_PATTERN.test(this.category) || this.category.length > 64) throw new ExpenseError("EXPENSE_INVALID", `Expense ${label}: category must be lowercase kebab-case (for example 'outside-service'), got '${this.category}'.`);
+		if (Boolean(this.costObjectType) !== Boolean(this.costObjectId)) throw new ExpenseError("EXPENSE_INVALID", `Expense ${label}: costObjectType and costObjectId are set together or not at all.`);
+		if (this.costObjectType) assertQualifiedClassName("Expense", label, this.costObjectType);
+		if (this.paidBy !== "company" && this.paidBy !== "person") throw new ExpenseError("EXPENSE_INVALID", `Expense ${label}: paidBy must be 'company' or 'person'.`);
+		if (this.paidBy === "person" && !this.paidByProfileId) throw new ExpenseError("EXPENSE_INVALID", `Expense ${label}: an expense paid by a person names that person (paidByProfileId).`);
+		if (this.paidBy === "company" && this.paidByProfileId) throw new ExpenseError("EXPENSE_INVALID", `Expense ${label}: paidByProfileId is only set when paidBy is 'person'.`);
+		if (this.reimbursable && this.paidBy !== "person") throw new ExpenseError("EXPENSE_INVALID", `Expense ${label}: only an expense a person paid can be owed back.`);
+		if (this.reimbursedAt && !this.reimbursable) throw new ExpenseError("EXPENSE_INVALID", `Expense ${label}: reimbursedAt needs reimbursable.`);
+		if (this.reviewStatus === "reviewed" && this.duplicateOfId) throw new ExpenseError("EXPENSE_INVALID", `Expense ${label}: a reviewed expense cannot be marked a duplicate.`);
+		if (this.commitmentLineId && !this.commitmentId) throw new ExpenseError("EXPENSE_INVALID", `Expense ${label}: a commitment line needs its commitment (commitmentId).`);
+	}
+	/**
+	* Read the stored row directly. The authoritative prior state for the
+	* review and lock guards: the in-memory copy may have been mass-assigned.
+	*/
+	async readPersisted() {
+		if (!this.id) return null;
+		return await this.db.get(this.tableName, { id: this.id }) ?? null;
+	}
+	reviewState() {
+		return {
+			status: this.reviewStatus,
+			reviewer: asNullableString(this.reviewedByProfileId),
+			reviewedAtMs: instantMs(this.reviewedAt),
+			note: this.reviewNote ?? "",
+			duplicateOf: asNullableString(this.duplicateOfId)
+		};
+	}
+	/**
+	* Refuse any review-field change a transition did not authorize. The token
+	* binds the transition's complete resulting state — status, reviewer,
+	* time, note and duplicate marker — so a field set directly beside a
+	* legitimate `review()` / `reject()` cannot ride along with it.
+	*/
+	assertReviewFields(persisted) {
+		const token = authorizedTransition.get(this);
+		const prior = {
+			status: persisted?.review_status ?? "unreviewed",
+			reviewer: asNullableString(persisted?.reviewed_by_profile_id),
+			reviewedAtMs: instantMs(persisted?.reviewed_at),
+			note: String(persisted?.review_note ?? ""),
+			duplicateOf: asNullableString(persisted?.duplicate_of_id)
+		};
+		const current = this.reviewState();
+		if (sameReviewState(current, prior)) return;
+		if (!token || token.from !== prior.status || !sameReviewState(current, token.expected)) throw new ExpenseError("EXPENSE_REVIEW_FIELDS_LOCKED", `Expense ${this.id || "<new>"}: review state changes only through review(), reject(), markDuplicate() or reopen().`);
+	}
+	assertReviewedLock(persisted) {
+		if (persisted?.review_status !== "reviewed") return;
+		const self = this;
+		for (const [fieldName, column] of LOCKED_WHEN_REVIEWED) {
+			const before = persisted[column];
+			const after = self[fieldName];
+			if (!(fieldName === "amount" ? Number(before) === Number(after) : fieldName === "recordedAt" ? instantMs(before) === instantMs(after) : asNullableString(before) === asNullableString(after))) throw new ExpenseError("EXPENSE_REVIEW_FIELDS_LOCKED", `Expense ${this.id}: ${fieldName} of a reviewed expense cannot change; reopen() it first.`);
+		}
+	}
+	/**
+	* A matched commitment must be visible in this expense's tenant, owned by
+	* the same tenant, and in the same currency; a matched line must belong to
+	* it. Mixed currencies are refused here rather than summed later.
+	*
+	* Checked when the match is made or changed, not on every save: a later
+	* change to the commitment (its currency, or its deletion) must not stop
+	* an unrelated save such as recording a reimbursement.
+	*/
+	async assertCommitment(persisted) {
+		if (!this.commitmentId) return;
+		if (persisted && asNullableString(persisted.commitment_id) === this.commitmentId && asNullableString(persisted.commitment_line_id) === this.commitmentLineId && String(persisted.currency ?? "") === this.currency) return;
+		const commitment = await (await ContractCollection.create({ db: this.db })).get({ id: this.commitmentId });
+		const owner = effectiveTenant(this.tenantId);
+		if (!commitment || !sameTenant(commitment.tenantId, owner)) throw new ExpenseError("EXPENSE_COMMITMENT_MISMATCH", `Expense ${this.id || "<new>"}: commitment ${this.commitmentId} was not found in this expense's tenant.`);
+		if (String(commitment.currency).toUpperCase() !== this.currency) throw new ExpenseError("EXPENSE_COMMITMENT_MISMATCH", `Expense ${this.id || "<new>"}: currency ${this.currency} does not match commitment ${this.commitmentId} (${commitment.currency}). Amounts in different currencies are never summed.`);
+		if (this.commitmentLineId) {
+			const line = await (await ContractLineItemCollection.create({ db: this.db })).get({ id: this.commitmentLineId });
+			if (!line || line.contractId !== this.commitmentId) throw new ExpenseError("EXPENSE_COMMITMENT_MISMATCH", `Expense ${this.id || "<new>"}: line ${this.commitmentLineId} is not a line of commitment ${this.commitmentId}.`);
+		}
+	}
+	/**
+	* A vendor must be visible in, and owned by, the expense's tenant. A
+	* `crossPackageRef` neither validates its target nor creates a foreign
+	* key, so without this an expense in one tenant could name another
+	* tenant's vendor. Checked when the vendor is set or changed.
+	*/
+	async assertVendor(persisted) {
+		if (!this.vendorId) return;
+		if (persisted && asNullableString(persisted.vendor_id) === this.vendorId) return;
+		const vendor = await (await VendorCollection.create({ db: this.db })).get({ id: this.vendorId });
+		const owner = effectiveTenant(this.tenantId);
+		if (!vendor || !sameTenant(vendor.tenantId, owner)) throw new ExpenseError("EXPENSE_VENDOR_MISMATCH", `Expense ${this.id || "<new>"}: vendor ${this.vendorId} was not found in this expense's tenant.`);
+	}
+	async transition(action, apply) {
+		const rule = REVIEW_TRANSITIONS[action];
+		const persisted = await this.readPersisted();
+		if (!persisted) throw new ExpenseError("EXPENSE_REVIEW_TRANSITION", `Expense ${this.id || "<new>"}: save the expense before ${action}().`);
+		const from = String(persisted.review_status);
+		if (!rule.from.includes(from)) throw new ExpenseError("EXPENSE_REVIEW_TRANSITION", `Expense ${this.id}: cannot ${action}() an expense that is ${from}.`);
+		if (action === "review" && persisted.duplicate_of_id) throw new ExpenseError("EXPENSE_REVIEW_TRANSITION", `Expense ${this.id}: a duplicate cannot be reviewed; reopen() it first.`);
+		const snapshot = {
+			reviewStatus: this.reviewStatus,
+			reviewedByProfileId: this.reviewedByProfileId,
+			reviewedAt: this.reviewedAt,
+			reviewNote: this.reviewNote,
+			duplicateOfId: this.duplicateOfId
+		};
+		apply();
+		authorizedTransition.set(this, {
+			from,
+			expected: this.reviewState()
+		});
+		try {
+			return await this.save();
+		} catch (error) {
+			Object.assign(this, snapshot);
+			throw error;
+		} finally {
+			authorizedTransition.delete(this);
+		}
+	}
+};
+__decorateClass([tenantId({ nullable: true })], Expense.prototype, "tenantId", 2);
+__decorateClass([field({ type: "text" })], Expense.prototype, "costObjectType", 2);
+__decorateClass([field({ type: "text" })], Expense.prototype, "costObjectId", 2);
+__decorateClass([field({ type: "text" })], Expense.prototype, "category", 2);
+__decorateClass([field({ type: "text" })], Expense.prototype, "description", 2);
+__decorateClass([field({ type: "integer" })], Expense.prototype, "amount", 2);
+__decorateClass([field({ type: "text" })], Expense.prototype, "currency", 2);
+__decorateClass([field({ type: "text" })], Expense.prototype, "incurredOn", 2);
+__decorateClass([crossPackageRef(PROFILE)], Expense.prototype, "recordedByProfileId", 2);
+__decorateClass([field({ type: "text" })], Expense.prototype, "paidBy", 2);
+__decorateClass([crossPackageRef(PROFILE)], Expense.prototype, "paidByProfileId", 2);
+__decorateClass([crossPackageRef("@happyvertical/smrt-commerce:Vendor")], Expense.prototype, "vendorId", 2);
+__decorateClass([crossPackageRef("@happyvertical/smrt-commerce:Contract")], Expense.prototype, "commitmentId", 2);
+__decorateClass([crossPackageRef("@happyvertical/smrt-commerce:ContractLineItem")], Expense.prototype, "commitmentLineId", 2);
+__decorateClass([field({
+	type: "text",
+	readonly: true
+})], Expense.prototype, "reviewStatus", 2);
+__decorateClass([crossPackageRef(PROFILE, { readonly: true })], Expense.prototype, "reviewedByProfileId", 2);
+__decorateClass([field({
+	type: "datetime",
+	readonly: true
+})], Expense.prototype, "reviewedAt", 2);
+__decorateClass([field({
+	type: "text",
+	readonly: true
+})], Expense.prototype, "reviewNote", 2);
+__decorateClass([foreignKey("Expense", {
+	readonly: true,
+	onDelete: "SET NULL"
+})], Expense.prototype, "duplicateOfId", 2);
+__decorateClass([field({ type: "boolean" })], Expense.prototype, "reimbursable", 2);
+__decorateClass([field({ type: "text" })], Expense.prototype, "reimbursementReference", 2);
+Expense = __decorateClass([TenantScoped({ mode: "optional" }), smrt({
+	tableName: "expenses",
+	api: { include: [] },
+	mcp: { include: [] },
+	cli: false,
+	indexes: [
+		{
+			name: "expenses_cost_object_idx",
+			columns: [
+				"tenantId",
+				"costObjectType",
+				"costObjectId",
+				"incurredOn"
+			]
+		},
+		{
+			name: "expenses_commitment_review_idx",
+			columns: [
+				"tenantId",
+				"commitmentId",
+				"reviewStatus"
+			]
+		},
+		{
+			name: "expenses_review_status_idx",
+			columns: [
+				"tenantId",
+				"reviewStatus",
+				"incurredOn"
+			]
+		}
+	]
+})], Expense);
+function requireReviewer(reviewerProfileId) {
+	const reviewer = String(reviewerProfileId ?? "").trim();
+	if (!reviewer) throw new ExpenseError("EXPENSE_INVALID", "A review decision names its reviewer (reviewerProfileId).");
+	return reviewer;
+}
+function sameTenant(a, b) {
+	return (a ?? null) === (b ?? null);
+}
+//#endregion
+export { identityConflict as a, pinNaturalKey as c, effectiveTenant as i, assertMinorUnits as n, normalizeSha256 as o, computeContentSha256 as r, normalizeTenantId as s, Expense as t };
+
+//# sourceMappingURL=Expense-C1uUZbAr.js.map

package/dist/chunks/Expense-C1uUZbAr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Expense-C1uUZbAr.js","names":[],"sources":["../../src/validation.ts","../../src/models/Expense.ts"],"sourcesContent":["/**\n * Small, pure validators shared by the expense models.\n *\n * @packageDocumentation\n */\n\nimport { createHash } from 'node:crypto';\nimport { getTenantId } from '@happyvertical/smrt-tenancy';\nimport { ExpenseError, type ExpenseErrorCode } from './types.js';\n\n/** Lowercase kebab-case: `material`, `outside-service`. */\nexport const CATEGORY_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;\n\nconst ISO_CURRENCY = /^[A-Z]{3}$/;\nconst ISO_DATE = /^(\\d{4})-(\\d{2})-(\\d{2})$/;\nconst QUALIFIED_CLASS = /^[^\\s:]+:[A-Za-z_$][\\w$]*$/;\nconst SHA256_HEX = /^[0-9a-f]{64}$/;\n\n/**\n * Throw unless `value` is a non-negative, JavaScript-safe integer number of\n * minor units. Money is exact: `$19.99` is `1999`, never `19.99`.\n */\nexport function assertMinorUnits(\n  model: string,\n  label: string,\n  fieldName: string,\n  value: number,\n  code: ExpenseErrorCode = 'EXPENSE_INVALID',\n): void {\n  if (!Number.isSafeInteger(value) || value < 0) {\n    throw new ExpenseError(\n      code,\n      `${model} ${label}: ${fieldName} must be a non-negative integer ` +\n        `number of minor units (cents) — got ${value}. $19.99 is 1999.`,\n    );\n  }\n}\n\n/** Throw unless `value` is an upper-case ISO 4217 code such as `USD`. */\nexport function assertIsoCurrency(\n  model: string,\n  label: string,\n  value: string,\n): void {\n  if (!ISO_CURRENCY.test(value)) {\n    throw new ExpenseError(\n      'EXPENSE_INVALID',\n      `${model} ${label}: currency must be a three-letter ISO 4217 code ` +\n        `(for example 'USD'), got '${value}'.`,\n    );\n  }\n}\n\n/** Throw unless `value` is a real calendar date written `YYYY-MM-DD`. */\nexport function assertIsoDate(\n  model: string,\n  label: string,\n  fieldName: string,\n  value: string,\n): void {\n  const match = ISO_DATE.exec(value);\n  const valid =\n    match !== null &&\n    (() => {\n      const [year, month, day] = match.slice(1).map(Number);\n      const date = new Date(Date.UTC(year, month - 1, day));\n      return (\n        date.getUTCFullYear() === year &&\n        date.getUTCMonth() === month - 1 &&\n        date.getUTCDate() === day\n      );\n    })();\n  if (!valid) {\n    throw new ExpenseError(\n      'EXPENSE_INVALID',\n      `${model} ${label}: ${fieldName} must be a calendar date written ` +\n        `YYYY-MM-DD, got '${value}'.`,\n    );\n  }\n}\n\n/**\n * Throw unless `value` is a package-qualified class name such as\n * `@happyvertical/smrt-projects:Project`. A bare class name is ambiguous\n * (packages can share names) and is refused.\n */\nexport function assertQualifiedClassName(\n  model: string,\n  label: string,\n  value: string,\n): void {\n  if (!QUALIFIED_CLASS.test(value)) {\n    throw new ExpenseError(\n      'EXPENSE_INVALID',\n      `${model} ${label}: costObjectType must be a qualified class name ` +\n        `such as '@happyvertical/smrt-projects:Project', got '${value}'.`,\n    );\n  }\n}\n\n/** Normalize and check a SHA-256 hex digest; returns it in lower case. */\nexport function normalizeSha256(model: string, label: string, value: string) {\n  const digest = String(value ?? '')\n    .trim()\n    .toLowerCase();\n  if (!SHA256_HEX.test(digest)) {\n    throw new ExpenseError(\n      'EXPENSE_RECEIPT_INVALID',\n      `${model} ${label}: contentSha256 must be a 64-character hex SHA-256 ` +\n        'digest of the file bytes.',\n    );\n  }\n  return digest;\n}\n\n/**\n * Lowercase hex SHA-256 of a file's bytes — the value\n * `ExpenseReceipt.contentSha256` expects.\n *\n * @example\n * ```typescript\n * const digest = computeContentSha256(await readFile('receipt.pdf'));\n * ```\n */\nexport function computeContentSha256(data: Uint8Array | string): string {\n  return createHash('sha256').update(data).digest('hex');\n}\n\n/** Milliseconds since the epoch of a date-ish value; `null` when empty. */\nexport function instantMs(value: unknown): number | null {\n  if (value === null || value === undefined || value === '') return null;\n  const ms =\n    value instanceof Date ? value.getTime() : new Date(String(value)).getTime();\n  return Number.isNaN(ms) ? null : ms;\n}\n\n/** The slice of `SmrtObject` the natural-key identity guard needs. */\ninterface NaturalKeyed {\n  id?: string | null;\n  slug?: string | null;\n  context?: string | null;\n  readonly isPersisted: boolean;\n  getSlug(): Promise<unknown>;\n  requireInsertOnSave(): void;\n}\n\n/**\n * Make a save write only the row its guards checked.\n *\n * Core's natural-key save adopts any same-owner row on\n * `(tenant_id, slug, context)` and upserts it without a revision predicate,\n * and these models have no human slug. So:\n *\n * - a fresh (never loaded, never saved) instance may only INSERT\n *   (`requireInsertOnSave`): naming an existing row's id is refused here, and\n *   a row that appears between this check and the write makes the INSERT\n *   fail rather than be adopted;\n * - an existing row is changed only through a loaded instance, whose save\n *   carries core's revision compare-and-swap, and it must keep the slug and\n *   context it is stored under, so the write targets that row and no other.\n *\n * @returns `true` when this save is an INSERT.\n * @throws {ExpenseError} `EXPENSE_IDENTITY_CONFLICT` when a fresh instance\n *   names an existing row, or a loaded one changes its natural key.\n */\nexport async function pinNaturalKey(\n  model: string,\n  object: NaturalKeyed,\n  persisted: Record<string, unknown> | null,\n): Promise<boolean> {\n  await object.getSlug();\n  if (!object.isPersisted) {\n    if (persisted) {\n      throw new ExpenseError(\n        'EXPENSE_IDENTITY_CONFLICT',\n        `${model} ${object.id} already exists; load it and save the loaded ` +\n          'instance instead of creating one with its id.',\n      );\n    }\n    object.requireInsertOnSave();\n    return true;\n  }\n  if (\n    persisted &&\n    (String(persisted.slug ?? '') !== String(object.slug ?? '') ||\n      String(persisted.context ?? '') !== String(object.context ?? ''))\n  ) {\n    throw new ExpenseError(\n      'EXPENSE_IDENTITY_CONFLICT',\n      `${model} ${object.id}: slug and context cannot change; they would ` +\n        'point the save at a different row.',\n    );\n  }\n  return false;\n}\n\n/** The error a refused natural-key INSERT is reported as. */\nexport function identityConflict(\n  model: string,\n  object: { id?: string | null; slug?: string | null },\n  cause: unknown,\n): ExpenseError {\n  return new ExpenseError(\n    'EXPENSE_IDENTITY_CONFLICT',\n    `${model} ${object.id}: another row already uses slug ` +\n      `'${object.slug}' in this tenant; a new ${model} cannot take it over.`,\n    { cause },\n  );\n}\n\n/**\n * The tenant a save will actually write: tenancy's `beforeSave` interceptor\n * fills an unset `tenantId` from the active tenant context, after the\n * model's own checks have run, and \"unset\" is falsy there — `''` included.\n * Compare against this, not the raw field.\n */\nexport function effectiveTenant(\n  tenantId: string | null | undefined,\n): string | null {\n  return tenantId || getTenantId() || null;\n}\n\n/**\n * An empty tenant id is unset, never a tenant of its own: core and tenancy\n * treat it as falsy (and real tenant ids are UUIDs), so it is stored as\n * NULL — a global row — rather than as a `''` pseudo-tenant.\n */\nexport function normalizeTenantId(\n  tenantId: string | null | undefined,\n): string | null {\n  return tenantId || null;\n}\n","/**\n * Expense — a cost someone incurred, against a cost object, with a review\n * state and optional reimbursement and commitment links.\n *\n * @packageDocumentation\n */\n\nimport {\n  ContractCollection,\n  ContractLineItemCollection,\n  VendorCollection,\n} from '@happyvertical/smrt-commerce';\nimport {\n  crossPackageRef,\n  field,\n  foreignKey,\n  isUniqueViolationError,\n  ObjectRegistry,\n  SmrtObject,\n  smrt,\n} from '@happyvertical/smrt-core';\nimport { TenantScoped, tenantId } from '@happyvertical/smrt-tenancy';\nimport {\n  ExpenseError,\n  type ExpenseOptions,\n  type ExpensePayer,\n  type ExpenseReviewStatus,\n  type MarkDuplicateExpenseInput,\n  type MarkReimbursedInput,\n  type RejectExpenseInput,\n  type ReopenExpenseInput,\n  type ReviewExpenseInput,\n} from '../types.js';\nimport {\n  assertIsoCurrency,\n  assertIsoDate,\n  assertMinorUnits,\n  assertQualifiedClassName,\n  CATEGORY_PATTERN,\n  effectiveTenant,\n  identityConflict,\n  instantMs,\n  normalizeTenantId,\n  pinNaturalKey,\n} from '../validation.js';\n\nconst PROFILE = '@happyvertical/smrt-profiles:Profile';\n\n/**\n * Legal review moves, keyed by the persisted status. Only the dedicated\n * methods perform them; `save()` refuses a review-field change they did not\n * authorize.\n */\nconst REVIEW_TRANSITIONS: Record<\n  'review' | 'reject' | 'markDuplicate' | 'reopen',\n  { from: readonly ExpenseReviewStatus[]; to: ExpenseReviewStatus }\n> = {\n  review: { from: ['unreviewed'], to: 'reviewed' },\n  reject: { from: ['unreviewed', 'reviewed'], to: 'rejected' },\n  markDuplicate: { from: ['unreviewed', 'reviewed'], to: 'rejected' },\n  reopen: { from: ['reviewed', 'rejected'], to: 'unreviewed' },\n};\n\n/**\n * Fields a reviewed expense freezes. Changing one needs `reopen()` first, so\n * a reviewed amount can never move without a fresh review.\n */\nconst LOCKED_WHEN_REVIEWED = [\n  ['amount', 'amount'],\n  ['currency', 'currency'],\n  ['incurredOn', 'incurred_on'],\n  ['recordedAt', 'recorded_at'],\n  ['category', 'category'],\n  ['costObjectType', 'cost_object_type'],\n  ['costObjectId', 'cost_object_id'],\n  ['vendorId', 'vendor_id'],\n  ['commitmentId', 'commitment_id'],\n  ['commitmentLineId', 'commitment_line_id'],\n  ['paidBy', 'paid_by'],\n  ['paidByProfileId', 'paid_by_profile_id'],\n] as const;\n\n/** The review transition a dedicated method has authorized for one save. */\nconst authorizedTransition = new WeakMap<\n  Expense,\n  { from: ExpenseReviewStatus; expected: ReviewFieldState }\n>();\n\n/** Every review field, normalized for comparison. */\ninterface ReviewFieldState {\n  status: ExpenseReviewStatus;\n  reviewer: string | null;\n  reviewedAtMs: number | null;\n  note: string;\n  duplicateOf: string | null;\n}\n\nfunction sameReviewState(a: ReviewFieldState, b: ReviewFieldState): boolean {\n  return (\n    a.status === b.status &&\n    a.reviewer === b.reviewer &&\n    a.reviewedAtMs === b.reviewedAtMs &&\n    a.note === b.note &&\n    a.duplicateOf === b.duplicateOf\n  );\n}\n\ntype PersistedRow = Record<string, unknown>;\n\nfunction asNullableString(value: unknown): string | null {\n  return value === null || value === undefined || value === ''\n    ? null\n    : String(value);\n}\n\n/**\n * A cost someone incurred.\n *\n * - **Cost object** — polymorphic `(costObjectType, costObjectId)`: a job, a\n *   work package, a project, any registered SMRT object. Exactly one per\n *   expense, so a cost is never rolled up into two jobs.\n * - **Money** — `amount` in integer minor units with an ISO 4217 `currency`.\n * - **Dates** — `incurredOn` (calendar date, `YYYY-MM-DD`) is when the cost\n *   happened; `recordedAt` is when it was entered.\n * - **Review** — `unreviewed → reviewed | rejected`, only through\n *   {@link Expense.review}, {@link Expense.reject},\n *   {@link Expense.markDuplicate} and {@link Expense.reopen}. A plain field\n *   write to the review state is refused on save.\n * - **Reimbursement** — recording only: whether a person who paid is owed\n *   back and when they were paid. Never changes review state.\n * - **Commitment** — optional commerce `Contract` (usually a `PurchaseOrder`)\n *   or one of its lines that this actual draws down.\n *\n * The generated REST/MCP/CLI surface is closed (`api: { include: [] }`):\n * cost visibility is permission-gated by every consumer, so they expose\n * expenses through their own routes and call the domain methods here.\n */\n@TenantScoped({ mode: 'optional' })\n@smrt({\n  tableName: 'expenses',\n  api: { include: [] },\n  mcp: { include: [] },\n  cli: false,\n  indexes: [\n    {\n      name: 'expenses_cost_object_idx',\n      columns: ['tenantId', 'costObjectType', 'costObjectId', 'incurredOn'],\n    },\n    {\n      name: 'expenses_commitment_review_idx',\n      columns: ['tenantId', 'commitmentId', 'reviewStatus'],\n    },\n    {\n      name: 'expenses_review_status_idx',\n      columns: ['tenantId', 'reviewStatus', 'incurredOn'],\n    },\n  ],\n})\nexport class Expense extends SmrtObject {\n  /** Owning tenant. Nullable: optional tenancy, like every commerce model. */\n  @tenantId({ nullable: true })\n  tenantId: string | null = null;\n\n  /**\n   * Qualified class of the cost object, e.g.\n   * `@happyvertical/smrt-projects:Project`. Empty only for an unallocated\n   * expense (then `costObjectId` is empty too).\n   */\n  @field({ type: 'text' })\n  costObjectType: string = '';\n\n  /** Id of the cost object. Bare string: the target table is polymorphic. */\n  @field({ type: 'text' })\n  costObjectId: string = '';\n\n  /**\n   * Lowercase kebab-case category. See `SUGGESTED_EXPENSE_CATEGORIES`;\n   * any value matching the pattern is accepted.\n   */\n  @field({ type: 'text' })\n  category: string = 'other';\n\n  /** What was bought or paid for. */\n  @field({ type: 'text' })\n  description: string = '';\n\n  /** Amount in integer minor units (cents). `= 0` makes the column INTEGER. */\n  @field({ type: 'integer' })\n  amount: number = 0;\n\n  /** ISO 4217 currency code, upper case. Required. */\n  @field({ type: 'text' })\n  currency: string = '';\n\n  /** Calendar date the cost was incurred, `YYYY-MM-DD`. Required. */\n  @field({ type: 'text' })\n  incurredOn: string = '';\n\n  /** When the expense was recorded; set on first save when empty. */\n  recordedAt: Date | null = null;\n\n  /** Profile that recorded the expense. */\n  @crossPackageRef(PROFILE)\n  recordedByProfileId: string | null = null;\n\n  /** `company`, or `person` (then {@link Expense.paidByProfileId} is set). */\n  @field({ type: 'text' })\n  paidBy: ExpensePayer = 'company';\n\n  /** Profile that paid out of pocket; required when `paidBy` is `person`. */\n  @crossPackageRef(PROFILE)\n  paidByProfileId: string | null = null;\n\n  /** Optional commerce vendor the cost was paid to. */\n  @crossPackageRef('@happyvertical/smrt-commerce:Vendor')\n  vendorId: string | null = null;\n\n  /**\n   * Optional commitment this actual draws down: a commerce `Contract`\n   * (normally a `PurchaseOrder`). Must be in the same currency and tenant.\n   */\n  @crossPackageRef('@happyvertical/smrt-commerce:Contract')\n  commitmentId: string | null = null;\n\n  /** Optional line of {@link Expense.commitmentId} this actual draws down. */\n  @crossPackageRef('@happyvertical/smrt-commerce:ContractLineItem')\n  commitmentLineId: string | null = null;\n\n  /** Review state. Changed only by the review methods. */\n  @field({ type: 'text', readonly: true })\n  reviewStatus: ExpenseReviewStatus = 'unreviewed';\n\n  /** Profile that made the current review decision. */\n  @crossPackageRef(PROFILE, { readonly: true })\n  reviewedByProfileId: string | null = null;\n\n  /** When the current review decision was made. */\n  @field({ type: 'datetime', readonly: true })\n  reviewedAt: Date | null = null;\n\n  /** Review note or rejection reason. */\n  @field({ type: 'text', readonly: true })\n  reviewNote: string = '';\n\n  /**\n   * Set when a reviewer marked this expense a duplicate of another one. A\n   * duplicate is `rejected` and never counts toward any total.\n   */\n  @foreignKey('Expense', { readonly: true, onDelete: 'SET NULL' })\n  duplicateOfId: string | null = null;\n\n  /** Whether the person who paid is owed the amount back. */\n  @field({ type: 'boolean' })\n  reimbursable: boolean = false;\n\n  /** When the person was paid back; set by {@link Expense.markReimbursed}. */\n  reimbursedAt: Date | null = null;\n\n  /** Payroll line, payables reference, or transfer id of the payback. */\n  @field({ type: 'text' })\n  reimbursementReference: string = '';\n\n  constructor(options: ExpenseOptions = {}) {\n    super(options);\n    if (options.tenantId !== undefined) this.tenantId = options.tenantId;\n    if (options.costObjectType !== undefined)\n      this.costObjectType = options.costObjectType;\n    if (options.costObjectId !== undefined)\n      this.costObjectId = options.costObjectId;\n    if (options.category !== undefined) this.category = options.category;\n    if (options.description !== undefined)\n      this.description = options.description;\n    if (options.amount !== undefined) this.amount = options.amount;\n    if (options.currency !== undefined) this.currency = options.currency;\n    if (options.incurredOn !== undefined) this.incurredOn = options.incurredOn;\n    if (options.recordedAt !== undefined) this.recordedAt = options.recordedAt;\n    if (options.recordedByProfileId !== undefined)\n      this.recordedByProfileId = options.recordedByProfileId;\n    if (options.paidBy !== undefined) this.paidBy = options.paidBy;\n    if (options.paidByProfileId !== undefined)\n      this.paidByProfileId = options.paidByProfileId;\n    if (options.vendorId !== undefined) this.vendorId = options.vendorId;\n    if (options.commitmentId !== undefined)\n      this.commitmentId = options.commitmentId;\n    if (options.commitmentLineId !== undefined)\n      this.commitmentLineId = options.commitmentLineId;\n    if (options.reimbursable !== undefined)\n      this.reimbursable = options.reimbursable;\n    if (options.reimbursedAt !== undefined)\n      this.reimbursedAt = options.reimbursedAt;\n    if (options.reimbursementReference !== undefined)\n      this.reimbursementReference = options.reimbursementReference;\n  }\n\n  /** True when the person who paid has been paid back. */\n  isReimbursed(): boolean {\n    return this.reimbursedAt !== null && this.reimbursedAt !== undefined;\n  }\n\n  /** True when this expense counts toward reviewed totals and drawdown. */\n  isCountable(): boolean {\n    return this.reviewStatus === 'reviewed' && !this.duplicateOfId;\n  }\n\n  /**\n   * Accept the expense as a real cost: `unreviewed → reviewed`.\n   *\n   * This is the separately authorizable review action: gate it in your route\n   * or service (for example on `expenses.review`). The expense must already\n   * be saved and must not be marked a duplicate.\n   *\n   * @throws {ExpenseError} `EXPENSE_REVIEW_TRANSITION` from any other state.\n   */\n  async review(input: ReviewExpenseInput): Promise<this> {\n    const reviewer = requireReviewer(input?.reviewerProfileId);\n    return this.transition('review', () => {\n      this.reviewStatus = 'reviewed';\n      this.reviewedByProfileId = reviewer;\n      this.reviewedAt = input.at ?? new Date();\n      this.reviewNote = input.note ?? '';\n      this.duplicateOfId = null;\n    });\n  }\n\n  /**\n   * Refuse the expense: `unreviewed | reviewed → rejected`. A rejected\n   * expense is kept and shown, and never counted.\n   *\n   * @throws {ExpenseError} `EXPENSE_REVIEW_TRANSITION` from `rejected`, or\n   *   `EXPENSE_INVALID` without a reason.\n   */\n  async reject(input: RejectExpenseInput): Promise<this> {\n    const reviewer = requireReviewer(input?.reviewerProfileId);\n    const reason = (input.reason ?? '').trim();\n    if (!reason) {\n      throw new ExpenseError('EXPENSE_INVALID', 'A rejection needs a reason.');\n    }\n    return this.transition('reject', () => {\n      this.reviewStatus = 'rejected';\n      this.reviewedByProfileId = reviewer;\n      this.reviewedAt = input.at ?? new Date();\n      this.reviewNote = reason;\n      this.duplicateOfId = null;\n    });\n  }\n\n  /**\n   * Mark this expense a duplicate of another expense in the same tenant:\n   * `unreviewed | reviewed → rejected` with {@link Expense.duplicateOfId}\n   * set. A duplicate never counts toward any total.\n   *\n   * @throws {ExpenseError} `EXPENSE_INVALID` when the target is this expense\n   *   or is not visible in this expense's tenant.\n   */\n  async markDuplicate(input: MarkDuplicateExpenseInput): Promise<this> {\n    const reviewer = requireReviewer(input?.reviewerProfileId);\n    const targetId = String(input.duplicateOfId ?? '').trim();\n    if (!targetId || targetId === this.id) {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        'An expense can only be a duplicate of a different expense.',\n      );\n    }\n    const { ExpenseCollection } = await import(\n      '../collections/ExpenseCollection.js'\n    );\n    const expenses = await ExpenseCollection.create({ db: this.db });\n    const target = await expenses.get({ id: targetId });\n    if (!target || (target.tenantId ?? null) !== (this.tenantId ?? null)) {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${targetId} was not found in this expense's tenant.`,\n      );\n    }\n    return this.transition('markDuplicate', () => {\n      this.reviewStatus = 'rejected';\n      this.reviewedByProfileId = reviewer;\n      this.reviewedAt = input.at ?? new Date();\n      this.reviewNote = `Duplicate of expense ${targetId}`;\n      this.duplicateOfId = targetId;\n    });\n  }\n\n  /**\n   * Send the expense back for review: `reviewed | rejected → unreviewed`.\n   * Clears the reviewer, the review time and any duplicate marker.\n   *\n   * @throws {ExpenseError} `EXPENSE_REVIEW_TRANSITION` from `unreviewed`.\n   */\n  async reopen(input: ReopenExpenseInput): Promise<this> {\n    requireReviewer(input?.reviewerProfileId);\n    return this.transition('reopen', () => {\n      this.reviewStatus = 'unreviewed';\n      this.reviewedByProfileId = null;\n      this.reviewedAt = null;\n      this.reviewNote = input.note ?? '';\n      this.duplicateOfId = null;\n    });\n  }\n\n  /**\n   * Record that the person who paid has been paid back. Recording only:\n   * paying happens in payroll or payables, and this never changes the review\n   * state.\n   *\n   * @throws {ExpenseError} `EXPENSE_INVALID` unless the expense is\n   *   `reimbursable`.\n   */\n  async markReimbursed(input: MarkReimbursedInput = {}): Promise<this> {\n    if (!this.reimbursable) {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${this.id} is not owed back to anyone.`,\n      );\n    }\n    this.reimbursedAt = input.at ?? new Date();\n    if (input.reference !== undefined)\n      this.reimbursementReference = input.reference;\n    return this.save();\n  }\n\n  /**\n   * Load the cost object this expense is charged to, through its registered\n   * collection (so tenant interceptors apply). Returns `null` when unset,\n   * when the type is not registered, when the row is gone, or when the row\n   * belongs to a different tenant than this expense.\n   */\n  async getCostObject<T extends SmrtObject = SmrtObject>(): Promise<T | null> {\n    if (!this.costObjectType || !this.costObjectId) return null;\n    let registered = ObjectRegistry.getClassByQualifiedName(\n      this.costObjectType,\n    );\n    if (!registered) {\n      const loaded = await ObjectRegistry.tryLoadFromExternalPackage(\n        this.costObjectType,\n      );\n      if (!loaded) return null;\n      registered = ObjectRegistry.getClassByQualifiedName(this.costObjectType);\n    }\n    if (!registered) return null;\n    const collection = await ObjectRegistry.getCollection<SmrtObject>(\n      registered.qualifiedName ?? this.costObjectType,\n      { db: this.db },\n    );\n    const target = await collection.get({ id: this.costObjectId });\n    if (!target) return null;\n    const targetTenant = (target as unknown as { tenantId?: string | null })\n      .tenantId;\n    if (\n      targetTenant !== undefined &&\n      targetTenant !== null &&\n      this.tenantId !== null &&\n      targetTenant !== this.tenantId\n    ) {\n      return null;\n    }\n    return target as T;\n  }\n\n  /**\n   * Validate, enforce the review and reviewed-field locks, check the\n   * commitment, then persist.\n   */\n  override async save(): Promise<this> {\n    this.normalize();\n    this.validateShape();\n\n    const persisted = await this.readPersisted();\n    // The guards below check `persisted`; pin the write to that row.\n    const inserting = await pinNaturalKey('Expense', this, persisted);\n    if (\n      persisted &&\n      String(persisted.tenant_id ?? '') !==\n        String(effectiveTenant(this.tenantId) ?? '')\n    ) {\n      // Includes the quiet case: saving a global expense inside a tenant\n      // context, where the interceptor would fill in that tenant and split\n      // the expense from its global receipts and links.\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${this.id}: its tenant cannot change after it is recorded.`,\n      );\n    }\n    this.assertReviewFields(persisted);\n    this.assertReviewedLock(persisted);\n    await this.assertCommitment(persisted);\n    await this.assertVendor(persisted);\n\n    if (!this.recordedAt) this.recordedAt = new Date();\n    try {\n      return await super.save();\n    } catch (error) {\n      // A new expense is a plain INSERT; its only unique keys are the id and\n      // the natural key, so a violation means it named an existing row.\n      if (inserting && isUniqueViolationError(error)) {\n        throw identityConflict('Expense', this, error);\n      }\n      throw error;\n    }\n  }\n\n  private normalize(): void {\n    this.tenantId = normalizeTenantId(this.tenantId);\n    this.currency = String(this.currency ?? '')\n      .trim()\n      .toUpperCase();\n    this.category = String(this.category ?? '').trim();\n    this.costObjectType = String(this.costObjectType ?? '').trim();\n    this.costObjectId = String(this.costObjectId ?? '').trim();\n    this.incurredOn = String(this.incurredOn ?? '').trim();\n    this.vendorId = asNullableString(this.vendorId);\n    this.commitmentId = asNullableString(this.commitmentId);\n    this.commitmentLineId = asNullableString(this.commitmentLineId);\n    this.paidByProfileId = asNullableString(this.paidByProfileId);\n    this.recordedByProfileId = asNullableString(this.recordedByProfileId);\n  }\n\n  private validateShape(): void {\n    const label = this.id || '<new>';\n    assertMinorUnits('Expense', label, 'amount', this.amount);\n    assertIsoCurrency('Expense', label, this.currency);\n    assertIsoDate('Expense', label, 'incurredOn', this.incurredOn);\n    if (!CATEGORY_PATTERN.test(this.category) || this.category.length > 64) {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${label}: category must be lowercase kebab-case ` +\n          `(for example 'outside-service'), got '${this.category}'.`,\n      );\n    }\n    if (Boolean(this.costObjectType) !== Boolean(this.costObjectId)) {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${label}: costObjectType and costObjectId are set together ` +\n          'or not at all.',\n      );\n    }\n    if (this.costObjectType) {\n      assertQualifiedClassName('Expense', label, this.costObjectType);\n    }\n    if (this.paidBy !== 'company' && this.paidBy !== 'person') {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${label}: paidBy must be 'company' or 'person'.`,\n      );\n    }\n    if (this.paidBy === 'person' && !this.paidByProfileId) {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${label}: an expense paid by a person names that person ` +\n          '(paidByProfileId).',\n      );\n    }\n    if (this.paidBy === 'company' && this.paidByProfileId) {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${label}: paidByProfileId is only set when paidBy is 'person'.`,\n      );\n    }\n    if (this.reimbursable && this.paidBy !== 'person') {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${label}: only an expense a person paid can be owed back.`,\n      );\n    }\n    if (this.reimbursedAt && !this.reimbursable) {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${label}: reimbursedAt needs reimbursable.`,\n      );\n    }\n    if (this.reviewStatus === 'reviewed' && this.duplicateOfId) {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${label}: a reviewed expense cannot be marked a duplicate.`,\n      );\n    }\n    if (this.commitmentLineId && !this.commitmentId) {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${label}: a commitment line needs its commitment ` +\n          '(commitmentId).',\n      );\n    }\n  }\n\n  /**\n   * Read the stored row directly. The authoritative prior state for the\n   * review and lock guards: the in-memory copy may have been mass-assigned.\n   */\n  private async readPersisted(): Promise<PersistedRow | null> {\n    if (!this.id) return null;\n    const row = await this.db.get(this.tableName, { id: this.id });\n    return (row as PersistedRow | null | undefined) ?? null;\n  }\n\n  private reviewState(): ReviewFieldState {\n    return {\n      status: this.reviewStatus,\n      reviewer: asNullableString(this.reviewedByProfileId),\n      reviewedAtMs: instantMs(this.reviewedAt),\n      note: this.reviewNote ?? '',\n      duplicateOf: asNullableString(this.duplicateOfId),\n    };\n  }\n\n  /**\n   * Refuse any review-field change a transition did not authorize. The token\n   * binds the transition's complete resulting state — status, reviewer,\n   * time, note and duplicate marker — so a field set directly beside a\n   * legitimate `review()` / `reject()` cannot ride along with it.\n   */\n  private assertReviewFields(persisted: PersistedRow | null): void {\n    const token = authorizedTransition.get(this);\n    const prior: ReviewFieldState = {\n      status: (persisted?.review_status ?? 'unreviewed') as ExpenseReviewStatus,\n      reviewer: asNullableString(persisted?.reviewed_by_profile_id),\n      reviewedAtMs: instantMs(persisted?.reviewed_at),\n      note: String(persisted?.review_note ?? ''),\n      duplicateOf: asNullableString(persisted?.duplicate_of_id),\n    };\n    const current = this.reviewState();\n    if (sameReviewState(current, prior)) return;\n    if (\n      !token ||\n      token.from !== prior.status ||\n      !sameReviewState(current, token.expected)\n    ) {\n      throw new ExpenseError(\n        'EXPENSE_REVIEW_FIELDS_LOCKED',\n        `Expense ${this.id || '<new>'}: review state changes only through ` +\n          'review(), reject(), markDuplicate() or reopen().',\n      );\n    }\n  }\n\n  private assertReviewedLock(persisted: PersistedRow | null): void {\n    if (persisted?.review_status !== 'reviewed') return;\n    const self = this as unknown as Record<string, unknown>;\n    for (const [fieldName, column] of LOCKED_WHEN_REVIEWED) {\n      const before = persisted[column];\n      const after = self[fieldName];\n      const same =\n        fieldName === 'amount'\n          ? Number(before) === Number(after)\n          : fieldName === 'recordedAt'\n            ? instantMs(before) === instantMs(after)\n            : asNullableString(before) === asNullableString(after);\n      if (!same) {\n        throw new ExpenseError(\n          'EXPENSE_REVIEW_FIELDS_LOCKED',\n          `Expense ${this.id}: ${fieldName} of a reviewed expense cannot ` +\n            'change; reopen() it first.',\n        );\n      }\n    }\n  }\n\n  /**\n   * A matched commitment must be visible in this expense's tenant, owned by\n   * the same tenant, and in the same currency; a matched line must belong to\n   * it. Mixed currencies are refused here rather than summed later.\n   *\n   * Checked when the match is made or changed, not on every save: a later\n   * change to the commitment (its currency, or its deletion) must not stop\n   * an unrelated save such as recording a reimbursement.\n   */\n  private async assertCommitment(\n    persisted: PersistedRow | null,\n  ): Promise<void> {\n    if (!this.commitmentId) return;\n    if (\n      persisted &&\n      asNullableString(persisted.commitment_id) === this.commitmentId &&\n      asNullableString(persisted.commitment_line_id) ===\n        this.commitmentLineId &&\n      String(persisted.currency ?? '') === this.currency\n    ) {\n      return;\n    }\n    const contracts = await ContractCollection.create({ db: this.db });\n    const commitment = await contracts.get({ id: this.commitmentId });\n    // Before super.save() the tenant interceptor has not populated tenantId\n    // yet, so compare against the tenant the row is about to be written in.\n    const owner = effectiveTenant(this.tenantId);\n    if (!commitment || !sameTenant(commitment.tenantId, owner)) {\n      throw new ExpenseError(\n        'EXPENSE_COMMITMENT_MISMATCH',\n        `Expense ${this.id || '<new>'}: commitment ${this.commitmentId} was ` +\n          \"not found in this expense's tenant.\",\n      );\n    }\n    if (String(commitment.currency).toUpperCase() !== this.currency) {\n      throw new ExpenseError(\n        'EXPENSE_COMMITMENT_MISMATCH',\n        `Expense ${this.id || '<new>'}: currency ${this.currency} does not ` +\n          `match commitment ${this.commitmentId} (${commitment.currency}). ` +\n          'Amounts in different currencies are never summed.',\n      );\n    }\n    if (this.commitmentLineId) {\n      const lines = await ContractLineItemCollection.create({ db: this.db });\n      const line = await lines.get({ id: this.commitmentLineId });\n      if (!line || line.contractId !== this.commitmentId) {\n        throw new ExpenseError(\n          'EXPENSE_COMMITMENT_MISMATCH',\n          `Expense ${this.id || '<new>'}: line ${this.commitmentLineId} is ` +\n            `not a line of commitment ${this.commitmentId}.`,\n        );\n      }\n    }\n  }\n\n  /**\n   * A vendor must be visible in, and owned by, the expense's tenant. A\n   * `crossPackageRef` neither validates its target nor creates a foreign\n   * key, so without this an expense in one tenant could name another\n   * tenant's vendor. Checked when the vendor is set or changed.\n   */\n  private async assertVendor(persisted: PersistedRow | null): Promise<void> {\n    if (!this.vendorId) return;\n    if (persisted && asNullableString(persisted.vendor_id) === this.vendorId) {\n      return;\n    }\n    const vendors = await VendorCollection.create({ db: this.db });\n    const vendor = await vendors.get({ id: this.vendorId });\n    const owner = effectiveTenant(this.tenantId);\n    if (!vendor || !sameTenant(vendor.tenantId, owner)) {\n      throw new ExpenseError(\n        'EXPENSE_VENDOR_MISMATCH',\n        `Expense ${this.id || '<new>'}: vendor ${this.vendorId} was not ` +\n          \"found in this expense's tenant.\",\n      );\n    }\n  }\n\n  private async transition(\n    action: keyof typeof REVIEW_TRANSITIONS,\n    apply: () => void,\n  ): Promise<this> {\n    const rule = REVIEW_TRANSITIONS[action];\n    const persisted = await this.readPersisted();\n    if (!persisted) {\n      throw new ExpenseError(\n        'EXPENSE_REVIEW_TRANSITION',\n        `Expense ${this.id || '<new>'}: save the expense before ${action}().`,\n      );\n    }\n    const from = String(persisted.review_status) as ExpenseReviewStatus;\n    if (!rule.from.includes(from)) {\n      throw new ExpenseError(\n        'EXPENSE_REVIEW_TRANSITION',\n        `Expense ${this.id}: cannot ${action}() an expense that is ${from}.`,\n      );\n    }\n    if (action === 'review' && persisted.duplicate_of_id) {\n      throw new ExpenseError(\n        'EXPENSE_REVIEW_TRANSITION',\n        `Expense ${this.id}: a duplicate cannot be reviewed; reopen() it first.`,\n      );\n    }\n    const snapshot = {\n      reviewStatus: this.reviewStatus,\n      reviewedByProfileId: this.reviewedByProfileId,\n      reviewedAt: this.reviewedAt,\n      reviewNote: this.reviewNote,\n      duplicateOfId: this.duplicateOfId,\n    };\n    // Every transition assigns every review field, so the token below\n    // describes the whole resulting review state.\n    apply();\n    authorizedTransition.set(this, { from, expected: this.reviewState() });\n    try {\n      return await this.save();\n    } catch (error) {\n      Object.assign(this, snapshot);\n      throw error;\n    } finally {\n      authorizedTransition.delete(this);\n    }\n  }\n}\n\nfunction requireReviewer(reviewerProfileId: string | undefined): string {\n  const reviewer = String(reviewerProfileId ?? '').trim();\n  if (!reviewer) {\n    throw new ExpenseError(\n      'EXPENSE_INVALID',\n      'A review decision names its reviewer (reviewerProfileId).',\n    );\n  }\n  return reviewer;\n}\n\nfunction sameTenant(\n  a: string | null | undefined,\n  b: string | null | undefined,\n): boolean {\n  return (a ?? null) === (b ?? null);\n}\n"],"mappings":"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"}