@wtree/payload-ecommerce-coupon 3.77.4 → 3.77.6

package/dist/index.js

@@ -1,8 +1,8 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/collections/createCouponsCollection.ts
 const createCouponsCollection = (pluginConfig) => {
-	const { collections, access, defaultCurrency, adminGroups } = pluginConfig;
+	const { collections, access, defaultCurrency, adminGroups, integration } = pluginConfig;
+	const usersSlug = integration.collections.usersSlug;
 	return {
 		slug: collections.couponsSlug,
 		admin: {
@@ -30,6 +30,16 @@ const createCouponsCollection = (pluginConfig) => {
 				unique: true,
 				admin: { description: "The coupon code that customers will enter" }
 			},
+			{
+				name: "normalizedCode",
+				type: "text",
+				unique: true,
+				index: true,
+				admin: {
+					hidden: true,
+					description: "Uppercased, trimmed code used for fast case-insensitive lookups"
+				}
+			},
 			{
 				name: "description",
 				type: "text",
@@ -105,21 +115,33 @@ const createCouponsCollection = (pluginConfig) => {
 			{
 				name: "createdBy",
 				type: "relationship",
-				relationTo: "users",
+				relationTo: usersSlug,
 				admin: {
 					readOnly: true,
 					position: "sidebar"
 				}
 			}
 		],
-		hooks: { beforeChange: [({ operation, req, data }) => {
-			if (operation === "create" && req.user) data.createdBy = req.user.id;
-			return data;
-		}] },
+		hooks: {
+			beforeValidate: [({ data }) => {
+				if (data && typeof data.code === "string") {
+					data.code = data.code.trim();
+					data.normalizedCode = data.code.toUpperCase();
+				}
+				return data;
+			}],
+			beforeChange: [({ operation, req, data }) => {
+				if (data && typeof data.code === "string") {
+					data.code = data.code.trim();
+					data.normalizedCode = data.code.toUpperCase();
+				}
+				if (operation === "create" && req.user && !data.createdBy) data.createdBy = req.user.id;
+				return data;
+			}]
+		},
 		timestamps: true
 	};
 };
-
 //#endregion
 //#region src/utilities/userRoles.ts
 function readByPath(input, path) {
@@ -168,17 +190,19 @@ const buildPartnerUserFilterWhere = ({ roleConfig }) => {
 	if (conditions.length === 1) return conditions[0];
 	return { or: conditions };
 };
-
 //#endregion
 //#region src/collections/createReferralCodesCollection.ts
+const normalizeCode$2 = (value) => typeof value === "string" ? value.trim().toUpperCase() : "";
 const createReferralCodesCollection = (pluginConfig) => {
-	const { collections, access, adminGroups, defaultCurrency, roleConfig } = pluginConfig;
+	const { collections, access, adminGroups, defaultCurrency, roleConfig, policies, integration } = pluginConfig;
+	const usersSlug = integration.collections.usersSlug;
 	return {
 		slug: collections.referralCodesSlug,
 		admin: {
 			useAsTitle: "code",
 			defaultColumns: [
 				"code",
+				"normalizedCode",
 				"partner",
 				"program",
 				"usageCount",
@@ -187,34 +211,59 @@ const createReferralCodesCollection = (pluginConfig) => {
 			group: adminGroups.referralsGroup
 		},
 		access: {
-			read: ({ req }) => {
+			read: async ({ req }) => {
 				const user = req?.user;
 				if (!user) return false;
 				if (isAdminUser({
 					user,
 					roleConfig
-				}) || access.isAdmin?.({ req })) return true;
+				}) || await Promise.resolve(access.isAdmin?.({ req }))) return true;
+				if (!await Promise.resolve(policies.canApplyReferral({
+					req,
+					user,
+					payload: req?.payload
+				}))) return false;
 				if (isPartnerUser({
 					user,
 					roleConfig
-				}) || access.isPartner?.({ req })) return { partner: { equals: user.id } };
+				}) || await Promise.resolve(access.isPartner?.({ req }))) return { partner: { equals: user.id } };
 				return access.canUseReferrals ? access.canUseReferrals({ req }) : false;
 			},
-			create: ({ req }) => {
+			create: async ({ req }) => {
 				const user = req?.user;
 				if (!user) return false;
+				if (!await Promise.resolve(policies.canApplyReferral({
+					req,
+					user,
+					payload: req?.payload
+				}))) return false;
 				if (isAdminUser({
 					user,
 					roleConfig
-				}) || access.isAdmin?.({ req })) return true;
+				}) || await Promise.resolve(access.isAdmin?.({ req }))) return true;
 				if (isPartnerUser({
 					user,
 					roleConfig
-				}) || access.isPartner?.({ req })) return true;
+				}) || await Promise.resolve(access.isPartner?.({ req }))) return true;
 				return access.isAdmin ? access.isAdmin({ req }) : false;
 			},
-			update: access.isAdmin || (() => false),
-			delete: access.isAdmin || (() => false)
+			update: async ({ req }) => {
+				const user = req?.user;
+				if (!user) return false;
+				if (isAdminUser({
+					user,
+					roleConfig
+				}) || await Promise.resolve(access.isAdmin?.({ req }))) return true;
+				return false;
+			},
+			delete: async ({ req }) => {
+				const user = req?.user;
+				if (!user) return false;
+				return isAdminUser({
+					user,
+					roleConfig
+				}) || await Promise.resolve(access.isAdmin?.({ req }));
+			}
 		},
 		fields: [
 			{
@@ -224,6 +273,17 @@ const createReferralCodesCollection = (pluginConfig) => {
 				unique: true,
 				admin: { description: "The referral code that customers will enter" }
 			},
+			{
+				name: "normalizedCode",
+				type: "text",
+				required: true,
+				unique: true,
+				index: true,
+				admin: {
+					readOnly: true,
+					description: "Uppercased normalized code for fast case-insensitive lookup"
+				}
+			},
 			{
 				name: "program",
 				type: "relationship",
@@ -234,16 +294,16 @@ const createReferralCodesCollection = (pluginConfig) => {
 			{
 				name: "partner",
 				type: "relationship",
-				relationTo: "users",
+				relationTo: usersSlug,
 				required: true,
-				filterOptions: ({ req, user }) => {
+				filterOptions: async ({ req, user }) => {
 					if (isAdminUser({
 						user: user || req?.user,
 						roleConfig
-					}) || access.isAdmin?.({ req })) return true;
+					}) || await Promise.resolve(access.isAdmin?.({ req }))) return true;
 					return buildPartnerUserFilterWhere({ roleConfig });
 				},
-				admin: { description: "The partner who owns this referral code" }
+				admin: { description: `The partner who owns this referral code (relation: ${usersSlug})` }
 			},
 			{
 				name: "isActive",
@@ -315,40 +375,41 @@ const createReferralCodesCollection = (pluginConfig) => {
 				}
 			}
 		],
-		hooks: { beforeChange: [({ operation, req, data }) => {
-			if (operation === "create" && !data.code && data.partner) data.code = `REF-${Date.now().toString(36)}-${Math.random().toString(36).substring(2, 8)}`.toUpperCase();
-			if (operation === "create" && req.user) {
-				const user = req.user;
-				if (isPartnerUser({
-					user,
-					roleConfig
-				})) data.partner = user.id;
-			}
-			return data;
-		}] },
+		hooks: {
+			beforeValidate: [({ data }) => {
+				if (!data) return data;
+				data.normalizedCode = normalizeCode$2(data.code);
+				return data;
+			}],
+			beforeChange: [({ operation, req, data }) => {
+				if (!data) return data;
+				if (operation === "create" && !data.code && data.partner) data.code = `REF-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`.toUpperCase();
+				data.normalizedCode = normalizeCode$2(data.code);
+				if (operation === "create" && req.user) {
+					const user = req.user;
+					if (isPartnerUser({
+						user,
+						roleConfig
+					}) && user.id != null) data.partner = user.id;
+				}
+				return data;
+			}]
+		},
 		timestamps: true
 	};
 };
