@happyvertical/smrt-commerce 0.56.0 → 0.56.2

package/dist/chunks/TaxCodeCollection-DF2eaJed.js

@@ -0,0 +1,149 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+import { MoneyValidationError } from "../money.js";
+import { SmrtCollection, SmrtObject, field, smrt } from "@happyvertical/smrt-core";
+import { TenantScoped, tenantId } from "@happyvertical/smrt-tenancy";
+//#region src/models/TaxCode.ts
+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 TaxCode = class extends SmrtObject {
+	tenantId = "";
+	code = "";
+	name = "";
+	kind = "taxable";
+	appliesTo = "both";
+	/** Ordered component IDs; compound is reserved and deliberately unsupported. */
+	/** Stored JSON is guarded through the typed accessor below. */
+	componentsJson = "[]";
+	get components() {
+		try {
+			const value = JSON.parse(this.componentsJson);
+			if (!Array.isArray(value)) return [];
+			return value.filter((part) => !!part && typeof part === "object" && typeof part.taxComponentId === "string" && typeof part.compound === "boolean");
+		} catch {
+			return [];
+		}
+	}
+	set components(value) {
+		this.componentsJson = typeof value === "string" ? value : JSON.stringify(value);
+	}
+	active = true;
+	constructor(options = {}) {
+		super(options);
+		if (options.tenantId !== void 0) this.tenantId = options.tenantId ?? "";
+		if (options.code !== void 0) this.code = options.code;
+		if (options.name !== void 0) this.name = options.name;
+		if (options.kind !== void 0) this.kind = options.kind;
+		if (options.appliesTo !== void 0) this.appliesTo = options.appliesTo;
+		if (options.components !== void 0) this.components = structuredClone(options.components);
+		if (options.active !== void 0) this.active = options.active;
+	}
+	async save() {
+		if (!this.code.trim() || !this.name.trim()) throw new Error("Tax code requires a nonempty code and name");
+		if (![
+			"taxable",
+			"zero-rated",
+			"exempt",
+			"out-of-scope"
+		].includes(this.kind)) throw new Error("Tax code kind is invalid");
+		if (![
+			"sales",
+			"purchases",
+			"both"
+		].includes(this.appliesTo)) throw new Error("Tax code appliesTo is invalid");
+		const parts = this.parsedComponents();
+		if (!parts) throw new Error("Tax code components must be a valid JSON array");
+		const nonTaxable = this.kind !== "taxable";
+		if (nonTaxable && parts.length) throw new MoneyValidationError("TAX_CODE_NON_TAXABLE_COMPONENTS", `${this.kind} tax codes cannot have components.`);
+		if (!nonTaxable && !parts.length) throw new MoneyValidationError("TAX_CODE_TAXABLE_EMPTY", "Taxable tax codes require at least one component.");
+		const seen = /* @__PURE__ */ new Set();
+		for (const component of parts) {
+			if (seen.has(component.taxComponentId)) throw new MoneyValidationError("TAX_CODE_DUPLICATE_COMPONENT", "A tax code cannot contain the same component twice.");
+			seen.add(component.taxComponentId);
+			if (component.compound) throw new MoneyValidationError("COMPOUND_UNSUPPORTED", "Compound tax components are reserved for a future release.");
+		}
+		return this.withTransaction(async () => {
+			const { TaxComponentCollection } = await import("./TaxComponentCollection-3x24xSNh.js").then((n) => n.n);
+			const components = await TaxComponentCollection.create({ db: this.db });
+			for (const part of parts) {
+				const component = await components.get({ id: part.taxComponentId }, { cache: false });
+				if (!component) throw new Error("Tax code components must belong to the same tenant");
+				if (!component.updated_at) throw new Error("Tax code component is missing its revision");
+				await component.claimRevision(component.updated_at);
+				if (!this.tenantId) this.tenantId = component.tenantId;
+				if (component.tenantId !== this.tenantId) throw new Error("Tax code components must belong to the same tenant");
+			}
+			return await super.save();
+		});
+	}
+	parsedComponents() {
+		try {
+			const value = JSON.parse(this.componentsJson);
+			if (!Array.isArray(value)) return null;
+			if (value.some((part) => !part || typeof part !== "object" || typeof part.taxComponentId !== "string" || !part.taxComponentId.trim() || typeof part.compound !== "boolean")) return null;
+			return value;
+		} catch {
+			return null;
+		}
+	}
+};
+__publicField(TaxCode, "__smrtPackage__", "@happyvertical/smrt-commerce");
+__decorateClass([tenantId()], TaxCode.prototype, "tenantId", 2);
+__decorateClass([field({ description: "A stable short code, for example gst-pst-bc." })], TaxCode.prototype, "code", 2);
+__decorateClass([field({ description: "The name people see for this tax code." })], TaxCode.prototype, "name", 2);
+__decorateClass([field({ description: "How the tax code is reported." })], TaxCode.prototype, "kind", 2);
+__decorateClass([field({ description: "Whether the code applies to sales, purchases or both." })], TaxCode.prototype, "appliesTo", 2);
+__decorateClass([field({
+	description: "The ordered tax components in this code.",
+	transient: true
+})], TaxCode.prototype, "components", 1);
+__decorateClass([field({ description: "Whether users may select this code for new documents." })], TaxCode.prototype, "active", 2);
+TaxCode = __decorateClass([TenantScoped({ mode: "required" }), smrt({
+	conflictColumns: ["tenant_id", "code"],
+	api: {
+		include: [
+			"list",
+			"get",
+			"create",
+			"update"
+		],
+		writable: [
+			"code",
+			"name",
+			"kind",
+			"appliesTo",
+			"components",
+			"active"
+		]
+	},
+	mcp: { include: ["list", "get"] },
+	cli: { skipApiCheck: true }
+})], TaxCode);
+//#endregion
+//#region src/collections/TaxCodeCollection.ts
+var TaxCodeCollection_exports = /* @__PURE__ */ __exportAll({ TaxCodeCollection: () => TaxCodeCollection });
+var TaxCodeCollection = class extends SmrtCollection {
+	static _itemClass = TaxCode;
+	async findByCode(code) {
+		return (await this.list({
+			where: { code },
+			limit: 1
+		}))[0] ?? null;
+	}
+};
+//#endregion
+export { TaxCodeCollection_exports as n, TaxCode as r, TaxCodeCollection as t };
+
+//# sourceMappingURL=TaxCodeCollection-DF2eaJed.js.map

