feat: Add transcript editor toggle and update related serializers and tests (#267)

Author: abhalsod-sonata

cms/djangoapps/contentstore/rest_api/v1/serializers/course_waffle_flags.py

@@ -35,6 +35,7 @@ class CourseWaffleFlagsSerializer(serializers.Serializer):
     enable_unit_expanded_view = serializers.SerializerMethodField()
     enable_outline_component_creation = serializers.SerializerMethodField()
     enable_audio_description = serializers.SerializerMethodField()
+    enable_transcript_editor = serializers.SerializerMethodField()
 
     def get_course_key(self):
         """
@@ -200,3 +201,10 @@ def get_enable_audio_description(self, obj):
         """
         course_key = self.get_course_key()
         return toggles.audio_description_enabled(course_key)
+
+    def get_enable_transcript_editor(self, obj):
+        """
+        Method to get the contentstore.enable_transcript_editor waffle flag.
+        """
+        course_key = self.get_course_key()
+        return toggles.transcript_editor_enabled(course_key)

cms/djangoapps/contentstore/rest_api/v1/views/tests/test_course_waffle_flags.py

@@ -42,6 +42,7 @@ class CourseWaffleFlagsViewTest(CourseTestCase):
         "enable_unit_expanded_view": False,
         "enable_outline_component_creation": False,
         "enable_audio_description": False,
+        "enable_transcript_editor": False,
     }
 
     def setUp(self):
@@ -84,3 +85,55 @@ def test_audio_description_upload_flag_enabled(self):
         url = reverse("cms.djangoapps.contentstore:v1:course_waffle_flags")
         response = self.client.get(url)
         assert response.data["enable_audio_description"] is True
+
+    def test_enable_transcript_editor_flag_default_is_false(self):
+        """
+        The contentstore.enable_transcript_editor flag should default to False when not
+        overridden, both globally and for a specific course.
+        """
+        global_url = reverse("cms.djangoapps.contentstore:v1:course_waffle_flags")
+        course_url = reverse(
+            "cms.djangoapps.contentstore:v1:course_waffle_flags",
+            kwargs={"course_id": self.course.id},
+        )
+        for url in (global_url, course_url):
+            response = self.client.get(url)
+            assert response.data["enable_transcript_editor"] is False
+
+    @override_waffle_flag(toggles.ENABLE_TRANSCRIPT_EDITOR, active=True)
+    def test_enable_transcript_editor_flag_enabled_globally(self):
+        """
+        When the contentstore.enable_transcript_editor flag is active globally, the
+        serializer should return True for both the global endpoint and any
+        course-specific endpoint.
+        """
+        global_url = reverse("cms.djangoapps.contentstore:v1:course_waffle_flags")
+        course_url = reverse(
+            "cms.djangoapps.contentstore:v1:course_waffle_flags",
+            kwargs={"course_id": self.course.id},
+        )
+        for url in (global_url, course_url):
+            response = self.client.get(url)
+            assert response.data["enable_transcript_editor"] is True
+
+    def test_enable_transcript_editor_flag_enabled_per_course(self):
+        """
+        When the contentstore.enable_transcript_editor flag is enabled via a
+        WaffleFlagCourseOverrideModel entry for a specific course, the
+        course-scoped endpoint should return True while the global endpoint
+        should remain False.
+        """
+        WaffleFlagCourseOverrideModel.objects.create(
+            waffle_flag=toggles.ENABLE_TRANSCRIPT_EDITOR.name,
+            course_id=self.course.id,
+            enabled=True,
+        )
+        global_url = reverse("cms.djangoapps.contentstore:v1:course_waffle_flags")
+        course_url = reverse(
+            "cms.djangoapps.contentstore:v1:course_waffle_flags",
+            kwargs={"course_id": self.course.id},
+        )
+        global_response = self.client.get(global_url)
+        course_response = self.client.get(course_url)
+        assert global_response.data["enable_transcript_editor"] is False
+        assert course_response.data["enable_transcript_editor"] is True

cms/djangoapps/contentstore/toggles.py

@@ -90,6 +90,31 @@ def audio_description_enabled(course_key):
     return ENABLE_AUDIO_DESCRIPTION.is_enabled(course_key)
 
 
+# .. toggle_name: contentstore.enable_transcript_editor
+# .. toggle_implementation: CourseWaffleFlag
+# .. toggle_default: False
+# .. toggle_description: Enables the in-platform transcript editor in Studio's
+#   videos page. When enabled, course staff can open an editor modal from the
+#   transcript row action menu and edit transcript cue text directly in the
+#   browser; edits are saved via PATCH to a new v1 transcript endpoint. When
+#   disabled, the "Edit transcript" menu item is hidden and the API endpoint
+#   returns 404. Existing upload, download, and delete flows are unaffected.
+# .. toggle_use_cases: open_edx
+# .. toggle_creation_date: 2026-05-05
+# .. toggle_tickets: TNL2-608
+ENABLE_TRANSCRIPT_EDITOR = CourseWaffleFlag(
+    'contentstore.enable_transcript_editor',
+    __name__,
+)
+
+
+def transcript_editor_enabled(course_key):
+    """
+    Return True if the in-platform transcript editor is enabled for the course.
+    """
+    return ENABLE_TRANSCRIPT_EDITOR.is_enabled(course_key)
+
+
 # .. toggle_name: legacy_studio.exam_settings
 # .. toggle_implementation: WaffleFlag
 # .. toggle_default: False

cms/djangoapps/contentstore/transcript_storage_handlers.py

@@ -181,6 +181,9 @@ def upload_transcript(request):
     new_language_code = request.POST['new_language_code']
     transcript_file = request.FILES['file']
     try:
+        # Determine whether this upload replaces an existing transcript
+        # (return 200) or creates a new one (return 201).
+        is_replace = new_language_code in get_available_transcript_languages(video_id=edx_video_id)
         # Convert SRT transcript into an SJSON format
         # and upload it to S3.
         sjson_subs = Transcript.convert(
@@ -198,7 +201,7 @@ def upload_transcript(request):
             },
             file_data=ContentFile(sjson_subs),
         )
-        response = JsonResponse(status=201)
+        response = JsonResponse(status=200 if is_replace else 201)
     except (TranscriptsGenerationException, UnicodeDecodeError):
         LOGGER.error("Unable to update transcript on edX video %s for language %s", edx_video_id, new_language_code)
         response = JsonResponse(