Merge commit '7a3c9a2fd29bdd89706b4a8a3f362fa48edd0e2c' into jun/do/alarm-invocation-detail

Author: Oxyjun

src/content/docs/d1/examples/query-d1-from-python-workers.mdx

@@ -81,7 +81,7 @@ The value of `binding` is how you will refer to your database from within your W
 To create a Python Worker, create an empty file at `src/entry.py`, matching the value of `main` in your Wrangler file with the contents below:
 
 ```python
-from js import Response
+from workers import Response
 
 async def on_fetch(request, env):
     # Do anything else you'd like on request here!

src/content/docs/reference-architecture/architectures/load-balancing.mdx

@@ -11,6 +11,12 @@ description: Review common troubleshooting scenarios for Rules features.
 
 import { Example, Render } from "~/components";
 
+## Interaction between redirects and other Cloudflare products
+
+Your redirects may interfere with Cloudflare products and features such as challenges. Consider excluding the [`/cdn-cgi/*` URI path](/fundamentals/reference/cdn-cgi-endpoint/) in your rule expression to avoid issues. Alternatively, you may exclude only a sub-path such as `/cdn-cgi/challenge-platform/*` to avoid issues with specific features (in this example, [Cloudflare challenges](#interaction-between-cloudflare-challenges-and-rules-features)).
+
+You may also want to exclude the `/.well-known/*` URL path used by several validation services. Refer to [Interaction between redirects and verification procedures like HTTP DCV](#interaction-between-redirects-and-verification-procedures-like-http-dcv) for more information.
+
 ## Interaction between Cloudflare challenges and Rules features
 
 If you are issuing a [challenge](/waf/reference/cloudflare-challenges/) for a given URI path that has one or more Rules features enabled, you should exclude URI paths starting with `/cdn-cgi/challenge-platform/` in your rule expressions to avoid challenge loops.
@@ -21,11 +27,11 @@ For example, define a compound expression for your rule using the `and` operator
 <OTHER_RULE_CONDITIONS> and not starts_with(http.request.uri, "/cdn-cgi/challenge-platform/")
 ```
 
-## HTTP DCV and redirects
+## Interaction between redirects and verification procedures like HTTP DCV
 
-<Render file="dcv-definition" product="ssl" />
+Paths used in validation procedures such as custom hostname verification (Cloudflare for SaaS), [Pages domain validation](/pages/configuration/debugging-pages/), or [HTTP domain control validation (DCV)](/ssl/edge-certificates/changing-dcv-method/methods/http/) may be affected by redirects.
 
-If you are using [HTTP DCV](/ssl/edge-certificates/changing-dcv-method/methods/http/) and also have [Single Redirects](/rules/url-forwarding/single-redirects/) set up in your zone, consider excluding the `/.well-known/*` path from your rule to avoid DCV issues. For details and other resources refer to the [SSL/TLS documentation](/ssl/edge-certificates/changing-dcv-method/).
+Consider excluding the `/.well-known/*` URI path from your rule to avoid issues.
 
 ## Content-Length header removed from response
 

src/content/docs/rules/page-rules/reference/settings.mdx

@@ -35,7 +35,7 @@ For more information on deploying and configuring rulesets using the Rulesets AP
 
 ## Example: Configure HTTP DDoS Attack Protection
 
-This example configures the [HTTP DDoS Attack Protection](/ddos-protection/managed-rulesets/http/) managed ruleset for a zone using Terraform, changing the sensitivity level of rule with ID <RuleID id="fdfdac75430c4c47a959592f0aa5e68a" /> to `low`.
+This example configures the [HTTP DDoS Attack Protection](/ddos-protection/managed-rulesets/http/) managed ruleset for a zone using Terraform.
 
 <Render file="v4-code-snippets" />
 
@@ -48,21 +48,36 @@ resource "cloudflare_ruleset" "zone_level_http_ddos_config" {
   phase       = "ddos_l7"
 
   rules {
-    ref         = "override_l7_ddos_ruleset_all"
-    description = "Override the HTTP DDoS Attack Protection managed ruleset"
-    expression  = "true"
-    action      = "execute"
+    action = "execute"
     action_parameters {
       # Cloudflare L7 DDoS Attack Protection Ruleset
       id = "4d21379b4f9f4bb088e0729962c8b3cf"
       overrides {
+        action = "block"
+        sensitivity_level = "default"
         rules {
-          # Rule: HTTP requests with unusual HTTP headers or URI path (signature #11).
-          id                = "fdfdac75430c4c47a959592f0aa5e68a"
-          sensitivity_level = "low"
+          # Adaptive DDoS Protection based on Locations (Available only to Enterprise zones with Advanced DDoS service)
+          id = "a8c6333711ff4b0a81371d1c444be2c3"
+          sensitivity_level = "default"    
+          action = "managed_challenge"      
+        }
+        rules {
+          # Adaptive DDoS Protection based on User-Agents (Available only to Enterprise zones with Advanced DDoS service)
+          id = "7709d496081e458899c1e3a6e4fe8e55"
+          sensitivity_level = "default"  
+          action = "managed_challenge"        
+        }
+        rules {
+          # HTTP requests causing a high number of origin errors.
+          id = "dd42da7baabe4e518eaf11c393596a9d"
+          sensitivity_level = "default"
+          action = "managed_challenge"
         }
       }
     }
+    expression = "true"
+    description = "Zone-wide HTTP DDoS Override"
+    enabled = true
   }
 }
 ```

src/content/docs/rules/reference/troubleshooting.mdx

@@ -111,7 +111,7 @@ export default {
 
 ```py
 import re
-from js import Response, Headers
+from workers import Response
 
 CSS = "body { color: red; }"
 HTML = """
@@ -129,11 +129,11 @@ HTML = """
 """
 def on_fetch(request):
     if re.search("test.css", request.url):
-        headers = Headers.new({"content-type": "text/css"}.items())
-        return Response.new(CSS, headers=headers)
+        headers = {"content-type": "text/css"}
+        return Response(CSS, headers=headers)
     else:
-        headers = Headers.new({"content-type": "text/html","link": "</test.css>; rel=preload; as=style"}.items())
-        return Response.new(HTML, headers=headers)
+        headers = {"content-type": "text/html","link": "</test.css>; rel=preload; as=style"}
+        return Response(HTML, headers=headers)
 ```
 
 </TabItem> </Tabs>

src/content/docs/terraform/additional-configurations/ddos-managed-rulesets.mdx

@@ -100,7 +100,7 @@ export default {
 ```py
 import random
 from urllib.parse import urlparse, urlunparse
-from js import Response, Headers, fetch
+from workers import Response, fetch
 
 NAME = "myExampleWorkersABTest"
 
@@ -132,8 +132,7 @@ async def on_fetch(request):
         res = await fetch(urlunparse(url))
         headers = dict(res.headers)
         headers["Set-Cookie"] = f'{NAME}={group}; path=/'
-        headers  = Headers.new(headers.items())
-        return Response.new(res.body, headers=headers)
+        return Response(res.body, headers=headers)
 
     return fetch(urlunparse(url))
 ```

src/content/docs/workers/examples/103-early-hints.mdx

@@ -60,13 +60,14 @@ export default {
 
 ```py
 import json
-from js import Response, Headers, JSON
+from workers import Response
+from js import JSON
 
 def on_fetch(request):
     error = json.dumps({ "error": "The `cf` object is not available inside the preview." })
     data = request.cf if request.cf is not None else error
-    headers = Headers.new({"content-type":"application/json"}.items())
-    return Response.new(JSON.stringify(data, None, 2), headers=headers)
+    headers = {"content-type":"application/json"}
+    return Response(JSON.stringify(data, None, 2), headers=headers)
 ```
 
 </TabItem> </Tabs>

src/content/docs/workers/examples/ab-testing.mdx

@@ -61,19 +61,21 @@ export default {
 </TabItem> <TabItem label="Python" icon="seti:python">
 
 ```py
-from js import Response, fetch, Headers, JSON, Promise
+from workers import Response, fetch
+import asyncio
+import json
 
 async def on_fetch(request):
     # some_host is set up to return JSON responses
     some_host = "https://jsonplaceholder.typicode.com"
     url1 = some_host + "/todos/1"
     url2 = some_host + "/todos/2"
 
-    responses = await Promise.all([fetch(url1), fetch(url2)])
-    results = await Promise.all(map(lambda r: r.json(), responses))
+    responses = await asyncio.gather(fetch(url1), fetch(url2))
+    results = await asyncio.gather(*(r.json() for r in responses))
 
-    headers = Headers.new({"content-type": "application/json;charset=UTF-8"}.items())
-    return Response.new(JSON.stringify(results), headers=headers)
+    headers = {"content-type": "application/json;charset=UTF-8"}
+    return Response.json(results, headers=headers)
 ```
 
 </TabItem> </Tabs>

src/content/docs/workers/examples/accessing-the-cloudflare-object.mdx

@@ -80,28 +80,27 @@ export default {
 </TabItem> <TabItem label="Python" icon="seti:python">
 
 ```py
-from js import Response, fetch
+from workers import Response, fetch
 
 async def on_fetch(request):
     response = await fetch("https://example.com")
 
-    # Clone the response so that it's no longer immutable
-    new_response = Response.new(response.body, response)
+    # Grab the response headers so they can be modified
+    new_headers = response.headers
 
     # Add a custom header with a value
-    new_response.headers.append(
-      "x-workers-hello",
-      "Hello from Cloudflare Workers"
-    )
-
+    new_headers["x-workers-hello"] = "Hello from Cloudflare Workers"
+    
     # Delete headers
-    new_response.headers.delete("x-header-to-delete")
-    new_response.headers.delete("x-header2-to-delete")
+    if "x-header-to-delete" in new_headers:
+        del new_headers["x-header-to-delete"]
+    if "x-header2-to-delete" in new_headers:
+        del new_headers["x-header2-to-delete"]
 
     # Adjust the value for an existing header
-    new_response.headers.set("x-header-to-change", "NewValue")
+    new_headers["x-header-to-change"] = "NewValue"
 
-    return new_response
+    return Response(response.body, headers=new_headers)
 ```
 
 </TabItem> </Tabs>