Skip to main content

Cloudflare/pages

@webframp/cloudflare/pagesv2026.09.15.1· 1d agoMODELS
01README

Cloudflare Pages — projects, deployments, domains, build configs

02Release Notes

2026.09.15.1

Changed: Bump zod 4.4.3 → 4.6.5

2026.08.28.2

Hardened codegen: instance names sanitized against path traversal; 429 rate-limit retry with Retry-After; string schema patterns emit regex validation; output schemas passthrough unknown fields; apiToken now optional and vault-wireable with CLOUDFLARE_API_TOKEN env fallback.

03Models1
@webframp/cloudflare/pagesv2026.09.15.1cloudflare/pages.ts

Global Arguments

ArgumentTypeDescription
apiToken?stringCloudflare API token; overrides the CLOUDFLARE_API_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
accountIdstringCloudflare account ID
fn get_projects(page?: number, per_page?: number)
Get projects
ArgumentTypeDescription
page?number
per_page?number
fn create_project(build_config?: object, deployment_configs?: object, name: string, production_branch: string, source?: object)
Create project
ArgumentTypeDescription
build_config?objectConfigs for the project build process.
deployment_configs?objectConfigs for deployments in a project.
namestringName of the project.
production_branchstringProduction branch of the project. Used to identify production deployments.
source?objectConfigs for the project source control.
fn get_project(project_name: string)
Get project
ArgumentTypeDescription
project_namestring
fn update_project(project_name: string, build_config?: object, deployment_configs?: object, name?: string, production_branch?: string, source?: object)
Update project
ArgumentTypeDescription
project_namestring
build_config?objectConfigs for the project build process.
deployment_configs?objectConfigs for deployments in a project.
name?stringName of the project.
production_branch?stringProduction branch of the project. Used to identify production deployments.
source?objectConfigs for the project source control.
fn delete_project(project_name: string)
Delete project
ArgumentTypeDescription
project_namestring
fn get_deployments(project_name: string, env?: enum, page?: number, per_page?: number)
Get deployments
ArgumentTypeDescription
project_namestring
env?enum
page?number
per_page?number
fn get_deployment_info(deployment_id: string, project_name: string)
Get deployment info
ArgumentTypeDescription
deployment_idstring
project_namestring
fn delete_deployment(deployment_id: string, project_name: string, force?: boolean)
Delete deployment
ArgumentTypeDescription
deployment_idstring
project_namestring
force?boolean
fn get_deployment_logs(deployment_id: string, project_name: string)
Get deployment logs
ArgumentTypeDescription
deployment_idstring
project_namestring
fn pages_deployment_retry_deployment(deployment_id: string, project_name: string)
Retry deployment
ArgumentTypeDescription
deployment_idstring
project_namestring
fn pages_deployment_rollback_deployment(deployment_id: string, project_name: string)
Rollback deployment
ArgumentTypeDescription
deployment_idstring
project_namestring
fn create_tail(deployment_id: string, project_name: string, filters?: array)
Create deployment tail
ArgumentTypeDescription
deployment_idstring
project_namestring
filters?arrayFilters to apply to the tail session.
fn delete_tail(tail_id: string, deployment_id: string, project_name: string)
Delete deployment tail
ArgumentTypeDescription
tail_idstring
deployment_idstring
project_namestring
fn get_domains(project_name: string)
Get domains
ArgumentTypeDescription
project_namestring
fn create_pages_domains_add_domain(project_name: string, name: unknown)
Add domain
ArgumentTypeDescription
project_namestring
nameunknown
fn get_domain(domain_name: string, project_name: string)
Get domain
ArgumentTypeDescription
domain_namestring
project_namestring
fn patch_domain(domain_name: string, project_name: string)
Patch domain
ArgumentTypeDescription
domain_namestring
project_namestring
fn delete_domain(domain_name: string, project_name: string)
Delete domain
ArgumentTypeDescription
domain_namestring
project_namestring
fn pages_purge_build_cache(project_name: string)
Purge build cache
ArgumentTypeDescription
project_namestring
fn create_pages_project_connect_project_source(project_name: string, config: object, type: enum)
Connect project source
ArgumentTypeDescription
project_namestring
configobject
typeenumThe source control management provider.
fn delete_pages_project_disconnect_project_source(project_name: string)
Disconnect project source
ArgumentTypeDescription
project_namestring
fn get_upload_token(project_name: string)
Get upload token
ArgumentTypeDescription
project_namestring

