Cloudflare/spectrum

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

01README

Cloudflare Spectrum — TCP/UDP proxying for non-HTTP applications

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 /zones/<zone>/spectrum/apps/<id>: <message>. This applies to every method on this model, since they all share the same request helper.
app_id is now validated as non-empty before any request is made. Passing an empty string previously sent a request to a malformed URL (/zones/<zone>/spectrum/apps/) and produced a confusing 404 from Cloudflare; it now fails fast with app_id must not be empty.

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

03Models1

@webframp/cloudflare/spectrumv2026.08.21.1cloudflare/spectrum.ts

Global Arguments

Argument	Type	Required	Description
apiToken	string	yes	Cloudflare API token
zoneId	string	yes	Cloudflare zone ID

fn get_current_aggregated_analytics(appID?: string, colo_name?: string)

Get current aggregated analytics

Argument	Type	Required	Description
appID?	string	no
colo_name?	string	no

fn get_analytics_by_time(dimensions?: string, sort?: string, until?: string, metrics?: string, filters?: string, since?: string, time_delta?: enum)

Get analytics by time

Argument	Type	Required
dimensions?	string	no
sort?	string	no
until?	string	no
metrics?	string	no
filters?	string	no
since?	string	no
time_delta?	enum	no

fn get_analytics_summary(dimensions?: string, sort?: string, until?: string, metrics?: string, filters?: string, since?: string)

Get analytics summary

Argument	Type	Required
dimensions?	string	no
sort?	string	no
until?	string	no
metrics?	string	no
filters?	string	no
since?	string	no

fn list_spectrum_applications(page?: number, per_page?: number, direction?: enum, order?: enum)

List Spectrum applications

Argument	Type	Required
page?	number	no
per_page?	number	no
direction?	enum	no
order?	enum	no

fn create_spectrum_application_using_a_name_for_the_origin()

Create Spectrum application using a name for the origin

fn get_spectrum_application_configuration(app_id: string)

Get Spectrum application configuration

Argument	Type	Required	Description
app_id	string	yes

fn update_spectrum_application_configuration_using_a_name_for_the_origin(app_id: string)

Update Spectrum application configuration using a name for the origin

Argument	Type	Required	Description
app_id	string	yes

fn delete_spectrum_application(app_id: string)

Delete Spectrum application

Argument	Type	Required	Description
app_id	string	yes

Resources

get_current_aggregated_analytics(infinite)— Get current aggregated analytics

analytics_by_time(infinite)— Get analytics by time

analytics_summary(infinite)— Get analytics summary

list_spectrum_applications(infinite)— List Spectrum applications

spectrum_application_using_a_name_for_the_origin(infinite)— Create Spectrum application using a name for the origin

spectrum_application_configuration(infinite)— Get Spectrum application configuration

spectrum_application_configuration_using_a_name_for_the_origin(infinite)— Update Spectrum application configuration using a name for the origin

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