identifier = $identifier; } /** * Handle the action. * * @since 1.0.0 * * @param string $action The name of the action. * @param array $data The data associated with the action. */ public function handle( $action, $data ) { $prefix_for_cpt = $this->identifier; $post_type = $prefix_for_cpt . '-flow'; $meta_key = '_' . $prefix_for_cpt . '_notification_flow_trigger'; $flows = get_posts( [ 'post_type' => $post_type, 'meta_key' => $meta_key, 'meta_value' => $action, 'post_status' => 'publish', ] ); if ( empty( $flows ) || !is_array( $flows ) ) { return; } foreach ( $flows as $flow ) { if ( !isset( $flow->ID ) ) { continue; } $flow_config = get_post_meta( $flow->ID, '_' . $prefix_for_cpt . '_notification_flow_flow_config', true ); if ( empty( $flow_config ) || !is_array( $flow_config ) ) { continue; } $this->execute_flow( $flow_config, $data, $action ); } } /** * Resume flow callback. * * @since 1.0.0 * * @param int $flow_id The ID of the flow. * @param string $resume_time The resume time. */ public function resume_flow_callback( $flow_id, $resume_time ) { if ( !$flow_id || !$resume_time ) { return; } $checkpoint = $this->get_user_flow_checkpoint( $resume_time, $flow_id ); if ( empty( $checkpoint ) || !is_array( $checkpoint ) ) { return; } if ( !isset( $checkpoint['resume_after'] ) || time() < $checkpoint['resume_after'] ) { return; } if ( !isset( $checkpoint['flow_snapshot'] ) || !isset( $checkpoint['hook_data'] ) ) { return; } $flow = $checkpoint['flow_snapshot']; $hook_data = $checkpoint['hook_data']; $resume_node = $checkpoint['resume_node'] ?? null; $action = $checkpoint['action']; $this->execute_flow( $flow, $hook_data, $action, $resume_node ); } /** * Execute a flow. * * @since 1.0.0 * * @param array $flow The flow data. * @param array $hook_data The hook data. * @param string|null $resume_from_id The node ID to resume from. */ public function execute_flow( $flow, $hook_data,$action, $resume_from_id = null ) { if ( !isset( $flow['nodes'] ) || !is_array( $flow['nodes'] ) || !isset( $flow['edges'] ) || !is_array( $flow['edges'] ) ) { return; } $nodes = $flow['nodes']; $edges = $flow['edges']; // Build node map with validation $node_map = []; foreach ( $nodes as $node ) { if ( !isset( $node['id'], $node['name'] ) ) { continue; } $node_map[$node['id']] = $node; } $start_node_id = $resume_from_id ?? $this->find_trigger_node( $nodes ); if ( !$start_node_id || !isset( $node_map[$start_node_id] ) ) { return; } $current_node_id = $start_node_id; while ( $current_node_id && isset( $node_map[$current_node_id] ) ) { $node = $node_map[$current_node_id]; switch ( $node['name'] ) { case 'trigger': $current_node_id = $this->get_next_node_id( $edges, $node['id'] ); break; case 'condition': if ( !isset( $node['data'] ) || !is_array( $node['data'] ) ) { $current_node_id = null; break; } $field = $node['data']['field'] ?? null; $operator = $node['data']['operator'] ?? null; $value = $node['data']['value'] ?? null; $field_value = $hook_data[$field] ?? null; if ( $field === null || $operator === null ) { $current_node_id = null; break; } if(is_numeric($value) && $value > 9999999999 && isset($hook_data[$field.'_timestamp'])){ $field_value = $hook_data[$field.'_timestamp']; $timestamp = (int) ($value / 1000); // Create DateTime object in WordPress timezone $dt = (new DateTime("@$timestamp"))->setTimezone(wp_timezone()); // For comparison: get timestamp in WordPress timezone $value = $dt->getTimestamp(); } if(is_string($value)){ $field_value = strtolower(preg_replace('/[^\w]/', '', trim($field_value))); $value = strtolower(preg_replace('/[^\w]/', '', trim($value))); } $is_true = $this->compare_values( $field_value, $operator, $value ); $lebel = $is_true ? 'True' : 'false'; $current_node_id = $this->get_next_node_id( $edges, $node['id'], $lebel ); break; case 'delay': if ( !isset( $node['data'] ) || !is_array( $node['data'] ) ) { $current_node_id = null; break; } $delayUnit = $node['data']['delayUnit'] ?? 'seconds'; $delay = isset( $node['data']['delay'] ) ? (int) $node['data']['delay'] : 60; $delay_depeneds_on = $node['data']['delayCondition'] ?? null; $delay_condition = 'after'; $dependent_key = $delay_depeneds_on; if(str_contains( $delay_depeneds_on, 'before' )) { $delay_condition = 'before'; $dependent_key = str_replace( 'before_', '', $delay_depeneds_on ); } if(str_contains( $delay_depeneds_on, 'after' )) { $delay_condition = 'after'; $dependent_key = str_replace( 'after_', '', $delay_depeneds_on ); } if(isset( $hook_data[$dependent_key.'_timestamp'] )) { $dependent_key = $dependent_key.'_timestamp'; } $dependency_value = isset( $hook_data[$dependent_key] ) ? ( $hook_data[$dependent_key] ?? current_time( 'timestamp' ) ) : current_time( 'timestamp' ); $general_prefix = $this->identifier; // Calculate seconds based on unit $seconds = $delay; switch ( $delayUnit ) { case 'minutes': $seconds *= 60; break; case 'hours': $seconds *= 60 * 60; break; case 'days': $seconds *= 60 * 60 * 24; break; } // Calculate resume time $resume_time = ( $delay_condition == 'before' ) ? $dependency_value - $seconds : $dependency_value + $seconds; $next_node_id = $this->get_next_node_id( $edges, $node['id'] ); if ( !$next_node_id ) { $current_node_id = null; break; } $flow_id = uniqid( 'flow_', true ); $post_id = $hook_data['post_id'] ?? null; if ( $post_id && isset( $hook_data['previous_'.$dependent_key] ) ) { $previous_resume_time = $hook_data['previous_'.$dependent_key]; $previous_resume_time = ( $delay_condition == 'before' ) ? $previous_resume_time - $seconds : $previous_resume_time + $seconds; if( $previous_resume_time != $resume_time ) { $hook = $general_prefix . '_resume_flow_after_delay'; $previous_flow_id = get_post_meta( $post_id, 'ens_flow_id', true ); if(wp_next_scheduled( $hook, [ 'flow_id' => $previous_flow_id, 'resume_time' => $previous_resume_time ] )){ $key = sprintf( 'flow_checkpoint_%s_%s', $previous_flow_id, $previous_resume_time ); delete_transient( $key ); wp_clear_scheduled_hook( $hook, [ 'flow_id' => $previous_flow_id, 'resume_time' => $previous_resume_time ] ); } } } if(isset( $post_id )) { update_post_meta( $post_id, 'ens_flow_id', $flow_id ); } // Save checkpoint $this->save_user_flow_checkpoint( $resume_time, $flow_id, [ 'resume_node' => $next_node_id, 'resume_after' => $resume_time, 'flow_snapshot' => $flow, 'hook_data' => $hook_data, 'action' => $action ] ); // Schedule resume wp_schedule_single_event( $resume_time, $general_prefix . '_resume_flow_after_delay', [ 'flow_id' => $flow_id, 'resume_time' => $resume_time, ] ); return; // Pause execution case 'email': if ( !isset( $node['data'] ) || !is_array( $node['data'] ) ) { $current_node_id = null; break; } $receiverType = $node['data']['receiverType'] ?? null; if ( $receiverType && isset( $hook_data[$receiverType] ) ) { $user_email = $hook_data[$receiverType]; $user_email = apply_filters( Helpers::get_hook_name( $this->identifier, 'notification_sdk_to_emails' ), $hook_data[$receiverType], $hook_data, $action ); if(is_array( $user_email )) { foreach ( $user_email as $key=>$email ) { $this->send_email_to_user( $receiverType, $email, $node['data'], $hook_data, $action,$key ); } } else{ $this->send_email_to_user( $receiverType, $user_email, $node['data'], $hook_data, $action ); } } $current_node_id = $this->get_next_node_id( $edges, $node['id'] ); break; case 'whatsapp': if ( !isset( $node['data'] ) || !is_array( $node['data'] ) ) { $current_node_id = null; break; } $receiverType = $node['data']['receiverType'] ?? null; if ( $receiverType && isset( $hook_data[$receiverType] ) ) { $user_number = $hook_data[$receiverType]; $user_number = apply_filters( Helpers::get_hook_name( $this->identifier, 'notification_sdk_to_whatsapp_numbers' ), $hook_data[$receiverType], $hook_data, $action ); if ( is_array( $user_number ) ) { foreach ( $user_number as $key => $number ) { $this->send_whatsapp_to_user( $receiverType, $number, $node['data'], $hook_data, $action, $key ); } } else { $this->send_whatsapp_to_user( $receiverType, $user_number, $node['data'], $hook_data, $action ); } } $current_node_id = $this->get_next_node_id( $edges, $node['id'] ); break; case 'end': return; default: $current_node_id = $this->get_next_node_id( $edges, $node['id'] ); break; } } } /** * Compare values with type safety. * * @since 1.0.0 * * @param mixed $left The left value. * @param string $operator The operator. * @param mixed $right The right value. * * @return bool */ public function compare_values( $left, $operator, $right ) { if ( $operator === null ) { return false; } switch ( $operator ) { case '=': return $left == $right; case 'not_equal': return $left != $right; case 'greater_than': if ( !is_numeric( $left ) || !is_numeric( $right ) ) { return false; } return $left > $right; case 'less_than': if ( !is_numeric( $left ) || !is_numeric( $right ) ) { return false; } return $left < $right; case 'greater_equal': if ( !is_numeric( $left ) || !is_numeric( $right ) ) { return false; } return $left >= $right; case 'less_equal': if ( !is_numeric( $left ) || !is_numeric( $right ) ) { return false; } return $left <= $right; default:return false; } } /** * Find trigger node in nodes array. * * @since 1.0.0 * * @param array $nodes The nodes array. * * @return string|null */ public function find_trigger_node( $nodes ) { foreach ( $nodes as $node ) { if ( isset( $node['name'] ) && $node['name'] === 'trigger' && isset( $node['id'] ) ) { return $node['id']; } } return null; } /** * Get next node ID from edges. * * @since 1.0.0 * * @param array $edges The edges array. * @param string $from_id The source node ID. * @param string|null $label The edge label (optional). * * @return string|null */ public function get_next_node_id( $edges, $from_id, $label = null ) { foreach ( $edges as $edge ) { if ( !isset( $edge['source'], $edge['target'] ) ) { continue; } if ( $edge['source'] === $from_id ) { if ( $label === null || ( isset( $edge['label'] ) && $edge['label'] === $label ) ) { return $edge['target']; } } } return null; } /** * Save user flow checkpoint. * * @since 1.0.0 * * @param int $resume_time The timestamp to resume at. * @param string $flow_id The flow ID. * @param array $data The checkpoint data. */ public function save_user_flow_checkpoint( $resume_time, $flow_id, $data ) { if ( empty( $data ) || !isset( $data['resume_after'] ) ) { return; } // Set a minimum expiration of 1 hour and maximum of 30 days $expiration = max( HOUR_IN_SECONDS, min( $data['resume_after'] - time() + DAY_IN_SECONDS, 30 * DAY_IN_SECONDS ) ); $key = sprintf( 'flow_checkpoint_%s_%s', $flow_id, $resume_time ); // Store the flow_id and resume_time in the data for verification $data['_flow_id'] = $flow_id; $data['_resume_time'] = $resume_time; // Store the current timestamp to help with debugging $data['_saved_at'] = time(); set_transient( $key, $data, $expiration ); } /** * Get user flow checkpoint. * * @since 1.0.0 * * @param int $resume_time The resume time. * @param string $flow_id The flow ID. * * @return array|null */ public function get_user_flow_checkpoint( $resume_time, $flow_id ) { $key = sprintf( 'flow_checkpoint_%s_%s', $flow_id, $resume_time ); $checkpoint = get_transient( $key ); if (!is_array($checkpoint)) { // Log additional debug info return null; } // Verify the flow_id and resume_time match what we expect if (($checkpoint['_flow_id'] ?? '') !== $flow_id || ($checkpoint['_resume_time'] ?? 0) != $resume_time) { return null; } return $checkpoint; } /** * Send email to user with validation. * * @since 1.0.0 * * @param string $receiverType The type of receiver. * @param string $email The recipient email. * @param array $data The email data. * @param array $action_data The action data. * @param string $action_name The action name. * @param int $count The email count. */ public function send_email_to_user( $receiverType, $email, $data, $action_data, $action_name, $count = 0 ) { if ( !filter_var( $email, FILTER_VALIDATE_EMAIL ) ) { return; } $from = $data['from'] ?? ''; $subject = $data['subject'] ?? ''; $body = $data['body'] ?? ''; if ( empty( $subject ) ) { return; } $email_sender = new EmailSender( $this->identifier, $action_name, $receiverType, $email, $from, $subject, $body, $action_data, $count ); $email_sender->send(); } /** * Send WhatsApp message to user with loose validation. * * @since 1.0.0 * * @param string $receiverType The type of receiver. * @param mixed $number The recipient phone number. * @param array $data The action node data (messageBody, etc.). * @param array $action_data The hook payload. * @param string $action_name The triggered action name. * @param int $count Iteration count when receiver is an array. */ public function send_whatsapp_to_user( $receiverType, $number, $data, $action_data, $action_name, $count = 0 ) { if ( ! is_scalar( $number ) ) { return; } $number = trim( (string) $number ); if ( '' === $number ) { return; } // Require at least 7 digits (E.164 sanity). if ( strlen( preg_replace( '/\D/', '', $number ) ) < 7 ) { return; } $message_type = isset( $data['messageType'] ) && 'template' === $data['messageType'] ? 'template' : 'text'; if ( 'template' === $message_type ) { $template_name = trim( (string) ( $data['templateName'] ?? '' ) ); if ( '' === $template_name ) { return; } $body_params = $data['templateBodyParams'] ?? []; if ( is_string( $body_params ) ) { // TagInput normally returns an array, but accept newline-separated string for resilience. $body_params = array_values( array_filter( array_map( 'trim', preg_split( '/\r\n|\r|\n/', $body_params ) ), 'strlen' ) ); } if ( ! is_array( $body_params ) ) { $body_params = []; } $sender = new WhatsappSender( [ 'action_name' => $action_name, 'receiver_type' => $receiverType, 'to' => $number, 'message' => '', 'message_type' => 'template', 'template' => [ 'name' => $template_name, 'language' => trim( (string) ( $data['templateLanguage'] ?? 'en_US' ) ) ?: 'en_US', 'body_params' => $body_params, ], 'action_data' => $action_data, 'count' => $count, ] ); $sender->send(); return; } $message = $data['messageBody'] ?? ''; if ( '' === trim( (string) $message ) ) { return; } $sender = new WhatsappSender( [ 'action_name' => $action_name, 'receiver_type' => $receiverType, 'to' => $number, 'message' => $message, 'message_type' => 'text', 'action_data' => $action_data, 'count' => $count, ] ); $sender->send(); } }