@wtree/payload-ecommerce-coupon 3.77.2 → 3.77.4

package/dist/index.mjs

@@ -118,10 +118,59 @@ const createCouponsCollection = (pluginConfig) => {
 	};
 };
 
+//#endregion
+//#region src/utilities/userRoles.ts
+function readByPath(input, path) {
+	if (!input || typeof input !== "object" || !path) return void 0;
+	return path.split(".").reduce((acc, key) => {
+		if (!acc || typeof acc !== "object") return void 0;
+		return acc[key];
+	}, input);
+}
+function toRoleArray(value) {
+	if (typeof value === "string" && value.trim().length > 0) return [value];
+	if (Array.isArray(value)) return value.filter((item) => typeof item === "string").map((item) => item.trim()).filter(Boolean);
+	return [];
+}
+const normalizeRoleValue = (value) => value.trim().toLowerCase();
+const resolveUserRoles = ({ user, roleConfig }) => {
+	if (!user) return [];
+	if (typeof roleConfig.customRoleResolver === "function") {
+		const custom = roleConfig.customRoleResolver(user);
+		return Array.isArray(custom) ? custom.map(normalizeRoleValue).filter(Boolean) : [];
+	}
+	const roles = roleConfig.roleFieldPaths.flatMap((path) => toRoleArray(readByPath(user, path)));
+	return [...new Set(roles.map(normalizeRoleValue).filter(Boolean))];
+};
+const userHasAnyRole = ({ user, roleConfig, targetRoles }) => {
+	const userRoles = new Set(resolveUserRoles({
+		user,
+		roleConfig
+	}));
+	for (const target of targetRoles) if (userRoles.has(normalizeRoleValue(target))) return true;
+	return false;
+};
+const isPartnerUser = ({ user, roleConfig }) => userHasAnyRole({
+	user,
+	roleConfig,
+	targetRoles: roleConfig.partnerRoleValues
+});
+const isAdminUser = ({ user, roleConfig }) => userHasAnyRole({
+	user,
+	roleConfig,
+	targetRoles: roleConfig.adminRoleValues
+});
+const buildPartnerUserFilterWhere = ({ roleConfig }) => {
+	if (!roleConfig.roleFieldPaths.length || !roleConfig.partnerRoleValues.length) return true;
+	const conditions = roleConfig.roleFieldPaths.map((fieldPath) => ({ [fieldPath]: { in: roleConfig.partnerRoleValues } }));
+	if (conditions.length === 1) return conditions[0];
+	return { or: conditions };
+};
+
 //#endregion
 //#region src/collections/createReferralCodesCollection.ts
 const createReferralCodesCollection = (pluginConfig) => {
-	const { collections, access, adminGroups, defaultCurrency } = pluginConfig;
+	const { collections, access, adminGroups, defaultCurrency, roleConfig } = pluginConfig;
 	return {
 		slug: collections.referralCodesSlug,
 		admin: {
@@ -139,15 +188,27 @@ const createReferralCodesCollection = (pluginConfig) => {
 			read: ({ req }) => {
 				const user = req?.user;
 				if (!user) return false;
-				if (user.role === "admin" || Array.isArray(user.role) && user.role.includes("admin") || Array.isArray(user.roles) && user.roles.includes("admin")) return true;
-				if (user.role === "partner" || Array.isArray(user.role) && user.role.includes("partner") || Array.isArray(user.roles) && user.roles.includes("partner")) return { partner: { equals: user.id } };
+				if (isAdminUser({
+					user,
+					roleConfig
+				}) || access.isAdmin?.({ req })) return true;
+				if (isPartnerUser({
+					user,
+					roleConfig
+				}) || access.isPartner?.({ req })) return { partner: { equals: user.id } };
 				return access.canUseReferrals ? access.canUseReferrals({ req }) : false;
 			},
 			create: ({ req }) => {
 				const user = req?.user;
 				if (!user) return false;
-				if (user.role === "admin" || Array.isArray(user.role) && user.role.includes("admin") || Array.isArray(user.roles) && user.roles.includes("admin")) return true;
-				if (user.role === "partner" || Array.isArray(user.role) && user.role.includes("partner") || Array.isArray(user.roles) && user.roles.includes("partner")) return true;
+				if (isAdminUser({
+					user,
+					roleConfig
+				}) || access.isAdmin?.({ req })) return true;
+				if (isPartnerUser({
+					user,
+					roleConfig
+				}) || access.isPartner?.({ req })) return true;
 				return access.isAdmin ? access.isAdmin({ req }) : false;
 			},
 			update: access.isAdmin || (() => false),
@@ -173,11 +234,12 @@ const createReferralCodesCollection = (pluginConfig) => {
 				type: "relationship",
 				relationTo: "users",
 				required: true,
-				filterOptions: ({ data }) => {
-					const user = data?.user;
-					if (!user) return false;
-					if (user.role === "partner" || Array.isArray(user.role) && user.role.includes("partner") || Array.isArray(user.roles) && user.roles.includes("partner")) return true;
-					return false;
+				filterOptions: ({ req, user }) => {
+					if (isAdminUser({
+						user: user || req?.user,
+						roleConfig
+					}) || access.isAdmin?.({ req })) return true;
+					return buildPartnerUserFilterWhere({ roleConfig });
 				},
 				admin: { description: "The partner who owns this referral code" }
 			},
@@ -255,7 +317,10 @@ const createReferralCodesCollection = (pluginConfig) => {
 			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 (user.role === "partner" || Array.isArray(user.role) && user.role.includes("partner")) data.partner = user.id;
+				if (isPartnerUser({
+					user,
+					roleConfig
+				})) data.partner = user.id;
 			}
 			return data;
 		}] },
@@ -268,7 +333,11 @@ const createReferralCodesCollection = (pluginConfig) => {
 function toNumber(value) {
 	return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
-const deriveCustomerSplit = (partnerSplit) => {
+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;
@@ -277,6 +346,7 @@ const deriveCustomerSplit = (partnerSplit) => {
 };
 const createReferralProgramsCollection = (pluginConfig) => {
 	const { collections, access, defaultCurrency, adminGroups, referralConfig } = pluginConfig;
+	const allowedTotalCommissionTypes = referralConfig.allowedTotalCommissionTypes;
 	return {
 		slug: collections.referralProgramsSlug,
 		admin: {
@@ -299,18 +369,27 @@ const createReferralProgramsCollection = (pluginConfig) => {
 			data.commissionRules = data.commissionRules.map((rule, index) => {
 				const r = rule;
 				if (!r.totalCommission) throw new Error(`Commission rule ${index + 1}: Total Commission is required`);
-				if (!r.totalCommission.type || !["fixed", "percentage"].includes(r.totalCommission.type)) throw new Error(`Commission rule ${index + 1}: Total Commission type must be fixed or percentage`);
+				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 totalValue = toNumber(r.totalCommission.value);
-				if (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 > 100) throw new Error(`Commission rule ${index + 1}: Percentage Total Commission cannot exceed 100`);
+				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 (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 || partnerSplit > 100) throw new Error(`Commission rule ${index + 1}: Partner Split must be between 0 and 100`);
-				const customerSplit = 100 - 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;
+				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,
@@ -320,7 +399,8 @@ const createReferralProgramsCollection = (pluginConfig) => {
 						maxAmount: maxAmount ?? null
 					},
 					partnerSplit,
-					customerSplit
+					customerSplit,
+					minOrderAmount: minOrderAmount ?? null
 				};
 			});
 			return data;
@@ -410,21 +490,20 @@ const createReferralProgramsCollection = (pluginConfig) => {
 								name: "type",
 								type: "select",
 								required: true,
-								options: [{
-									label: "Fixed Amount",
-									value: "fixed"
-								}, {
-									label: "Percentage of Order",
-									value: "percentage"
-								}],
-								defaultValue: "percentage"
+								options: allowedTotalCommissionTypes.map((value) => ({
+									label: value === "fixed" ? "Fixed Amount" : "Percentage of Order",
+									value
+								})),
+								defaultValue: allowedTotalCommissionTypes.includes("fixed") ? "fixed" : "percentage"
 							},
 							{
 								name: "value",
 								type: "number",
-								required: true,
-								min: 0,
-								admin: { description: `Total commission value` }
+								admin: {
+									condition: ({ siblingData }) => siblingData?.type === "percentage",
+									description: "Total commission value (shown for percentage rules; ignored when using fixed split amounts)"
+								},
+								min: 0
 							},
 							{
 								name: "maxAmount",
@@ -439,22 +518,25 @@ const createReferralProgramsCollection = (pluginConfig) => {
 						type: "number",
 						required: true,
 						min: 0,
-						max: 100,
-						defaultValue: referralConfig.defaultPartnerSplit,
-						admin: { description: "Percentage of total commission given to Partner (0-100)" }
+						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" }
+					},
+					{
+						name: "minOrderAmount",
+						type: "number",
+						min: 0,
+						admin: { description: `Minimum cart subtotal required for this rule in ${defaultCurrency}. Leave empty for no minimum.` }
 					},
 					{
 						name: "customerSplit",
 						type: "number",
 						min: 0,
-						max: 100,
-						hooks: {
-							beforeValidate: [({ siblingData }) => deriveCustomerSplit(siblingData?.partnerSplit)],
-							beforeChange: [({ siblingData }) => deriveCustomerSplit(siblingData?.partnerSplit)]
-						},
 						admin: {
-							readOnly: true,
-							description: "Auto-calculated from Partner Split (saved automatically)"
+							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)]
 						}
 					}
 				]
@@ -529,6 +611,7 @@ function relationId(value) {
 	if (typeof value === "object" && (typeof value.id === "string" || typeof value.id === "number")) return value.id;
 	return null;
 }
+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);
@@ -541,8 +624,19 @@ function getRuleSplits(rule) {
 		customerSplit: typeof rule.customerSplit === "number" ? rule.customerSplit : typeof rule.refereeSplit === "number" ? rule.refereeSplit : 100 - partnerRaw
 	};
 }
-function calculateItemRewardByRule({ rule, itemTotal, quantity }) {
+function calculateItemRewardByRule({ rule, itemTotal, quantity, allowedTotalCommissionTypes }) {
+	const allowedTypes = allowedCommissionTypesSet(allowedTotalCommissionTypes);
 	if (rule.totalCommission) {
+		if (!allowedTypes.has(rule.totalCommission.type)) return null;
+		if (rule.totalCommission.type === "fixed" && rule.totalCommission.value == null) {
+			const partnerAmt = typeof rule.partnerSplit === "number" ? rule.partnerSplit : null;
+			const customerAmt = typeof rule.customerSplit === "number" ? rule.customerSplit : null;
+			if (partnerAmt == null || customerAmt == null) return null;
+			return {
+				partner: partnerAmt * quantity,
+				customer: customerAmt * quantity
+			};
+		}
 		const splits = getRuleSplits(rule);
 		if (!splits) return null;
 		let totalPot = 0;
@@ -581,21 +675,27 @@ function getItemCategoryIds(item) {
 function getItemTagIds(item) {
 	return Array.isArray(item?.product?.tags) ? normalizeIds(item.product.tags) : [];
 }
-function selectBestRuleForItem({ rules, item, itemTotal, quantity }) {
+function selectBestRuleForItem({ rules, item, itemTotal, quantity, cartTotal, allowedTotalCommissionTypes }) {
+	const allowedTypes = allowedCommissionTypesSet(allowedTotalCommissionTypes);
+	const eligibleRules = rules.filter((rule) => {
+		if (!(rule?.totalCommission?.type ? allowedTypes.has(rule.totalCommission.type) : true)) return false;
+		if (typeof rule?.minOrderAmount === "number" && Number.isFinite(rule.minOrderAmount)) return cartTotal >= rule.minOrderAmount;
+		return true;
+	});
 	const productId = relationId(item.product);
 	const itemCategoryIds = new Set(getItemCategoryIds(item));
 	const itemTagIds = new Set(getItemTagIds(item));
 	const candidates = [
-		rules.filter((r) => r.appliesTo === "products" && normalizeIds(r.products).some((id) => productId != null && id === productId)),
-		rules.filter((r) => {
+		eligibleRules.filter((r) => r.appliesTo === "products" && normalizeIds(r.products).some((id) => productId != null && id === productId)),
+		eligibleRules.filter((r) => {
 			if (!(r.appliesTo === "segments" || r.appliesTo === "categories")) return false;
 			return normalizeIds(r.categories).some((id) => itemCategoryIds.has(id));
 		}),
-		rules.filter((r) => {
+		eligibleRules.filter((r) => {
 			if (r.appliesTo !== "segments") return false;
 			return normalizeIds(r.tags).some((id) => itemTagIds.has(id));
 		}),
-		rules.filter((r) => r.appliesTo === "all")
+		eligibleRules.filter((r) => r.appliesTo === "all")
 	].find((level) => level.length > 0) ?? [];
 	if (!candidates.length) return null;
 	let best = null;
@@ -603,7 +703,8 @@ function selectBestRuleForItem({ rules, item, itemTotal, quantity }) {
 		const reward = calculateItemRewardByRule({
 			rule,
 			itemTotal,
-			quantity
+			quantity,
+			allowedTotalCommissionTypes
 		});
 		if (!reward) continue;
 		if (!best) {
@@ -627,7 +728,18 @@ function selectBestRuleForItem({ rules, item, itemTotal, quantity }) {
 	}
 	return best;
 }
-function calculateCommissionAndDiscount({ cartItems, program, currencyCode = "AED" }) {
+function getProgramMinimumOrderAmount({ program, allowedTotalCommissionTypes }) {
+	const rules = Array.isArray(program?.commissionRules) ? program.commissionRules : [];
+	if (!rules.length) return null;
+	const allowedTypes = allowedCommissionTypesSet(allowedTotalCommissionTypes);
+	const minValues = rules.filter((rule) => {
+		if (rule?.totalCommission?.type) return allowedTypes.has(rule.totalCommission.type);
+		return true;
+	}).map((rule) => rule?.minOrderAmount).filter((value) => typeof value === "number" && Number.isFinite(value));
+	if (!minValues.length) return null;
+	return Math.min(...minValues);
+}
+function calculateCommissionAndDiscount({ cartItems, program, currencyCode = "AED", cartTotal = 0, allowedTotalCommissionTypes }) {
 	const rules = Array.isArray(program?.commissionRules) ? program.commissionRules : [];
 	if (!rules.length) return {
 		partnerCommission: 0,
@@ -652,7 +764,9 @@ function calculateCommissionAndDiscount({ cartItems, program, currencyCode = "AE
 				product
 			},
 			itemTotal,
-			quantity
+			quantity,
+			cartTotal,
+			allowedTotalCommissionTypes
 		});
 		if (!bestMatch) continue;
 		totalPartnerCommission += bestMatch.reward.partner;
@@ -880,10 +994,20 @@ async function handleReferralCode({ payload, code, cartID, cart, customerEmail:
 		error: "Referral code already applied to this cart"
 	}, { status: 400 });
 	const cartTotal = cart.subtotal || cart.total || 0;
+	const minOrderAmount = getProgramMinimumOrderAmount({
+		program,
+		allowedTotalCommissionTypes: pluginConfig.referralConfig.allowedTotalCommissionTypes
+	});
+	if (typeof minOrderAmount === "number" && cartTotal < minOrderAmount) return Response.json({
+		success: false,
+		error: `Minimum order value of ${minOrderAmount} ${pluginConfig.defaultCurrency} required for this referral program`
+	}, { status: 400 });
 	const { partnerCommission, customerDiscount } = calculateCommissionAndDiscount({
 		cartItems: cart.items || [],
 		program,
-		currencyCode: pluginConfig.defaultCurrency
+		currencyCode: pluginConfig.defaultCurrency,
+		cartTotal,
+		allowedTotalCommissionTypes: pluginConfig.referralConfig.allowedTotalCommissionTypes
 	});
 	const roundedPartnerCommission = roundTo2(partnerCommission);
 	const roundedCustomerDiscount = roundTo2(customerDiscount);
@@ -923,8 +1047,14 @@ const partnerStatsHandler = ({ pluginConfig }) => async (req) => {
 		error: "Authentication required"
 	}, { status: 401 });
 	const typedUser = user;
-	const isPartner = typedUser.role === "partner" || Array.isArray(typedUser.role) && typedUser.role?.includes("partner") || Array.isArray(typedUser.roles) && typedUser.roles?.includes("partner");
-	const isAdmin = typedUser.role === "admin" || Array.isArray(typedUser.role) && typedUser.role?.includes("admin") || Array.isArray(typedUser.roles) && typedUser.roles?.includes("admin");
+	const isPartner = isPartnerUser({
+		user: typedUser,
+		roleConfig: pluginConfig.roleConfig
+	}) || pluginConfig.access.isPartner?.({ req });
+	const isAdmin = isAdminUser({
+		user: typedUser,
+		roleConfig: pluginConfig.roleConfig
+	}) || pluginConfig.access.isAdmin?.({ req });
 	if (!isPartner && !isAdmin) return Response.json({
 		success: false,
 		error: "Partner access required"
@@ -1204,12 +1334,22 @@ async function validateReferralCode({ payload, code, cartID, pluginConfig }) {
 		id: cartID,
 		depth: 2
 	}) : null;
+	const cartTotal = cart ? cart.subtotal || cart.total || 0 : 0;
+	const minOrderAmount = getProgramMinimumOrderAmount({
+		program,
+		allowedTotalCommissionTypes: pluginConfig.referralConfig.allowedTotalCommissionTypes
+	});
+	if (typeof minOrderAmount === "number" && cartTotal < minOrderAmount) return Response.json({
+		success: false,
+		error: `Minimum order value of ${minOrderAmount} ${pluginConfig.defaultCurrency} required for this referral program`
+	}, { status: 400 });
 	const { partnerCommission, customerDiscount } = calculateCommissionAndDiscount({
 		cartItems: cart?.items || [],
 		program,
-		currencyCode: pluginConfig.defaultCurrency
+		currencyCode: pluginConfig.defaultCurrency,
+		cartTotal,
+		allowedTotalCommissionTypes: pluginConfig.referralConfig.allowedTotalCommissionTypes
 	});
-	const cartTotal = cart ? cart.subtotal || cart.total || 0 : 0;
 	const cappedCustomerDiscount = cartTotal > 0 ? Math.min(customerDiscount, cartTotal) : customerDiscount;
 	const roundedPartnerCommission = roundTo2(partnerCommission);
 	const roundedCustomerDiscount = roundTo2(cappedCustomerDiscount);
@@ -1235,12 +1375,6 @@ const validateCouponEndpoint = ({ pluginConfig }) => ({
 const recalculateCartHook = (pluginConfig) => async ({ data, req, originalDoc }) => {
 	if (!req.payload) return data;
 	const effectiveItems = data.items || originalDoc?.items || [];
-	console.log("[RecalculateCart] Hook triggered", {
-		hasDataItems: !!data.items,
-		dataItemsCount: data.items?.length,
-		originalItemsCount: originalDoc?.items?.length,
-		effectiveItemsCount: effectiveItems.length
-	});
 	if (!effectiveItems.length) return {
 		...data,
 		partnerCommission: 0,
@@ -1287,12 +1421,6 @@ const recalculateCartHook = (pluginConfig) => async ({ data, req, originalDoc })
 			currencyCode: pluginConfig.defaultCurrency
 		});
 		calculatedSubtotal += itemPrice * (item.quantity ?? 1);
-		console.log("[RecalculateCart] Item processed", {
-			productId,
-			quantity: item.quantity,
-			priceUsed: itemPrice,
-			currentSubtotal: calculatedSubtotal
-		});
 		return {
 			...item,
 			product,
@@ -1321,16 +1449,30 @@ const recalculateCartHook = (pluginConfig) => async ({ data, req, originalDoc })
 				id: programId
 			}) : null;
 			if (program) {
+				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;
+				}
 				const { partnerCommission, customerDiscount } = calculateCommissionAndDiscount({
 					cartItems: enrichedItems,
 					program,
-					currencyCode: pluginConfig.defaultCurrency
+					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;
@@ -1351,12 +1493,6 @@ const recalculateCartHook = (pluginConfig) => async ({ data, req, originalDoc })
 				coupon,
 				cartTotal: calculatedSubtotal
 			});
-			console.log("[RecalculateCart] Coupon Logic", {
-				appliedCoupon,
-				couponId: coupon.id,
-				cartTotal: calculatedSubtotal,
-				discountAmount
-			});
 			data.discountAmount = discountAmount;
 			const currentDiscount = data.customerDiscount || 0;
 			data.total = Math.max(0, calculatedSubtotal - currentDiscount - discountAmount);
@@ -1368,6 +1504,13 @@ const recalculateCartHook = (pluginConfig) => async ({ data, req, originalDoc })
 //#endregion
 //#region src/utilities/sanitizePluginConfig.ts
 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"],
+		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"))] : [];
 	return {
 		enabled: !(pluginConfig?.enabled === false || typeof pluginConfig?.enabled === "string" && pluginConfig.enabled === "false"),
 		enableReferrals: !!pluginConfig?.enableReferrals && (typeof pluginConfig?.enableReferrals !== "string" || pluginConfig.enableReferrals !== "false"),
@@ -1389,20 +1532,21 @@ const sanitizePluginConfig = ({ pluginConfig }) => {
 		access: {
 			canUseCoupons: typeof pluginConfig?.access?.canUseCoupons === "function" ? pluginConfig.access.canUseCoupons : () => true,
 			canUseReferrals: typeof pluginConfig?.access?.canUseReferrals === "function" ? pluginConfig.access.canUseReferrals : () => false,
-			isAdmin: typeof pluginConfig?.access?.isAdmin === "function" ? pluginConfig.access.isAdmin : () => false,
-			isPartner: typeof pluginConfig?.access?.isPartner === "function" ? pluginConfig.access.isPartner : ({ req }) => {
-				const user = req?.user;
-				if (!user) return false;
-				if (user.role === "partner") return true;
-				if (Array.isArray(user.roles) && user.roles.includes("partner")) return true;
-				return false;
-			}
+			isAdmin: typeof pluginConfig?.access?.isAdmin === "function" ? pluginConfig.access.isAdmin : ({ req }) => isAdminUser({
+				user: req?.user,
+				roleConfig
+			}),
+			isPartner: typeof pluginConfig?.access?.isPartner === "function" ? pluginConfig.access.isPartner : ({ req }) => isPartnerUser({
+				user: req?.user,
+				roleConfig
+			})
 		},
 		referralConfig: {
 			allowBothSystems: pluginConfig?.referralConfig?.allowBothSystems ?? false,
 			singleCodePerCart: pluginConfig?.referralConfig?.singleCodePerCart ?? true,
 			defaultPartnerSplit: pluginConfig?.referralConfig?.defaultPartnerSplit ?? 70,
-			defaultCustomerSplit: pluginConfig?.referralConfig?.defaultCustomerSplit ?? 30
+			defaultCustomerSplit: pluginConfig?.referralConfig?.defaultCustomerSplit ?? 30,
+			allowedTotalCommissionTypes: normalizedAllowedTotalCommissionTypes.length > 0 ? normalizedAllowedTotalCommissionTypes : ["fixed", "percentage"]
 		},
 		adminGroups: {
 			couponsGroup: pluginConfig?.adminGroups?.couponsGroup ?? "Coupons",
@@ -1420,7 +1564,8 @@ const sanitizePluginConfig = ({ pluginConfig }) => {
 			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",
 			orderPaidStatusValue: typeof pluginConfig?.orderIntegration?.orderPaidStatusValue === "string" ? pluginConfig.orderIntegration.orderPaidStatusValue : "paid"
-		}
+		},
+		roleConfig
 	};
 };
 
@@ -1807,5 +1952,5 @@ async function recordCouponUsageForOrder(payload, order, pluginConfig) {
 }
 
 //#endregion
-export { calculateCommissionAndDiscount, createCouponsCollection, createReferralCodesCollection, createReferralProgramsCollection, getCartTotalWithDiscounts, payloadEcommerceCouponPlugin as payloadEcommerceCoupon, recordCouponUsageForOrder, useCouponCode, usePartnerStats, validateCouponCode };
+export { calculateCommissionAndDiscount, createCouponsCollection, createReferralCodesCollection, createReferralProgramsCollection, getCartTotalWithDiscounts, getProgramMinimumOrderAmount, payloadEcommerceCouponPlugin as payloadEcommerceCoupon, recordCouponUsageForOrder, useCouponCode, usePartnerStats, validateCouponCode };
 //# sourceMappingURL=index.mjs.map