Cloudflare/rulesets

@webframp/cloudflare/rulesetsv2026.07.27.1· 11d agoMODELS

01README

Cloudflare Rulesets — WAF custom rules, transform rules, managed rulesets

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/rulesetsv2026.07.27.1cloudflare/rulesets.ts

Global Arguments

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

fn listaccountrulesets(cursor?: string, per_page?: string)

List account rulesets

Argument	Type	Required	Description
cursor?	string	no
per_page?	string	no

fn createaccountruleset()

Create an account ruleset

fn getaccountentrypointruleset(ruleset_phase: string)

Get an account entry point ruleset

Argument	Type	Required	Description
ruleset_phase	string	yes

fn updateaccountentrypointruleset(ruleset_phase: string)

Update an account entry point ruleset

Argument	Type	Required	Description
ruleset_phase	string	yes

fn listaccountentrypointrulesetversions(ruleset_phase: string)

List an account entry point ruleset's versions

Argument	Type	Required	Description
ruleset_phase	string	yes

fn getaccountentrypointrulesetversion(ruleset_version: string, ruleset_phase: string)

Get an account entry point ruleset version

Argument	Type	Required	Description
ruleset_version	string	yes
ruleset_phase	string	yes

fn getaccountruleset(ruleset_id: string)

Get an account ruleset

Argument	Type	Required	Description
ruleset_id	string	yes

fn updateaccountruleset(ruleset_id: string)

Update an account ruleset

Argument	Type	Required	Description
ruleset_id	string	yes

fn deleteaccountruleset(ruleset_id: string)

Delete an account ruleset

Argument	Type	Required	Description
ruleset_id	string	yes

fn createaccountrulesetrule(ruleset_id: string)

Create an account ruleset rule

Argument	Type	Required	Description
ruleset_id	string	yes

fn updateaccountrulesetrule(rule_id: string, ruleset_id: string)

Update an account ruleset rule

Argument	Type	Required	Description
rule_id	string	yes
ruleset_id	string	yes

fn deleteaccountrulesetrule(rule_id: string, ruleset_id: string)

Delete an account ruleset rule

Argument	Type	Required	Description
rule_id	string	yes
ruleset_id	string	yes

fn listaccountrulesetversions(ruleset_id: string)

List an account ruleset's versions

Argument	Type	Required	Description
ruleset_id	string	yes

fn getaccountrulesetversion(ruleset_version: string, ruleset_id: string)

Get an account ruleset version

Argument	Type	Required	Description
ruleset_version	string	yes
ruleset_id	string	yes

fn deleteaccountrulesetversion(ruleset_version: string, ruleset_id: string)

Delete an account ruleset version

Argument	Type	Required	Description
ruleset_version	string	yes
ruleset_id	string	yes

fn listaccountrulesetversionrulesbytag(rule_tag: string, ruleset_version: string, ruleset_id: string)

List an account ruleset version's rules by tag

Argument	Type	Required
rule_tag	string	yes
ruleset_version	string	yes
ruleset_id	string	yes

fn listzonerulesets(zone_id: string, cursor?: string, per_page?: string)

List zone rulesets

Argument	Type	Required
zone_id	string	yes
cursor?	string	no
per_page?	string	no

fn createzoneruleset(zone_id: string)

Create a zone ruleset

Argument	Type	Required	Description
zone_id	string	yes

fn getzoneentrypointruleset(ruleset_phase: string, zone_id: string)

Get a zone entry point ruleset

Argument	Type	Required	Description
ruleset_phase	string	yes
zone_id	string	yes

fn updatezoneentrypointruleset(ruleset_phase: string, zone_id: string)

Update a zone entry point ruleset

Argument	Type	Required	Description
ruleset_phase	string	yes
zone_id	string	yes

fn listzoneentrypointrulesetversions(ruleset_phase: string, zone_id: string)

List a zone entry point ruleset's versions

Argument	Type	Required	Description
ruleset_phase	string	yes
zone_id	string	yes

fn getzoneentrypointrulesetversion(ruleset_version: string, ruleset_phase: string, zone_id: string)

Get a zone entry point ruleset version

Argument	Type	Required
ruleset_version	string	yes
ruleset_phase	string	yes
zone_id	string	yes

