Thomas Gauvin

This commit significantly **enhances the documentation** for **Workers VPC**, providing users with improved resources for troubleshooting and understanding new features. It introduces a **comprehensive error code reference** to the `troubleshooting.mdx` guide, categorizing common connection issues like 'Bad Upstream', 'Client', and 'Internal' errors, each with descriptions and recommended fixes, while also restructuring existing tunnel error information. Additionally, a new changelog entry in `2026-03-20-metrics-and-settings-dashboard.mdx` details recent observability features, including the **Workers VPC** metrics and settings dashboard. This **documentation update** aims to improve the developer experience by making it easier to diagnose and resolve **Workers VPC** connectivity problems.

This commit **adds a new changelog entry** for the **Hyperdrive** service, specifically documenting the recently introduced **support for custom TLS/SSL certificates** when connecting to **MySQL databases**. This **documentation update** informs users about the enhanced security and flexibility now available for Hyperdrive's database integrations. The entry, located at `src/content/changelog/hyperdrive/2026-03-19-hyperdrive-mysql-custom-certificate-support.mdx`, ensures that this **new capability** is properly announced and discoverable.

This commit introduces **new documentation** for **Wrangler commands** specifically designed for **Workers VPC**. It adds two new pages: `src/content/docs/workers-vpc/reference/wrangler-commands.mdx` which provides a general reference, and `src/content/docs/workers/wrangler/commands/vpc.mdx` which details the usage of these commands. This **documentation update** enhances the discoverability and understanding of how to manage Workers VPC services using Wrangler, improving the developer experience for users interacting with this feature.

This commit introduces a **major new feature** to the **Wrangler CLI**, adding a comprehensive **`tunnel` subsystem** for managing Cloudflare Tunnels directly from the command line. It provides new commands like `wrangler tunnel create`, `list`, `info`, `delete`, `quick-start`, and `run`, enabling full lifecycle management of tunnels. This **new capability** includes robust handling of the `cloudflared` binary, managing its download, caching, and execution, alongside API interactions for tunnel administration. The **Wrangler CLI** is significantly extended, simplifying the workflow for developers to expose local services via Cloudflare Tunnels.

This commit provides significant **documentation updates** for **Hyperdrive's query caching** mechanism, clarifying its interaction with PostgreSQL function volatility. It explicitly states that queries containing `STABLE` or `VOLATILE` PostgreSQL functions are now considered uncacheable, impacting how users understand and optimize their database interactions. The **maintenance** work includes a new changelog entry, expanded details in the `query-caching.mdx` and `troubleshooting.mdx` guides, and clarification of the 'volatile' cache status in `metrics.mdx`. These changes improve user understanding and **troubleshooting** capabilities for Hyperdrive's caching behavior, particularly regarding functions like `STABLE` and `VOLATILE`.

This commit significantly **enhances documentation** for **Workers VPC**, specifically by introducing a new guide on managing **VPC Services** using the **Cloudflare Terraform provider**. A new document, `src/content/docs/workers-vpc/configuration/vpc-services/terraform.mdx`, details this process, while the existing VPC Services documentation (`index.mdx`) is updated with a direct link and various style and content fixes. Furthermore, the general **Infrastructure as Code documentation** is expanded to include a new section on VPC Service bindings, improving the clarity and discoverability of IaC options for Workers.

This commit **improves the documentation** for **Agents** by adding a crucial troubleshooting note regarding the `@callable()` decorator. It addresses a common `SyntaxError: Invalid or unexpected token` by advising users to set their `tsconfig` target to `ES2021` or higher, which is necessary for proper decorator compilation. This **documentation improvement** is applied to both the `src/content/docs/agents/api-reference/callable-methods.mdx` and `src/content/docs/agents/getting-started/quick-start.mdx` files, enhancing the **developer experience** and **onboarding process** for **Agent** creation.

This commit **updates the documentation** for **Workers VPC** to reflect enhanced security capabilities. It introduces a new changelog entry in `src/content/changelog/workers-vpc/2026-02-13-origin-ca-certificate-support.mdx` and expands the `vpc-services.mdx` documentation to detail support for **Cloudflare Origin CA certificates** and general **SSL certificates**. This **documentation update** provides users with crucial information on configuring secure TLS connections within their **Workers VPC** environments, clarifying available certificate options for their services.

This commit **updates the date** within the **Workers KV changelog documentation**. It specifically corrects the publication date for the entry detailing the "reduced minimum cachettl" feature, changing it from January 20th to **January 30th, 2026**. This is a **documentation maintenance** task, ensuring the accuracy of release information for **Workers KV** feature updates.