-
 //#endregion
 //#region src/collections/createReferralProgramsCollection.ts
 function toNumber(value) {
 	return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
-const deriveCustomerSplit = (partnerSplit, totalCommission) => {
-	if (totalCommission?.type === "fixed" && totalCommission.value == null) {
-		const partner = toNumber(partnerSplit);
-		return partner != null ? partner : 0;
-	}
-	const partner = toNumber(partnerSplit);
-	if (partner == null) return 0;
-	if (partner < 0) return 100;
-	if (partner > 100) return 0;
-	return 100 - partner;
-};
+function toCents(value) {
+	return Math.round(value * 100);
+}
 const createReferralProgramsCollection = (pluginConfig) => {
-	const { collections, access, defaultCurrency, adminGroups, referralConfig } = pluginConfig;
+	const { collections, access, defaultCurrency, adminGroups, referralConfig, integration } = pluginConfig;
 	const allowedTotalCommissionTypes = referralConfig.allowedTotalCommissionTypes;
+	const relationSlugs = integration.collections;
 	return {
 		slug: collections.referralProgramsSlug,
 		admin: {
@@ -372,34 +433,71 @@ const createReferralProgramsCollection = (pluginConfig) => {
 				const r = rule;
 				if (!r.totalCommission) throw new Error(`Commission rule ${index + 1}: Total Commission is required`);
 				if (!r.totalCommission.type || !allowedTotalCommissionTypes.includes(r.totalCommission.type)) throw new Error(`Commission rule ${index + 1}: Total Commission type must be one of ${allowedTotalCommissionTypes.join(", ")}`);
+				const type = r.totalCommission.type;
 				const totalValue = toNumber(r.totalCommission.value);
-				if (r.totalCommission.type === "percentage" && (totalValue == null || totalValue < 0)) throw new Error(`Commission rule ${index + 1}: Total Commission value must be a non-negative number`);
-				if (r.totalCommission.type === "percentage" && totalValue && totalValue > 100) throw new Error(`Commission rule ${index + 1}: Percentage Total Commission cannot exceed 100`);
 				const maxAmount = toNumber(r.totalCommission.maxAmount);
+				if (type === "percentage") {
+					if (totalValue == null || totalValue < 0) throw new Error(`Commission rule ${index + 1}: Total Commission value must be a non-negative number`);
+					if (totalValue > 100) throw new Error(`Commission rule ${index + 1}: Percentage Total Commission cannot exceed 100`);
+				}
 				if (maxAmount != null && maxAmount < 0) throw new Error(`Commission rule ${index + 1}: Max Amount must be a non-negative number`);
 				const appliesTo = r.appliesTo ?? "all";
 				if (appliesTo === "products" && (!r.products || r.products.length === 0)) throw new Error(`Commission rule ${index + 1}: At least one product is required`);
 				if ((appliesTo === "segments" || appliesTo === "categories") && (!r.categories || r.categories.length === 0) && (!r.tags || r.tags.length === 0)) throw new Error(`Commission rule ${index + 1}: At least one category or tag is required`);
-				const partnerSplit = toNumber(r.partnerSplit);
-				if (partnerSplit == null || partnerSplit < 0) throw new Error(`Commission rule ${index + 1}: Partner Split must be a non-negative number`);
-				const hasFixedValue = r.totalCommission.type === "fixed" && toNumber(r.totalCommission.value) != null;
-				if (!hasFixedValue && r.totalCommission.type !== "fixed" && partnerSplit > 100) throw new Error(`Commission rule ${index + 1}: Partner Split must be between 0 and 100`);
-				if (hasFixedValue && partnerSplit > 100) throw new Error(`Commission rule ${index + 1}: Partner Split must be between 0 and 100`);
-				let customerSplit = null;
-				if (r.totalCommission.type === "fixed" && !hasFixedValue) {
-					customerSplit = toNumber(r.customerSplit);
-					if (customerSplit == null || customerSplit < 0) throw new Error(`Commission rule ${index + 1}: For fixed commissions with no value, both partnerSplit and customerSplit must be non-negative numbers`);
-				} else customerSplit = 100 - partnerSplit;
+				let partnerSplit;
+				let customerSplit;
+				let partnerPercent = null;
+				let customerPercent = null;
+				let partnerAmount = null;
+				let customerAmount = null;
+				if (type === "percentage") {
+					const partnerPctInput = toNumber(r.partnerPercent) ?? toNumber(r.partnerSplit);
+					if (partnerPctInput == null || partnerPctInput < 0 || partnerPctInput > 100) throw new Error(`Commission rule ${index + 1}: Partner Split must be between 0 and 100`);
+					const customerPctComputed = 100 - partnerPctInput;
+					if (customerPctComputed < 0 || customerPctComputed > 100) throw new Error(`Commission rule ${index + 1}: Customer percentage must be between 0 and 100`);
+					partnerPercent = partnerPctInput;
+					customerPercent = customerPctComputed;
+					partnerSplit = partnerPctInput;
+					customerSplit = customerPctComputed;
+				} else {
+					const partnerAmountInput = toNumber(r.partnerAmount);
+					const customerAmountInput = toNumber(r.customerAmount);
+					const legacyPartnerSplitInput = toNumber(r.partnerSplit);
+					const legacyCustomerSplitInput = toNumber(r.customerSplit);
+					const hasNewFixedInputs = partnerAmountInput != null || customerAmountInput != null;
+					const hasLegacyFixedInputs = legacyPartnerSplitInput != null || legacyCustomerSplitInput != null;
+					if (hasNewFixedInputs) {
+						if (partnerAmountInput == null || partnerAmountInput < 0) throw new Error(`Commission rule ${index + 1}: Partner fixed amount must be a non-negative number`);
+						if (customerAmountInput == null || customerAmountInput < 0) throw new Error(`Commission rule ${index + 1}: Customer fixed amount must be a non-negative number`);
+						partnerAmount = partnerAmountInput;
+						customerAmount = customerAmountInput;
+						partnerSplit = toCents(partnerAmountInput);
+						customerSplit = toCents(customerAmountInput);
+					} else if (hasLegacyFixedInputs) {
+						if (legacyPartnerSplitInput == null || legacyPartnerSplitInput < 0) throw new Error(`Commission rule ${index + 1}: For fixed commissions, both partner and customer values must be non-negative numbers`);
+						const legacyHasTotalValue = toNumber(r.totalCommission?.value) != null;
+						const resolvedLegacyCustomerSplit = legacyCustomerSplitInput ?? (legacyHasTotalValue ? 100 - legacyPartnerSplitInput : null);
+						if (resolvedLegacyCustomerSplit == null || resolvedLegacyCustomerSplit < 0) throw new Error(`Commission rule ${index + 1}: For fixed commissions, both partner and customer values must be non-negative numbers`);
+						partnerSplit = legacyPartnerSplitInput;
+						customerSplit = resolvedLegacyCustomerSplit;
+						partnerAmount = null;
+						customerAmount = null;
+					} else throw new Error(`Commission rule ${index + 1}: For fixed commissions, both partner and customer values must be provided`);
+				}
 				const minOrderAmount = toNumber(r.minOrderAmount);
 				if (minOrderAmount != null && minOrderAmount < 0) throw new Error(`Commission rule ${index + 1}: Minimum Order Amount must be a non-negative number`);
 				return {
 					...rule,
 					appliesTo: appliesTo === "categories" ? "segments" : appliesTo,
 					totalCommission: {
-						type: r.totalCommission.type,
-						value: totalValue,
+						type,
+						value: type === "percentage" ? totalValue : null,
 						maxAmount: maxAmount ?? null
 					},
+					partnerPercent,
+					customerPercent,
+					partnerAmount,
+					customerAmount,
 					partnerSplit,
 					customerSplit,
 					minOrderAmount: minOrderAmount ?? null
@@ -456,7 +554,7 @@ const createReferralProgramsCollection = (pluginConfig) => {
 					{
 						name: "products",
 						type: "relationship",
-						relationTo: "products",
+						relationTo: relationSlugs.productsSlug,
 						hasMany: true,
 						admin: {
 							condition: (_, siblingData) => siblingData?.appliesTo === "products",
@@ -466,7 +564,7 @@ const createReferralProgramsCollection = (pluginConfig) => {
 					{
 						name: "categories",
 						type: "relationship",
-						relationTo: "categories",
+						relationTo: relationSlugs.categoriesSlug,
 						hasMany: true,
 						admin: {
 							condition: (_, siblingData) => siblingData?.appliesTo === "segments",
@@ -476,7 +574,7 @@ const createReferralProgramsCollection = (pluginConfig) => {
 					{
 						name: "tags",
 						type: "relationship",
-						relationTo: "tags",
+						relationTo: relationSlugs.tagsSlug,
 						hasMany: true,
 						admin: {
 							condition: (_, siblingData) => siblingData?.appliesTo === "segments",
@@ -486,7 +584,7 @@ const createReferralProgramsCollection = (pluginConfig) => {
 					{
 						name: "totalCommission",
 						type: "group",
-						admin: { description: "Total commission pool to split between partner and customer" },
+						admin: { description: "Total commission pool configuration" },
 						fields: [
 							{
 								name: "type",
@@ -501,11 +599,12 @@ const createReferralProgramsCollection = (pluginConfig) => {
 							{
 								name: "value",
 								type: "number",
+								min: 0,
+								max: 100,
 								admin: {
 									condition: ({ siblingData }) => siblingData?.type === "percentage",
-									description: "Total commission value (shown for percentage rules; ignored when using fixed split amounts)"
-								},
-								min: 0
+									description: "Total commission percentage for this rule (0-100). Partner/Customer percentages split this 100-based bucket."
+								}
 							},
 							{
 								name: "maxAmount",
@@ -516,30 +615,74 @@ const createReferralProgramsCollection = (pluginConfig) => {
 						]
 					},
 					{
-						name: "partnerSplit",
+						name: "partnerPercent",
 						type: "number",
-						required: true,
 						min: 0,
-						admin: { description: "For percentage rules this is the percent that goes to the partner; when using fixed type it becomes the literal amount per item" }
+						max: 100,
+						admin: {
+							condition: ({ siblingData }) => siblingData?.totalCommission?.type === "percentage",
+							description: "Partner share in percent (0-100). Customer share is auto-calculated as 100 - Partner."
+						}
 					},
 					{
-						name: "minOrderAmount",
+						name: "customerPercent",
 						type: "number",
 						min: 0,
-						admin: { description: `Minimum cart subtotal required for this rule in ${defaultCurrency}. Leave empty for no minimum.` }
+						max: 100,
+						admin: {
+							readOnly: true,
+							condition: ({ siblingData }) => siblingData?.totalCommission?.type === "percentage",
+							description: "Auto-calculated customer share percentage."
+						},
+						hooks: { beforeValidate: [({ siblingData }) => {
+							if (!siblingData || siblingData.totalCommission?.type !== "percentage") return null;
+							const partner = toNumber(siblingData.partnerPercent) ?? toNumber(siblingData.partnerSplit) ?? 0;
+							if (partner < 0) return 100;
+							if (partner > 100) return 0;
+							return 100 - partner;
+						}] }
+					},
+					{
+						name: "partnerAmount",
+						type: "number",
+						min: 0,
+						admin: {
+							condition: ({ siblingData }) => siblingData?.totalCommission?.type === "fixed",
+							description: `Fixed partner commission amount per item in ${defaultCurrency}. Stored as cents internally.`
+						}
+					},
+					{
+						name: "customerAmount",
+						type: "number",
+						min: 0,
+						admin: {
+							condition: ({ siblingData }) => siblingData?.totalCommission?.type === "fixed",
+							description: `Fixed customer discount amount per item in ${defaultCurrency}. Stored as cents internally.`
+						}
+					},
+					{
+						name: "partnerSplit",
+						type: "number",
+						min: 0,
+						admin: {
+							hidden: true,
+							description: "Canonical storage field. Percentage mode: percent. Fixed mode: amount in cents."
+						}
 					},
 					{
 						name: "customerSplit",
 						type: "number",
 						min: 0,
 						admin: {
-							condition: ({ siblingData }) => siblingData?.totalCommission?.type !== "fixed",
-							description: "When using percentage rules this is auto-calculated; for fixed-type rules you may enter a literal amount"
-						},
-						hooks: {
-							beforeValidate: [({ siblingData }) => deriveCustomerSplit(siblingData?.partnerSplit, siblingData?.totalCommission?.type)],
-							beforeChange: [({ siblingData }) => deriveCustomerSplit(siblingData?.partnerSplit, siblingData?.totalCommission?.type)]
+							hidden: true,
+							description: "Canonical storage field. Percentage mode: percent. Fixed mode: amount in cents."
 						}
+					},
+					{
+						name: "minOrderAmount",
+						type: "number",
+						min: 0,
+						admin: { description: `Minimum cart subtotal required for this rule in ${defaultCurrency}. Leave empty for no minimum.` }
 					}
 				]
 			}
@@ -547,7 +690,6 @@ const createReferralProgramsCollection = (pluginConfig) => {
 		timestamps: true
 	};
 };
-
 //#endregion
 //#region src/utilities/roundTo2.ts
 /**
@@ -556,12 +698,8 @@ const createReferralProgramsCollection = (pluginConfig) => {
 function roundTo2(value) {
 	return Math.round(value * 100) / 100;
 }
-
-//#endregion
-//#region src/utilities/pricing.ts
-const DEFAULT_PRICE_CURRENCY = "AED";
 function normalizeCurrencyCode(currencyCode) {
-	if (!currencyCode) return DEFAULT_PRICE_CURRENCY;
+	if (!currencyCode) return "AED";
 	return currencyCode.toUpperCase();
 }
 function readNumberField(entity, key) {
@@ -572,7 +710,7 @@ function readNumberField(entity, key) {
 function getPriceFieldKey(currencyCode) {
 	return `priceIn${normalizeCurrencyCode(currencyCode)}`;
 }
-function readMoneyField(entity, currencyCode, defaultCurrencyCode = DEFAULT_PRICE_CURRENCY) {
+function readMoneyField(entity, currencyCode, defaultCurrencyCode = "AED") {
 	if (!entity) return void 0;
 	const primaryField = getPriceFieldKey(currencyCode);
 	const primary = readNumberField(entity, primaryField);
@@ -584,16 +722,15 @@ function readMoneyField(entity, currencyCode, defaultCurrencyCode = DEFAULT_PRIC
 	}
 	return typeof entity.price === "number" ? entity.price : void 0;
 }
-function resolveMoneyField(entity, currencyCode, defaultCurrencyCode = DEFAULT_PRICE_CURRENCY) {
+function resolveMoneyField(entity, currencyCode, defaultCurrencyCode = "AED") {
 	return readMoneyField(entity, currencyCode, defaultCurrencyCode) ?? 0;
 }
-function getCartItemUnitPrice({ item, product, variant, currencyCode, defaultCurrencyCode = DEFAULT_PRICE_CURRENCY }) {
+function getCartItemUnitPrice({ item, product, variant, currencyCode, defaultCurrencyCode = "AED" }) {
 	if (typeof item?.price === "number") return item.price;
 	if (typeof item?.unitPrice === "number") return item.unitPrice;
 	if (variant) return resolveMoneyField(variant, currencyCode, defaultCurrencyCode);
 	return resolveMoneyField(product, currencyCode, defaultCurrencyCode);
 }
-
 //#endregion
 //#region src/utilities/calculateValues.ts
 function calculateCouponDiscount({ coupon, cartTotal }) {
@@ -607,7 +744,7 @@ function calculateCouponDiscount({ coupon, cartTotal }) {
 	}
 	return roundTo2(discount);
 }
-function relationId(value) {
+function relationId$5(value) {
 	if (value == null) return null;
 	if (typeof value === "string" || typeof value === "number") return value;
 	if (typeof value === "object" && (typeof value.id === "string" || typeof value.id === "number")) return value.id;
@@ -616,7 +753,7 @@ function relationId(value) {
 const allowedCommissionTypesSet = (allowed) => new Set((allowed && allowed.length ? allowed : ["fixed", "percentage"]).map((v) => v));
 function normalizeIds(values) {
 	if (!Array.isArray(values)) return [];
-	return values.map(relationId).filter((v) => v != null);
+	return values.map(relationId$5).filter((v) => v != null);
 }
 function getRuleSplits(rule) {
 	const partnerRaw = typeof rule.partnerSplit === "number" ? rule.partnerSplit : typeof rule.referrerSplit === "number" ? rule.referrerSplit : null;
@@ -671,7 +808,7 @@ function calculateItemRewardByRule({ rule, itemTotal, quantity, allowedTotalComm
 }
 function getItemCategoryIds(item) {
 	const productCategories = Array.isArray(item?.product?.categories) ? normalizeIds(item.product.categories) : [];
-	const singleCategory = relationId(item?.category ?? item?.product?.category);
+	const singleCategory = relationId$5(item?.category ?? item?.product?.category);
 	return [...productCategories, ...singleCategory != null ? [singleCategory] : []];
 }
 function getItemTagIds(item) {
@@ -684,7 +821,7 @@ function selectBestRuleForItem({ rules, item, itemTotal, quantity, cartTotal, al
 		if (typeof rule?.minOrderAmount === "number" && Number.isFinite(rule.minOrderAmount)) return cartTotal >= rule.minOrderAmount;
 		return true;
 	});
-	const productId = relationId(item.product);
+	const productId = relationId$5(item.product);
 	const itemCategoryIds = new Set(getItemCategoryIds(item));
 	const itemTagIds = new Set(getItemTagIds(item));
 	const candidates = [
@@ -779,66 +916,118 @@ function calculateCommissionAndDiscount({ cartItems, program, currencyCode = "AE
 		customerDiscount: totalCustomerDiscount
 	};
 }
-
 //#endregion
 //#region src/endpoints/applyCoupon.ts
-const globalDebugLogs = [];
-const getRelationId = (value) => {
+function relationId$4(value) {
 	if (value == null) return null;
 	if (typeof value === "string" || typeof value === "number") return value;
 	if (typeof value === "object" && (typeof value.id === "string" || typeof value.id === "number")) return value.id;
 	return null;
-};
+}
+function readField$3(doc, field) {
+	if (!doc || typeof doc !== "object") return void 0;
+	return doc[field];
+}
+function writeField$1(doc, field, value) {
+	doc[field] = value;
+}
+function normalizeCode$1(value) {
+	return typeof value === "string" ? value.trim().toUpperCase() : "";
+}
+async function findByNormalizedCode$1({ payload, collection, normalizedCode }) {
+	const exactQuery = await payload.find({
+		collection,
+		where: { normalizedCode: { equals: normalizedCode } },
+		limit: 1
+	});
+	if (exactQuery?.docs?.[0]) return exactQuery.docs[0];
+	const lowerQuery = await payload.find({
+		collection,
+		where: { code: { equals: normalizedCode.toLowerCase() } },
+		limit: 1
+	});
+	if (lowerQuery?.docs?.[0]) return lowerQuery.docs[0];
+	const upperQuery = await payload.find({
+		collection,
+		where: { code: { equals: normalizedCode.toUpperCase() } },
+		limit: 1
+	});
+	if (upperQuery?.docs?.[0]) return upperQuery.docs[0];
+	return (await payload.find({
+		collection,
+		where: { code: { equals: normalizedCode } },
+		limit: 1
+	}))?.docs?.[0] ?? null;
+}
 const applyCouponHandler = ({ pluginConfig }) => async (req) => {
-	globalDebugLogs.length = 0;
 	const { payload } = req;
-	const { code: rawCode, cartID, customerEmail } = req.data || {};
-	const code = typeof rawCode === "string" ? rawCode.trim() : rawCode;
-	if (!code || !cartID) return Response.json({
+	const fields = pluginConfig.integration.fields;
+	const collections = pluginConfig.integration.collections;
+	const rawCode = req?.data?.code;
+	const cartID = req?.data?.cartID;
+	const customerEmail = req?.data?.customerEmail;
+	const normalizedCode = normalizeCode$1(rawCode);
+	if (!normalizedCode || !cartID) return Response.json({
 		success: false,
 		error: `${pluginConfig.enableReferrals ? "Referral code" : "Coupon code"} and cart ID are required`
 	}, { status: 400 });
+	const allowCoupon = await Promise.resolve(pluginConfig.policies.canApplyCoupon({
+		req,
+		user: req?.user,
+		payload
+	}));
+	const allowReferral = await Promise.resolve(pluginConfig.policies.canApplyReferral({
+		req,
+		user: req?.user,
+		payload
+	}));
+	if (!allowCoupon && !(pluginConfig.enableReferrals && allowReferral)) return Response.json({
+		success: false,
+		error: "Forbidden"
+	}, { status: 403 });
 	try {
-		const cartQuery = await payload.findByID({
-			collection: "carts",
+		const cart = await payload.findByID({
+			collection: collections.cartsSlug,
 			id: cartID,
 			depth: 2
 		});
-		if (!cartQuery) return Response.json({
+		if (!cart) return Response.json({
 			success: false,
 			error: "Cart not found"
 		}, { status: 404 });
-		if (pluginConfig.referralConfig.singleCodePerCart) {
-			const hasExistingCoupon = cartQuery.appliedCoupon;
-			const hasExistingReferral = cartQuery.appliedReferralCode;
-			if (hasExistingCoupon || hasExistingReferral) return Response.json({
-				success: false,
-				error: "A code has already been applied to this cart. Only one code can be used per order."
-			}, { status: 400 });
-		}
-		if (pluginConfig.enableReferrals) {
+		const cartAppliedCoupon = relationId$4(readField$3(cart, fields.cartAppliedCouponField));
+		const cartAppliedReferral = relationId$4(readField$3(cart, fields.cartAppliedReferralCodeField));
+		if (pluginConfig.referralConfig.singleCodePerCart && (cartAppliedCoupon || cartAppliedReferral)) return Response.json({
+			success: false,
+			error: "A code has already been applied to this cart. Only one code can be used per order."
+		}, { status: 400 });
+		if (pluginConfig.enableReferrals && allowReferral) {
 			const referralResult = await handleReferralCode({
 				payload,
-				code,
+				cart,
 				cartID,
-				cart: cartQuery,
-				customerEmail,
+				normalizedCode,
 				pluginConfig
 			});
-			if (!referralResult.ok && referralResult.status === 404 && pluginConfig.referralConfig.allowBothSystems) return await handleCouponCode({
+			if (!referralResult.ok && referralResult.status === 404 && pluginConfig.referralConfig.allowBothSystems && allowCoupon) return await handleCouponCode({
 				payload,
-				code,
+				cart,
 				cartID,
-				cart: cartQuery,
+				normalizedCode,
 				customerEmail,
 				pluginConfig
 			});
 			return referralResult;
-		} else return await handleCouponCode({
+		}
+		if (!allowCoupon) return Response.json({
+			success: false,
+			error: "Forbidden"
+		}, { status: 403 });
+		return await handleCouponCode({
 			payload,
-			code,
+			cart,
 			cartID,
-			cart: cartQuery,
+			normalizedCode,
 			customerEmail,
 			pluginConfig
 		});
@@ -850,27 +1039,18 @@ const applyCouponHandler = ({ pluginConfig }) => async (req) => {
 		}, { status: 500 });
 	}
 };
-async function handleCouponCode({ payload, code, cartID, cart, customerEmail, pluginConfig }) {
-	let couponQuery = await payload.find({
+async function handleCouponCode({ payload, cart, cartID, normalizedCode, customerEmail, pluginConfig }) {
+	const fields = pluginConfig.integration.fields;
+	const resolvers = pluginConfig.integration.resolvers;
+	const coupon = await findByNormalizedCode$1({
+		payload,
 		collection: pluginConfig.collections.couponsSlug,
-		where: { code: { equals: code } },
-		limit: 1
+		normalizedCode
 	});
-	if (!couponQuery.docs.length) couponQuery = await payload.find({
-		collection: pluginConfig.collections.couponsSlug,
-		where: { code: { equals: code.toLowerCase() } },
-		limit: 1
-	});
-	if (!couponQuery.docs.length) couponQuery = await payload.find({
-		collection: pluginConfig.collections.couponsSlug,
-		where: { code: { equals: code.toUpperCase() } },
-		limit: 1
-	});
-	if (!couponQuery.docs.length) return Response.json({
+	if (!coupon) return Response.json({
 		success: false,
 		error: "Invalid coupon code"
 	}, { status: 404 });
-	const coupon = couponQuery.docs[0];
 	const now = /* @__PURE__ */ new Date();
 	const activeFrom = coupon.activeFrom ? new Date(coupon.activeFrom) : null;
 	const activeUntil = coupon.activeUntil ? new Date(coupon.activeUntil) : null;
@@ -892,13 +1072,12 @@ async function handleCouponCode({ payload, code, cartID, cart, customerEmail, pl
 			success: false,
 			error: "Customer email is required for this coupon."
 		}, { status: 400 });
-		const { ordersSlug, orderCustomerEmailField, orderPaymentStatusField, orderPaidStatusValue } = pluginConfig.orderIntegration;
 		if ((await payload.find({
-			collection: ordersSlug,
+			collection: pluginConfig.orderIntegration.ordersSlug,
 			where: { and: [
-				{ appliedCoupon: { equals: coupon.id } },
-				{ [orderCustomerEmailField]: { equals: email } },
-				{ [orderPaymentStatusField]: { equals: orderPaidStatusValue } }
+				{ [fields.orderAppliedCouponField]: { equals: coupon.id } },
+				{ [pluginConfig.orderIntegration.orderCustomerEmailField]: { equals: email } },
+				{ [pluginConfig.orderIntegration.orderPaymentStatusField]: { equals: pluginConfig.orderIntegration.orderPaidStatusValue } }
 			] },
 			limit: 0
 		})).totalDocs >= coupon.perCustomerLimit) return Response.json({
@@ -906,11 +1085,12 @@ async function handleCouponCode({ payload, code, cartID, cart, customerEmail, pl
 			error: "You have reached the maximum uses for this coupon."
 		}, { status: 400 });
 	}
-	if (getRelationId(cart.appliedCoupon) === coupon.id) return Response.json({
+	if (relationId$4(readField$3(cart, fields.cartAppliedCouponField)) === coupon.id) return Response.json({
 		success: false,
 		error: "Coupon already applied to this cart"
 	}, { status: 400 });
-	const cartTotal = cart.subtotal || cart.total || 0;
+	const cartSubtotal = Number(resolvers.getCartSubtotal(cart)) || 0;
+	const cartTotal = Number(resolvers.getCartTotal(cart)) || cartSubtotal || 0;
 	if (coupon.minOrderValue && cartTotal < coupon.minOrderValue) return Response.json({
 		success: false,
 		error: `Minimum order value of ${coupon.minOrderValue} ${pluginConfig.defaultCurrency} required`
@@ -923,15 +1103,15 @@ async function handleCouponCode({ payload, code, cartID, cart, customerEmail, pl
 		coupon,
 		cartTotal
 	});
-	const total = roundTo2(Math.max(0, cartTotal - discountAmount));
+	const nextTotal = roundTo2(Math.max(0, cartTotal - discountAmount));
+	const data = {};
+	writeField$1(data, fields.cartAppliedCouponField, coupon.id);
+	writeField$1(data, fields.cartDiscountAmountField, discountAmount);
+	writeField$1(data, fields.cartTotalField, nextTotal);
 	await payload.update({
-		collection: "carts",
+		collection: pluginConfig.integration.collections.cartsSlug,
 		id: cartID,
-		data: {
-			appliedCoupon: coupon.id,
-			discountAmount,
-			total
-		}
+		data
 	});
 	return Response.json({
 		success: true,
@@ -942,34 +1122,21 @@ async function handleCouponCode({ payload, code, cartID, cart, customerEmail, pl
 			value: coupon.value
 		},
 		discount: discountAmount,
-		currency: pluginConfig.defaultCurrency,
-		debug: globalDebugLogs
+		currency: pluginConfig.defaultCurrency
 	});
 }
-async function handleReferralCode({ payload, code, cartID, cart, customerEmail: _customerEmail, pluginConfig }) {
-	let referralQuery = await payload.find({
+async function handleReferralCode({ payload, cart, cartID, normalizedCode, pluginConfig }) {
+	const fields = pluginConfig.integration.fields;
+	const resolvers = pluginConfig.integration.resolvers;
+	const referralCode = await findByNormalizedCode$1({
+		payload,
 		collection: pluginConfig.collections.referralCodesSlug,
-		where: { code: { equals: code } },
-		limit: 1,
-		depth: 1
+		normalizedCode
 	});
-	if (!referralQuery.docs.length) referralQuery = await payload.find({
-		collection: pluginConfig.collections.referralCodesSlug,
-		where: { code: { equals: code.toLowerCase() } },
-		limit: 1,
-		depth: 1
-	});
-	if (!referralQuery.docs.length) referralQuery = await payload.find({
-		collection: pluginConfig.collections.referralCodesSlug,
-		where: { code: { equals: code.toUpperCase() } },
-		limit: 1,
-		depth: 1
-	});
-	if (!referralQuery.docs.length) return Response.json({
+	if (!referralCode) return Response.json({
 		success: false,
 		error: "Invalid referral code"
 	}, { status: 404 });
-	const referralCode = referralQuery.docs[0];
 	if (!referralCode.isActive) return Response.json({
 		success: false,
 		error: "Referral code is not active"
@@ -982,7 +1149,7 @@ async function handleReferralCode({ payload, code, cartID, cart, customerEmail:
 		success: false,
 		error: "Referral code usage limit exceeded"
 	}, { status: 400 });
-	const programId = typeof referralCode.program === "string" ? referralCode.program : referralCode.program?.id;
+	const programId = typeof referralCode.program === "string" || typeof referralCode.program === "number" ? referralCode.program : referralCode.program?.id;
 	const program = await payload.findByID({
 		collection: pluginConfig.collections.referralProgramsSlug,
 		id: programId
@@ -991,11 +1158,12 @@ async function handleReferralCode({ payload, code, cartID, cart, customerEmail:
 		success: false,
 		error: "Referral program is not active"
 	}, { status: 400 });
-	if (getRelationId(cart.appliedReferralCode) === referralCode.id) return Response.json({
+	if (relationId$4(readField$3(cart, fields.cartAppliedReferralCodeField)) === referralCode.id) return Response.json({
 		success: false,
 		error: "Referral code already applied to this cart"
 	}, { status: 400 });
-	const cartTotal = cart.subtotal || cart.total || 0;
+	const cartItems = resolvers.getCartItems(cart);
+	const cartTotal = Number(resolvers.getCartTotal(cart)) || Number(resolvers.getCartSubtotal(cart)) || 0;
 	const minOrderAmount = getProgramMinimumOrderAmount({
 		program,
 		allowedTotalCommissionTypes: pluginConfig.referralConfig.allowedTotalCommissionTypes
@@ -1005,7 +1173,7 @@ async function handleReferralCode({ payload, code, cartID, cart, customerEmail:
 		error: `Minimum order value of ${minOrderAmount} ${pluginConfig.defaultCurrency} required for this referral program`
 	}, { status: 400 });
 	const { partnerCommission, customerDiscount } = calculateCommissionAndDiscount({
-		cartItems: cart.items || [],
+		cartItems,
 		program,
 		currencyCode: pluginConfig.defaultCurrency,
 		cartTotal,
@@ -1013,16 +1181,16 @@ async function handleReferralCode({ payload, code, cartID, cart, customerEmail:
 	});
 	const roundedPartnerCommission = roundTo2(partnerCommission);
 	const roundedCustomerDiscount = roundTo2(customerDiscount);
-	const total = roundTo2(Math.max(0, cartTotal - roundedCustomerDiscount));
+	const nextTotal = roundTo2(Math.max(0, cartTotal - roundedCustomerDiscount));
+	const data = {};
+	writeField$1(data, fields.cartAppliedReferralCodeField, referralCode.id);
+	writeField$1(data, fields.cartPartnerCommissionField, roundedPartnerCommission);
+	writeField$1(data, fields.cartCustomerDiscountField, roundedCustomerDiscount);
+	writeField$1(data, fields.cartTotalField, nextTotal);
 	await payload.update({
-		collection: "carts",
+		collection: pluginConfig.integration.collections.cartsSlug,
 		id: cartID,
-		data: {
-			appliedReferralCode: referralCode.id,
-			partnerCommission: roundedPartnerCommission,
-			customerDiscount: roundedCustomerDiscount,
-			total
-		}
+		data
 	});
 	return Response.json({
 		success: true,
@@ -1030,8 +1198,7 @@ async function handleReferralCode({ payload, code, cartID, cart, customerEmail:
 		referralCode: { code: referralCode.code },
 		partnerCommission: roundedPartnerCommission,
 		customerDiscount: roundedCustomerDiscount,
-		currency: pluginConfig.defaultCurrency,
-		debug: globalDebugLogs
+		currency: pluginConfig.defaultCurrency
 	});
 }
 const applyCouponEndpoint = ({ pluginConfig }) => ({
@@ -1039,70 +1206,115 @@ const applyCouponEndpoint = ({ pluginConfig }) => ({
 	method: "post",
 	handler: applyCouponHandler({ pluginConfig })
 });
-
 //#endregion
 //#region src/endpoints/partnerStats.ts
+function relationId$3(value) {
+	if (value == null) return null;
+	if (typeof value === "string" || typeof value === "number") return value;
+	if (typeof value === "object" && (typeof value.id === "string" || typeof value.id === "number")) return value.id;
+	return null;
+}
+function readField$2(doc, field) {
+	if (!doc || typeof doc !== "object") return void 0;
+	return doc[field];
+}
+function asNumber$1(value) {
+	return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
+function asString(value) {
+	return typeof value === "string" ? value : "";
+}
+function toStatsStatus(value) {
+	if (value === "paid") return "paid";
+	if (value === "cancelled") return "cancelled";
+	return "pending";
+}
 const partnerStatsHandler = ({ pluginConfig }) => async (req) => {
 	const { payload, user } = req;
+	const fields = pluginConfig.integration.fields;
+	const collections = pluginConfig.integration.collections;
 	if (!user) return Response.json({
 		success: false,
 		error: "Authentication required"
 	}, { status: 401 });
 	const typedUser = user;
+	const userID = pluginConfig.integration.resolvers.getUserID({
+		req,
+		user
+	});
+	if (userID == null) return Response.json({
+		success: false,
+		error: "Unable to resolve user identity"
+	}, { status: 403 });
 	const isPartner = isPartnerUser({
 		user: typedUser,
 		roleConfig: pluginConfig.roleConfig
-	}) || pluginConfig.access.isPartner?.({ req });
+	}) || await Promise.resolve(pluginConfig.access.isPartner?.({ req }));
 	const isAdmin = isAdminUser({
 		user: typedUser,
 		roleConfig: pluginConfig.roleConfig
-	}) || pluginConfig.access.isAdmin?.({ req });
-	if (!isPartner && !isAdmin) return Response.json({
+	}) || await Promise.resolve(pluginConfig.access.isAdmin?.({ req }));
+	if (!await Promise.resolve(pluginConfig.policies.canViewPartnerStats({
+		req,
+		user,
+		payload,
+		requestedPartnerID: userID
+	})) && !isAdmin && !isPartner) return Response.json({
 		success: false,
 		error: "Partner access required"
 	}, { status: 403 });
 	try {
-		const referralCodes = (await payload.find({
+		const referralCodesQuery = await payload.find({
 			collection: pluginConfig.collections.referralCodesSlug,
-			where: { partner: { equals: typedUser.id } },
+			where: { partner: { equals: userID } },
 			limit: 100
-		})).docs;
+		});
+		const referralCodes = Array.isArray(referralCodesQuery?.docs) ? referralCodesQuery.docs : [];
 		let totalEarnings = 0;
 		let pendingEarnings = 0;
 		let paidEarnings = 0;
 		let totalReferrals = 0;
 		let successfulReferrals = 0;
 		const referralCodeData = referralCodes.map((code) => {
-			totalEarnings += code.totalEarnings || 0;
-			pendingEarnings += code.pendingEarnings || 0;
-			paidEarnings += code.paidEarnings || 0;
-			totalReferrals += code.usageCount || 0;
-			successfulReferrals += code.successfulReferralsCount || 0;
+			totalEarnings += asNumber$1(code?.totalEarnings);
+			pendingEarnings += asNumber$1(code?.pendingEarnings);
+			paidEarnings += asNumber$1(code?.paidEarnings);
+			totalReferrals += asNumber$1(code?.usageCount);
+			successfulReferrals += asNumber$1(code?.successfulReferralsCount);
 			return {
-				id: code.id,
-				code: code.code,
-				usageCount: code.usageCount || 0,
-				totalEarnings: code.totalEarnings || 0,
-				isActive: code.isActive
+				id: String(code?.id ?? ""),
+				code: asString(code?.code),
+				usageCount: asNumber$1(code?.usageCount),
+				totalEarnings: asNumber$1(code?.totalEarnings),
+				isActive: Boolean(code?.isActive)
 			};
 		});
 		const conversionRate = totalReferrals > 0 ? successfulReferrals / totalReferrals * 100 : 0;
 		const recentReferrals = [];
 		try {
-			const ordersQuery = await payload.find({
-				collection: "orders",
-				where: { appliedReferralCode: { in: referralCodes.map((c) => c.id) } },
-				limit: 10,
-				sort: "-createdAt"
-			});
-			for (const order of ordersQuery.docs) recentReferrals.push({
-				id: order.id,
-				code: referralCodes.find((c) => c.id === order.appliedReferralCode)?.code || "",
-				orderValue: order.total || 0,
-				commission: order.partnerCommission || 0,
-				date: order.createdAt,
-				status: order.paymentStatus === "paid" ? "paid" : "pending"
-			});
+			const referralCodeIDs = referralCodes.map((c) => relationId$3(c?.id)).filter((id) => id != null);
+			if (referralCodeIDs.length > 0) {
+				const ordersQuery = await payload.find({
+					collection: collections.ordersSlug,
+					where: { [fields.orderAppliedReferralCodeField]: { in: referralCodeIDs } },
+					limit: 10,
+					sort: `-${fields.orderCreatedAtField}`
+				});
+				for (const order of ordersQuery?.docs || []) {
+					const orderReferralID = relationId$3(readField$2(order, fields.orderAppliedReferralCodeField));
+					const matchedCode = referralCodes.find((c) => relationId$3(c?.id) === orderReferralID);
+					const paymentStatus = readField$2(order, fields.orderPaymentStatusField);
+					const createdAt = readField$2(order, fields.orderCreatedAtField);
+					recentReferrals.push({
+						id: String(order?.id ?? ""),
+						code: asString(matchedCode?.code),
+						orderValue: asNumber$1(readField$2(order, fields.cartTotalField) ?? order?.total),
+						commission: asNumber$1(readField$2(order, fields.orderPartnerCommissionField)),
+						date: asString(createdAt),
+						status: toStatsStatus(paymentStatus)
+					});
+				}
+			}
 		} catch {}
 		const monthlyEarnings = [];
 		const now = /* @__PURE__ */ new Date();
@@ -1120,18 +1332,19 @@ const partnerStatsHandler = ({ pluginConfig }) => async (req) => {
 		let program = null;
 		if (referralCodes.length > 0) {
 			const firstCode = referralCodes[0];
-			if (firstCode.program) try {
+			const programID = relationId$3(firstCode?.program);
+			if (programID != null) try {
 				const programData = await payload.findByID({
 					collection: pluginConfig.collections.referralProgramsSlug,
-					id: typeof firstCode.program === "string" ? firstCode.program : firstCode.program.id
+					id: programID
 				});
 				if (programData) {
 					const typedProgram = programData;
-					const firstRule = typedProgram.commissionRules?.[0];
-					const partnerSplit = firstRule?.partnerSplit ?? firstRule?.referrerSplit ?? firstRule?.split?.partnerPercentage ?? 0;
-					const customerSplit = firstRule?.customerSplit ?? firstRule?.refereeSplit ?? firstRule?.split?.customerPercentage ?? 100 - partnerSplit;
+					const firstRule = typedProgram?.commissionRules?.[0];
+					const partnerSplit = asNumber$1(firstRule?.partnerSplit) || asNumber$1(firstRule?.referrerSplit) || asNumber$1(firstRule?.split?.partnerPercentage);
+					const customerSplit = asNumber$1(firstRule?.customerSplit) || asNumber$1(firstRule?.refereeSplit) || asNumber$1(firstRule?.split?.customerPercentage) || Math.max(0, 100 - partnerSplit);
 					program = {
-						name: typedProgram.name,
+						name: asString(typedProgram?.name),
 						commissionRate: partnerSplit,
 						customerDiscount: customerSplit
 					};
@@ -1170,27 +1383,81 @@ const partnerStatsEndpoint = ({ pluginConfig }) => ({
 	method: "get",
 	handler: partnerStatsHandler({ pluginConfig })
 });
-
 //#endregion
 //#region src/endpoints/validateCoupon.ts
+function relationId$2(value) {
+	if (value == null) return null;
+	if (typeof value === "string" || typeof value === "number") return value;
+	if (typeof value === "object" && (typeof value.id === "string" || typeof value.id === "number")) return value.id;
+	return null;
+}
+function normalizeCode(value) {
+	return typeof value === "string" ? value.trim().toUpperCase() : "";
+}
+async function findByNormalizedCode({ payload, collection, normalizedCode }) {
+	const normalizedQuery = await payload.find({
+		collection,
+		where: { normalizedCode: { equals: normalizedCode } },
+		limit: 1
+	});
+	if (normalizedQuery?.docs?.length) return normalizedQuery.docs[0];
+	const lowerQuery = await payload.find({
+		collection,
+		where: { code: { equals: normalizedCode.toLowerCase() } },
+		limit: 1
+	});
+	if (lowerQuery?.docs?.length) return lowerQuery.docs[0];
+	const upperQuery = await payload.find({
+		collection,
+		where: { code: { equals: normalizedCode.toUpperCase() } },
+		limit: 1
+	});
+	if (upperQuery?.docs?.length) return upperQuery.docs[0];
+	return (await payload.find({
+		collection,
+		where: { code: { equals: normalizedCode } },
+		limit: 1
+	}))?.docs?.[0] ?? null;
+}
 const validateCouponHandler = ({ pluginConfig }) => async (req) => {
 	const { payload } = req;
-	const { code: rawCode, cartValue, cartID, customerEmail } = req.data || {};
-	const code = typeof rawCode === "string" ? rawCode.trim() : rawCode;
-	if (!code) return Response.json({
+	const rawCode = req?.data?.code;
+	const cartValue = req?.data?.cartValue;
+	const cartID = req?.data?.cartID;
+	const customerEmail = req?.data?.customerEmail;
+	const normalizedCode = normalizeCode(rawCode);
+	if (!normalizedCode) return Response.json({
 		success: false,
 		error: "Code is required"
 	}, { status: 400 });
 	try {
-		if (pluginConfig.enableReferrals) return await validateReferralCode({
-			payload,
-			code,
-			cartID,
-			pluginConfig
-		});
-		else return await validateCouponCode$1({
+		if (pluginConfig.enableReferrals) {
+			if (!await Promise.resolve(pluginConfig.policies.canApplyReferral({
+				req,
+				user: req?.user,
+				payload
+			}))) return Response.json({
+				success: false,
+				error: "Forbidden"
+			}, { status: 403 });
+			return await validateReferralCode({
+				payload,
+				normalizedCode,
+				cartID,
+				pluginConfig
+			});
+		}
+		if (!await Promise.resolve(pluginConfig.policies.canApplyCoupon({
+			req,
+			user: req?.user,
+			payload
+		}))) return Response.json({
+			success: false,
+			error: "Forbidden"
+		}, { status: 403 });
+		return await validateCouponCode$1({
 			payload,
-			code,
+			normalizedCode,
 			cartValue,
 			customerEmail,
 			pluginConfig
@@ -1203,27 +1470,17 @@ const validateCouponHandler = ({ pluginConfig }) => async (req) => {
 		}, { status: 500 });
 	}
 };
-async function validateCouponCode$1({ payload, code, cartValue, customerEmail, pluginConfig }) {
-	let coupon = await payload.find({
+async function validateCouponCode$1({ payload, normalizedCode, cartValue, customerEmail, pluginConfig }) {
+	const fields = pluginConfig.integration.fields;
+	const couponData = await findByNormalizedCode({
+		payload,
 		collection: pluginConfig.collections.couponsSlug,
-		where: { code: { equals: code } },
-		limit: 1
+		normalizedCode
 	});
-	if (!coupon.docs.length) coupon = await payload.find({
-		collection: pluginConfig.collections.couponsSlug,
-		where: { code: { equals: code.toLowerCase() } },
-		limit: 1
-	});
-	if (!coupon.docs.length) coupon = await payload.find({
-		collection: pluginConfig.collections.couponsSlug,
-		where: { code: { equals: code.toUpperCase() } },
-		limit: 1
-	});
-	if (!coupon.docs.length) return Response.json({
+	if (!couponData) return Response.json({
 		success: false,
 		error: "Invalid coupon code"
 	}, { status: 404 });
-	const couponData = coupon.docs[0];
 	const now = /* @__PURE__ */ new Date();
 	const activeFrom = couponData.activeFrom ? new Date(couponData.activeFrom) : null;
 	const activeUntil = couponData.activeUntil ? new Date(couponData.activeUntil) : null;
@@ -1241,13 +1498,12 @@ async function validateCouponCode$1({ payload, code, cartValue, customerEmail, p
 	}, { status: 400 });
 	if (couponData.perCustomerLimit != null && couponData.perCustomerLimit > 0 && typeof customerEmail === "string" && customerEmail.trim().length > 0) {
 		const email = customerEmail.trim();
-		const { ordersSlug, orderCustomerEmailField, orderPaymentStatusField, orderPaidStatusValue } = pluginConfig.orderIntegration;
 		if ((await payload.find({
-			collection: ordersSlug,
+			collection: pluginConfig.orderIntegration.ordersSlug,
 			where: { and: [
-				{ appliedCoupon: { equals: couponData.id } },
-				{ [orderCustomerEmailField]: { equals: email } },
-				{ [orderPaymentStatusField]: { equals: orderPaidStatusValue } }
+				{ [fields.orderAppliedCouponField]: { equals: couponData.id } },
+				{ [pluginConfig.orderIntegration.orderCustomerEmailField]: { equals: email } },
+				{ [pluginConfig.orderIntegration.orderPaymentStatusField]: { equals: pluginConfig.orderIntegration.orderPaidStatusValue } }
 			] },
 			limit: 0
 		})).totalDocs >= couponData.perCustomerLimit) return Response.json({
@@ -1289,27 +1545,18 @@ async function validateCouponCode$1({ payload, code, cartValue, customerEmail, p
 		currency: pluginConfig.defaultCurrency
 	});
 }
-async function validateReferralCode({ payload, code, cartID, pluginConfig }) {
-	let referral = await payload.find({
+async function validateReferralCode({ payload, normalizedCode, cartID, pluginConfig }) {
+	const collections = pluginConfig.integration.collections;
+	const resolvers = pluginConfig.integration.resolvers;
+	const referralData = await findByNormalizedCode({
+		payload,
 		collection: pluginConfig.collections.referralCodesSlug,
-		where: { code: { equals: code } },
-		limit: 1
+		normalizedCode
 	});
-	if (!referral.docs.length) referral = await payload.find({
-		collection: pluginConfig.collections.referralCodesSlug,
-		where: { code: { equals: code.toLowerCase() } },
-		limit: 1
-	});
-	if (!referral.docs.length) referral = await payload.find({
-		collection: pluginConfig.collections.referralCodesSlug,
-		where: { code: { equals: code.toUpperCase() } },
-		limit: 1
-	});
-	if (!referral.docs.length) return Response.json({
+	if (!referralData) return Response.json({
 		success: false,
 		error: "Referral code not found"
 	}, { status: 404 });
-	const referralData = referral.docs[0];
 	if (!referralData.isActive) return Response.json({
 		success: false,
 		error: "Referral code is not active"
@@ -1322,7 +1569,11 @@ async function validateReferralCode({ payload, code, cartID, pluginConfig }) {
 		success: false,
 		error: "Referral code usage limit exceeded"
 	}, { status: 400 });
-	const programId = typeof referralData.program === "string" ? referralData.program : referralData.program?.id;
+	const programId = relationId$2(referralData.program);
+	if (programId == null) return Response.json({
+		success: false,
+		error: "Referral program not found"
+	}, { status: 404 });
 	const program = await payload.findByID({
 		collection: pluginConfig.collections.referralProgramsSlug,
 		id: programId
@@ -1332,11 +1583,11 @@ async function validateReferralCode({ payload, code, cartID, pluginConfig }) {
 		error: "Referral program is not active"
 	}, { status: 400 });
 	const cart = cartID ? await payload.findByID({
-		collection: "carts",
+		collection: collections.cartsSlug,
 		id: cartID,
 		depth: 2
 	}) : null;
-	const cartTotal = cart ? cart.subtotal || cart.total || 0 : 0;
+	const cartTotal = cart ? Number(resolvers.getCartTotal(cart)) || Number(resolvers.getCartSubtotal(cart)) || 0 : 0;
 	const minOrderAmount = getProgramMinimumOrderAmount({
 		program,
 		allowedTotalCommissionTypes: pluginConfig.referralConfig.allowedTotalCommissionTypes
@@ -1346,7 +1597,7 @@ async function validateReferralCode({ payload, code, cartID, pluginConfig }) {
 		error: `Minimum order value of ${minOrderAmount} ${pluginConfig.defaultCurrency} required for this referral program`
 	}, { status: 400 });
 	const { partnerCommission, customerDiscount } = calculateCommissionAndDiscount({
-		cartItems: cart?.items || [],
+		cartItems: cart ? resolvers.getCartItems(cart) : [],
 		program,
 		currencyCode: pluginConfig.defaultCurrency,
 		cartTotal,
@@ -1371,152 +1622,428 @@ const validateCouponEndpoint = ({ pluginConfig }) => ({
 	method: "post",
 	handler: validateCouponHandler({ pluginConfig })
 });
-
 //#endregion
 //#region src/hooks/recalculateCart.ts
+function relationId$1(value) {
+	if (value == null) return null;
+	if (typeof value === "string" || typeof value === "number") return value;
+	if (typeof value === "object" && (typeof value.id === "string" || typeof value.id === "number")) return value.id;
+	return null;
+}
+function readField$1(doc, field) {
+	if (!doc || typeof doc !== "object") return void 0;
+	return doc[field];
+}
+function writeField(doc, field, value) {
+	doc[field] = value;
+}
+function clearCouponFields(target, fields) {
+	writeField(target, fields.cartAppliedCouponField, null);
+	writeField(target, fields.cartDiscountAmountField, 0);
+}
+function clearReferralFields(target, fields) {
+	writeField(target, fields.cartAppliedReferralCodeField, null);
+	writeField(target, fields.cartPartnerCommissionField, 0);
+	writeField(target, fields.cartCustomerDiscountField, 0);
+}
 const recalculateCartHook = (pluginConfig) => async ({ data, req, originalDoc }) => {
 	if (!req.payload) return data;
-	const effectiveItems = data.items || originalDoc?.items || [];
-	if (!effectiveItems.length) return {
-		...data,
-		partnerCommission: 0,
-		customerDiscount: 0,
-		discountAmount: 0,
-		total: 0
+	const integration = pluginConfig.integration || {};
+	const collections = integration.collections || {
+		cartsSlug: "carts",
+		ordersSlug: "orders",
+		productsSlug: "products",
+		usersSlug: "users",
+		categoriesSlug: "categories",
+		tagsSlug: "tags"
 	};
-	const appliedReferralCode = data.appliedReferralCode !== void 0 ? data.appliedReferralCode : originalDoc?.appliedReferralCode;
-	const appliedCoupon = data.appliedCoupon !== void 0 ? data.appliedCoupon : originalDoc?.appliedCoupon;
-	if (!appliedReferralCode && !appliedCoupon) {
-		if (data.appliedReferralCode === null || data.appliedCoupon === null) {
-			const fallbackSubtotal = typeof data.subtotal === "number" ? data.subtotal : typeof originalDoc?.subtotal === "number" ? originalDoc.subtotal : void 0;
-			return {
-				...data,
-				partnerCommission: 0,
-				customerDiscount: 0,
-				discountAmount: 0,
-				total: fallbackSubtotal
+	const fields = integration.fields || {
+		cartItemsField: "items",
+		cartSubtotalField: "subtotal",
+		cartTotalField: "total",
+		cartAppliedCouponField: "appliedCoupon",
+		cartAppliedReferralCodeField: "appliedReferralCode",
+		cartDiscountAmountField: "discountAmount",
+		cartCustomerDiscountField: "customerDiscount",
+		cartPartnerCommissionField: "partnerCommission",
+		orderAppliedCouponField: "appliedCoupon",
+		orderAppliedReferralCodeField: "appliedReferralCode",
+		orderDiscountAmountField: "discountAmount",
+		orderCustomerDiscountField: "customerDiscount",
+		orderPartnerCommissionField: "partnerCommission",
+		orderCustomerEmailField: "customerEmail",
+		orderPaymentStatusField: "paymentStatus",
+		orderCreatedAtField: "createdAt",
+		productPriceField: "price",
+		productCurrencyCodeField: "currencyCode"
+	};
+	const resolvers = integration.resolvers || {
+		getUserID: ({ user }) => {
+			if (!user || typeof user !== "object") return null;
+			const id = user.id;
+			if (typeof id === "string" || typeof id === "number") return id;
+			return null;
+		},
+		getCartItems: (cart) => {
+			if (!cart || typeof cart !== "object") return [];
+			const value = cart[fields.cartItemsField];
+			return Array.isArray(value) ? value : [];
+		},
+		getCartSubtotal: (cart) => {
+			if (!cart || typeof cart !== "object") return 0;
+			const value = cart[fields.cartSubtotalField];
+			return typeof value === "number" ? value : 0;
+		},
+		getCartTotal: (cart) => {
+			if (!cart || typeof cart !== "object") return 0;
+			const value = cart[fields.cartTotalField];
+			return typeof value === "number" ? value : 0;
+		},
+		isOrderPaid: (_order) => false,
+		getProductUnitPrice: ({ item, product, variant, currencyCode }) => {
+			if (item && typeof item === "object") {
+				const itemPrice = item.price;
+				if (typeof itemPrice === "number") return itemPrice;
+				const unitPrice = item.unitPrice;
+				if (typeof unitPrice === "number") return unitPrice;
+			}
+			const readPrice = (entity, code) => {
+				if (!entity || typeof entity !== "object") return void 0;
+				const map = entity;
+				if (code && typeof code === "string") {
+					const value = map[`priceIn${code.toUpperCase()}`];
+					if (typeof value === "number") return value;
+				}
+				const base = map.price;
+				return typeof base === "number" ? base : void 0;
 			};
+			return readPrice(variant, currencyCode) ?? readPrice(product, currencyCode) ?? 0;
 		}
-		return data;
-	}
-	const getRelationID = (value) => {
-		if (value === null || value === void 0) return void 0;
-		if (typeof value === "object") return value.id;
-		if (typeof value === "string" || typeof value === "number") return value;
 	};
-	const productIds = effectiveItems.map((item) => getRelationID(item.product)).filter((id) => id !== void 0);
-	if (!productIds.length) return data;
-	const productsQuery = await req.payload.find({
-		collection: "products",
-		where: { id: { in: productIds } },
-		limit: productIds.length
-	});
-	const productsMap = new Map(productsQuery.docs.map((p) => [String(p.id), p]));
+	const mutableData = data || {};
+	const original = originalDoc || {};
+	const effectiveItems = readField$1(mutableData, fields.cartItemsField) ?? readField$1(original, fields.cartItemsField) ?? [];
+	const effectiveAppliedReferral = readField$1(mutableData, fields.cartAppliedReferralCodeField) !== void 0 ? readField$1(mutableData, fields.cartAppliedReferralCodeField) : readField$1(original, fields.cartAppliedReferralCodeField);
+	const effectiveAppliedCoupon = readField$1(mutableData, fields.cartAppliedCouponField) !== void 0 ? readField$1(mutableData, fields.cartAppliedCouponField) : readField$1(original, fields.cartAppliedCouponField);
+	if (!Array.isArray(effectiveItems) || effectiveItems.length === 0) {
+		clearReferralFields(mutableData, fields);
+		clearCouponFields(mutableData, fields);
+		writeField(mutableData, fields.cartTotalField, 0);
+		return mutableData;
+	}
+	const getRelationID = (value) => relationId$1(value);
+	const productIds = effectiveItems.map((item) => getRelationID(item?.product)).filter((id) => id != null);
+	let productsMap = /* @__PURE__ */ new Map();
+	if (productIds.length > 0) {
+		const productsQuery = await req.payload.find({
+			collection: collections.productsSlug,
+			where: { id: { in: productIds } },
+			limit: productIds.length
+		});
+		productsMap = new Map((productsQuery?.docs || []).map((p) => [String(p.id), p]));
+	}
 	let calculatedSubtotal = 0;
 	const enrichedItems = effectiveItems.map((item) => {
-		const productId = getRelationID(item.product);
-		const product = productId !== void 0 ? productsMap.get(String(productId)) || {} : {};
-		const itemPrice = getCartItemUnitPrice({
+		const pid = getRelationID(item?.product);
+		const product = pid != null ? productsMap.get(String(pid)) || {} : {};
+		const variant = typeof item?.variant === "object" ? item.variant : void 0;
+		const unitPrice = Number(resolvers.getProductUnitPrice({
 			item,
 			product,
-			variant: typeof item.variant === "object" ? item.variant : void 0,
+			variant,
 			currencyCode: pluginConfig.defaultCurrency
-		});
-		calculatedSubtotal += itemPrice * (item.quantity ?? 1);
+		}));
+		const quantity = typeof item?.quantity === "number" && Number.isFinite(item.quantity) ? item.quantity : 1;
+		const safeUnitPrice = Number.isFinite(unitPrice) ? unitPrice : 0;
+		calculatedSubtotal += safeUnitPrice * quantity;
 		return {
 			...item,
 			product,
-			price: itemPrice
+			price: safeUnitPrice,
+			quantity
 		};
 	});
-	if (appliedReferralCode && pluginConfig.enableReferrals) {
-		const appliedReferralCodeID = getRelationID(appliedReferralCode);
-		if (appliedReferralCodeID === void 0) {
-			data.partnerCommission = 0;
-			data.customerDiscount = 0;
-			data.total = calculatedSubtotal;
-			return data;
-		}
-		const referralQuery = await req.payload.find({
+	writeField(mutableData, fields.cartSubtotalField, roundTo2(calculatedSubtotal));
+	let customerDiscount = 0;
+	let couponDiscount = 0;
+	const appliedReferralID = relationId$1(effectiveAppliedReferral);
+	if (pluginConfig.enableReferrals && appliedReferralID != null) {
+		const referralCode = (await req.payload.find({
 			collection: pluginConfig.collections.referralCodesSlug,
-			where: { id: { equals: appliedReferralCodeID } },
+			where: { id: { equals: appliedReferralID } },
 			limit: 1,
 			depth: 1
-		});
-		if (referralQuery.docs.length) {
-			const referralCode = referralQuery.docs[0];
-			const programId = typeof referralCode.program === "string" ? referralCode.program : referralCode.program?.id;
-			const program = typeof referralCode.program === "object" ? referralCode.program : programId ? await req.payload.findByID({
+		}))?.docs?.[0];
+		if (!referralCode || referralCode.isActive === false) clearReferralFields(mutableData, fields);
+		else {
+			const programId = relationId$1(referralCode.program);
+			const program = typeof referralCode.program === "object" ? referralCode.program : programId != null ? await req.payload.findByID({
 				collection: pluginConfig.collections.referralProgramsSlug,
 				id: programId
 			}) : null;
-			if (program) {
+			if (!program || program.isActive === false) clearReferralFields(mutableData, fields);
+			else {
 				const minOrderAmount = getProgramMinimumOrderAmount({
 					program,
 					allowedTotalCommissionTypes: pluginConfig.referralConfig.allowedTotalCommissionTypes
 				});
-				if (typeof minOrderAmount === "number" && calculatedSubtotal < minOrderAmount) {
-					data.appliedReferralCode = null;
-					data.partnerCommission = 0;
-					data.customerDiscount = 0;
-					data.total = calculatedSubtotal;
-					return data;
+				if (typeof minOrderAmount === "number" && calculatedSubtotal < minOrderAmount) clearReferralFields(mutableData, fields);
+				else {
+					const result = calculateCommissionAndDiscount({
+						cartItems: enrichedItems,
+						program,
+						currencyCode: pluginConfig.defaultCurrency,
+						cartTotal: calculatedSubtotal,
+						allowedTotalCommissionTypes: pluginConfig.referralConfig.allowedTotalCommissionTypes
+					});
+					const roundedPartnerCommission = roundTo2(result.partnerCommission);
+					const roundedCustomerDiscount = roundTo2(Math.max(0, result.customerDiscount));
+					writeField(mutableData, fields.cartPartnerCommissionField, roundedPartnerCommission);
+					writeField(mutableData, fields.cartCustomerDiscountField, roundedCustomerDiscount);
+					customerDiscount = roundedCustomerDiscount;
 				}
-				const { partnerCommission, customerDiscount } = calculateCommissionAndDiscount({
-					cartItems: enrichedItems,
-					program,
-					currencyCode: pluginConfig.defaultCurrency,
-					cartTotal: calculatedSubtotal,
-					allowedTotalCommissionTypes: pluginConfig.referralConfig.allowedTotalCommissionTypes
-				});
-				const roundedCustomerDiscount = roundTo2(customerDiscount);
-				data.partnerCommission = roundTo2(partnerCommission);
-				data.customerDiscount = roundedCustomerDiscount;
-				data.total = Math.max(0, calculatedSubtotal - roundedCustomerDiscount);
-			} else {
-				data.appliedReferralCode = null;
-				data.partnerCommission = 0;
-				data.customerDiscount = 0;
-				data.total = calculatedSubtotal;
 			}
 		}
-	}
-	if (appliedCoupon && (!appliedReferralCode || pluginConfig.referralConfig.allowBothSystems)) {
-		const appliedCouponID = getRelationID(appliedCoupon);
-		if (appliedCouponID === void 0) return data;
-		const couponQuery = await req.payload.find({
+	} else if (readField$1(mutableData, fields.cartAppliedReferralCodeField) === null) clearReferralFields(mutableData, fields);
+	const appliedCouponID = relationId$1(effectiveAppliedCoupon);
+	const canUseCouponWithReferral = !pluginConfig.enableReferrals || pluginConfig.referralConfig.allowBothSystems || relationId$1(readField$1(mutableData, fields.cartAppliedReferralCodeField)) == null;
+	if (appliedCouponID != null && canUseCouponWithReferral) {
+		const coupon = (await req.payload.find({
 			collection: pluginConfig.collections.couponsSlug,
 			where: { id: { equals: appliedCouponID } },
 			limit: 1
+		}))?.docs?.[0];
+		if (!coupon) clearCouponFields(mutableData, fields);
+		else {
+			const now = /* @__PURE__ */ new Date();
+			const activeFrom = coupon.activeFrom ? new Date(coupon.activeFrom) : null;
+			const activeUntil = coupon.activeUntil ? new Date(coupon.activeUntil) : null;
+			const isValidDate = (!activeFrom || now >= activeFrom) && (!activeUntil || now <= activeUntil);
+			const underUsage = !coupon.usageLimit || Number(coupon.usageCount || 0) < Number(coupon.usageLimit || 0);
+			if (!isValidDate || !underUsage) clearCouponFields(mutableData, fields);
+			else {
+				couponDiscount = roundTo2(calculateCouponDiscount({
+					coupon,
+					cartTotal: calculatedSubtotal
+				}));
+				writeField(mutableData, fields.cartDiscountAmountField, couponDiscount);
+			}
+		}
+	} else if (readField$1(mutableData, fields.cartAppliedCouponField) === null) {
+		clearCouponFields(mutableData, fields);
+		writeField(mutableData, fields.cartCustomerDiscountField, 0);
+		writeField(mutableData, fields.cartPartnerCommissionField, 0);
+		writeField(mutableData, fields.cartTotalField, roundTo2(Number(resolvers.getCartSubtotal(mutableData)) || calculatedSubtotal));
+		return mutableData;
+	}
+	const nextTotal = roundTo2(Math.max(0, calculatedSubtotal - customerDiscount - couponDiscount));
+	writeField(mutableData, fields.cartTotalField, nextTotal);
+	return mutableData;
+};
+//#endregion
+//#region src/utilities/recordCouponUsageForOrder.ts
+const USAGE_MARKER_FIELD = "couponUsageRecordedAt";
+function relationId(value) {
+	if (value == null) return null;
+	if (typeof value === "string" || typeof value === "number") return value;
+	if (typeof value === "object" && (typeof value.id === "string" || typeof value.id === "number")) return value.id;
+	return null;
+}
+function asNumber(value) {
+	return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
+function readField(doc, field) {
+	if (!doc || typeof doc !== "object") return void 0;
+	return doc[field];
+}
+async function markOrderUsageRecorded({ payload, pluginConfig, orderID }) {
+	const ordersSlug = pluginConfig.integration.collections.ordersSlug;
+	const latestOrder = await payload.findByID({
+		collection: ordersSlug,
+		id: orderID,
+		depth: 0
+	});
+	if (!latestOrder) return false;
+	if (Boolean(readField(latestOrder, USAGE_MARKER_FIELD))) return false;
+	await payload.update({
+		collection: ordersSlug,
+		id: orderID,
+		data: { [USAGE_MARKER_FIELD]: (/* @__PURE__ */ new Date()).toISOString() }
+	});
+	return true;
+}
+/**
+* Record coupon and referral usage when an order is placed successfully.
+* This function is idempotent and integration-field aware.
+*
+* Behavior:
+* - Uses configured order field names from `pluginConfig.integration.fields`
+* - Uses configured paid-order resolver (`integration.resolvers.isOrderPaid`)
+* - Marks the order with `couponUsageRecordedAt` before mutating counters to avoid duplicate counting
+* - If marker already exists, returns `alreadyRecorded: true` and performs no increments
+*/
+async function recordCouponUsageForOrder(payload, order, pluginConfig) {
+	const result = {
+		recordedCoupon: false,
+		recordedReferral: false,
+		alreadyRecorded: false
+	};
+	const orderID = order.id;
+	if (orderID == null) return result;
+	if (!await Promise.resolve(pluginConfig.integration.resolvers.isOrderPaid(order))) return result;
+	if (!await Promise.resolve(pluginConfig.policies.canRecordOrderUsage({
+		req: {},
+		user: void 0,
+		payload,
+		order
+	}))) return result;
+	if (!await markOrderUsageRecorded({
+		payload,
+		pluginConfig,
+		orderID
+	})) {
+		result.alreadyRecorded = true;
+		return result;
+	}
+	const fields = pluginConfig.integration.fields;
+	const couponField = fields.orderAppliedCouponField;
+	const referralField = fields.orderAppliedReferralCodeField;
+	const partnerCommissionField = fields.orderPartnerCommissionField;
+	const couponId = relationId(readField(order, couponField));
+	const referralCodeId = relationId(readField(order, referralField));
+	const commission = asNumber(readField(order, partnerCommissionField));
+	if (couponId) {
+		const coupon = await payload.findByID({
+			collection: pluginConfig.collections.couponsSlug,
+			id: couponId,
+			depth: 0
+		});
+		if (coupon) {
+			const currentUsage = asNumber(coupon.usageCount);
+			await payload.update({
+				collection: pluginConfig.collections.couponsSlug,
+				id: couponId,
+				data: { usageCount: currentUsage + 1 }
+			});
+			result.recordedCoupon = true;
+		}
+	}
+	if (referralCodeId) {
+		const referralCode = await payload.findByID({
+			collection: pluginConfig.collections.referralCodesSlug,
+			id: referralCodeId,
+			depth: 0
 		});
-		if (couponQuery.docs.length) {
-			const coupon = couponQuery.docs[0];
-			const discountAmount = calculateCouponDiscount({
-				coupon,
-				cartTotal: calculatedSubtotal
+		if (referralCode) {
+			const rc = referralCode;
+			const currentTotal = asNumber(rc.totalEarnings);
+			const currentPending = asNumber(rc.pendingEarnings);
+			const currentUsage = asNumber(rc.usageCount);
+			const currentSuccessful = asNumber(rc.successfulReferralsCount);
+			await payload.update({
+				collection: pluginConfig.collections.referralCodesSlug,
+				id: referralCodeId,
+				data: {
+					usageCount: currentUsage + 1,
+					successfulReferralsCount: currentSuccessful + 1,
+					totalEarnings: currentTotal + commission,
+					pendingEarnings: currentPending + commission
+				}
 			});
-			data.discountAmount = discountAmount;
-			const currentDiscount = data.customerDiscount || 0;
-			data.total = Math.max(0, calculatedSubtotal - currentDiscount - discountAmount);
+			result.recordedReferral = true;
 		}
 	}
-	return data;
-};
-
+	return result;
+}
 //#endregion
 //#region src/utilities/sanitizePluginConfig.ts
+const toCleanStringArray = (value) => Array.isArray(value) ? value.filter((item) => typeof item === "string").map((item) => item.trim()).filter(Boolean) : [];
+const toBoolean = (value, fallback) => {
+	if (typeof value === "boolean") return value;
+	if (typeof value === "number") {
+		if (value === 1) return true;
+		if (value === 0) return false;
+	}
+	if (typeof value === "string") {
+		const normalized = value.trim().toLowerCase();
+		if (normalized === "true" || normalized === "1" || normalized === "yes" || normalized === "on") return true;
+		if (normalized === "false" || normalized === "0" || normalized === "no" || normalized === "off") return false;
+	}
+	return fallback;
+};
 const sanitizePluginConfig = ({ pluginConfig }) => {
 	const roleConfig = {
-		roleFieldPaths: Array.isArray(pluginConfig?.roleConfig?.roleFieldPaths) && pluginConfig.roleConfig.roleFieldPaths.length > 0 ? pluginConfig.roleConfig.roleFieldPaths.filter((value) => typeof value === "string").map((value) => value.trim()).filter(Boolean) : ["role", "roles"],
-		adminRoleValues: Array.isArray(pluginConfig?.roleConfig?.adminRoleValues) && pluginConfig.roleConfig.adminRoleValues.length > 0 ? pluginConfig.roleConfig.adminRoleValues.filter((value) => typeof value === "string").map((value) => value.trim()).filter(Boolean) : ["admin"],
-		partnerRoleValues: Array.isArray(pluginConfig?.roleConfig?.partnerRoleValues) && pluginConfig.roleConfig.partnerRoleValues.length > 0 ? pluginConfig.roleConfig.partnerRoleValues.filter((value) => typeof value === "string").map((value) => value.trim()).filter(Boolean) : ["partner"],
+		roleFieldPaths: toCleanStringArray(pluginConfig?.roleConfig?.roleFieldPaths).length > 0 ? toCleanStringArray(pluginConfig?.roleConfig?.roleFieldPaths) : ["role", "roles"],
+		adminRoleValues: toCleanStringArray(pluginConfig?.roleConfig?.adminRoleValues).length > 0 ? toCleanStringArray(pluginConfig?.roleConfig?.adminRoleValues) : ["admin"],
+		partnerRoleValues: toCleanStringArray(pluginConfig?.roleConfig?.partnerRoleValues).length > 0 ? toCleanStringArray(pluginConfig?.roleConfig?.partnerRoleValues) : ["partner"],
 		customRoleResolver: typeof pluginConfig?.roleConfig?.customRoleResolver === "function" ? pluginConfig.roleConfig.customRoleResolver : void 0
 	};
 	const normalizedAllowedTotalCommissionTypes = Array.isArray(pluginConfig?.referralConfig?.allowedTotalCommissionTypes) ? [...new Set(pluginConfig.referralConfig.allowedTotalCommissionTypes.filter((value) => value === "fixed" || value === "percentage"))] : [];
+	const integrationCollections = {
+		cartsSlug: typeof pluginConfig?.integration?.collections?.cartsSlug === "string" && pluginConfig.integration.collections.cartsSlug.trim().length > 0 ? pluginConfig.integration.collections.cartsSlug.trim() : "carts",
+		ordersSlug: typeof pluginConfig?.integration?.collections?.ordersSlug === "string" && pluginConfig.integration.collections.ordersSlug.trim().length > 0 ? pluginConfig.integration.collections.ordersSlug.trim() : "orders",
+		productsSlug: typeof pluginConfig?.integration?.collections?.productsSlug === "string" && pluginConfig.integration.collections.productsSlug.trim().length > 0 ? pluginConfig.integration.collections.productsSlug.trim() : "products",
+		usersSlug: typeof pluginConfig?.integration?.collections?.usersSlug === "string" && pluginConfig.integration.collections.usersSlug.trim().length > 0 ? pluginConfig.integration.collections.usersSlug.trim() : "users",
+		categoriesSlug: typeof pluginConfig?.integration?.collections?.categoriesSlug === "string" && pluginConfig.integration.collections.categoriesSlug.trim().length > 0 ? pluginConfig.integration.collections.categoriesSlug.trim() : "categories",
+		tagsSlug: typeof pluginConfig?.integration?.collections?.tagsSlug === "string" && pluginConfig.integration.collections.tagsSlug.trim().length > 0 ? pluginConfig.integration.collections.tagsSlug.trim() : "tags"
+	};
+	const integrationFields = {
+		cartItemsField: pluginConfig?.integration?.fields?.cartItemsField?.trim() || "items",
+		cartSubtotalField: pluginConfig?.integration?.fields?.cartSubtotalField?.trim() || "subtotal",
+		cartTotalField: pluginConfig?.integration?.fields?.cartTotalField?.trim() || "total",
+		cartAppliedCouponField: pluginConfig?.integration?.fields?.cartAppliedCouponField?.trim() || "appliedCoupon",
+		cartAppliedReferralCodeField: pluginConfig?.integration?.fields?.cartAppliedReferralCodeField?.trim() || "appliedReferralCode",
+		cartDiscountAmountField: pluginConfig?.integration?.fields?.cartDiscountAmountField?.trim() || "discountAmount",
+		cartCustomerDiscountField: pluginConfig?.integration?.fields?.cartCustomerDiscountField?.trim() || "customerDiscount",
+		cartPartnerCommissionField: pluginConfig?.integration?.fields?.cartPartnerCommissionField?.trim() || "partnerCommission",
+		orderAppliedCouponField: pluginConfig?.integration?.fields?.orderAppliedCouponField?.trim() || "appliedCoupon",
+		orderAppliedReferralCodeField: pluginConfig?.integration?.fields?.orderAppliedReferralCodeField?.trim() || "appliedReferralCode",
+		orderDiscountAmountField: pluginConfig?.integration?.fields?.orderDiscountAmountField?.trim() || "discountAmount",
+		orderCustomerDiscountField: pluginConfig?.integration?.fields?.orderCustomerDiscountField?.trim() || "customerDiscount",
+		orderPartnerCommissionField: pluginConfig?.integration?.fields?.orderPartnerCommissionField?.trim() || "partnerCommission",
+		orderCustomerEmailField: pluginConfig?.integration?.fields?.orderCustomerEmailField?.trim() || pluginConfig?.orderIntegration?.orderCustomerEmailField?.trim() || "customerEmail",
+		orderPaymentStatusField: pluginConfig?.integration?.fields?.orderPaymentStatusField?.trim() || pluginConfig?.orderIntegration?.orderPaymentStatusField?.trim() || "paymentStatus",
+		orderCreatedAtField: pluginConfig?.integration?.fields?.orderCreatedAtField?.trim() || "createdAt",
+		productPriceField: pluginConfig?.integration?.fields?.productPriceField?.trim() || "price",
+		productCurrencyCodeField: pluginConfig?.integration?.fields?.productCurrencyCodeField?.trim() || "currencyCode"
+	};
+	const integrationResolvers = {
+		getUserID: pluginConfig?.integration?.resolvers?.getUserID || (({ user }) => {
+			if (!user || typeof user !== "object") return null;
+			const id = user.id;
+			if (typeof id === "string" || typeof id === "number") return id;
+			return null;
+		}),
+		getCartItems: pluginConfig?.integration?.resolvers?.getCartItems || ((cart) => {
+			if (!cart || typeof cart !== "object") return [];
+			const value = cart[integrationFields.cartItemsField];
+			return Array.isArray(value) ? value : [];
+		}),
+		getCartSubtotal: pluginConfig?.integration?.resolvers?.getCartSubtotal || ((cart) => {
+			if (!cart || typeof cart !== "object") return 0;
+			const value = cart[integrationFields.cartSubtotalField];
+			return typeof value === "number" ? value : 0;
+		}),
+		getCartTotal: pluginConfig?.integration?.resolvers?.getCartTotal || ((cart) => {
+			if (!cart || typeof cart !== "object") return 0;
+			const value = cart[integrationFields.cartTotalField];
+			return typeof value === "number" ? value : 0;
+		}),
+		isOrderPaid: pluginConfig?.integration?.resolvers?.isOrderPaid || ((order) => {
+			if (!order || typeof order !== "object") return false;
+			return order[integrationFields.orderPaymentStatusField] === (pluginConfig?.orderIntegration?.orderPaidStatusValue ?? "paid");
+		}),
+		getProductUnitPrice: pluginConfig?.integration?.resolvers?.getProductUnitPrice || ((args) => getCartItemUnitPrice({
+			item: args.item ?? null,
+			product: args.product ?? null,
+			variant: args.variant ?? null,
+			currencyCode: args.currencyCode || "USD"
+		}))
+	};
 	return {
-		enabled: !(pluginConfig?.enabled === false || typeof pluginConfig?.enabled === "string" && pluginConfig.enabled === "false"),
-		enableReferrals: !!pluginConfig?.enableReferrals && (typeof pluginConfig?.enableReferrals !== "string" || pluginConfig.enableReferrals !== "false"),
-		allowStackWithOtherCoupons: !!pluginConfig?.allowStackWithOtherCoupons && (typeof pluginConfig?.allowStackWithOtherCoupons !== "string" || pluginConfig.allowStackWithOtherCoupons !== "false"),
+		enabled: toBoolean(pluginConfig?.enabled, true),
+		enableReferrals: toBoolean(pluginConfig?.enableReferrals, false),
+		allowStackWithOtherCoupons: toBoolean(pluginConfig?.allowStackWithOtherCoupons, false),
 		defaultCurrency: typeof pluginConfig?.defaultCurrency === "string" && pluginConfig.defaultCurrency.length > 0 && pluginConfig.defaultCurrency.length <= 3 ? pluginConfig.defaultCurrency : "USD",
 		collections: {
 			couponsSlug: typeof pluginConfig?.collections?.couponsSlug === "string" && pluginConfig.collections.couponsSlug.trim().length > 0 && pluginConfig.collections.couponsSlug.length <= 100 ? pluginConfig.collections.couponsSlug : "coupons",
@@ -1525,10 +2052,10 @@ const sanitizePluginConfig = ({ pluginConfig }) => {
 			referralPartnersSlug: typeof pluginConfig?.collections?.referralPartnersSlug === "string" && pluginConfig.collections.referralPartnersSlug.trim().length > 0 && pluginConfig.collections.referralPartnersSlug.length <= 100 ? pluginConfig.collections.referralPartnersSlug : "referral-partners"
 		},
 		endpoints: {
-			applyCoupon: typeof pluginConfig?.endpoints?.applyCoupon === "string" && pluginConfig.endpoints.applyCoupon.trim().length > 0 ? pluginConfig.endpoints.applyCoupon : "/coupons/apply",
-			validateCoupon: typeof pluginConfig?.endpoints?.validateCoupon === "string" && pluginConfig.endpoints.validateCoupon.trim().length > 0 ? pluginConfig.endpoints.validateCoupon : "/coupons/validate",
-			partnerStats: typeof pluginConfig?.endpoints?.partnerStats === "string" && pluginConfig.endpoints.partnerStats.trim().length > 0 ? pluginConfig.endpoints.partnerStats : "/referrals/partner-stats",
-			recordOrderUsage: typeof pluginConfig?.endpoints?.recordOrderUsage === "string" && pluginConfig.endpoints.recordOrderUsage.trim().length > 0 ? pluginConfig.endpoints.recordOrderUsage : "/coupons/record-order-usage"
+			applyCoupon: typeof pluginConfig?.endpoints?.applyCoupon === "string" && pluginConfig.endpoints.applyCoupon.trim().length > 0 ? pluginConfig.endpoints.applyCoupon.trim() : "/coupons/apply",
+			validateCoupon: typeof pluginConfig?.endpoints?.validateCoupon === "string" && pluginConfig.endpoints.validateCoupon.trim().length > 0 ? pluginConfig.endpoints.validateCoupon.trim() : "/coupons/validate",
+			partnerStats: typeof pluginConfig?.endpoints?.partnerStats === "string" && pluginConfig.endpoints.partnerStats.trim().length > 0 ? pluginConfig.endpoints.partnerStats.trim() : "/referrals/partner-stats",
+			recordOrderUsage: typeof pluginConfig?.endpoints?.recordOrderUsage === "string" && pluginConfig.endpoints.recordOrderUsage.trim().length > 0 ? pluginConfig.endpoints.recordOrderUsage.trim() : "/coupons/record-order-usage"
 		},
 		autoIntegrate: pluginConfig?.autoIntegrate !== false,
 		access: {
@@ -1543,6 +2070,23 @@ const sanitizePluginConfig = ({ pluginConfig }) => {
 				roleConfig
 			})
 		},
+		policies: {
+			canApplyCoupon: typeof pluginConfig?.policies?.canApplyCoupon === "function" ? pluginConfig.policies.canApplyCoupon : () => true,
+			canApplyReferral: typeof pluginConfig?.policies?.canApplyReferral === "function" ? pluginConfig.policies.canApplyReferral : () => true,
+			canViewPartnerStats: typeof pluginConfig?.policies?.canViewPartnerStats === "function" ? pluginConfig.policies.canViewPartnerStats : ({ req }) => isPartnerUser({
+				user: req?.user,
+				roleConfig
+			}) || isAdminUser({
+				user: req?.user,
+				roleConfig
+			}),
+			canRecordOrderUsage: typeof pluginConfig?.policies?.canRecordOrderUsage === "function" ? pluginConfig.policies.canRecordOrderUsage : () => true
+		},
+		integration: {
+			collections: integrationCollections,
+			fields: integrationFields,
+			resolvers: integrationResolvers
+		},
 		referralConfig: {
 			allowBothSystems: pluginConfig?.referralConfig?.allowBothSystems ?? false,
 			singleCodePerCart: pluginConfig?.referralConfig?.singleCodePerCart ?? true,
@@ -1562,17 +2106,84 @@ const sanitizePluginConfig = ({ pluginConfig }) => {
 			showCommissionBreakdown: pluginConfig?.partnerDashboard?.showCommissionBreakdown ?? true
 		},
 		orderIntegration: {
-			ordersSlug: typeof pluginConfig?.orderIntegration?.ordersSlug === "string" && pluginConfig.orderIntegration.ordersSlug.trim().length > 0 ? pluginConfig.orderIntegration.ordersSlug : "orders",
-			orderCustomerEmailField: typeof pluginConfig?.orderIntegration?.orderCustomerEmailField === "string" && pluginConfig.orderIntegration.orderCustomerEmailField.trim().length > 0 ? pluginConfig.orderIntegration.orderCustomerEmailField : "customerEmail",
-			orderPaymentStatusField: typeof pluginConfig?.orderIntegration?.orderPaymentStatusField === "string" && pluginConfig.orderIntegration.orderPaymentStatusField.trim().length > 0 ? pluginConfig.orderIntegration.orderPaymentStatusField : "paymentStatus",
+			ordersSlug: typeof pluginConfig?.orderIntegration?.ordersSlug === "string" && pluginConfig.orderIntegration.ordersSlug.trim().length > 0 ? pluginConfig.orderIntegration.ordersSlug : integrationCollections.ordersSlug,
+			orderCustomerEmailField: integrationFields.orderCustomerEmailField,
+			orderPaymentStatusField: integrationFields.orderPaymentStatusField,
 			orderPaidStatusValue: typeof pluginConfig?.orderIntegration?.orderPaidStatusValue === "string" ? pluginConfig.orderIntegration.orderPaidStatusValue : "paid"
 		},
 		roleConfig
 	};
 };
-
 //#endregion
 //#region src/plugin.ts
+const RECALCULATE_HOOK_KEY = "__payloadEcommerceCouponRecalculateHook__";
+const asArray = (value) => Array.isArray(value) ? value : [];
+const hasNamedField = (collection, fieldName) => asArray(collection.fields).some((f) => f?.name === fieldName);
+const addFieldsToCollection = (config, targetSlug, newFields) => {
+	const collections = asArray(config.collections);
+	const idx = collections.findIndex((c) => c.slug === targetSlug);
+	if (idx === -1) return;
+	const collection = collections[idx];
+	collection.fields = asArray(collection.fields);
+	for (const field of newFields) {
+		const name = typeof field.name === "string" ? field.name : "";
+		if (!name) continue;
+		if (!hasNamedField(collection, name)) collection.fields.push(field);
+	}
+	collections[idx] = collection;
+	config.collections = collections;
+};
+const markHook = (fn) => {
+	fn[RECALCULATE_HOOK_KEY] = true;
+	return fn;
+};
+const hasMarkedHook = (hook) => Boolean(hook && typeof hook === "function" && hook[RECALCULATE_HOOK_KEY]);
+const createRecordOrderUsageEndpoint = ({ pluginConfig }) => ({
+	path: pluginConfig.endpoints.recordOrderUsage,
+	method: "post",
+	handler: async (req) => {
+		try {
+			const payload = req?.payload;
+			const orderId = req?.data?.orderId ?? req?.json?.orderId;
+			if (!payload) return Response.json({
+				success: false,
+				error: "Payload instance is required"
+			}, { status: 500 });
+			if (!orderId) return Response.json({
+				success: false,
+				error: "orderId is required"
+			}, { status: 400 });
+			if (!await Promise.resolve(pluginConfig.policies.canRecordOrderUsage({
+				req,
+				user: req?.user,
+				payload,
+				order: { id: orderId }
+			}))) return Response.json({
+				success: false,
+				error: "Forbidden"
+			}, { status: 403 });
+			const order = await payload.findByID({
+				collection: pluginConfig.integration.collections.ordersSlug,
+				id: orderId
+			});
+			if (!order) return Response.json({
+				success: false,
+				error: "Order not found"
+			}, { status: 404 });
+			const result = await recordCouponUsageForOrder(payload, order, pluginConfig);
+			return Response.json({
+				success: true,
+				result
+			});
+		} catch (error) {
+			console.error("record-order-usage endpoint error:", error);
+			return Response.json({
+				success: false,
+				error: "Internal server error"
+			}, { status: 500 });
+		}
+	}
+});
 const payloadEcommerceCouponPlugin = (pluginOptions = {}) => async (incomingConfig) => {
 	const pluginConfig = sanitizePluginConfig({ pluginConfig: pluginOptions });
 	if (!pluginConfig.enabled) return incomingConfig || {};
@@ -1580,7 +2191,8 @@ const payloadEcommerceCouponPlugin = (pluginOptions = {}) => async (incomingConf
 		collections: [],
 		endpoints: []
 	};
-	if (!incomingConfig.collections) incomingConfig.collections = [];
+	incomingConfig.collections = asArray(incomingConfig.collections);
+	incomingConfig.endpoints = asArray(incomingConfig.endpoints);
 	const collectionsToAdd = [];
 	if (pluginConfig.enableReferrals) {
 		let referralProgramsCollection = createReferralProgramsCollection(pluginConfig);
@@ -1598,64 +2210,59 @@ const payloadEcommerceCouponPlugin = (pluginOptions = {}) => async (incomingConf
 		if (pluginOptions.collections?.couponsCollectionOverride) couponsCollection = await pluginOptions.collections.couponsCollectionOverride({ defaultCollection: couponsCollection });
 		collectionsToAdd.push(couponsCollection);
 	}
-	const existingSlugs = new Set(incomingConfig.collections.map((c) => c.slug));
-	const collectionsToAddFiltered = collectionsToAdd.filter((c) => !existingSlugs.has(c.slug));
-	incomingConfig.collections = [...incomingConfig.collections, ...collectionsToAddFiltered];
-	if (!incomingConfig.endpoints) incomingConfig.endpoints = [];
-	incomingConfig.endpoints = [
-		...incomingConfig.endpoints,
-		validateCouponEndpoint({ pluginConfig }),
-		applyCouponEndpoint({ pluginConfig })
-	];
-	if (pluginConfig.enableReferrals) incomingConfig.endpoints.push(partnerStatsEndpoint({ pluginConfig }));
+	const existingSlugs = new Set(asArray(incomingConfig.collections).map((c) => c.slug));
+	const toAppend = collectionsToAdd.filter((c) => !existingSlugs.has(c.slug));
+	incomingConfig.collections = [...asArray(incomingConfig.collections), ...toAppend];
+	const endpointPaths = new Set(asArray(incomingConfig.endpoints).map((e) => `${e?.method || "get"}:${e?.path || ""}`));
+	const maybePushEndpoint = (endpoint) => {
+		const key = `${endpoint?.method || "get"}:${endpoint?.path || ""}`;
+		if (!endpointPaths.has(key)) {
+			endpointPaths.add(key);
+			incomingConfig.endpoints.push(endpoint);
+		}
+	};
+	maybePushEndpoint(validateCouponEndpoint({ pluginConfig }));
+	maybePushEndpoint(applyCouponEndpoint({ pluginConfig }));
+	if (pluginOptions.endpoints?.recordOrderUsage) maybePushEndpoint(createRecordOrderUsageEndpoint({ pluginConfig }));
+	if (pluginConfig.enableReferrals) maybePushEndpoint(partnerStatsEndpoint({ pluginConfig }));
 	if (pluginConfig.autoIntegrate) {
-		incomingConfig.collections = incomingConfig.collections || [];
-		const allSlugs = new Set(incomingConfig.collections.map((c) => c.slug));
-		const addFieldsToCollection = (targetSlug, newFields) => {
-			const idx = incomingConfig.collections.findIndex((c) => c.slug === targetSlug);
-			if (idx === -1) return;
-			const collection = incomingConfig.collections[idx];
-			collection.fields = collection.fields || [];
-			const existingFieldNames = new Set(collection.fields.map((f) => f.name));
-			for (const f of newFields) if (!existingFieldNames.has(f.name)) collection.fields.push(f);
-			incomingConfig.collections[idx] = collection;
-		};
+		const allSlugs = new Set(asArray(incomingConfig.collections).map((c) => c.slug));
+		const cartsSlug = pluginConfig.integration.collections.cartsSlug;
+		const ordersSlug = pluginConfig.integration.collections.ordersSlug;
+		const { cartAppliedReferralCodeField, cartPartnerCommissionField, cartCustomerDiscountField, cartAppliedCouponField, cartDiscountAmountField, orderAppliedReferralCodeField, orderPartnerCommissionField, orderCustomerDiscountField, orderAppliedCouponField, orderDiscountAmountField } = pluginConfig.integration.fields;
 		if (pluginConfig.enableReferrals && allSlugs.has(pluginConfig.collections.referralCodesSlug)) {
 			const cartReferralFields = [
 				{
-					name: "appliedReferralCode",
+					name: cartAppliedReferralCodeField,
 					type: "relationship",
 					relationTo: pluginConfig.collections.referralCodesSlug,
 					admin: { description: "Referral code applied to this cart" }
 				},
 				{
-					name: "partnerCommission",
+					name: cartPartnerCommissionField,
 					type: "number",
 					admin: { description: "Partner commission amount for this cart" }
 				},
 				{
-					name: "customerDiscount",
+					name: cartCustomerDiscountField,
 					type: "number",
 					admin: { description: "Customer discount amount for this cart" }
 				}
 			];
-			if (pluginConfig.referralConfig.allowBothSystems && allSlugs.has(pluginConfig.collections.couponsSlug)) {
-				cartReferralFields.push({
-					name: "appliedCoupon",
-					type: "relationship",
-					relationTo: pluginConfig.collections.couponsSlug,
-					admin: { description: "Coupon applied to this cart" }
-				});
-				cartReferralFields.push({
-					name: "discountAmount",
-					type: "number",
-					admin: { description: "Discount amount from coupon" }
-				});
-			}
-			addFieldsToCollection("carts", cartReferralFields);
+			if (pluginConfig.referralConfig.allowBothSystems && allSlugs.has(pluginConfig.collections.couponsSlug)) cartReferralFields.push({
+				name: cartAppliedCouponField,
+				type: "relationship",
+				relationTo: pluginConfig.collections.couponsSlug,
+				admin: { description: "Coupon applied to this cart" }
+			}, {
+				name: cartDiscountAmountField,
+				type: "number",
+				admin: { description: "Discount amount from coupon" }
+			});
+			addFieldsToCollection(incomingConfig, cartsSlug, cartReferralFields);
 			const orderReferralFields = [
 				{
-					name: "appliedReferralCode",
+					name: orderAppliedReferralCodeField,
 					type: "relationship",
 					relationTo: pluginConfig.collections.referralCodesSlug,
 					admin: {
@@ -1664,7 +2271,7 @@ const payloadEcommerceCouponPlugin = (pluginOptions = {}) => async (incomingConf
 					}
 				},
 				{
-					name: "partnerCommission",
+					name: orderPartnerCommissionField,
 					type: "number",
 					admin: {
 						description: "Partner commission amount for this order",
@@ -1672,7 +2279,7 @@ const payloadEcommerceCouponPlugin = (pluginOptions = {}) => async (incomingConf
 					}
 				},
 				{
-					name: "customerDiscount",
+					name: orderCustomerDiscountField,
 					type: "number",
 					admin: {
 						description: "Customer discount amount for this order",
@@ -1680,39 +2287,36 @@ const payloadEcommerceCouponPlugin = (pluginOptions = {}) => async (incomingConf
 					}
 				}
 			];
-			if (pluginConfig.referralConfig.allowBothSystems && allSlugs.has(pluginConfig.collections.couponsSlug)) {
-				orderReferralFields.push({
-					name: "appliedCoupon",
-					type: "relationship",
-					relationTo: pluginConfig.collections.couponsSlug,
-					admin: {
-						description: "Coupon applied to this order",
-						readOnly: true
-					}
-				});
-				orderReferralFields.push({
-					name: "discountAmount",
-					type: "number",
-					admin: {
-						description: "Discount amount from coupon",
-						readOnly: true
-					}
-				});
-			}
-			addFieldsToCollection("orders", orderReferralFields);
+			if (pluginConfig.referralConfig.allowBothSystems && allSlugs.has(pluginConfig.collections.couponsSlug)) orderReferralFields.push({
+				name: orderAppliedCouponField,
+				type: "relationship",
+				relationTo: pluginConfig.collections.couponsSlug,
+				admin: {
+					description: "Coupon applied to this order",
+					readOnly: true
+				}
+			}, {
+				name: orderDiscountAmountField,
+				type: "number",
+				admin: {
+					description: "Discount amount from coupon",
+					readOnly: true
+				}
+			});
+			addFieldsToCollection(incomingConfig, ordersSlug, orderReferralFields);
 		} else if (!pluginConfig.enableReferrals && allSlugs.has(pluginConfig.collections.couponsSlug)) {
-			addFieldsToCollection("carts", [{
-				name: "appliedCoupon",
+			const cartCouponFields = [{
+				name: cartAppliedCouponField,
 				type: "relationship",
 				relationTo: pluginConfig.collections.couponsSlug,
 				admin: { description: "Coupon applied to this cart" }
 			}, {
-				name: "discountAmount",
+				name: cartDiscountAmountField,
 				type: "number",
 				admin: { description: "Discount amount from coupon" }
-			}]);
-			addFieldsToCollection("orders", [{
-				name: "appliedCoupon",
+			}];
+			const orderCouponFields = [{
+				name: orderAppliedCouponField,
 				type: "relationship",
 				relationTo: pluginConfig.collections.couponsSlug,
 				admin: {
@@ -1720,43 +2324,75 @@ const payloadEcommerceCouponPlugin = (pluginOptions = {}) => async (incomingConf
 					readOnly: true
 				}
 			}, {
-				name: "discountAmount",
+				name: orderDiscountAmountField,
 				type: "number",
 				admin: {
 					description: "Discount amount from coupon",
 					readOnly: true
 				}
-			}]);
+			}];
+			addFieldsToCollection(incomingConfig, cartsSlug, cartCouponFields);
+			addFieldsToCollection(incomingConfig, ordersSlug, orderCouponFields);
 		}
 	}
-	const cartIndex = incomingConfig.collections.findIndex((c) => c.slug === "carts");
+	const cartsSlug = pluginConfig.integration.collections.cartsSlug;
+	const cartIndex = asArray(incomingConfig.collections).findIndex((c) => c.slug === cartsSlug);
 	if (cartIndex > -1) {
 		const collection = incomingConfig.collections[cartIndex];
-		collection.hooks = {
-			...collection.hooks,
-			beforeChange: [...collection.hooks?.beforeChange || [], recalculateCartHook(pluginConfig)]
-		};
+		const beforeChangeHooks = asArray(collection.hooks?.beforeChange);
+		if (!beforeChangeHooks.some((h) => hasMarkedHook(h))) {
+			const hook = markHook(recalculateCartHook(pluginConfig));
+			collection.hooks = {
+				...collection.hooks || {},
+				beforeChange: [...beforeChangeHooks, hook]
+			};
+		}
 		incomingConfig.collections[cartIndex] = collection;
 	}
 	return incomingConfig;
 };
-
 //#endregion
 //#region src/client/hooks.ts
+const DEFAULT_ENDPOINTS = {
+	applyCoupon: "/api/coupons/apply",
+	validateCoupon: "/api/coupons/validate",
+	partnerStats: "/api/referrals/partner-stats"
+};
+function normalizePath(path) {
+	if (!path) return "";
+	return path.startsWith("/") ? path : `/${path}`;
+}
+function withBaseURL(path, baseURL) {
+	if (!baseURL) return path;
+	return `${baseURL.endsWith("/") ? baseURL.slice(0, -1) : baseURL}${normalizePath(path)}`;
+}
+function resolveEndpoints(input) {
+	if (typeof input === "string") return {
+		...DEFAULT_ENDPOINTS,
+		partnerStats: input
+	};
+	const baseURL = input?.baseURL;
+	return {
+		applyCoupon: withBaseURL(input?.applyCoupon || DEFAULT_ENDPOINTS.applyCoupon, baseURL),
+		validateCoupon: withBaseURL(input?.validateCoupon || DEFAULT_ENDPOINTS.validateCoupon, baseURL),
+		partnerStats: withBaseURL(input?.partnerStats || DEFAULT_ENDPOINTS.partnerStats, baseURL)
+	};
+}
 /**
-* Apply a coupon code to a cart
-* @param options - Coupon code, cart ID, and customer email
-* @returns Response with success status, discount amount, and coupon details
+* Apply a coupon/referral code to a cart
+* @param options - Code, cart ID, and optional customerEmail
+* @param endpointConfig - Optional endpoint override config
 */
-async function useCouponCode(options) {
+async function useCouponCode(options, endpointConfig) {
 	const { code, cartID, customerEmail } = options;
 	if (!code) return {
 		success: false,
 		message: "Coupon code is required",
 		error: "Code is missing"
 	};
+	const endpoints = resolveEndpoints(endpointConfig);
 	try {
-		const response = await fetch("/api/coupons/apply", {
+		const response = await fetch(endpoints.applyCoupon, {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify({
@@ -1774,8 +2410,8 @@ async function useCouponCode(options) {
 		const couponData = data.coupon;
 		const referralData = data.referralCode;
 		return {
-			success: data.success,
-			message: data.message,
+			success: Boolean(data.success),
+			message: data.message || "Code applied",
 			discount: data.discount || data.customerDiscount,
 			partnerCommission: data.partnerCommission,
 			customerDiscount: data.customerDiscount,
@@ -1796,25 +2432,29 @@ async function useCouponCode(options) {
 	}
 }
 /**
-* Validate a coupon code without applying it
-* @param code - Coupon code to validate
-* @param cartValue - Optional cart value in smallest currency unit
-* @returns Response with validation result and coupon details
+* Validate a coupon/referral code without applying it
+* @param code - Code to validate
+* @param cartValue - Optional cart value
+* @param cartID - Optional cart ID
+* @param customerEmail - Optional customer email (for per-customer limits)
+* @param endpointConfig - Optional endpoint override config
 */
-async function validateCouponCode(code, cartValue, cartID) {
+async function validateCouponCode(code, cartValue, cartID, customerEmail, endpointConfig) {
 	if (!code) return {
 		success: false,
 		message: "Code required",
 		error: "Code missing"
 	};
+	const endpoints = resolveEndpoints(endpointConfig);
 	try {
-		const response = await fetch("/api/coupons/validate", {
+		const response = await fetch(endpoints.validateCoupon, {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify({
 				code,
 				cartValue,
-				cartID
+				cartID,
+				customerEmail
 			})
 		});
 		const data = await response.json();
@@ -1826,8 +2466,8 @@ async function validateCouponCode(code, cartValue, cartID) {
 		const couponData = data.coupon;
 		const referralData = data.referralCode;
 		return {
-			success: data.success,
-			message: data.message,
+			success: Boolean(data.success),
+			message: data.message || "Code is valid",
 			coupon: couponData ? {
 				code: couponData.code || "",
 				type: couponData.type || "percentage",
@@ -1850,12 +2490,12 @@ async function validateCouponCode(code, cartValue, cartID) {
 }
 /**
 * Fetch partner dashboard statistics
-* @param apiEndpoint - Optional custom API endpoint (default: /api/referrals/partner-stats)
-* @returns Response with partner stats, referral codes, and program info
+* @param endpointConfig - Optional endpoint override config
 */
-async function usePartnerStats(apiEndpoint = "/api/referrals/partner-stats") {
+async function usePartnerStats(endpointConfig) {
+	const endpoints = resolveEndpoints(endpointConfig);
 	try {
-		const response = await fetch(apiEndpoint, {
+		const response = await fetch(endpoints.partnerStats, {
 			method: "GET",
 			headers: { "Content-Type": "application/json" },
 			credentials: "include"
@@ -1866,7 +2506,7 @@ async function usePartnerStats(apiEndpoint = "/api/referrals/partner-stats") {
 			error: data.error || "Failed to fetch partner stats"
 		};
 		return {
-			success: data.success,
+			success: Boolean(data.success),
 			data: data.data,
 			currency: data.currency
 		};
@@ -1877,7 +2517,6 @@ async function usePartnerStats(apiEndpoint = "/api/referrals/partner-stats") {
 		};
 	}
 }
-
 //#endregion
 //#region src/utilities/getCartTotalWithDiscounts.ts
 /**
@@ -1893,66 +2532,6 @@ function getCartTotalWithDiscounts(cart) {
 	const customerDiscount = cart.customerDiscount ?? 0;
 	return roundTo2(Math.max(0, subtotal - discountAmount - customerDiscount));
 }
-
-//#endregion
-//#region src/utilities/recordCouponUsageForOrder.ts
-/**
-* Record coupon and referral usage when an order is placed successfully.
-* Call this once when the order is created/paid (e.g. from Orders collection afterChange hook).
-*
-* - Coupon: increments the coupon's usageCount.
-* - Referral: increments the referral code's usageCount and successfulReferralsCount,
-*   and adds order.partnerCommission to totalEarnings and pendingEarnings (partner gets commission;
-*   referee discount is already on the order).
-*/
-async function recordCouponUsageForOrder(payload, order, pluginConfig) {
-	const result = {
-		recordedCoupon: false,
-		recordedReferral: false
-	};
-	const couponId = order.appliedCoupon == null ? null : typeof order.appliedCoupon === "string" ? order.appliedCoupon : order.appliedCoupon?.id;
-	const referralCodeId = order.appliedReferralCode == null ? null : typeof order.appliedReferralCode === "string" ? order.appliedReferralCode : order.appliedReferralCode?.id;
-	if (couponId) {
-		const coupon = await payload.findByID({
-			collection: pluginConfig.collections.couponsSlug,
-			id: couponId
-		});
-		if (coupon) {
-			await payload.update({
-				collection: pluginConfig.collections.couponsSlug,
-				id: couponId,
-				data: { usageCount: (coupon.usageCount ?? 0) + 1 }
-			});
-			result.recordedCoupon = true;
-		}
-	}
-	if (referralCodeId) {
-		const referralCode = await payload.findByID({
-			collection: pluginConfig.collections.referralCodesSlug,
-			id: referralCodeId
-		});
-		if (referralCode) {
-			const commission = Number(order.partnerCommission) || 0;
-			const currentTotal = Number(referralCode.totalEarnings) || 0;
-			const currentPending = Number(referralCode.pendingEarnings) || 0;
-			const currentUsageCount = Number(referralCode.usageCount) || 0;
-			const currentSuccessful = Number(referralCode.successfulReferralsCount) || 0;
-			await payload.update({
-				collection: pluginConfig.collections.referralCodesSlug,
-				id: referralCodeId,
-				data: {
-					usageCount: currentUsageCount + 1,
-					successfulReferralsCount: currentSuccessful + 1,
-					totalEarnings: currentTotal + commission,
-					pendingEarnings: currentPending + commission
-				}
-			});
-			result.recordedReferral = true;
-		}
-	}
-	return result;
-}
-
 //#endregion
 exports.calculateCommissionAndDiscount = calculateCommissionAndDiscount;
 exports.createCouponsCollection = createCouponsCollection;
@@ -1965,4 +2544,5 @@ exports.recordCouponUsageForOrder = recordCouponUsageForOrder;
 exports.useCouponCode = useCouponCode;
 exports.usePartnerStats = usePartnerStats;
 exports.validateCouponCode = validateCouponCode;
+
 //# sourceMappingURL=index.js.map