fn getzoneruleset(ruleset_id: string, zone_id: string)

Get a zone ruleset

Argument	Type	Required	Description
ruleset_id	string	yes
zone_id	string	yes

fn updatezoneruleset(ruleset_id: string, zone_id: string)

Update a zone ruleset

Argument	Type	Required	Description
ruleset_id	string	yes
zone_id	string	yes

fn deletezoneruleset(ruleset_id: string, zone_id: string)

Delete a zone ruleset

Argument	Type	Required	Description
ruleset_id	string	yes
zone_id	string	yes

fn createzonerulesetrule(ruleset_id: string, zone_id: string)

Create a zone ruleset rule

Argument	Type	Required	Description
ruleset_id	string	yes
zone_id	string	yes

fn updatezonerulesetrule(rule_id: string, ruleset_id: string, zone_id: string)

Update a zone ruleset rule

Argument	Type	Required
rule_id	string	yes
ruleset_id	string	yes
zone_id	string	yes

fn deletezonerulesetrule(rule_id: string, ruleset_id: string, zone_id: string)

Delete a zone ruleset rule

Argument	Type	Required
rule_id	string	yes
ruleset_id	string	yes
zone_id	string	yes

fn listzonerulesetversions(ruleset_id: string, zone_id: string)

List a zone ruleset's versions

Argument	Type	Required	Description
ruleset_id	string	yes
zone_id	string	yes

fn getzonerulesetversion(ruleset_version: string, ruleset_id: string, zone_id: string)

Get a zone ruleset version

Argument	Type	Required
ruleset_version	string	yes
ruleset_id	string	yes
zone_id	string	yes

fn deletezonerulesetversion(ruleset_version: string, ruleset_id: string, zone_id: string)

Delete a zone ruleset version

Argument	Type	Required
ruleset_version	string	yes
ruleset_id	string	yes
zone_id	string	yes

fn listzonerulesetversionrulesbytag(rule_tag: string, ruleset_version: string, ruleset_id: string, zone_id: string)

List a zone ruleset version's rules by tag

Argument	Type	Required
rule_tag	string	yes
ruleset_version	string	yes
ruleset_id	string	yes
zone_id	string	yes

Resources

listaccountrulesets(infinite)— List account rulesets

createaccountruleset(infinite)— Create an account ruleset

getaccountentrypointruleset(infinite)— Get an account entry point ruleset

updateaccountentrypointruleset(infinite)— Update an account entry point ruleset

listaccountentrypointrulesetversions(infinite)— List an account entry point ruleset's versions

getaccountentrypointrulesetversion(infinite)— Get an account entry point ruleset version

getaccountruleset(infinite)— Get an account ruleset

updateaccountruleset(infinite)— Update an account ruleset

createaccountrulesetrule(infinite)— Create an account ruleset rule

updateaccountrulesetrule(infinite)— Update an account ruleset rule

listaccountrulesetversions(infinite)— List an account ruleset's versions

getaccountrulesetversion(infinite)— Get an account ruleset version

listaccountrulesetversionrulesbytag(infinite)— List an account ruleset version's rules by tag

listzonerulesets(infinite)— List zone rulesets

createzoneruleset(infinite)— Create a zone ruleset

getzoneentrypointruleset(infinite)— Get a zone entry point ruleset

updatezoneentrypointruleset(infinite)— Update a zone entry point ruleset

listzoneentrypointrulesetversions(infinite)— List a zone entry point ruleset's versions

getzoneentrypointrulesetversion(infinite)— Get a zone entry point ruleset version

getzoneruleset(infinite)— Get a zone ruleset

updatezoneruleset(infinite)— Update a zone ruleset

createzonerulesetrule(infinite)— Create a zone ruleset rule

updatezonerulesetrule(infinite)— Update a zone ruleset rule

listzonerulesetversions(infinite)— List a zone ruleset's versions

getzonerulesetversion(infinite)— Get a zone ruleset version

listzonerulesetversionrulesbytag(infinite)— List a zone ruleset version's rules by tag

04Previous Versions1

2026.07.19.1Jul 19, 2026

2026.07.19.1

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

05Stats

100 / 100

Downloads

Archive size

9.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 #rulesets #waf #security