package/dist/chunks/TaxCodeCollection-DF2eaJed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaxCodeCollection-DF2eaJed.js","names":[],"sources":["../../src/models/TaxCode.ts","../../src/collections/TaxCodeCollection.ts"],"sourcesContent":["import { field, SmrtObject, smrt } from '@happyvertical/smrt-core';\nimport { TenantScoped, tenantId } from '@happyvertical/smrt-tenancy';\nimport { MoneyValidationError } from '../money.js';\nimport type { TaxCodeOptions, TaxCodePart } from '../types/index.js';\n\nexport type TaxCodeKind = 'taxable' | 'zero-rated' | 'exempt' | 'out-of-scope';\nexport type TaxCodeAppliesTo = 'sales' | 'purchases' | 'both';\n\n/** A reusable tax code whose ordered component list is safe to edit. */\n@TenantScoped({ mode: 'required' })\n@smrt({\n  conflictColumns: ['tenant_id', 'code'],\n  api: {\n    include: ['list', 'get', 'create', 'update'],\n    writable: ['code', 'name', 'kind', 'appliesTo', 'components', 'active'],\n  },\n  mcp: { include: ['list', 'get'] },\n  cli: { skipApiCheck: true },\n})\nexport class TaxCode extends SmrtObject { static __smrtPackage__ = \"@happyvertical/smrt-commerce\";\n  @tenantId()\n  tenantId = '';\n\n  @field({ description: 'A stable short code, for example gst-pst-bc.' })\n  code = '';\n\n  @field({ description: 'The name people see for this tax code.' })\n  name = '';\n\n  @field({ description: 'How the tax code is reported.' })\n  kind: TaxCodeKind = 'taxable';\n\n  @field({\n    description: 'Whether the code applies to sales, purchases or both.',\n  })\n  appliesTo: TaxCodeAppliesTo = 'both';\n\n  /** Ordered component IDs; compound is reserved and deliberately unsupported. */\n  /** Stored JSON is guarded through the typed accessor below. */\n  componentsJson = '[]';\n\n  @field({\n    description: 'The ordered tax components in this code.',\n    transient: true,\n  })\n  get components(): TaxCodePart[] {\n    try {\n      const value: unknown = JSON.parse(this.componentsJson);\n      if (!Array.isArray(value)) return [];\n      return value.filter(\n        (part): part is TaxCodePart =>\n          !!part &&\n          typeof part === 'object' &&\n          typeof (part as TaxCodePart).taxComponentId === 'string' &&\n          typeof (part as TaxCodePart).compound === 'boolean',\n      );\n    } catch {\n      return [];\n    }\n  }\n\n  set components(value: TaxCodePart[] | string) {\n    this.componentsJson =\n      typeof value === 'string' ? value : JSON.stringify(value);\n  }\n\n  @field({\n    description: 'Whether users may select this code for new documents.',\n  })\n  active = true;\n\n  constructor(options: TaxCodeOptions = {}) {\n    super(options);\n    if (options.tenantId !== undefined) this.tenantId = options.tenantId ?? '';\n    if (options.code !== undefined) this.code = options.code;\n    if (options.name !== undefined) this.name = options.name;\n    if (options.kind !== undefined) this.kind = options.kind;\n    if (options.appliesTo !== undefined) this.appliesTo = options.appliesTo;\n    if (options.components !== undefined)\n      this.components = structuredClone(options.components);\n    if (options.active !== undefined) this.active = options.active;\n  }\n\n  override async save(): Promise<this> {\n    if (!this.code.trim() || !this.name.trim())\n      throw new Error('Tax code requires a nonempty code and name');\n    if (\n      !['taxable', 'zero-rated', 'exempt', 'out-of-scope'].includes(this.kind)\n    )\n      throw new Error('Tax code kind is invalid');\n    if (!['sales', 'purchases', 'both'].includes(this.appliesTo))\n      throw new Error('Tax code appliesTo is invalid');\n    const parts = this.parsedComponents();\n    if (!parts)\n      throw new Error('Tax code components must be a valid JSON array');\n    const nonTaxable = this.kind !== 'taxable';\n    if (nonTaxable && parts.length) {\n      throw new MoneyValidationError(\n        'TAX_CODE_NON_TAXABLE_COMPONENTS',\n        `${this.kind} tax codes cannot have components.`,\n      );\n    }\n    if (!nonTaxable && !parts.length) {\n      throw new MoneyValidationError(\n        'TAX_CODE_TAXABLE_EMPTY',\n        'Taxable tax codes require at least one component.',\n      );\n    }\n    const seen = new Set<string>();\n    for (const component of parts) {\n      if (seen.has(component.taxComponentId)) {\n        throw new MoneyValidationError(\n          'TAX_CODE_DUPLICATE_COMPONENT',\n          'A tax code cannot contain the same component twice.',\n        );\n      }\n      seen.add(component.taxComponentId);\n      if (component.compound) {\n        throw new MoneyValidationError(\n          'COMPOUND_UNSUPPORTED',\n          'Compound tax components are reserved for a future release.',\n        );\n      }\n    }\n    return this.withTransaction(async () => {\n      const { TaxComponentCollection } = await import(\n        '../collections/TaxComponentCollection.js'\n      );\n      const components = await TaxComponentCollection.create({ db: this.db });\n      for (const part of parts) {\n        const component = await components.get(\n          { id: part.taxComponentId },\n          { cache: false },\n        );\n        if (!component) {\n          throw new Error('Tax code components must belong to the same tenant');\n        }\n        if (!component.updated_at)\n          throw new Error('Tax code component is missing its revision');\n        await component.claimRevision(component.updated_at);\n        if (!this.tenantId) this.tenantId = component.tenantId;\n        if (component.tenantId !== this.tenantId)\n          throw new Error('Tax code components must belong to the same tenant');\n      }\n      return (await super.save()) as this;\n    });\n  }\n\n  private parsedComponents(): TaxCodePart[] | null {\n    try {\n      const value: unknown = JSON.parse(this.componentsJson);\n      if (!Array.isArray(value)) return null;\n      if (\n        value.some(\n          (part) =>\n            !part ||\n            typeof part !== 'object' ||\n            typeof (part as TaxCodePart).taxComponentId !== 'string' ||\n            !(part as TaxCodePart).taxComponentId.trim() ||\n            typeof (part as TaxCodePart).compound !== 'boolean',\n        )\n      )\n        return null;\n      return value as TaxCodePart[];\n    } catch {\n      return null;\n    }\n  }\n}\n","import { SmrtCollection } from '@happyvertical/smrt-core';\nimport { TaxCode } from '../models/TaxCode.js';\n\nexport class TaxCodeCollection extends SmrtCollection<TaxCode> {\n  static readonly _itemClass = TaxCode;\n\n  async findByCode(code: string): Promise<TaxCode | null> {\n    return (await this.list({ where: { code }, limit: 1 }))[0] ?? null;\n  }\n}\n"],"mappings":"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"}

