refactor: gate entry.client.js skip on a plugin capability, not EmbedPlugin identity

Add `Plugin.provides_entry_client()` so any plugin can opt out of the
framework's default `entry.client.js` write. `update_entry_client` now
checks all registered plugins instead of importing `get_embed_plugin`,
keeping the framework agnostic to which plugin owns the entry file.

Author: FarhanAliRaza

packages/reflex-base/src/reflex_base/plugins/base.py

@@ -153,6 +153,19 @@ def post_build(self, **context: Unpack[PostBuildContext]) -> None:
             context: The context for the plugin.
         """
 
+    def provides_entry_client(self) -> bool:
+        """Return whether this plugin emits its own ``entry.client.js``.
+
+        The framework calls this during ``setup_frontend`` to decide whether
+        to skip its default ``entry.client.js`` write. Plugins that register
+        a save task for the same path should return ``True`` so the framework
+        write doesn't race with (or overwrite) theirs.
+
+        Returns:
+            ``True`` if the plugin owns ``entry.client.js`` for this build.
+        """
+        return False
+
     def update_env_json(
         self, **context: Unpack[CommonContext]
     ) -> dict[str, Any] | None:

packages/reflex-base/src/reflex_base/plugins/embed.py

@@ -293,6 +293,19 @@ def pre_compile(self, **context):
                 _inject_vite_dev_preview(self.mount_target),
             )
 
+    def provides_entry_client(self) -> bool:
+        """Declare that EmbedPlugin emits its own ``entry.client.js``.
+
+        ``pre_compile`` registers ``_embed_entry_task`` which writes the
+        embed-aware entry template at ``constants.Embed.ENTRY_PATH``; the
+        framework's default ``update_entry_client`` must skip this path to
+        avoid stomping the embed entry on every compile.
+
+        Returns:
+            Always ``True``.
+        """
+        return True
+
     def update_env_json(self, **context):
         """Contribute the mount target so the embed entry can read it.
 

reflex/utils/frontend_skeleton.py

@@ -186,11 +186,11 @@ def initialize_web_directory():
 def update_entry_client():
     """Write ``.web/app/entry.client.js`` from the framework-mode template.
 
-    Skipped when ``EmbedPlugin`` is registered — the plugin emits the
-    embed-aware variant via its own save task and overwriting it here would
-    just be redone on the same compile.
+    Skipped when any registered plugin reports ``provides_entry_client()`` —
+    that plugin emits its own variant via a save task and overwriting it
+    here would just be redone on the same compile.
     """
-    if get_embed_plugin() is not None:
+    if any(p.provides_entry_client() for p in get_config().plugins):
         return
     write_file(
         get_web_dir() / constants.Embed.ENTRY_PATH,

tests/units/plugins/test_embed.py

@@ -52,6 +52,11 @@ def test_update_env_json_returns_mount_target():
     assert plugin.update_env_json() == {"MOUNT_TARGET": "#widget"}
 
 
+def test_provides_entry_client_is_true():
+    plugin = EmbedPlugin(mount_target="#widget")
+    assert plugin.provides_entry_client() is True
+
+
 def test_pre_compile_registers_save_tasks():
     plugin = EmbedPlugin(mount_target="#root")
     saved: list[tuple] = []