@happyvertical/smrt-sales 0.40.7 → 0.40.9

package/dist/chunks/{__smrt-register__-D9Gim8vC.js.map → __smrt-register__-D08SaNJE.js.map}

@@ -1 +1 @@
-{"version":3,"file":"__smrt-register__-D9Gim8vC.js","names":[],"sources":["../../src/__smrt-register__.ts"],"sourcesContent":["import { ObjectRegistry } from '@happyvertical/smrt-core';\n\nObjectRegistry.registerPackageManifest(\n  new URL('./manifest.json', import.meta.url),\n);\n"],"mappings":""}
+{"version":3,"file":"__smrt-register__-D08SaNJE.js","names":[],"sources":["../../src/__smrt-register__.ts"],"sourcesContent":["import { ObjectRegistry } from '@happyvertical/smrt-core';\n\nObjectRegistry.registerPackageManifest(\n  new URL('./manifest.json', import.meta.url),\n);\n"],"mappings":""}

package/dist/chunks/{commissions-pI_MmBxN.js → commissions-CelWwvjZ.js}

@@ -1,12 +1,13 @@
 import { SmrtCollection, SmrtObject, crossPackageRef, field, foreignKey, smrt } from "@happyvertical/smrt-core";
-import { TenantScoped, assertTenantReadAllowed, getCurrentTenant, tenantId } from "@happyvertical/smrt-tenancy";
+import { TenantContextError, TenantScoped, assertTenantReadAllowed, getCurrentTenant, requireTenantId, tenantId } from "@happyvertical/smrt-tenancy";
+import { randomUUID } from "node:crypto";
 //#region src/commissions/models/CommissionAdjustment.ts
-var __defProp$6 = Object.defineProperty;
-var __getOwnPropDesc$6 = Object.getOwnPropertyDescriptor;
-var __decorateClass$6 = (decorators, target, key, kind) => {
-	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$6(target, key) : target;
+var __defProp$7 = Object.defineProperty;
+var __getOwnPropDesc$7 = Object.getOwnPropertyDescriptor;
+var __decorateClass$7 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$7(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$6(target, key, result);
+	if (kind && result) __defProp$7(target, key, result);
 	return result;
 };
 var frozenAdjustmentSnapshot = /* @__PURE__ */ new WeakMap();
@@ -30,6 +31,7 @@ var CommissionAdjustment = class extends SmrtObject {
 	metadata = "{}";
 	constructor(options = {}) {
 		super(options);
+		if ("operationId" in options) throw new Error("CommissionAdjustment has no public operationId field; use CommissionAdjustmentService.createAdjustment()");
 		if (options.tenantId !== void 0) this.tenantId = options.tenantId;
 		if (options.commissionId !== void 0) this.commissionId = options.commissionId;
 		if (options.earnerId !== void 0) this.earnerId = options.earnerId;
@@ -102,13 +104,13 @@ var CommissionAdjustment = class extends SmrtObject {
 		});
 	}
 };