package/dist/chunks/TaxComponentCollection-3x24xSNh.js

@@ -0,0 +1,129 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+import { MoneyValidationError } from "../money.js";
+import { SmrtCollection, SmrtObject, crossPackageRef, field, smrt } from "@happyvertical/smrt-core";
+import { TenantScoped, tenantId } from "@happyvertical/smrt-tenancy";
+import { AccountCollection } from "@happyvertical/smrt-ledgers";
+//#region src/models/TaxComponent.ts
+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 PERCENT = /^(\d+)(?:\.(\d{1,6}))?$/;
+function isPercent(value) {
+	const match = PERCENT.exec(value);
+	if (!match) return false;
+	return BigInt(match[1]) * 1000000n + BigInt((match[2] ?? "").padEnd(6, "0")) <= 100000000n;
+}
+function canonicalPercent(value) {
+	const [whole, fraction = ""] = String(value).split(".");
+	const normalizedWhole = whole.replace(/^0+(?=\d)/, "") || "0";
+	const normalizedFraction = fraction.replace(/0+$/, "");
+	return normalizedFraction ? `${normalizedWhole}.${normalizedFraction}` : normalizedWhole;
+}
+var TaxComponent = class extends SmrtObject {
+	tenantId = "";
+	name = "";
+	percent = "0.0";
+	liabilityAccountId = "";
+	recoverable = false;
+	active = true;
+	constructor(options = {}) {
+		super(options);
+		if (options.tenantId !== void 0) this.tenantId = options.tenantId ?? "";
+		if (options.name !== void 0) this.name = options.name;
+		if (options.percent !== void 0) this.percent = options.percent;
+		if (options.liabilityAccountId !== void 0) this.liabilityAccountId = options.liabilityAccountId;
+		if (options.recoverable !== void 0) this.recoverable = options.recoverable;
+		if (options.active !== void 0) this.active = options.active;
+	}
+	async initialize() {
+		await super.initialize();
+		this.percent = canonicalPercent(String(this.percent));
+		return this;
+	}
+	async save() {
+		if (!this.name.trim()) throw new Error("Tax component requires a nonempty name");
+		if (!isPercent(this.percent)) throw new MoneyValidationError("PERCENT_OUT_OF_RANGE", "Tax component percent must be between 0 and 100 with at most six decimal places.");
+		this.percent = canonicalPercent(this.percent);
+		return this.withTransaction(async () => {
+			const { TaxComponentCollection } = await Promise.resolve().then(() => TaxComponentCollection_exports);
+			const components = await TaxComponentCollection.create({ db: this.db });
+			const persisted = this.id ? await components.get({ id: this.id }, { cache: false }) : null;
+			if (persisted && canonicalPercent(persisted.percent) !== this.percent) {
+				const referenced = await this.isReferenced(persisted);
+				this.updated_at = persisted.updated_at;
+				if (referenced) throw new MoneyValidationError("PERCENT_OUT_OF_RANGE", "A referenced tax component rate is immutable; archive it and repoint its tax codes.");
+			}
+			if (this.liabilityAccountId) {
+				const account = await (await AccountCollection.create({ db: this.db })).get({ id: this.liabilityAccountId }, { cache: false });
+				if (!account || account.tenantId !== this.tenantId) throw new Error("Tax component liability account must belong to its tenant");
+			}
+			return await super.save();
+		});
+	}
+	async isReferenced(persisted) {
+		if (!this.id) return false;
+		if (!persisted.updated_at) throw new Error("Referenced tax component is missing its revision");
+		await persisted.claimRevision(persisted.updated_at);
+		const { TaxCodeCollection } = await import("./TaxCodeCollection-DF2eaJed.js").then((n) => n.n);
+		const { DocumentTaxCollection } = await import("./DocumentTaxCollection-KOkaQT2M.js").then((n) => n.n);
+		if ((await (await TaxCodeCollection.create({ db: this.db })).list({ where: { tenantId: this.tenantId } })).some((code) => code.components.some((component) => component.taxComponentId === this.id))) return true;
+		return (await (await DocumentTaxCollection.create({ db: this.db })).list({
+			where: {
+				tenantId: this.tenantId,
+				taxComponentId: this.id
+			},
+			limit: 1
+		})).length > 0;
+	}
+};
+__publicField(TaxComponent, "__smrtPackage__", "@happyvertical/smrt-commerce");
+__decorateClass([tenantId()], TaxComponent.prototype, "tenantId", 2);
+__decorateClass([field({ description: "The name of this tax component, for example GST." })], TaxComponent.prototype, "name", 2);
+__decorateClass([field({
+	type: "decimal",
+	description: "The tax percentage, for example 7.125 for 7.125 percent."
+})], TaxComponent.prototype, "percent", 2);
+__decorateClass([crossPackageRef("@happyvertical/smrt-ledgers:Account", { description: "The liability account that receives this tax component." })], TaxComponent.prototype, "liabilityAccountId", 2);
+__decorateClass([field({ description: "Whether purchases using this component may recover the full input tax. Partial recovery is not supported." })], TaxComponent.prototype, "recoverable", 2);
+__decorateClass([field({ description: "Whether new tax codes and overrides may select it." })], TaxComponent.prototype, "active", 2);
+TaxComponent = __decorateClass([TenantScoped({ mode: "required" }), smrt({
+	api: {
+		include: [
+			"list",
+			"get",
+			"create",
+			"update"
+		],
+		writable: [
+			"name",
+			"percent",
+			"liabilityAccountId",
+			"recoverable",
+			"active"
+		]
+	},
+	mcp: { include: ["list", "get"] },
+	cli: { skipApiCheck: true }
+})], TaxComponent);
+//#endregion
+//#region src/collections/TaxComponentCollection.ts
+var TaxComponentCollection_exports = /* @__PURE__ */ __exportAll({ TaxComponentCollection: () => TaxComponentCollection });
+var TaxComponentCollection = class extends SmrtCollection {
+	static _itemClass = TaxComponent;
+};
+//#endregion
+export { TaxComponentCollection_exports as n, TaxComponent as r, TaxComponentCollection as t };
+
+//# sourceMappingURL=TaxComponentCollection-3x24xSNh.js.map

