WP_AI_Client_Event_Dispatcher

22class WP_AI_Client_Event_Dispatcher implements EventDispatcherInterface {23 24	/**25	 * Dispatches an event to WordPress action hooks.26	 *27	 * Converts the event class name to a WordPress action hook name and fires it.28	 * For example, BeforeGenerateResultEvent becomes wp_ai_client_before_generate_result.29	 *30	 * @since 7.0.031	 *32	 * @param object $event The event object to dispatch.33	 * @return object The same event object, potentially modified by listeners.34	 */35	public function dispatch( object $event ): object {36		$event_name = $this->get_hook_name_portion_for_event( $event );37 38		/**39		 * Fires when an AI client event is dispatched.40		 *41		 * The dynamic portion of the hook name, `$event_name`, refers to the42		 * snake_case version of the event class name, without the `_event` suffix.43		 *44		 * For example, an event class named `BeforeGenerateResultEvent` will fire the45		 * `wp_ai_client_before_generate_result` action hook.46		 *47		 * In practice, the available action hook names are:48		 *49		 * - wp_ai_client_before_generate_result50		 * - wp_ai_client_after_generate_result51		 *52		 * @since 7.0.053		 *54		 * @param object $event The event object.55		 */56		do_action( "wp_ai_client_{$event_name}", $event );57 58		return $event;59	}60 61	/**62	 * Converts an event object class name to a WordPress action hook name portion.63	 *64	 * @since 7.0.065	 *66	 * @param object $event The event object.67	 * @return string The hook name portion derived from the event class name.68	 */69	private function get_hook_name_portion_for_event( object $event ): string {70		$class_name = get_class( $event );71		$pos        = strrpos( $class_name, '\\' );72		$short_name = false !== $pos ? substr( $class_name, $pos + 1 ) : $class_name;73 74		// Convert PascalCase to snake_case.75		$snake_case = strtolower( (string) preg_replace( '/([a-z])([A-Z])/', '$1_$2', $short_name ) );76 77		// Strip '_event' suffix if present.78		if ( str_ends_with( $snake_case, '_event' ) ) {79			$snake_case = (string) substr( $snake_case, 0, -6 );80		}81 82		return $snake_case;83	}84}