Cloudflare/tunnel

@webframp/cloudflare/tunnelv2026.08.21.1· 1d agoMODELS

01README

Cloudflare Tunnel — tunnel management, configurations, connections

02Release Notes

2026.08.21.1

Changed: Errors and validation now say what went wrong and where.

Cloudflare API failures (HTTP errors and success: false API responses) now name the HTTP method and path that was attempted, in addition to the original status/message. Previously the error read only Cloudflare API error: <message>, with no indication of which endpoint the method call was hitting — now it reads Cloudflare API request failed: GET /accounts/<account>/cfd_tunnel/<id>: <message>. This applies to every method on this model, since they all share the same request helper.
tunnel_id and connector_id are now validated as non-empty before any request is made. Passing an empty string previously sent a request to a malformed URL and produced a confusing 404 from Cloudflare; each now fails fast with a <field> must not be empty message.

Upgrade note: No method was added, removed, or renamed. Existing callers that always pass non-empty identifiers see no behavioral change beyond clearer error text.

03Models1

@webframp/cloudflare/tunnelv2026.08.21.1cloudflare/tunnel.ts

Global Arguments

Argument	Type	Required	Description
apiToken	string	yes	Cloudflare API token
accountId	string	yes	Cloudflare account ID

fn list_cloudflare_tunnels(name?: string, is_deleted?: boolean, existed_at?: string, uuid?: string, was_active_at?: string, was_inactive_at?: string, include_prefix?: string, exclude_prefix?: string, status?: string, per_page?: string, page?: string)

List Cloudflare Tunnels

Argument	Type	Required
name?	string	no
is_deleted?	boolean	no
existed_at?	string	no
uuid?	string	no
was_active_at?	string	no
was_inactive_at?	string	no
include_prefix?	string	no
exclude_prefix?	string	no
status?	string	no
per_page?	string	no
page?	string	no

fn create_a_cloudflare_tunnel(config_src?: unknown, name: unknown, tunnel_secret?: unknown)

Create a Cloudflare Tunnel

Argument	Type	Required
config_src?	unknown	no
name	unknown	yes
tunnel_secret?	unknown	no

fn get_a_cloudflare_tunnel(tunnel_id: string)

Get a Cloudflare Tunnel

Argument	Type	Required	Description
tunnel_id	string	yes

fn update_a_cloudflare_tunnel(tunnel_id: string, name?: unknown, tunnel_secret?: unknown)

Update a Cloudflare Tunnel

Argument	Type	Required
tunnel_id	string	yes
name?	unknown	no
tunnel_secret?	unknown	no

fn delete_a_cloudflare_tunnel(tunnel_id: string)

Delete a Cloudflare Tunnel

Argument	Type	Required	Description
tunnel_id	string	yes

fn get_configuration(tunnel_id: string)

Get configuration

Argument	Type	Required	Description
tunnel_id	string	yes

fn put_configuration(tunnel_id: string, config?: unknown)

Put configuration

Argument	Type	Required	Description
tunnel_id	string	yes
config?	unknown	no

fn list_cloudflare_tunnel_connections(tunnel_id: string)

List Cloudflare Tunnel connections

Argument	Type	Required	Description
tunnel_id	string	yes

fn delete_cloudflare_tunnel_clean_up_cloudflare_tunnel_connections(tunnel_id: string, client_id?: string)

Clean up Cloudflare Tunnel connections

Argument	Type	Required	Description
tunnel_id	string	yes
client_id?	string	no

fn get_cloudflare_tunnel_connector(tunnel_id: string, connector_id: string)

Get Cloudflare Tunnel connector

Argument	Type	Required	Description
tunnel_id	string	yes
connector_id	string	yes

fn get_a_cloudflare_tunnel_management_token(tunnel_id: string, resources: array)

Get a Cloudflare Tunnel management token

Argument	Type	Required	Description
tunnel_id	string	yes
resources	array	yes

fn get_a_cloudflare_tunnel_token(tunnel_id: string)

Get a Cloudflare Tunnel token

Argument	Type	Required	Description
tunnel_id	string	yes

fn list_all_tunnels(name?: string, is_deleted?: boolean, existed_at?: string, uuid?: string, was_active_at?: string, was_inactive_at?: string, include_prefix?: string, exclude_prefix?: string, tun_types?: string, status?: string, per_page?: string, page?: string)

List All Tunnels

Argument	Type	Required
name?	string	no
is_deleted?	boolean	no
existed_at?	string	no
uuid?	string	no
was_active_at?	string	no
was_inactive_at?	string	no
include_prefix?	string	no
exclude_prefix?	string	no
tun_types?	string	no
status?	string	no
per_page?	string	no
page?	string	no

Resources

cloudflare_tunnels(infinite)— List Cloudflare Tunnels

a_cloudflare_tunnel(infinite)— Create a Cloudflare Tunnel

configuration(infinite)— Get configuration

put_configuration(infinite)— Put configuration

cloudflare_tunnel_connections(infinite)— List Cloudflare Tunnel connections

cloudflare_tunnel_connector(infinite)— Get Cloudflare Tunnel connector

a_cloudflare_tunnel_management_token(infinite)— Get a Cloudflare Tunnel management token

a_cloudflare_tunnel_token(infinite)— Get a Cloudflare Tunnel token

all_tunnels(infinite)— List All Tunnels

04Previous Versions2

2026.07.27.1Jul 27, 2026

2026.07.27.1

Fixed: Regenerated from scripts/cloudflare-codegen after two generator bugs were repaired (webframp/swamp-extensions#284).

Methods referencing an undeclared path parameter did not compile. The generator derived a method's arguments schema and execute signature from the OpenAPI parameters list, but built the request URL from the path template. Where the Cloudflare spec omits a declaration for a {placeholder} — which it does in several places — the result was a method with arguments: z.object({}) and an unused _args parameter whose body still interpolated args.<name>. Those methods failed type checking and were uncallable even if they had compiled, because the argument was never declared. Path-template placeholders are now unioned into the declared parameters, so the schema, the signature, and the body agree.
Generated tests could request a URL the mock server did not serve. Test arguments merged the request-body fixture over the path-parameter values, so a body property sharing a name with a path parameter (commonly id) substituted its own example value into the URL. The request then missed the mock and failed with Cloudflare API error: Not found. Path parameters now take precedence, matching what the generated model already does by excluding path-parameter names from the request body.

Upgrade note: No API surface change and no method was added or removed. If this extension type-checked and tested cleanly before, its behavior is unchanged and only the version moved. Extensions that previously failed deno check or deno task test now pass.

2026.07.19.1Jul 19, 2026