package/dist/chunks/TaxComponentCollection-3x24xSNh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaxComponentCollection-3x24xSNh.js","names":[],"sources":["../../src/models/TaxComponent.ts","../../src/collections/TaxComponentCollection.ts"],"sourcesContent":["import {\n  crossPackageRef,\n  field,\n  SmrtObject,\n  smrt,\n} from '@happyvertical/smrt-core';\nimport { AccountCollection } from '@happyvertical/smrt-ledgers';\nimport { TenantScoped, tenantId } from '@happyvertical/smrt-tenancy';\nimport { MoneyValidationError } from '../money.js';\nimport type { TaxComponentOptions } from '../types/index.js';\n\nconst PERCENT = /^(\\d+)(?:\\.(\\d{1,6}))?$/;\n\nfunction isPercent(value: string): boolean {\n  const match = PERCENT.exec(value);\n  if (!match) return false;\n  const scaled =\n    BigInt(match[1]) * 1_000_000n + BigInt((match[2] ?? '').padEnd(6, '0'));\n  return scaled <= 100_000_000n;\n}\n\nfunction canonicalPercent(value: string): string {\n  const [whole, fraction = ''] = String(value).split('.');\n  const normalizedWhole = whole.replace(/^0+(?=\\d)/, '') || '0';\n  const normalizedFraction = fraction.replace(/0+$/, '');\n  return normalizedFraction\n    ? `${normalizedWhole}.${normalizedFraction}`\n    : normalizedWhole;\n}\n\n/**\n * One reusable tax rate component. Codes may combine components, but the\n * component's percent is immutable after it has been saved: archive it and\n * repoint editable codes to a replacement rate instead of rewriting history.\n */\n@TenantScoped({ mode: 'required' })\n@smrt({\n  api: {\n    include: ['list', 'get', 'create', 'update'],\n    writable: [\n      'name',\n      'percent',\n      'liabilityAccountId',\n      'recoverable',\n      'active',\n    ],\n  },\n  mcp: { include: ['list', 'get'] },\n  cli: { skipApiCheck: true },\n})\nexport class TaxComponent extends SmrtObject { static __smrtPackage__ = \"@happyvertical/smrt-commerce\";\n  @tenantId()\n  tenantId = '';\n\n  @field({ description: 'The name of this tax component, for example GST.' })\n  name = '';\n\n  /** Percent, not a fraction: 7.125 means 7.125%. Stored as DECIMAL. */\n  @field({\n    type: 'decimal',\n    description: 'The tax percentage, for example 7.125 for 7.125 percent.',\n  })\n  percent = '0.0';\n\n  @crossPackageRef('@happyvertical/smrt-ledgers:Account', {\n    description: 'The liability account that receives this tax component.',\n  })\n  liabilityAccountId = '';\n\n  @field({\n    description:\n      'Whether purchases using this component may recover the full input tax. Partial recovery is not supported.',\n  })\n  recoverable = false;\n\n  @field({ description: 'Whether new tax codes and overrides may select it.' })\n  active = true;\n\n  constructor(options: TaxComponentOptions = {}) {\n    super(options);\n    if (options.tenantId !== undefined) this.tenantId = options.tenantId ?? '';\n    if (options.name !== undefined) this.name = options.name;\n    if (options.percent !== undefined) this.percent = options.percent;\n    if (options.liabilityAccountId !== undefined)\n      this.liabilityAccountId = options.liabilityAccountId;\n    if (options.recoverable !== undefined)\n      this.recoverable = options.recoverable;\n    if (options.active !== undefined) this.active = options.active;\n  }\n\n  override async initialize(): Promise<this> {\n    await super.initialize();\n    this.percent = canonicalPercent(String(this.percent));\n    return this;\n  }\n\n  override async save(): Promise<this> {\n    if (!this.name.trim())\n      throw new Error('Tax component requires a nonempty name');\n    if (!isPercent(this.percent)) {\n      throw new MoneyValidationError(\n        'PERCENT_OUT_OF_RANGE',\n        'Tax component percent must be between 0 and 100 with at most six decimal places.',\n      );\n    }\n    this.percent = canonicalPercent(this.percent);\n    return this.withTransaction(async () => {\n      const { TaxComponentCollection } = await import(\n        '../collections/TaxComponentCollection.js'\n      );\n      const components = await TaxComponentCollection.create({ db: this.db });\n      const persisted = this.id\n        ? await components.get({ id: this.id }, { cache: false })\n        : null;\n      if (persisted && canonicalPercent(persisted.percent) !== this.percent) {\n        const referenced = await this.isReferenced(persisted);\n        // claimRevision advanced the row's version; the pending save must use\n        // that version rather than its stale caller snapshot.\n        this.updated_at = persisted.updated_at;\n        if (referenced) {\n          throw new MoneyValidationError(\n            'PERCENT_OUT_OF_RANGE',\n            'A referenced tax component rate is immutable; archive it and repoint its tax codes.',\n          );\n        }\n      }\n      if (this.liabilityAccountId) {\n        const accounts = await AccountCollection.create({ db: this.db });\n        const account = await accounts.get(\n          { id: this.liabilityAccountId },\n          { cache: false },\n        );\n        if (!account || account.tenantId !== this.tenantId) {\n          throw new Error(\n            'Tax component liability account must belong to its tenant',\n          );\n        }\n      }\n      return (await super.save()) as this;\n    });\n  }\n\n  private async isReferenced(persisted: TaxComponent): Promise<boolean> {\n    if (!this.id) return false;\n    if (!persisted.updated_at)\n      throw new Error('Referenced tax component is missing its revision');\n    // Claim before inspecting references. TaxCode.save() claims the same row\n    // before attaching it, so a concurrent rate edit must reload and retry.\n    await persisted.claimRevision(persisted.updated_at);\n    const { TaxCodeCollection } = await import(\n      '../collections/TaxCodeCollection.js'\n    );\n    const { DocumentTaxCollection } = await import(\n      '../collections/DocumentTaxCollection.js'\n    );\n    const codes = await TaxCodeCollection.create({ db: this.db });\n    const usedByCode = (\n      await codes.list({ where: { tenantId: this.tenantId } })\n    ).some((code) =>\n      code.components.some((component) => component.taxComponentId === this.id),\n    );\n    if (usedByCode) return true;\n    const documentTaxes = await DocumentTaxCollection.create({ db: this.db });\n    return (\n      (\n        await documentTaxes.list({\n          where: { tenantId: this.tenantId, taxComponentId: this.id },\n          limit: 1,\n        })\n      ).length > 0\n    );\n  }\n}\n","import { SmrtCollection } from '@happyvertical/smrt-core';\nimport { TaxComponent } from '../models/TaxComponent.js';\n\nexport class TaxComponentCollection extends SmrtCollection<TaxComponent> {\n  static readonly _itemClass = TaxComponent;\n}\n"],"mappings":"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"}

