Cloudflare/pages

@webframp/cloudflare/pagesv2026.07.27.1· 5d agoMODELS

01README

Cloudflare Pages — projects, deployments, domains, build configs

02Release Notes

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.

03Models1

@webframp/cloudflare/pagesv2026.07.27.1cloudflare/pages.ts

Global Arguments

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

fn get_projects(page?: number, per_page?: number)

Get projects

Argument	Type	Required	Description
page?	number	no
per_page?	number	no

fn create_project(build_config?: object, deployment_configs?: object, name: string, production_branch: string, source?: object)

Create project

Argument	Type	Required	Description
build_config?	object	no	Configs for the project build process.
deployment_configs?	object	no	Configs for deployments in a project.
name	string	yes	Name of the project.
production_branch	string	yes	Production branch of the project. Used to identify production deployments.
source?	object	no	Configs for the project source control.

fn get_project(project_name: string)

Get project

Argument	Type	Required	Description
project_name	string	yes

fn update_project(project_name: string, build_config?: object, deployment_configs?: object, name?: string, production_branch?: string, source?: object)

Update project

Argument	Type	Required	Description
project_name	string	yes
build_config?	object	no	Configs for the project build process.
deployment_configs?	object	no	Configs for deployments in a project.
name?	string	no	Name of the project.
production_branch?	string	no	Production branch of the project. Used to identify production deployments.
source?	object	no	Configs for the project source control.

fn delete_project(project_name: string)

Delete project

Argument	Type	Required	Description
project_name	string	yes

fn get_deployments(project_name: string, env?: enum, page?: number, per_page?: number)

Get deployments

Argument	Type	Required
project_name	string	yes
env?	enum	no
page?	number	no
per_page?	number	no

fn create_deployment(project_name: string)

Create deployment

Argument	Type	Required	Description
project_name	string	yes

fn get_deployment_info(deployment_id: string, project_name: string)

Get deployment info

Argument	Type	Required	Description
deployment_id	string	yes
project_name	string	yes

fn delete_deployment(deployment_id: string, project_name: string, force?: boolean)

Delete deployment

Argument	Type	Required
deployment_id	string	yes
project_name	string	yes
force?	boolean	no

fn get_deployment_logs(deployment_id: string, project_name: string)

Get deployment logs

Argument	Type	Required	Description
deployment_id	string	yes
project_name	string	yes

fn pages_deployment_retry_deployment(deployment_id: string, project_name: string)

Retry deployment

Argument	Type	Required	Description
deployment_id	string	yes
project_name	string	yes

fn pages_deployment_rollback_deployment(deployment_id: string, project_name: string)

Rollback deployment

Argument	Type	Required	Description
deployment_id	string	yes
project_name	string	yes

fn create_tail(deployment_id: string, project_name: string, filters?: array)

Create deployment tail

Argument	Type	Required	Description
deployment_id	string	yes
project_name	string	yes
filters?	array	no	Filters to apply to the tail session.

fn delete_tail(tail_id: string, deployment_id: string, project_name: string)

Delete deployment tail

Argument	Type	Required
tail_id	string	yes
deployment_id	string	yes
project_name	string	yes

fn get_domains(project_name: string)

Get domains

Argument	Type	Required	Description
project_name	string	yes

fn create_pages_domains_add_domain(project_name: string, name: unknown)

Add domain

Argument	Type	Required	Description
project_name	string	yes
name	unknown	yes

fn get_domain(domain_name: string, project_name: string)

Get domain

Argument	Type	Required	Description
domain_name	string	yes
project_name	string	yes

fn patch_domain(domain_name: string, project_name: string)

Patch domain

Argument	Type	Required	Description
domain_name	string	yes
project_name	string	yes

fn delete_domain(domain_name: string, project_name: string)

Delete domain

Argument	Type	Required	Description
domain_name	string	yes
project_name	string	yes

fn pages_purge_build_cache(project_name: string)

Purge build cache

Argument	Type	Required	Description
project_name	string	yes

fn create_pages_project_connect_project_source(project_name: string, config: object, type: enum)

Connect project source

Argument	Type	Required	Description
project_name	string	yes
config	object	yes
type	enum	yes	The source control management provider.

fn delete_pages_project_disconnect_project_source(project_name: string)

Disconnect project source

Argument	Type	Required	Description
project_name	string	yes

fn get_upload_token(project_name: string)

Get upload token

Argument	Type	Required	Description
project_name	string	yes

Resources

get_projects(infinite)— Get projects

project(infinite)— Create project

get_deployments(infinite)— Get deployments

deployment(infinite)— Create deployment

deployment_info(infinite)— Get deployment info

deployment_logs(infinite)— Get deployment logs

pages_deployment_retry_deployment(infinite)— Retry deployment

pages_deployment_rollback_deployment(infinite)— Rollback deployment

tail(infinite)— Create deployment tail

get_domains(infinite)— Get domains

pages_domains_add_domain(infinite)— Add domain

domain(infinite)— Get domain

patch_domain(infinite)— Patch domain

pages_purge_build_cache(infinite)— Purge build cache

pages_project_connect_project_source(infinite)— Connect project source

upload_token(infinite)— Get upload token

04Previous Versions1

2026.07.19.1Jul 19, 2026

2026.07.19.1

Added: Initial code-generated release of @webframp/cloudflare/pages with 23 methods covering the Cloudflare pages API surface.

05Stats

100 / 100

Downloads

Archive size

14.2 KB

Has README or module doc2/2earned
README has a code example1/1earned
README is substantive1/1earned
Most symbols documented1/1earned
No slow types (deprecated)1/1earned
Dependencies pass trust audit2/2earned
Has description1/1earned
Platform support declared (or universal)2/2earned
License declared1/1earned
Verified public repository2/2earned

Repository

https://github.com/webframp/swamp-extensions

06Platforms

linux · x86_64 linux · aarch64 macOS · x86_64 macOS · aarch64

07Labels

#cloudflare #pages #jamstack #deployment