Resources

get_projects(infinite)— Get projects
project(infinite)— Create project
get_deployments(infinite)— Get deployments
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 Versions10
2026.08.28.2

2026.08.28.2

Hardened codegen: instance names sanitized against path traversal; 429 rate-limit retry with Retry-After; string schema patterns emit regex validation; output schemas passthrough unknown fields; apiToken now optional and vault-wireable with CLOUDFLARE_API_TOKEN env fallback.

updated labels

2026.08.28.1

2026.08.28.1

Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.

Upgrade note: License text only. No API, schema, or runtime behavior changed.

2026.08.26.2

Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry quality scorer can resolve dependencies and score the extension. An earlier release used a bare "zod" import-map specifier, which published but scored as unscored.

Changed: Retained explicit compilerOptions.strict in deno.json. No behavioral or schema changes.

2026.08.26.2

2026.08.26.2

Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry quality scorer can resolve dependencies and score the extension. An earlier release used a bare "zod" import-map specifier, which published but scored as unscored.

Changed: Retained explicit compilerOptions.strict in deno.json. No behavioral or schema changes.

2026.08.25.1

2026.08.25.1

Changed: Updated labels for improved extension discoverability. Added cross-cutting category labels (security, observability, finops, infrastructure, networking, compliance, devops, ai, incident-response) where applicable.

updated labels

2026.08.24.1

2026.08.24.1

Added: Output metadata attributes for observability.

  • durationMs: Method execution duration in milliseconds.
  • collectedBy: Extension name that produced the data.
  • fetchedAt: ISO 8601 timestamp when data was fetched (added to resources that previously lacked it).
2026.08.21.3

2026.08.21.3

Changed:

  • Errors raised when a Cloudflare API call fails now name the HTTP method and path that was attempted (e.g. Cloudflare API POST /accounts/.../pages/projects failed with HTTP 400 ...) instead of a bare Cloudflare API error: .... Network-level failures (DNS, connection reset, timeout) are now also caught and wrapped with the same operation context instead of surfacing a raw fetch error.
  • create_project now rejects an empty name or production_branch before making a request, instead of letting Cloudflare reject the request with a less specific error.

No breaking changes. Existing calls that already supplied a non-empty name and production_branch are unaffected.

2026.08.21.2

2026.08.21.2

Changed: Added .describe() and .min(1) to the identifier arguments used across most methods — project_name, deployment_id, domain_name, and tail_id. No behavioral changes.

2026.08.21.1

Fixed: Regenerated with three cloudflare-codegen fixes: (1) discriminated-union request bodies with a sibling top-level discriminator property (e.g. gateway proxy_endpoints kind) now correctly build the body from the full oneOf variant instead of silently dropping it to undefined; (2) DELETE methods with a request body (e.g. r2 delete_objects bulk-delete-by-list) now send that body instead of ignoring it; (3) oneOf/anyOf request body variants that are $ref (e.g. r2 sippy config) are now resolved to their real schema instead of collapsing to z.unknown(). Same generator fix as workers-scripts in #352, now caught up for these 7 services.

Changed: create_deployment was removed — it is no longer present in the upstream Cloudflare API spec this extension is generated from.

2026.08.21.1

2026.08.21.1

Fixed: Regenerated with three cloudflare-codegen fixes: (1) discriminated-union request bodies with a sibling top-level discriminator property (e.g. gateway proxy_endpoints kind) now correctly build the body from the full oneOf variant instead of silently dropping it to undefined; (2) DELETE methods with a request body (e.g. r2 delete_objects bulk-delete-by-list) now send that body instead of ignoring it; (3) oneOf/anyOf request body variants that are $ref (e.g. r2 sippy config) are now resolved to their real schema instead of collapsing to z.unknown(). Same generator fix as workers-scripts in #352, now caught up for these 7 services.

Changed: create_deployment was removed — it is no longer present in the upstream Cloudflare API spec this extension is generated from.

Modified 1 models

2026.07.27.1

2026.07.27.1

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

  1. 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.

  2. 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.1

2026.07.19.1

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

05Stats
A
100 / 100
Downloads
2
Archive size
20.9 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
06Platforms
07Labels