This commit performs a **documentation update** and adds a **changelog entry** for a significant change in the **Workers KV** service. Specifically, it announces and reflects the **reduction of the minimum cache TTL to 30 seconds**, providing users with greater flexibility for caching short-lived data. The changes span across the `kv` documentation, updating `read-key-value-pairs.mdx`, `limits.mdx`, and `cache-data-with-workers-kv.mdx` to specify and demonstrate the new lower limit, alongside minor formatting in `write-key-value-pairs.mdx`. This **maintenance work** ensures that all relevant user-facing information is current and accurate regarding the enhanced caching capabilities.

This commit significantly **improves the documentation** for **Workers VPC** by providing comprehensive details on **required account roles**. It introduces a new partial file, `src/content/partials/workers-vpc/required-roles.mdx`, which centralizes the necessary permissions for various operations. This crucial information is then integrated into the `api`, `configuration`, `get-started`, and `troubleshooting` guides within the **Workers VPC** documentation. The update helps users understand the necessary roles for binding VPC Services and effectively troubleshoot permission-related errors, thereby enhancing the overall user experience and reducing setup friction.

This commit introduces a **new changelog entry** within the `src/content/changelog/kv` module, documenting a significant **redesign of the Workers KV Dashboard UI**. This **documentation update** highlights the new and improved homepage, along with an enhanced analytics view, providing users with better insights into their **Workers KV** usage. The entry also includes an updated screenshot to accurately reflect the new metrics, ensuring users are well-informed about the latest UI enhancements.

This commit **updates the documentation** for the **Slack agent configuration** to include the `compatibility_flags = ["nodejs_compat"]` setting. This **documentation update** is crucial for users, as it addresses a specific **compatibility issue** where the `mime-types` dependency used by the agent relies on `require('path')`. By providing this explicit configuration guidance in `src/content/docs/agents/guides/slack-agent.mdx`, the commit ensures that users can successfully deploy and run the **Slack agent** without encountering runtime errors related to Node.js compatibility, thereby improving its **usability and reliability**.

This commit **updates the Hyperdrive documentation** by adding a **"Beta" badge** to the sidebar configuration for the **MySQL connection example**. This **documentation enhancement** ensures that users are clearly informed about the experimental status of the Hyperdrive MySQL connector. The change specifically affects the `src/content/docs/hyperdrive/examples/connect-to-mysql/index.mdx` file, improving the clarity and accuracy of the user-facing documentation for this specific integration.

This commit **updates the documentation** for the **Sandbox API**, specifically clarifying the `ExposePortResponse` return value. It corrects an inaccuracy in `src/content/docs/sandbox/api/ports.mdx`, stating that the preview URL field is named `url` instead of the previously documented `exposedAt`. This **documentation fix** ensures developers correctly understand the API response structure, preventing potential integration issues when consuming the `ExposePortResponse`.

This commit **removes the dedicated PostgreSQL connection pool** from the project's dependencies and operational logic. It represents a significant **refactoring** of the **database connection management** subsystem, impacting how the application establishes and maintains connections to the PostgreSQL database. This change likely aims to streamline the architecture or transition to an alternative connection handling strategy, potentially affecting resource utilization and performance for all **PostgreSQL interactions**.

This commit introduces a **new capability** for **Hyperdrive's local development workflow**, enabling `wrangler dev` to connect to remote databases. Developers can now use `wrangler dev --remote` and configure `localConnectionString` to test their Hyperdrive applications against production-like remote databases, significantly enhancing the realism of local testing. This **feature addition** improves the developer experience by providing a more flexible and accurate environment for Hyperdrive development. The changes are comprehensively documented across **Hyperdrive documentation**, including the changelog, local development configuration guide, and get-started instructions.

This commit **updates the documentation** for **Hyperdrive**, specifically within the `src/content/docs/hyperdrive/examples/connect-to-postgres/postgres-database-providers/supabase.mdx` guide. It adds a crucial note advising users to employ the **direct connection string** when connecting Hyperdrive to a **Supabase** database. This **documentation update** clarifies that Hyperdrive inherently handles connection pooling, making Supabase's built-in pooling redundant and potentially problematic if not bypassed. The change aims to improve user understanding and prevent misconfigurations for developers integrating these services, ensuring optimal performance and stability.

This commit **updates the documentation** for **Email Workers**, specifically revising the navigation instructions for enabling the feature within the Cloudflare dashboard. It addresses the content of `src/content/docs/email-routing/email-workers/enable-email-workers.mdx` to provide **accurate and current guidance** to users. This is a **documentation maintenance** task, ensuring that the public-facing instructions for setting up email routing remain correct. The update improves the user experience by preventing confusion during the Email Workers activation process.

This commit **introduces comprehensive documentation** for **Hyperdrive's connection pooling**, specifically detailing how to configure and tune these pools for optimal performance. The new content in `src/content/docs/hyperdrive/configuration/tune-connection-pool.mdx` outlines best practices and related resources for managing connections. This **documentation update** empowers users to effectively manage and optimize Hyperdrive's resource utilization and overall system performance.