Merge branch 'production' into maddy/email-security-pcx-16837

Author: Maddy-Cloudflare

.github/CODEOWNERS

@@ -203,6 +203,7 @@
 /src/content/docs/dmarc-management/ @Maddy-Cloudflare @cloudflare/pcx-technical-writing
 /src/content/docs/firewall/ @pedrosousa @cloudflare/firewall @cloudflare/pcx-technical-writing
 /src/content/docs/page-shield/ @pedrosousa @cloudflare/pcx-technical-writing
+/src/content/docs/secrets-store/ @RebeccaTamachiro @cloudflare/pcx-technical-writing
 /src/content/docs/security-center/ @jason-cf @cloudflare/pcx-technical-writing
 /src/content/docs/ssl/ @RebeccaTamachiro @cloudflare/pcx-technical-writing
 /src/content/docs/waf/ @pedrosousa @cloudflare/firewall @cloudflare/pcx-technical-writing

package-lock.json

@@ -36,7 +36,7 @@
 		"@astrojs/starlight-docsearch": "0.6.0",
 		"@astrojs/starlight-tailwind": "3.0.1",
 		"@astrojs/tailwind": "5.1.5",
-		"@cloudflare/vitest-pool-workers": "0.8.12",
+		"@cloudflare/vitest-pool-workers": "0.8.14",
 		"@cloudflare/workers-types": "4.20250404.0",
 		"@codingheads/sticky-header": "1.0.2",
 		"@expressive-code/plugin-collapsible-sections": "0.40.2",
@@ -50,7 +50,7 @@
 		"@types/node": "22.14.0",
 		"@types/react": "19.0.7",
 		"@types/react-dom": "19.0.4",
-		"@typescript-eslint/parser": "8.29.0",
+		"@typescript-eslint/parser": "8.29.1",
 		"algoliasearch": "5.23.3",
 		"astro": "5.6.1",
 		"astro-breadcrumbs": "3.3.1",
@@ -75,7 +75,7 @@
 		"he": "1.2.0",
 		"jsonc-parser": "3.3.1",
 		"lz-string": "1.5.0",
-		"marked": "15.0.7",
+		"marked": "15.0.8",
 		"mdast-util-from-markdown": "2.0.2",
 		"mdast-util-mdx": "3.0.0",
 		"mdast-util-mdx-expression": "2.0.1",
@@ -117,7 +117,7 @@
 		"ts-blank-space": "0.6.1",
 		"tsx": "4.19.3",
 		"typescript": "5.8.3",
-		"typescript-eslint": "8.29.0",
+		"typescript-eslint": "8.29.1",
 		"unified": "11.0.5",
 		"unist-util-visit": "5.0.0",
 		"vite-tsconfig-paths": "5.1.4",

package.json

@@ -264,7 +264,7 @@
 /cache/how-to/edge-browser-cache-ttl/create-page-rules/ /cache/how-to/cache-rules/ 301
 
 # Cloudflare Calls
-/calls/turn/overview/ /calls/turn/ 301
+/calls/turn/overview/ /realtime/turn/ 301
 
 # china network
 /support/about-cloudflare/enterprise-documentation/understanding-and-configuring-an-icp-number/ /china-network/concepts/icp/ 301