package/dist/chunks/TaxSettingsCollection-DYYF-In-.js

@@ -0,0 +1,319 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+import { MoneyValidationError } from "../money.js";
+import { SmrtCollection, SmrtObject, field, foreignKey, smrt } from "@happyvertical/smrt-core";
+import { TenantScoped, getTenantId, tenantId } from "@happyvertical/smrt-tenancy";
+//#region src/document-money-internal.ts
+var activeMoneyTransactions = /* @__PURE__ */ new WeakSet();
+var DOCUMENT_MONEY_WRITE = /* @__PURE__ */ Symbol("commerce.documentMoneyWrite");
+var MONEY_MIGRATION_WRITE = /* @__PURE__ */ Symbol("commerce.moneyMigrationWrite");
+var DOCUMENT_MONEY_READ_REBIND = /* @__PURE__ */ Symbol("commerce.documentMoneyReadRebind");
+function compareCodeUnits(left, right) {
+	return left < right ? -1 : left > right ? 1 : 0;
+}
+function quoteIdentifier(identifier) {
+	if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(identifier)) throw new MoneyValidationError("INVALID_MONEY_INPUT", `Unsafe money parent table identifier: ${identifier}`);
+	return `"${identifier}"`;
+}
+function assertIdentifier(value, label) {
+	if (typeof value !== "string" || value.trim() !== value || value.length === 0) throw new MoneyValidationError("INVALID_MONEY_INPUT", `${label} must be a nonempty identifier`);
+}
+async function withDocumentMoneyTransaction(db, operation) {
+	if (activeMoneyTransactions.has(db)) return operation(db);
+	if (!db.transaction) throw new MoneyValidationError("INVALID_MONEY_INPUT", "Document money persistence requires transaction support");
+	return db.transaction(async (tx) => {
+		activeMoneyTransactions.add(tx);
+		try {
+			return await operation(tx);
+		} finally {
+			activeMoneyTransactions.delete(tx);
+		}
+	});
+}
+async function withDocumentMoneyObjectTransaction(input, operation) {
+	if (activeMoneyTransactions.has(input.db)) return operation(input, input.db);
+	return input.withTransaction(async (bound) => {
+		const tx = bound.db;
+		activeMoneyTransactions.add(tx);
+		try {
+			return await operation(bound, tx);
+		} finally {
+			activeMoneyTransactions.delete(tx);
+		}
+	});
+}
+async function lockDocumentMoneyParents(targets) {
+	const sorted = [...targets].sort((left, right) => compareCodeUnits(left.id, right.id) || compareCodeUnits(left.collection.tableName, right.collection.tableName));
+	const identities = /* @__PURE__ */ new Set();
+	for (const target of sorted) {
+		assertIdentifier(target.id, "Money parent id");
+		assertIdentifier(target.tenantId, "Money parent tenant id");
+		const identity = `${target.collection.tableName}\0${target.id}`;
+		if (identities.has(identity)) throw new MoneyValidationError("INVALID_MONEY_INPUT", `Duplicate money parent lock target: ${target.id}`);
+		identities.add(identity);
+		const table = quoteIdentifier(target.collection.tableName);
+		if ((await target.collection.query(`UPDATE ${table}
+          SET "updated_at" = "updated_at"
+        WHERE "id" = ? AND "tenant_id" = ?
+        RETURNING "id"`, [target.id, target.tenantId], { allowRawOnTenantScoped: true })).length !== 1) throw new MoneyValidationError("INVALID_MONEY_INPUT", `Money parent ${target.id} was not found in tenant ${target.tenantId}`);
+	}
+}
+//#endregion
+//#region src/models/TaxSettings.ts
+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 TaxSettings = class extends SmrtObject {
+	tenantId = "";
+	defaultSalesTaxCodeId = "";
+	defaultPurchaseTaxCodeId = "";
+	defaultLineAmountType = "exclusive";
+	taxRoundingScope = "line";
+	/** Stored JSON is guarded through the typed accessor below. */
+	taxRegistrationsJson = "[]";
+	/** Server-owned runtime semantics gate. Never exposed as a generated write. */
+	moneyModel = "legacy";
+	/** Opaque owner token while a tenant migration is in progress. */
+	moneyMigrationId = "";
+	get taxRegistrations() {
+		try {
+			const value = JSON.parse(this.taxRegistrationsJson);
+			if (!Array.isArray(value)) return [];
+			return value.filter((entry) => !!entry && typeof entry === "object" && typeof entry.taxComponentId === "string" && typeof entry.number === "string" && typeof entry.label === "string");
+		} catch {
+			return [];
+		}
+	}
+	set taxRegistrations(value) {
+		this.taxRegistrationsJson = typeof value === "string" ? value : JSON.stringify(value);
+	}
+	constructor(options = {}) {
+		super(options);
+		if (options.tenantId !== void 0) this.tenantId = options.tenantId;
+		if (options.defaultSalesTaxCodeId !== void 0) this.defaultSalesTaxCodeId = options.defaultSalesTaxCodeId;
+		if (options.defaultPurchaseTaxCodeId !== void 0) this.defaultPurchaseTaxCodeId = options.defaultPurchaseTaxCodeId;
+		if (options.defaultLineAmountType !== void 0) this.defaultLineAmountType = options.defaultLineAmountType;
+		if (options.taxRoundingScope !== void 0) this.taxRoundingScope = options.taxRoundingScope;
+		if (options.taxRegistrations !== void 0) this.taxRegistrations = structuredClone(options.taxRegistrations);
+		if (options.moneyModel !== void 0) this.moneyModel = options.moneyModel;
+		if (options.moneyMigrationId !== void 0) this.moneyMigrationId = options.moneyMigrationId;
+	}
+	async save() {
+		return this.saveValidated(false);
+	}
+	/** @internal Money migration owns marker transitions. */
+	async saveMoneyModel(capability) {
+		if (capability !== MONEY_MIGRATION_WRITE) throw new MoneyValidationError("FROZEN_DOCUMENT", "Tenant money model requires the migration capability");
+		return this.saveValidated(true);
+	}
+	/** @internal Caller already owns the transaction-bound migration barrier. */
+	async saveMoneyModelOnTransaction(capability) {
+		if (capability !== MONEY_MIGRATION_WRITE) throw new MoneyValidationError("FROZEN_DOCUMENT", "Tenant money model requires the migration capability");
+		return this.saveValidated(true, true);
+	}
+	async saveValidated(allowMoneyModelWrite, transactionBound = false) {
+		if (![
+			"exclusive",
+			"inclusive",
+			"none"
+		].includes(this.defaultLineAmountType)) throw new Error("Tax settings defaultLineAmountType is invalid");
+		if (!["line", "document"].includes(this.taxRoundingScope)) throw new Error("Tax settings taxRoundingScope is invalid");
+		if (![
+			"legacy",
+			"migrating",
+			"v2"
+		].includes(this.moneyModel)) throw new Error("Tax settings moneyModel is invalid");
+		if (this.moneyModel === "migrating" !== !!this.moneyMigrationId) throw new Error("Tax settings migrating state requires exactly one migration owner");
+		const registrations = this.parsedRegistrations();
+		if (!registrations) throw new Error("Tax registrations must be a valid JSON array");
+		if (registrations.some((entry) => !entry.taxComponentId || !entry.number.trim() || !entry.label.trim())) throw new Error("Tax registrations require component, number and label");
+		const persist = async () => {
+			const { TaxCodeCollection } = await import("./TaxCodeCollection-DF2eaJed.js").then((n) => n.n);
+			const { TaxComponentCollection } = await import("./TaxComponentCollection-3x24xSNh.js").then((n) => n.n);
+			const codes = await TaxCodeCollection.create({ db: this.db });
+			const components = await TaxComponentCollection.create({ db: this.db });
+			if (!allowMoneyModelWrite) {
+				const tenantKey = this.tenantId || getTenantId() || "";
+				const { TaxSettingsCollection } = await Promise.resolve().then(() => TaxSettingsCollection_exports);
+				const persistedByTenant = tenantKey ? await (await TaxSettingsCollection.create({ db: this.db })).lockForTenant(tenantKey, false) : null;
+				const persistedById = this.id ? await this.db.get(this.tableName, { id: this.id }) : null;
+				if (persistedByTenant && (persistedByTenant.moneyModel !== this.moneyModel || persistedByTenant.moneyMigrationId !== this.moneyMigrationId) || persistedById && (persistedById.money_model !== this.moneyModel || (persistedById.money_migration_id ?? "") !== this.moneyMigrationId)) throw new MoneyValidationError("FROZEN_DOCUMENT", "Tenant money model is server-managed");
+				if (!persistedByTenant && !this.isPersisted) this.requireInsertOnSave();
+			}
+			for (const id of [this.defaultSalesTaxCodeId, this.defaultPurchaseTaxCodeId].filter(Boolean)) {
+				const code = await codes.get({ id }, { cache: false });
+				if (!code || code.tenantId !== this.tenantId) throw new Error("Tax setting default codes must belong to its tenant");
+			}
+			for (const registration of registrations) {
+				const component = await components.get({ id: registration.taxComponentId }, { cache: false });
+				if (!component || component.tenantId !== this.tenantId) throw new Error("Tax setting registrations must belong to its tenant");
+			}
+			return await super.save();
+		};
+		return transactionBound ? persist() : this.withTransaction(persist);
+	}
+	parsedRegistrations() {
+		try {
+			const value = JSON.parse(this.taxRegistrationsJson);
+			if (!Array.isArray(value)) return null;
+			if (value.some((entry) => !entry || typeof entry !== "object" || typeof entry.taxComponentId !== "string" || typeof entry.number !== "string" || typeof entry.label !== "string")) return null;
+			return value;
+		} catch {
+			return null;
+		}
+	}
+};
+__publicField(TaxSettings, "__smrtPackage__", "@happyvertical/smrt-commerce");
+__decorateClass([tenantId()], TaxSettings.prototype, "tenantId", 2);
+__decorateClass([foreignKey("TaxCode", { description: "The default tax code for sales documents." })], TaxSettings.prototype, "defaultSalesTaxCodeId", 2);
+__decorateClass([foreignKey("TaxCode", { description: "The default tax code for purchase documents." })], TaxSettings.prototype, "defaultPurchaseTaxCodeId", 2);
+__decorateClass([field({ description: "Whether new document amounts are exclusive, inclusive or out of scope." })], TaxSettings.prototype, "defaultLineAmountType", 2);
+__decorateClass([field({ description: "Whether components round per line or per document." })], TaxSettings.prototype, "taxRoundingScope", 2);
+__decorateClass([field({
+	sensitive: true,
+	transient: true,
+	description: "Registration numbers by tax component, for issued-document snapshots."
+})], TaxSettings.prototype, "taxRegistrations", 1);
+TaxSettings = __decorateClass([TenantScoped({ mode: "required" }), smrt({
+	conflictColumns: ["tenant_id"],
+	api: {
+		include: [
+			"get",
+			"create",
+			"update"
+		],
+		writable: [
+			"defaultSalesTaxCodeId",
+			"defaultPurchaseTaxCodeId",
+			"defaultLineAmountType",
+			"taxRoundingScope",
+			"taxRegistrations"
+		]
+	},
+	mcp: { include: ["get"] },
+	cli: { skipApiCheck: true }
+})], TaxSettings);
+//#endregion
+//#region src/tax/identity.ts
+async function deterministicTaxId(tenantId, kind, key) {
+	if (!tenantId.trim() || !key.trim()) throw new Error("Tax bootstrap identity requires tenant and key");
+	const bytes = new TextEncoder().encode(JSON.stringify([
+		"commerce-tax",
+		tenantId,
+		kind,
+		key
+	]));
+	const uuid = new Uint8Array(await crypto.subtle.digest("SHA-256", bytes)).slice(0, 16);
+	uuid[6] = uuid[6] & 15 | 80;
+	uuid[8] = uuid[8] & 63 | 128;
+	const joined = Array.from(uuid, (byte) => byte.toString(16).padStart(2, "0")).join("");
+	return `${joined.slice(0, 8)}-${joined.slice(8, 12)}-${joined.slice(12, 16)}-${joined.slice(16, 20)}-${joined.slice(20)}`;
+}
+async function createOrLoadTaxSeed(create, load) {
+	for (let attempt = 0; attempt < 3; attempt++) try {
+		return await create();
+	} catch (error) {
+		const code = error?.code;
+		if (code === "RUNTIME_REVISION_CONFLICT" && attempt < 2) continue;
+		if (code !== "VALIDATION_UNIQUE_CONSTRAINT" && code !== "23505") throw error;
+		const winner = await load();
+		if (!winner) throw error;
+		return winner;
+	}
+	throw new Error("Tax seed retry exhausted");
+}
+//#endregion
+//#region src/collections/TaxSettingsCollection.ts
+var TaxSettingsCollection_exports = /* @__PURE__ */ __exportAll({ TaxSettingsCollection: () => TaxSettingsCollection });
+var TaxSettingsCollection = class TaxSettingsCollection extends SmrtCollection {
+	static _itemClass = TaxSettings;
+	async getOrCreateForTenant(tenantId) {
+		const existing = await this.getForTenant(tenantId);
+		if (existing) return existing;
+		const id = await deterministicTaxId(tenantId, "settings", "default");
+		return createOrLoadTaxSeed(() => this.create({
+			id,
+			tenantId
+		}), async () => (await this.list({
+			where: { tenantId },
+			limit: 1
+		}))[0] ?? null);
+	}
+	async getForTenant(tenantId) {
+		const listed = (await this.list({
+			where: { tenantId },
+			limit: 1
+		}))[0];
+		if (!listed?.id) return listed ?? null;
+		return await this.get({ id: listed.id }, { cache: false }) ?? null;
+	}
+	/** @internal Lock and re-read the one tenant marker on this transaction. */
+	async lockForTenant(tenantId, create = true) {
+		const first = create ? await this.getOrCreateForTenant(tenantId) : await this.getForTenant(tenantId);
+		if (!first?.id) return null;
+		await lockDocumentMoneyParents([{
+			id: first.id,
+			tenantId,
+			collection: this
+		}]);
+		const locked = await this.getForTenant(tenantId);
+		if (!locked || locked.id !== first.id) throw new MoneyValidationError("INVALID_MONEY_INPUT", "Tenant money settings changed while acquiring the barrier");
+		return locked;
+	}
+	/** Claim exclusive runtime maintenance before any per-document rewrite. */
+	async beginMoneyMigration(tenantId, requestedMigrationId) {
+		if (requestedMigrationId !== void 0 && !/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(requestedMigrationId)) throw new MoneyValidationError("INVALID_MONEY_INPUT", "Migration owner identity must be a UUID");
+		return withDocumentMoneyTransaction(this.db, async (tx) => {
+			const { lockTenantMoneyMigrationClaim } = await import("./tenant-money-barrier-y6EAa6vY.js").then((n) => n.r);
+			const current = await lockTenantMoneyMigrationClaim(tx, tenantId);
+			const migrationId = requestedMigrationId ?? crypto.randomUUID();
+			current.moneyModel = "migrating";
+			current.moneyMigrationId = migrationId;
+			await current.saveMoneyModelOnTransaction(MONEY_MIGRATION_WRITE);
+			return migrationId;
+		});
+	}
+	async activateMoneyV2(tenantId, migrationId) {
+		await withDocumentMoneyTransaction(this.db, async (tx) => {
+			const { lockTenantMoneyMigrationOwner } = await import("./tenant-money-barrier-y6EAa6vY.js").then((n) => n.r);
+			const current = await lockTenantMoneyMigrationOwner(tx, tenantId, migrationId);
+			current.moneyModel = "v2";
+			current.moneyMigrationId = "";
+			await current.saveMoneyModelOnTransaction(MONEY_MIGRATION_WRITE);
+		});
+	}
+	async restoreLegacyMoneyModel(tenantId, migrationId) {
+		await withDocumentMoneyTransaction(this.db, async (tx) => {
+			const { lockTenantMoneyMigrationOwner } = await import("./tenant-money-barrier-y6EAa6vY.js").then((n) => n.r);
+			const current = await lockTenantMoneyMigrationOwner(tx, tenantId, migrationId);
+			current.moneyModel = "legacy";
+			current.moneyMigrationId = "";
+			await current.saveMoneyModelOnTransaction(MONEY_MIGRATION_WRITE);
+		});
+	}
+	/** Claim a previously completed migration for checksum-guarded rollback. */
+	async beginMoneyRollback(tenantId, migrationId) {
+		await withDocumentMoneyTransaction(this.db, async (tx) => {
+			const current = await (await TaxSettingsCollection.create({ db: tx })).lockForTenant(tenantId, false);
+			if (current?.moneyModel !== "v2") throw new MoneyValidationError("FROZEN_DOCUMENT", "Money rollback requires an active v2 tenant marker");
+			current.moneyModel = "migrating";
+			current.moneyMigrationId = migrationId;
+			await current.saveMoneyModelOnTransaction(MONEY_MIGRATION_WRITE);
+		});
+	}
+};
+//#endregion
+export { DOCUMENT_MONEY_READ_REBIND as a, lockDocumentMoneyParents as c, TaxSettings as i, withDocumentMoneyObjectTransaction as l, createOrLoadTaxSeed as n, DOCUMENT_MONEY_WRITE as o, deterministicTaxId as r, MONEY_MIGRATION_WRITE as s, TaxSettingsCollection as t, withDocumentMoneyTransaction as u };
+
+//# sourceMappingURL=TaxSettingsCollection-DYYF-In-.js.map