chore(core-flows): improve TSDocs of customer and customer groups workflows / steps (#10993)

* improve customer tsdocs

* finished improving tsdocs

* fix build error

Author: shahednasser

packages/core/core-flows/src/cart/workflows/add-shipping-method-to-cart.ts

@@ -75,6 +75,8 @@ export const addShippingMethodToCartWorkflowId = "add-shipping-method-to-cart"
  * @summary
  * 
  * Add a shipping method to a cart.
+ * 
+ * @property hooks.validate - This hook is executed before all operations. You can consume this hook to perform any custom validation. If validation fails, you can throw an error to stop the workflow execution.
  */
 export const addShippingMethodToCartWorkflow = createWorkflow(
   addShippingMethodToCartWorkflowId,

packages/core/core-flows/src/cart/workflows/add-to-cart.ts

@@ -63,6 +63,8 @@ export const addToCartWorkflowId = "add-to-cart"
  * @summary
  * 
  * Add a line item to a cart.
+ * 
+ * @property hooks.validate - This hook is executed before all operations. You can consume this hook to perform any custom validation. If validation fails, you can throw an error to stop the workflow execution.
  */
 export const addToCartWorkflow = createWorkflow(
   addToCartWorkflowId,

packages/core/core-flows/src/cart/workflows/complete-cart.ts

@@ -75,6 +75,8 @@ export const completeCartWorkflowId = "complete-cart"
  * @summary
  * 
  * Complete a cart and place an order.
+ * 
+ * @property hooks.validate - This hook is executed before all operations. You can consume this hook to perform any custom validation. If validation fails, you can throw an error to stop the workflow execution.
  */
 export const completeCartWorkflow = createWorkflow(
   {

packages/core/core-flows/src/cart/workflows/create-carts.ts

@@ -73,7 +73,7 @@ export const createCartWorkflowId = "create-cart"
  *
  * Create a cart specifying region, items, and more.
  *
- * @property hooks.validate - This hook is executed before all operations. You can consume this hook to perform any custom validation.
+ * @property hooks.validate - This hook is executed before all operations. You can consume this hook to perform any custom validation. If validation fails, you can throw an error to stop the workflow execution.
  * @property hooks.cartCreated - This hook is executed after a cart is created. You can consume this hook to perform custom actions on the created cart.
  */
 export const createCartWorkflow = createWorkflow(

packages/core/core-flows/src/cart/workflows/refresh-cart-items.ts

@@ -65,6 +65,8 @@ export const refreshCartItemsWorkflowId = "refresh-cart-items"
  * @summary
  * 
  * Refresh a cart's details after an update.
+ * 
+ * @property hooks.validate - This hook is executed before all operations. You can consume this hook to perform any custom validation. If validation fails, you can throw an error to stop the workflow execution.
  */
 export const refreshCartItemsWorkflow = createWorkflow(
   refreshCartItemsWorkflowId,

packages/core/core-flows/src/cart/workflows/refresh-cart-shipping-methods.ts

@@ -42,6 +42,8 @@ export const refreshCartShippingMethodsWorkflowId =
  * @summary
  * 
  * Refresh a cart's shipping methods after an update.
+ * 
+ * @property hooks.validate - This hook is executed before all operations. You can consume this hook to perform any custom validation. If validation fails, you can throw an error to stop the workflow execution.
  */
 export const refreshCartShippingMethodsWorkflow = createWorkflow(
   refreshCartShippingMethodsWorkflowId,

packages/core/core-flows/src/cart/workflows/refresh-payment-collection.ts

@@ -46,6 +46,8 @@ export const refreshPaymentCollectionForCartWorkflowId =
  * @summary
  * 
  * Refresh a cart's payment collection details.
+ * 
+ * @property hooks.validate - This hook is executed before all operations. You can consume this hook to perform any custom validation. If validation fails, you can throw an error to stop the workflow execution.
  */
 export const refreshPaymentCollectionForCartWorkflow = createWorkflow(
   refreshPaymentCollectionForCartWorkflowId,

packages/core/core-flows/src/cart/workflows/transfer-cart-customer.ts

@@ -44,6 +44,8 @@ export const transferCartCustomerWorkflowId = "transfer-cart-customer"
  * @summary
  * 
  * Refresh a cart's payment collection details.
+ * 
+ * @property hooks.validate - This hook is executed before all operations. You can consume this hook to perform any custom validation. If validation fails, you can throw an error to stop the workflow execution.
  */
 export const transferCartCustomerWorkflow = createWorkflow(
   transferCartCustomerWorkflowId,

packages/core/core-flows/src/cart/workflows/update-cart-promotions.ts

@@ -64,6 +64,8 @@ export const updateCartPromotionsWorkflowId = "update-cart-promotions"
  * @summary
  * 
  * Update a cart's applied promotions to add, replace, or remove them.
+ * 
+ * @property hooks.validate - This hook is executed before all operations. You can consume this hook to perform any custom validation. If validation fails, you can throw an error to stop the workflow execution.
  */
 export const updateCartPromotionsWorkflow = createWorkflow(
   updateCartPromotionsWorkflowId,

packages/core/core-flows/src/cart/workflows/update-cart.ts

@@ -76,7 +76,7 @@ export const updateCartWorkflowId = "update-cart"
  *
  * Update a cart's details, such as region, address, and more.
  *
- * @property hooks.validate - This hook is executed before all operations. You can consume this hook to perform any custom validation.
+ * @property hooks.validate - This hook is executed before all operations. You can consume this hook to perform any custom validation. If validation fails, you can throw an error to stop the workflow execution.
  * @property hooks.cartUpdated - This hook is executed after a cart is update. You can consume this hook to perform custom actions on the updated cart.
  */
 export const updateCartWorkflow = createWorkflow(