@@ -1948,3 +1948,6 @@
 /fundamentals/notifications/* /notifications/:splat 301
 /support/other-languages/* /support/ 301
 /support/speed/* /speed/ 301
+
+# Calls
+/calls/* /realtime/:splat 301

public/__redirects

@@ -1,10 +1,10 @@
 openapi: 3.0.0
 info:
-  title: Cloudflare Calls API
+  title: Cloudflare Realtime API
   version: "1.0"
 externalDocs:
-  description: Find out more about Cloudflare Calls
-  url: https://developers.cloudflare.com/calls/
+  description: Find out more about Cloudflare Realtime
+  url: https://developers.cloudflare.com/realtime/
 servers:
   - url: https://rtc.live.cloudflare.com/v1
 paths:
@@ -140,6 +140,17 @@ paths:
                       sessionId: 2a45361d5fd7cc14eface0587c276c94
                       trackName: generated-audio
                       kind: "audio"
+              remote_track_with_simulcast:
+                description: Pull a remote track with simulcast preferences
+                value:
+                  tracks:
+                    - location: remote
+                      sessionId: 2a45361d5fd7cc14eface0587c276c94
+                      trackName: simulcast-video-track
+                      simulcast:
+                        preferredRid: "h"
+                        priorityOrdering: "asciibetical"
+                        ridUnavailableStrategy: "nextPriority"
       security:
         - secret: []
       parameters:
@@ -207,6 +218,32 @@ paths:
                         a=rtpmap:96 VP8/90000
                         ...
                       type: offer
+                remote_tracks_with_simulcast:
+                  value:
+                    requiresImmediateRenegotiation: true
+                    tracks:
+                      - sessionId: 2a45361d5fd7cc14eface0587c276c94
+                        trackName: simulcast-video-track
+                        mid: "5"
+                        simulcast:
+                          preferredRid: "h"
+                          priorityOrdering: "asciibetical"
+                          ridUnavailableStrategy: "nextPriority"
+                    sessionDescription:
+                      sdp: |
+                        v=0
+                        o=- 0 0 IN IP4 127.0.0.1
+                        s=-
+                        c=IN IP4 127.0.0.1
+                        t=0 0
+                        m=video 4002 RTP/AVP 96
+                        a=rtpmap:96 VP8/90000
+                        a=simulcast:recv f;h;q
+                        a=rid:f recv
+                        a=rid:h recv
+                        a=rid:q recv
+                        ...
+                      type: offer
   /apps/{appId}/sessions/{sessionId}/renegotiate:
     put:
       tags:
@@ -329,6 +366,73 @@ paths:
                 requiresImmediateRenegotiation: false
                 tracks:
                   - mid: "7"
+  /apps/{appId}/sessions/{sessionId}/tracks/update:
+    put:
+      tags:
+        - Change tracks
+      summary: Change tracks by reusing existing transceivers
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/UpdateTracksRequest"
+            examples:
+              reuse_transceiver:
+                description: Reuse an existing transceiver for a new track
+                value:
+                  tracks:
+                    - location: "remote"
+                      sessionId: "2a45361d5fd7cc14eface0587c276c94"
+                      trackName: "other-track-name"
+                      mid: "7"
+              reuse_with_simulcast:
+                description: Reuse an existing transceiver with new simulcast preferences
+                value:
+                  tracks:
+                    - location: "remote"
+                      sessionId: "2a45361d5fd7cc14eface0587c276c94"
+                      trackName: "simulcast-track"
+                      mid: "8"
+                      simulcast:
+                        preferredRid: "h"
+                        priorityOrdering: "asciibetical"
+                        ridUnavailableStrategy: "nextPriority"
+      security:
+        - secret: []
+      parameters:
+        - in: path
+          name: appId
+          schema:
+            type: string
+          required: true
+          description: WebRTC application ID
+        - in: path
+          name: sessionId
+          schema:
+            type: string
+          required: true
+          description: Current PeerConnection session ID
+      responses:
+        "200":
+          description: OK
+          headers:
+            vary:
+              schema:
+                type: string
+                example: Origin
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/UpdateTracksResponse"
+              examples:
+                success:
+                  value:
+                    requiresImmediateRenegotiation: false
+                    tracks:
+                      - mid: "7"
+                        sessionId: "2a45361d5fd7cc14eface0587c276c94"
+                        trackName: "new-track-name"
+
   /apps/{appId}/sessions/{sessionId}:
     get:
       tags:
@@ -412,6 +516,27 @@ components:
         kind:
           type: string
           description: Give a hint to the SFU about the transceiver kind. This is required when the SFU generates the offer
+        simulcast:
+          type: object
+          description: Simulcast configuration for the track
+          properties:
+            preferredRid:
+              type: string
+              description: Preferred RID for simulcast streams
+            priorityOrdering:
+              type: string
+              enum:
+                - none
+                - asciibetical
+              default: none
+              description: Controls what happens if there is not enough network resources available to send the preferredRid. 'none' means keep sending even if not enough bandwidth, 'asciibetical' uses a-z order to determine priority where a is most desirable and z is least desirable.
+            ridUnavailableStrategy:
+              type: string
+              enum:
+                - none
+                - nextPriority
+              default: none
+              description: Controls what happens when the rid currently being used or preferredRid is no longer being sent by the publisher. 'none' means do nothing, 'nextPriority' uses the next on the priorityOrdering.
     CloseTrackObject:
       type: object
       properties:
@@ -543,3 +668,44 @@ components:
           type: string
         sessionDescription:
           $ref: "#/components/schemas/SessionDescription"
+    ChangeTracksRequest:
+      type: object
+      properties:
+        tracks:
+          type: object
+          additionalProperties:
+            allOf:
+              - $ref: "#/components/schemas/TrackObject"
+          description: Map of track IDs to track objects for changing tracks
+        sessionDescription:
+          $ref: "#/components/schemas/SessionDescription"
+    UpdateTracksRequest:
+      type: object
+      properties:
+        tracks:
+          type: array
+          items:
+            $ref: "#/components/schemas/TrackObject"
+          description: Array of track objects for updating tracks
+        sessionDescription:
+          $ref: "#/components/schemas/SessionDescription"
+    UpdateTracksResponse:
+      type: object
+      properties:
+        errorCode:
+          type: string
+        errorDescription:
+          type: string
+        requiresImmediateRenegotiation:
+          type: boolean
+        tracks:
+          type: array
+          items:
+            allOf:
+              - $ref: "#/components/schemas/TrackObject"
+              - properties:
+                  errorCode:
+                    type: string
+                  errorDescription:
+                    type: string
+          description: Array of track objects with results