-__decorateClass$6([tenantId({ nullable: true })], CommissionAdjustment.prototype, "tenantId", 2);
-__decorateClass$6([foreignKey("Commission", { required: true })], CommissionAdjustment.prototype, "commissionId", 2);
-__decorateClass$6([foreignKey("Earner", { required: true })], CommissionAdjustment.prototype, "earnerId", 2);
-__decorateClass$6([field({ required: true })], CommissionAdjustment.prototype, "reason", 2);
-__decorateClass$6([crossPackageRef("@happyvertical/smrt-profiles:Profile")], CommissionAdjustment.prototype, "createdByProfileId", 2);
-__decorateClass$6([foreignKey("CommissionPayout")], CommissionAdjustment.prototype, "payoutId", 2);
-CommissionAdjustment = __decorateClass$6([TenantScoped({ mode: "optional" }), smrt({
+__decorateClass$7([tenantId({ nullable: true })], CommissionAdjustment.prototype, "tenantId", 2);
+__decorateClass$7([foreignKey("Commission", { required: true })], CommissionAdjustment.prototype, "commissionId", 2);
+__decorateClass$7([foreignKey("Earner", { required: true })], CommissionAdjustment.prototype, "earnerId", 2);
+__decorateClass$7([field({ required: true })], CommissionAdjustment.prototype, "reason", 2);
+__decorateClass$7([crossPackageRef("@happyvertical/smrt-profiles:Profile")], CommissionAdjustment.prototype, "createdByProfileId", 2);
+__decorateClass$7([foreignKey("CommissionPayout")], CommissionAdjustment.prototype, "payoutId", 2);
+CommissionAdjustment = __decorateClass$7([TenantScoped({ mode: "optional" }), smrt({
 	api: { include: [
 		"create",
 		"list",
@@ -193,12 +195,12 @@ var CommissionAdjustmentCollection = class extends SmrtCollection {
 };
 //#endregion
 //#region src/commissions/models/Commission.ts
-var __defProp$5 = Object.defineProperty;
-var __getOwnPropDesc$5 = Object.getOwnPropertyDescriptor;
-var __decorateClass$5 = (decorators, target, key, kind) => {
-	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$5(target, key) : target;
+var __defProp$6 = Object.defineProperty;
+var __getOwnPropDesc$6 = Object.getOwnPropertyDescriptor;
+var __decorateClass$6 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$6(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$5(target, key, result);
+	if (kind && result) __defProp$6(target, key, result);
 	return result;
 };
 var COMMISSION_STATUS_TRANSITIONS = {
@@ -466,12 +468,12 @@ var Commission = class extends SmrtObject {
 		return null;
 	}
 };
-__decorateClass$5([tenantId({ nullable: true })], Commission.prototype, "tenantId", 2);
-__decorateClass$5([foreignKey("Earner", { required: true })], Commission.prototype, "earnerId", 2);
-__decorateClass$5([foreignKey("EarningEvent")], Commission.prototype, "earningEventId", 2);
-__decorateClass$5([foreignKey("CommissionPayout")], Commission.prototype, "payoutId", 2);
-__decorateClass$5([field({ required: true })], Commission.prototype, "dedupeKey", 2);
-Commission = __decorateClass$5([TenantScoped({ mode: "optional" }), smrt({
+__decorateClass$6([tenantId({ nullable: true })], Commission.prototype, "tenantId", 2);
+__decorateClass$6([foreignKey("Earner", { required: true })], Commission.prototype, "earnerId", 2);
+__decorateClass$6([foreignKey("EarningEvent")], Commission.prototype, "earningEventId", 2);
+__decorateClass$6([foreignKey("CommissionPayout")], Commission.prototype, "payoutId", 2);
+__decorateClass$6([field({ required: true })], Commission.prototype, "dedupeKey", 2);
+Commission = __decorateClass$6([TenantScoped({ mode: "optional" }), smrt({
 	conflictColumns: ["dedupe_key"],
 	api: { include: [
 		"list",
@@ -606,12 +608,12 @@ var CommissionCollection = class extends SmrtCollection {
 };
 //#endregion
 //#region src/commissions/models/CommissionPayout.ts
-var __defProp$4 = Object.defineProperty;
-var __getOwnPropDesc$4 = Object.getOwnPropertyDescriptor;
-var __decorateClass$4 = (decorators, target, key, kind) => {
-	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$4(target, key) : target;
+var __defProp$5 = Object.defineProperty;
+var __getOwnPropDesc$5 = Object.getOwnPropertyDescriptor;
+var __decorateClass$5 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$5(target, key) : target;
 	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
-	if (kind && result) __defProp$4(target, key, result);
+	if (kind && result) __defProp$5(target, key, result);
 	return result;
 };
 var PAYOUT_STATUS_TRANSITIONS = {
@@ -872,12 +874,12 @@ ${memo}` : memo;
 		return null;
 	}
 };
-__decorateClass$4([tenantId({ nullable: true })], CommissionPayout.prototype, "tenantId", 2);
-__decorateClass$4([foreignKey("Earner", { required: true })], CommissionPayout.prototype, "earnerId", 2);
-__decorateClass$4([crossPackageRef("@happyvertical/smrt-commerce:Invoice")], CommissionPayout.prototype, "invoiceId", 2);
-__decorateClass$4([field({ required: true })], CommissionPayout.prototype, "idempotencyKey", 2);
-__decorateClass$4([field({ indexed: true })], CommissionPayout.prototype, "sourceId", 2);
-CommissionPayout = __decorateClass$4([TenantScoped({ mode: "optional" }), smrt({
+__decorateClass$5([tenantId({ nullable: true })], CommissionPayout.prototype, "tenantId", 2);
+__decorateClass$5([foreignKey("Earner", { required: true })], CommissionPayout.prototype, "earnerId", 2);
+__decorateClass$5([crossPackageRef("@happyvertical/smrt-commerce:Invoice")], CommissionPayout.prototype, "invoiceId", 2);
+__decorateClass$5([field({ required: true })], CommissionPayout.prototype, "idempotencyKey", 2);
+__decorateClass$5([field({ indexed: true })], CommissionPayout.prototype, "sourceId", 2);
+CommissionPayout = __decorateClass$5([TenantScoped({ mode: "optional" }), smrt({
 	conflictColumns: ["idempotency_key"],
 	api: { include: ["list", "get"] },
 	mcp: { include: ["list", "get"] },
@@ -1008,12 +1010,12 @@ var ADJUSTMENT_SETTLEABLE_COMMISSION_STATUSES = [
 ];
 //#endregion
 //#region src/commissions/models/CommissionPlan.ts
-var __defProp$3 = Object.defineProperty;
-var __getOwnPropDesc$3 = Object.getOwnPropertyDescriptor;
-var __decorateClass$3 = (decorators, target, key, kind) => {
-	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$3(target, key) : target;
+var __defProp$4 = Object.defineProperty;
+var __getOwnPropDesc$4 = Object.getOwnPropertyDescriptor;
+var __decorateClass$4 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$4(target, key) : target;
 	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
-	if (kind && result) __defProp$3(target, key, result);
+	if (kind && result) __defProp$4(target, key, result);
 	return result;
 };
 var PLAN_STATUS_TRANSITIONS = {
@@ -1244,9 +1246,9 @@ var CommissionPlan = class extends SmrtObject {
 		return null;
 	}
 };
-__decorateClass$3([tenantId({ nullable: true })], CommissionPlan.prototype, "tenantId", 2);
-__decorateClass$3([field({ required: true })], CommissionPlan.prototype, "planKey", 2);
-CommissionPlan = __decorateClass$3([TenantScoped({ mode: "optional" }), smrt({
+__decorateClass$4([tenantId({ nullable: true })], CommissionPlan.prototype, "tenantId", 2);
+__decorateClass$4([field({ required: true })], CommissionPlan.prototype, "planKey", 2);
+CommissionPlan = __decorateClass$4([TenantScoped({ mode: "optional" }), smrt({
 	conflictColumns: [
 		"tenant_id",
 		"plan_key",
@@ -1351,12 +1353,12 @@ var CommissionPlanCollection = class extends SmrtCollection {
 };
 //#endregion
 //#region src/commissions/models/Earner.ts
-var __defProp$2 = Object.defineProperty;
-var __getOwnPropDesc$2 = Object.getOwnPropertyDescriptor;
-var __decorateClass$2 = (decorators, target, key, kind) => {
-	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$2(target, key) : target;
+var __defProp$3 = Object.defineProperty;
+var __getOwnPropDesc$3 = Object.getOwnPropertyDescriptor;
+var __decorateClass$3 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$3(target, key) : target;
 	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
-	if (kind && result) __defProp$2(target, key, result);
+	if (kind && result) __defProp$3(target, key, result);
 	return result;
 };
 var Earner = class extends SmrtObject {
@@ -1422,9 +1424,9 @@ var Earner = class extends SmrtObject {
 		this.metadata = JSON.stringify(data ?? {});
 	}
 };
-__decorateClass$2([tenantId({ nullable: true })], Earner.prototype, "tenantId", 2);
-__decorateClass$2([crossPackageRef("@happyvertical/smrt-profiles:Profile")], Earner.prototype, "profileId", 2);
-Earner = __decorateClass$2([TenantScoped({ mode: "optional" }), smrt({
+__decorateClass$3([tenantId({ nullable: true })], Earner.prototype, "tenantId", 2);
+__decorateClass$3([crossPackageRef("@happyvertical/smrt-profiles:Profile")], Earner.prototype, "profileId", 2);
+Earner = __decorateClass$3([TenantScoped({ mode: "optional" }), smrt({
 	api: { include: [
 		"list",
 		"get",
@@ -1463,12 +1465,12 @@ var EarnerCollection = class extends SmrtCollection {
 };
 //#endregion
 //#region src/commissions/models/EarnerSourceAttribution.ts
-var __defProp$1 = Object.defineProperty;
-var __getOwnPropDesc$1 = Object.getOwnPropertyDescriptor;
-var __decorateClass$1 = (decorators, target, key, kind) => {
-	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$1(target, key) : target;
+var __defProp$2 = Object.defineProperty;
+var __getOwnPropDesc$2 = Object.getOwnPropertyDescriptor;
+var __decorateClass$2 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$2(target, key) : target;
 	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
-	if (kind && result) __defProp$1(target, key, result);
+	if (kind && result) __defProp$2(target, key, result);
 	return result;
 };
 var EarnerSourceAttribution = class extends SmrtObject {
@@ -1542,14 +1544,14 @@ var EarnerSourceAttribution = class extends SmrtObject {
 		if (earnerTenant !== mappingTenant) throw new Error(`EarnerSourceAttribution ${this.id ?? "<new>"}: mapping tenant '${mappingTenant ?? "global"}' does not match earner tenant '${earnerTenant ?? "global"}' \u2014 a mapping must live in its earner's tenant.`);
 	}
 };
-__decorateClass$1([tenantId({ nullable: true })], EarnerSourceAttribution.prototype, "tenantId", 2);
-__decorateClass$1([foreignKey("Earner", { required: true })], EarnerSourceAttribution.prototype, "earnerId", 2);
-__decorateClass$1([field({ required: true })], EarnerSourceAttribution.prototype, "sourceKind", 2);
-__decorateClass$1([field({
+__decorateClass$2([tenantId({ nullable: true })], EarnerSourceAttribution.prototype, "tenantId", 2);
+__decorateClass$2([foreignKey("Earner", { required: true })], EarnerSourceAttribution.prototype, "earnerId", 2);
+__decorateClass$2([field({ required: true })], EarnerSourceAttribution.prototype, "sourceKind", 2);
+__decorateClass$2([field({
 	required: true,
 	indexed: true
 })], EarnerSourceAttribution.prototype, "sourceId", 2);
-EarnerSourceAttribution = __decorateClass$1([TenantScoped({ mode: "optional" }), smrt({
+EarnerSourceAttribution = __decorateClass$2([TenantScoped({ mode: "optional" }), smrt({
 	conflictColumns: [
 		"tenant_id",
 		"source_kind",
@@ -1615,12 +1617,12 @@ var EarnerSourceAttributionCollection = class extends SmrtCollection {
 };
 //#endregion
 //#region src/commissions/models/EarningEvent.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;
+var __defProp$1 = Object.defineProperty;
+var __getOwnPropDesc$1 = Object.getOwnPropertyDescriptor;
+var __decorateClass$1 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$1(target, key) : target;
 	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
-	if (kind && result) __defProp(target, key, result);
+	if (kind && result) __defProp$1(target, key, result);
 	return result;
 };
 var persistedEventState = /* @__PURE__ */ new WeakMap();
@@ -1768,18 +1770,18 @@ var EarningEvent = class extends SmrtObject {
 		return null;
 	}
 };
-__decorateClass([tenantId({ nullable: true })], EarningEvent.prototype, "tenantId", 2);
-__decorateClass([field({ required: true })], EarningEvent.prototype, "eventKind", 2);
-__decorateClass([field({
+__decorateClass$1([tenantId({ nullable: true })], EarningEvent.prototype, "tenantId", 2);
+__decorateClass$1([field({ required: true })], EarningEvent.prototype, "eventKind", 2);
+__decorateClass$1([field({
 	type: "integer",
 	nullable: true
 })], EarningEvent.prototype, "netAmountCents", 2);
-__decorateClass([field({
+__decorateClass$1([field({
 	type: "integer",
 	nullable: true
 })], EarningEvent.prototype, "marginCents", 2);
-__decorateClass([field({ required: true })], EarningEvent.prototype, "dedupeKey", 2);
-EarningEvent = __decorateClass([TenantScoped({ mode: "optional" }), smrt({
+__decorateClass$1([field({ required: true })], EarningEvent.prototype, "dedupeKey", 2);
+EarningEvent = __decorateClass$1([TenantScoped({ mode: "optional" }), smrt({
 	conflictColumns: ["dedupe_key"],
 	api: { include: [
 		"create",
@@ -1861,6 +1863,284 @@ function calculateCommissionAmountCents(baseCents, rate, shareFraction) {
 	return roundCents(baseCents * rate * (shareFraction ?? 1));
 }
 //#endregion
+//#region src/commissions/models/CommissionAdjustmentOperation.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 CommissionAdjustmentOperation = class extends SmrtObject {
+	tenantId = "";
+	adjustmentId;
+	constructor(options = {}) {
+		super(options);
+		if (options.tenantId !== void 0) this.tenantId = options.tenantId;
+		if (options.adjustmentId !== void 0) this.adjustmentId = options.adjustmentId;
+	}
+};
+__decorateClass([tenantId()], CommissionAdjustmentOperation.prototype, "tenantId", 2);
+__decorateClass([field({
+	sqlType: "UUID",
+	required: true,
+	readonly: true,
+	indexed: true
+})], CommissionAdjustmentOperation.prototype, "adjustmentId", 2);
+CommissionAdjustmentOperation = __decorateClass([TenantScoped({ mode: "required" }), smrt({
+	api: false,
+	mcp: false,
+	cli: false
+})], CommissionAdjustmentOperation);
+//#endregion
+//#region src/commissions/collections/CommissionAdjustmentOperationCollection.ts
+var CommissionAdjustmentOperationCollection = class extends SmrtCollection {
+	static _itemClass = CommissionAdjustmentOperation;
+	/** Tenant-scoped lookup; foreign-tenant operation payloads stay invisible. */
+	async findByOperationId(operationId) {
+		const tenantId = requireTenantId();
+		const [operation] = await this.query(`SELECT
+         id, slug, context, created_at, updated_at, tenant_id,
+         CAST(adjustment_id AS TEXT) AS adjustment_id
+       FROM ${this.tableName}
+       WHERE id = ? AND tenant_id = ?
+       LIMIT 1`, [operationId, tenantId], { allowRawOnTenantScoped: true });
+		return operation ?? null;
+	}
+	/**
+	* Claim the globally unique operation UUID without changing an existing
+	* winner. This must run inside the same transaction that creates the
+	* corresponding adjustment.
+	*/
+	async claim(input) {
+		if (requireTenantId().toLowerCase() !== input.tenantId.toLowerCase()) throw new Error("CommissionAdjustment operation tenant mismatch");
+		const inserted = await this.query(`INSERT INTO ${this.tableName} (
+         id, slug, context, tenant_id, adjustment_id
+       ) VALUES (?, ?, ?, ?, ?)
+       ON CONFLICT (id) DO NOTHING
+       RETURNING id`, [
+			input.operationId,
+			input.operationId,
+			"",
+			input.tenantId,
+			input.adjustmentId
+		], { allowRawOnTenantScoped: true });
+		return {
+			operation: await this.findByOperationId(input.operationId),
+			claimed: inserted.length === 1
+		};
+	}
+};
+//#endregion
+//#region src/commissions/services/CommissionAdjustmentService.ts
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+var CommissionAdjustmentReplayConflictError = class extends Error {
+	constructor(operationId, mismatches) {
+		super(`Commission adjustment operation '${operationId}' was already used with different immutable ${mismatches.length === 1 ? "field" : "fields"}: ` + mismatches.join(", "));
+		this.operationId = operationId;
+		this.mismatches = mismatches;
+		this.name = "CommissionAdjustmentReplayConflictError";
+	}
+	operationId;
+	mismatches;
+	code = "COMMISSION_ADJUSTMENT_REPLAY_CONFLICT";
+};
+var CommissionAdjustmentValidationError = class extends Error {
+	constructor(reason, message) {
+		super(message);
+		this.reason = reason;
+		this.name = "CommissionAdjustmentValidationError";
+	}
+	reason;
+	code = "COMMISSION_ADJUSTMENT_VALIDATION_ERROR";
+};
+var CommissionAdjustmentService = class CommissionAdjustmentService {
+	constructor(deps) {
+		this.deps = deps;
+	}
+	deps;
+	static async create(options = {}) {
+		return new CommissionAdjustmentService({
+			commissions: await CommissionCollection.create(options),
+			adjustments: await CommissionAdjustmentCollection.create(options),
+			operations: await CommissionAdjustmentOperationCollection.create(options),
+			earners: await EarnerCollection.create(options)
+		});
+	}
+	/**
+	* Create exactly one immutable adjustment for `operationId`.
+	*
+	* The operation fence table's primary UUID is the serialization point. The
+	* fence and adjustment are committed in one transaction. An exact replay
+	* returns the persisted row; any changed immutable input raises
+	* {@link CommissionAdjustmentReplayConflictError}. The claim primitive uses
+	* `ON CONFLICT DO NOTHING`, so a losing PostgreSQL transaction remains
+	* usable and can read/verify the committed winner rather than entering an
+	* aborted transaction state.
+	*/
+	async createAdjustment(input) {
+		const intent = this.canonicalize(input);
+		this.assertTenant(intent.tenantId);
+		return await this.runTransaction(async (deps) => {
+			const existingOperation = await deps.operations.findByOperationId(intent.operationId);
+			if (existingOperation) return await this.replayFromOperation(deps, existingOperation, intent);
+			await this.assertParentAndEarner(deps, intent);
+			const adjustmentId = randomUUID();
+			const claimed = await deps.operations.claim({
+				operationId: intent.operationId,
+				tenantId: intent.tenantId,
+				adjustmentId
+			});
+			if (!claimed.operation) throw new CommissionAdjustmentReplayConflictError(intent.operationId, ["tenantId"]);
+			if (!claimed.claimed) return await this.replayFromOperation(deps, claimed.operation, intent);
+			const { operationId: _operationId, ...adjustmentIntent } = intent;
+			const adjustment = await deps.adjustments.create({
+				id: adjustmentId,
+				...adjustmentIntent
+			});
+			this.assertExactReplay(adjustment, intent);
+			return {
+				adjustment,
+				created: true
+			};
+		});
+	}
+	canonicalize(input) {
+		this.assertUuid(input.operationId, "invalid_operation_id", "operationId");
+		this.assertUuid(input.tenantId, "invalid_tenant_id", "tenantId");
+		if (input.tenantId !== input.tenantId.toLowerCase()) throw new CommissionAdjustmentValidationError("invalid_tenant_id", "Commission adjustment tenantId must use canonical lowercase UUID casing");
+		this.assertUuid(input.commissionId, "invalid_commission_id", "commissionId");
+		this.assertUuid(input.earnerId, "invalid_earner_id", "earnerId");
+		this.assertUuid(input.createdByProfileId, "invalid_operator_profile_id", "createdByProfileId");
+		if (!COMMISSION_ADJUSTMENT_KINDS.includes(input.adjustmentKind)) throw new CommissionAdjustmentValidationError("invalid_adjustment_kind", `Unknown commission adjustment kind '${String(input.adjustmentKind)}'`);
+		if (!Number.isSafeInteger(input.amountCents) || input.amountCents === 0) throw new CommissionAdjustmentValidationError("invalid_amount", "Commission adjustment amountCents must be a non-zero safe integer");
+		const currency = input.currency.trim().toUpperCase();
+		if (!/^[A-Z]{3}$/.test(currency)) throw new CommissionAdjustmentValidationError("invalid_currency", "Commission adjustment currency must be a three-letter ISO code");
+		const reason = input.reason.trim();
+		if (!reason) throw new CommissionAdjustmentValidationError("reason_required", "Commission adjustment reason is required");
+		return {
+			operationId: input.operationId.toLowerCase(),
+			tenantId: input.tenantId.toLowerCase(),
+			commissionId: input.commissionId.toLowerCase(),
+			earnerId: input.earnerId.toLowerCase(),
+			adjustmentKind: input.adjustmentKind,
+			amountCents: input.amountCents,
+			currency,
+			reason,
+			createdByProfileId: input.createdByProfileId.toLowerCase(),
+			metadata: this.canonicalMetadata(input.metadata === void 0 ? {} : input.metadata)
+		};
+	}
+	assertTenant(tenantId) {
+		let activeTenantId;
+		try {
+			activeTenantId = requireTenantId();
+		} catch (error) {
+			if (!(error instanceof TenantContextError)) throw error;
+			throw new CommissionAdjustmentValidationError("tenant_context_mismatch", "Commission adjustment creation requires an active tenant context");
+		}
+		if (activeTenantId !== activeTenantId.toLowerCase() || activeTenantId !== tenantId) throw new CommissionAdjustmentValidationError("tenant_context_mismatch", "Commission adjustment tenant must exactly match the canonical lowercase active tenant");
+	}
+	async assertParentAndEarner(deps, intent) {
+		const commission = await deps.commissions.get({ id: intent.commissionId });
+		if (!commission) throw new CommissionAdjustmentValidationError("commission_not_found", `Commission '${intent.commissionId}' was not found in the active tenant`);
+		if (commission.tenantId?.toLowerCase() !== intent.tenantId) throw new CommissionAdjustmentValidationError("commission_tenant_mismatch", "Commission does not belong to the adjustment tenant");
+		if (commission.earnerId.toLowerCase() !== intent.earnerId) throw new CommissionAdjustmentValidationError("earner_mismatch", `Adjustment earner '${intent.earnerId}' does not match Commission earner '${commission.earnerId}'`);
+		if (commission.currency.toUpperCase() !== intent.currency) throw new CommissionAdjustmentValidationError("currency_mismatch", `Adjustment currency '${intent.currency}' does not match Commission currency '${commission.currency}'`);
+		const earner = await deps.earners.get({ id: intent.earnerId });
+		if (!earner) throw new CommissionAdjustmentValidationError("earner_not_found", `Earner '${intent.earnerId}' was not found in the active tenant`);
+		if (earner.tenantId?.toLowerCase() !== intent.tenantId) throw new CommissionAdjustmentValidationError("earner_tenant_mismatch", "Earner does not belong to the adjustment tenant");
+	}
+	assertExactReplay(existing, intent) {
+		const mismatches = [];
+		if (existing.tenantId?.toLowerCase() !== intent.tenantId) mismatches.push("tenantId");
+		if (existing.commissionId.toLowerCase() !== intent.commissionId) mismatches.push("commissionId");
+		if (existing.earnerId.toLowerCase() !== intent.earnerId) mismatches.push("earnerId");
+		if (existing.adjustmentKind !== intent.adjustmentKind) mismatches.push("adjustmentKind");
+		if (existing.amountCents !== intent.amountCents) mismatches.push("amountCents");
+		if (existing.currency.toUpperCase() !== intent.currency) mismatches.push("currency");
+		if (existing.reason !== intent.reason) mismatches.push("reason");
+		if (existing.createdByProfileId.toLowerCase() !== intent.createdByProfileId) mismatches.push("createdByProfileId");
+		if (canonicalizePersistedJson(existing.metadata) !== intent.metadata) mismatches.push("metadata");
+		if (mismatches.length > 0) throw new CommissionAdjustmentReplayConflictError(intent.operationId, mismatches);
+	}
+	assertUuid(value, reason, field) {
+		if (typeof value !== "string" || !UUID_RE.test(value)) throw new CommissionAdjustmentValidationError(reason, `Commission adjustment ${field} must be a UUID`);
+	}
+	canonicalMetadata(metadata) {
+		try {
+			if (!isPlainJsonObject(metadata)) throw new TypeError("metadata must be a plain JSON object");
+			return stableJson(metadata);
+		} catch (error) {
+			throw new CommissionAdjustmentValidationError("invalid_metadata", `Commission adjustment metadata must be JSON-serializable: ${error instanceof Error ? error.message : String(error)}`);
+		}
+	}
+	async replayFromOperation(deps, operation, intent) {
+		const adjustment = await deps.adjustments.get({ id: operation.adjustmentId });
+		if (!adjustment) throw new CommissionAdjustmentValidationError("operation_adjustment_missing", `Commission adjustment operation '${intent.operationId}' has no visible adjustment`);
+		this.assertExactReplay(adjustment, intent);
+		return {
+			adjustment,
+			created: false
+		};
+	}
+	async runTransaction(fn) {
+		const db = this.deps.adjustments.db;
+		if (typeof db.transaction !== "function") throw new CommissionAdjustmentValidationError("transaction_unavailable", "Commission adjustment creation requires a transaction-capable database adapter");
+		return await db.transaction(async (tx) => fn({
+			commissions: await CommissionCollection.create({ db: tx }),
+			adjustments: await CommissionAdjustmentCollection.create({ db: tx }),
+			operations: await CommissionAdjustmentOperationCollection.create({ db: tx }),
+			earners: await EarnerCollection.create({ db: tx })
+		}));
+	}
+};
+function canonicalizePersistedJson(value) {
+	try {
+		return stableJson(JSON.parse(value));
+	} catch {
+		return value;
+	}
+}
+function stableJson(value) {
+	return JSON.stringify(sortJsonValue(value, /* @__PURE__ */ new Set()));
+}
+function isPlainJsonObject(value) {
+	if (value === null || typeof value !== "object" || Array.isArray(value)) return false;
+	const prototype = Object.getPrototypeOf(value);
+	return prototype === Object.prototype || prototype === null;
+}
+function sortJsonValue(value, ancestors) {
+	if (value === null || typeof value === "string" || typeof value === "boolean" || typeof value === "number" && Number.isFinite(value)) return value;
+	if (Array.isArray(value)) {
+		if (ancestors.has(value)) throw new TypeError("metadata must be acyclic");
+		ancestors.add(value);
+		try {
+			return value.map((item) => sortJsonValue(item, ancestors));
+		} finally {
+			ancestors.delete(value);
+		}
+	}
+	if (value && typeof value === "object") {
+		const prototype = Object.getPrototypeOf(value);
+		if (prototype !== Object.prototype && prototype !== null) throw new TypeError("metadata objects must be plain JSON objects");
+		if (ancestors.has(value)) throw new TypeError("metadata must be acyclic");
+		ancestors.add(value);
+		try {
+			const sorted = /* @__PURE__ */ Object.create(null);
+			for (const key of Object.keys(value).sort()) {
+				const item = value[key];
+				if (item !== void 0) sorted[key] = sortJsonValue(item, ancestors);
+			}
+			return sorted;
+		} finally {
+			ancestors.delete(value);
+		}
+	}
+	throw new TypeError("metadata must contain only JSON values");
+}
+//#endregion
 //#region src/commissions/services/CommissionBalanceService.ts
 var CommissionBalanceService = class CommissionBalanceService {
 	constructor(commissions, adjustments) {
@@ -3270,6 +3550,6 @@ var EarnerAttributionService = class EarnerAttributionService {
 	}
 };
 //#endregion
-export { CommissionPayout as A, COMMISSION_PLAN_STATUSES as C, EARNING_EVENT_KINDS as D, EARNER_STATUSES as E, Commission as M, CommissionAdjustmentCollection as N, PAYOUT_METHODS as O, CommissionAdjustment as P, COMMISSION_PAYOUT_STATUSES as S, EARNER_SOURCE_ATTRIBUTION_STATUSES as T, CommissionPlan as _, CommissionBalanceService as a, COMMISSION_ADJUSTMENT_KINDS as b, centsToAmount as c, EarningEvent as d, EarnerSourceAttributionCollection as f, CommissionPlanCollection as g, Earner as h, CommissionCalculationService as i, CommissionCollection as j, CommissionPayoutCollection as k, roundCents as l, EarnerCollection as m, CommissionSettlementService as n, amountToCents as o, EarnerSourceAttribution as p, CommissionPayoutService as r, calculateCommissionAmountCents as s, EarnerAttributionService as t, EarningEventCollection as u, validateCommissionPlanComponents as v, COMMISSION_STATUSES as w, COMMISSION_BASES as x, ADJUSTMENT_SETTLEABLE_COMMISSION_STATUSES as y };
+export { EARNING_EVENT_KINDS as A, COMMISSION_ADJUSTMENT_KINDS as C, COMMISSION_STATUSES as D, COMMISSION_PLAN_STATUSES as E, Commission as F, CommissionAdjustmentCollection as I, CommissionAdjustment as L, CommissionPayoutCollection as M, CommissionPayout as N, EARNER_SOURCE_ATTRIBUTION_STATUSES as O, CommissionCollection as P, ADJUSTMENT_SETTLEABLE_COMMISSION_STATUSES as S, COMMISSION_PAYOUT_STATUSES as T, EarnerCollection as _, CommissionBalanceService as a, CommissionPlan as b, CommissionAdjustmentValidationError as c, centsToAmount as d, roundCents as f, EarnerSourceAttribution as g, EarnerSourceAttributionCollection as h, CommissionCalculationService as i, PAYOUT_METHODS as j, EARNER_STATUSES as k, amountToCents as l, EarningEvent as m, CommissionSettlementService as n, CommissionAdjustmentReplayConflictError as o, EarningEventCollection as p, CommissionPayoutService as r, CommissionAdjustmentService as s, EarnerAttributionService as t, calculateCommissionAmountCents as u, Earner as v, COMMISSION_BASES as w, validateCommissionPlanComponents as x, CommissionPlanCollection as y };
 
-//# sourceMappingURL=commissions-pI_MmBxN.js.map
+//# sourceMappingURL=commissions-CelWwvjZ.js.map