Skip to main content

Cloudflare/logpush

@webframp/cloudflare/logpushv2026.11.03.1· Apache-2.0· 17d agoBEHAVIORS
01README

Cloudflare Logpush — log jobs, destinations, field configurations

02Release Notes

2026.11.03.1

Changed: Bump zod 4.6.5 → 4.6.7

2026.10.21.1

Changed: The README and the apiToken description now lead with a vault. Store the token with swamp vault put cloudflare API_TOKEN and set apiToken to ${{ vault.get("cloudflare", "API_TOKEN") }}. The CLOUDFLARE_API_TOKEN environment variable still works as a fallback, but swamp does not redact it, so it is no longer recommended. The missing-token error now says the same.

Changed: Method arguments that carry a secret are now marked sensitive, so swamp redacts them from logs and run records. Pass them as vault.get expressions. Affected: create_post_accounts_account_id_logpush_jobs, put_accounts_account_id_logpush_jobs_job_id, create_post_accounts_account_id_logpush_ownership, create_post_accounts_account_id_logpush_ownership_validate, delete_accounts_account_id_logpush_validate_destination, delete_accounts_account_id_logpush_validate_destination_exists and 6 more. The README's new "Secrets" section lists them per method.

Changed: Secrets returned by create_post_accounts_account_id_logpush_jobs, get_accounts_account_id_logpush_jobs_job_id, put_accounts_account_id_logpush_jobs_job_id, create_post_zones_zone_id_logpush_jobs, get_zones_zone_id_logpush_jobs_job_id and put_zones_zone_id_logpush_jobs_job_id are now stored in a vault, and the stored resource holds a vault.get reference instead of the value. Because the model now declares secret output, swamp refuses to run any of the model's methods, reads included, until a vault exists (swamp vault create local_encryption cloudflare). The README's "Secrets" section lists what each method stores.

Changed: Secrets inside list items, maps or unions, which swamp cannot move into a vault, are now removed before the result is stored. Affected: get_accounts_account_id_logpush_datasets_dataset_id_jobs, get_accounts_account_id_logpush_jobs, get_zones_zone_id_logpush_datasets_dataset_id_jobs and get_zones_zone_id_logpush_jobs.

Fixed: Create methods whose response carries no id wrote every result to one instance named created, so each call overwrote the previous one. They now name the instance by the response's id when present, else by the path parameter that scopes the call, else by a hash of the request arguments (secret arguments left out). Affected: create_post_accounts_account_id_logpush_ownership, create_post_accounts_account_id_logpush_ownership_validate, delete_accounts_account_id_logpush_validate_destination, delete_accounts_account_id_logpush_validate_destination_exists, create_post_accounts_account_id_logpush_validate_origin, create_post_zones_zone_id_logpush_edge_jobs and 5 more.

Upgrade note: Resources stored by earlier versions of the methods in the README's "Secrets" section may hold plaintext secrets; delete them with swamp data delete and rotate the affected credentials. Results earlier versions wrote to the created instance stay there; new runs write under the new names.

03Behaviors1
@webframp/cloudflare/logpushv2026.11.03.1cloudflare/logpush.ts

Global Arguments

ArgumentTypeDescription
apiToken?stringCloudflare API token. Wire it with ${{ vault.get("cloudflare", "API_TOKEN") }}; never pass the literal token. The CLOUDFLARE_API_TOKEN environment variable is read as a fallback, but it is not redacted and is not recommended.
accountIdstringCloudflare account ID
fn get_accounts_account_id_logpush_datasets_dataset_id_fields(dataset_id: string)
List fields
ArgumentTypeDescription
dataset_idstring
fn get_accounts_account_id_logpush_datasets_dataset_id_jobs(dataset_id: string)
List Logpush jobs for a dataset
ArgumentTypeDescription
dataset_idstring
fn get_accounts_account_id_logpush_jobs()
List Logpush jobs
fn create_post_accounts_account_id_logpush_jobs(dataset?: unknown, destination_conf: unknown, enabled?: unknown, filter?: unknown, frequency?: unknown, kind?: unknown, logpull_options?: unknown, max_upload_bytes?: unknown, max_upload_interval_seconds?: unknown, max_upload_records?: unknown, name?: unknown, output_options?: unknown, ownership_challenge?: unknown)
Create Logpush job
ArgumentTypeDescription
dataset?unknown
destination_confunknownSecret: pass a vault.get expression, never a literal value.
enabled?unknown
filter?unknown
frequency?unknown
kind?unknown
logpull_options?unknown
max_upload_bytes?unknown
max_upload_interval_seconds?unknown
max_upload_records?unknown
name?unknown
output_options?unknown
ownership_challenge?unknownSecret: pass a vault.get expression, never a literal value.
fn get_accounts_account_id_logpush_jobs_job_id(job_id: string)
Get Logpush job details
ArgumentTypeDescription
job_idstring
fn put_accounts_account_id_logpush_jobs_job_id(job_id: string, destination_conf?: unknown, enabled?: unknown, filter?: unknown, frequency?: unknown, kind?: unknown, logpull_options?: unknown, max_upload_bytes?: unknown, max_upload_interval_seconds?: unknown, max_upload_records?: unknown, name?: unknown, output_options?: unknown, ownership_challenge?: unknown)
Update Logpush job
ArgumentTypeDescription
job_idstring
destination_conf?unknownSecret: pass a vault.get expression, never a literal value.
enabled?unknown
filter?unknown
frequency?unknown
kind?unknown
logpull_options?unknown
max_upload_bytes?unknown
max_upload_interval_seconds?unknown
max_upload_records?unknown
name?unknown
output_options?unknown
ownership_challenge?unknownSecret: pass a vault.get expression, never a literal value.
fn delete_accounts_account_id_logpush_jobs_job_id(job_id: string)
Delete Logpush job
ArgumentTypeDescription
job_idstring
fn create_post_accounts_account_id_logpush_ownership(destination_conf: unknown)
Get ownership challenge
ArgumentTypeDescription
destination_confunknownSecret: pass a vault.get expression, never a literal value.
fn create_post_accounts_account_id_logpush_ownership_validate(destination_conf: unknown, ownership_challenge: unknown)
Validate ownership challenge
ArgumentTypeDescription
destination_confunknownSecret: pass a vault.get expression, never a literal value.
ownership_challengeunknownSecret: pass a vault.get expression, never a literal value.
fn delete_accounts_account_id_logpush_validate_destination(destination_conf: unknown)
Validate destination
ArgumentTypeDescription
destination_confunknownSecret: pass a vault.get expression, never a literal value.
fn delete_accounts_account_id_logpush_validate_destination_exists(destination_conf: unknown)
Check destination exists
ArgumentTypeDescription
destination_confunknownSecret: pass a vault.get expression, never a literal value.
fn create_post_accounts_account_id_logpush_validate_origin(logpull_options: unknown)
Validate origin
ArgumentTypeDescription
logpull_optionsunknown
fn get_zones_zone_id_logpush_datasets_dataset_id_fields(dataset_id: string, zone_id: string)
List fields
ArgumentTypeDescription
dataset_idstring
zone_idstring
fn get_zones_zone_id_logpush_datasets_dataset_id_jobs(dataset_id: string, zone_id: string)
List Logpush jobs for a dataset
ArgumentTypeDescription
dataset_idstring
zone_idstring
fn get_zones_zone_id_logpush_edge_jobs(zone_id: string)
List Instant Logs jobs
ArgumentTypeDescription
zone_idstring
fn create_post_zones_zone_id_logpush_edge_jobs(zone_id: string, fields?: unknown, filter?: unknown, sample?: unknown)
Create Instant Logs job
ArgumentTypeDescription
zone_idstring
fields?unknown
filter?unknown
sample?unknown
fn get_zones_zone_id_logpush_jobs(zone_id: string)
List Logpush jobs
ArgumentTypeDescription
zone_idstring
fn create_post_zones_zone_id_logpush_jobs(zone_id: string, dataset?: unknown, destination_conf: unknown, enabled?: unknown, filter?: unknown, frequency?: unknown, kind?: unknown, logpull_options?: unknown, max_upload_bytes?: unknown, max_upload_interval_seconds?: unknown, max_upload_records?: unknown, name?: unknown, output_options?: unknown, ownership_challenge?: unknown)
Create Logpush job
ArgumentTypeDescription
zone_idstring
dataset?unknown
destination_confunknownSecret: pass a vault.get expression, never a literal value.
enabled?unknown
filter?unknown
frequency?unknown
kind?unknown
logpull_options?unknown
max_upload_bytes?unknown
max_upload_interval_seconds?unknown
max_upload_records?unknown
name?unknown
output_options?unknown
ownership_challenge?unknownSecret: pass a vault.get expression, never a literal value.
fn get_zones_zone_id_logpush_jobs_job_id(job_id: string, zone_id: string)
Get Logpush job details
ArgumentTypeDescription
job_idstring
zone_idstring
fn put_zones_zone_id_logpush_jobs_job_id(job_id: string, zone_id: string, destination_conf?: unknown, enabled?: unknown, filter?: unknown, frequency?: unknown, kind?: unknown, logpull_options?: unknown, max_upload_bytes?: unknown, max_upload_interval_seconds?: unknown, max_upload_records?: unknown, name?: unknown, output_options?: unknown, ownership_challenge?: unknown)
Update Logpush job
ArgumentTypeDescription
job_idstring
zone_idstring
destination_conf?unknownSecret: pass a vault.get expression, never a literal value.
enabled?unknown
filter?unknown
frequency?unknown
kind?unknown
logpull_options?unknown
max_upload_bytes?unknown
max_upload_interval_seconds?unknown
max_upload_records?unknown
name?unknown
output_options?unknown
ownership_challenge?unknownSecret: pass a vault.get expression, never a literal value.
fn delete_zones_zone_id_logpush_jobs_job_id(job_id: string, zone_id: string)
Delete Logpush job
ArgumentTypeDescription
job_idstring
zone_idstring
fn create_post_zones_zone_id_logpush_ownership(zone_id: string, destination_conf: unknown)
Get ownership challenge
ArgumentTypeDescription
zone_idstring
destination_confunknownSecret: pass a vault.get expression, never a literal value.
fn create_post_zones_zone_id_logpush_ownership_validate(zone_id: string, destination_conf: unknown, ownership_challenge: unknown)
Validate ownership challenge
ArgumentTypeDescription
zone_idstring
destination_confunknownSecret: pass a vault.get expression, never a literal value.
ownership_challengeunknownSecret: pass a vault.get expression, never a literal value.
fn create_post_zones_zone_id_logpush_validate_destination(zone_id: string, destination_conf: unknown)
Validate destination
ArgumentTypeDescription
zone_idstring
destination_confunknownSecret: pass a vault.get expression, never a literal value.
fn create_post_zones_zone_id_logpush_validate_destination_exists(zone_id: string, destination_conf: unknown)
Check destination exists
ArgumentTypeDescription
zone_idstring
destination_confunknownSecret: pass a vault.get expression, never a literal value.
fn create_post_zones_zone_id_logpush_validate_origin(zone_id: string, logpull_options: unknown)
Validate origin
ArgumentTypeDescription
zone_idstring
logpull_optionsunknown

Resources

accounts_account_id_logpush_datasets_dataset_id_fields(infinite)— List fields
get_accounts_account_id_logpush_datasets_dataset_id_jobs(infinite)— List Logpush jobs for a dataset
get_accounts_account_id_logpush_jobs(infinite)— List Logpush jobs
post_accounts_account_id_logpush_jobs(infinite)— Create Logpush job
accounts_account_id_logpush_jobs_job_id(infinite)— Get Logpush job details
put_accounts_account_id_logpush_jobs_job_id(infinite)— Update Logpush job
post_accounts_account_id_logpush_ownership(infinite)— Get ownership challenge
post_accounts_account_id_logpush_ownership_validate(infinite)— Validate ownership challenge
delete_accounts_account_id_logpush_validate_destination(infinite)— Validate destination
delete_accounts_account_id_logpush_validate_destination_exists(infinite)— Check destination exists
post_accounts_account_id_logpush_validate_origin(infinite)— Validate origin
zones_zone_id_logpush_datasets_dataset_id_fields(infinite)— List fields
get_zones_zone_id_logpush_datasets_dataset_id_jobs(infinite)— List Logpush jobs for a dataset
get_zones_zone_id_logpush_edge_jobs(infinite)— List Instant Logs jobs
post_zones_zone_id_logpush_edge_jobs(infinite)— Create Instant Logs job
get_zones_zone_id_logpush_jobs(infinite)— List Logpush jobs
post_zones_zone_id_logpush_jobs(infinite)— Create Logpush job
zones_zone_id_logpush_jobs_job_id(infinite)— Get Logpush job details
put_zones_zone_id_logpush_jobs_job_id(infinite)— Update Logpush job
post_zones_zone_id_logpush_ownership(infinite)— Get ownership challenge
post_zones_zone_id_logpush_ownership_validate(infinite)— Validate ownership challenge
post_zones_zone_id_logpush_validate_destination(infinite)— Validate destination
post_zones_zone_id_logpush_validate_destination_exists(infinite)— Check destination exists
post_zones_zone_id_logpush_validate_origin(infinite)— Validate origin
04Previous Versions13
2026.10.21.1Apache-2.0

2026.10.21.1

Changed: The README and the apiToken description now lead with a vault. Store the token with swamp vault put cloudflare API_TOKEN and set apiToken to ${{ vault.get("cloudflare", "API_TOKEN") }}. The CLOUDFLARE_API_TOKEN environment variable still works as a fallback, but swamp does not redact it, so it is no longer recommended. The missing-token error now says the same.

Changed: Method arguments that carry a secret are now marked sensitive, so swamp redacts them from logs and run records. Pass them as vault.get expressions. Affected: create_post_accounts_account_id_logpush_jobs, put_accounts_account_id_logpush_jobs_job_id, create_post_accounts_account_id_logpush_ownership, create_post_accounts_account_id_logpush_ownership_validate, delete_accounts_account_id_logpush_validate_destination, delete_accounts_account_id_logpush_validate_destination_exists and 6 more. The README's new "Secrets" section lists them per method.

Changed: Secrets returned by create_post_accounts_account_id_logpush_jobs, get_accounts_account_id_logpush_jobs_job_id, put_accounts_account_id_logpush_jobs_job_id, create_post_zones_zone_id_logpush_jobs, get_zones_zone_id_logpush_jobs_job_id and put_zones_zone_id_logpush_jobs_job_id are now stored in a vault, and the stored resource holds a vault.get reference instead of the value. Because the model now declares secret output, swamp refuses to run any of the model's methods, reads included, until a vault exists (swamp vault create local_encryption cloudflare). The README's "Secrets" section lists what each method stores.

Changed: Secrets inside list items, maps or unions, which swamp cannot move into a vault, are now removed before the result is stored. Affected: get_accounts_account_id_logpush_datasets_dataset_id_jobs, get_accounts_account_id_logpush_jobs, get_zones_zone_id_logpush_datasets_dataset_id_jobs and get_zones_zone_id_logpush_jobs.

Fixed: Create methods whose response carries no id wrote every result to one instance named created, so each call overwrote the previous one. They now name the instance by the response's id when present, else by the path parameter that scopes the call, else by a hash of the request arguments (secret arguments left out). Affected: create_post_accounts_account_id_logpush_ownership, create_post_accounts_account_id_logpush_ownership_validate, delete_accounts_account_id_logpush_validate_destination, delete_accounts_account_id_logpush_validate_destination_exists, create_post_accounts_account_id_logpush_validate_origin, create_post_zones_zone_id_logpush_edge_jobs and 5 more.

Upgrade note: Resources stored by earlier versions of the methods in the README's "Secrets" section may hold plaintext secrets; delete them with swamp data delete and rotate the affected credentials. Results earlier versions wrote to the created instance stay there; new runs write under the new names.

2026.10.14.1Apache-2.0(was none)

2026.10.14.1

Added: The manifest now declares license: Apache-2.0 (SPDX). The registry quality rubric scores a declared license separately from the bundled LICENSE.md.

Upgrade note: Metadata only. No code, schema, or behavioral changes.

2026.09.18.1

Upgrade note: Normalized npm:zod dependency version to 4.6.5 across the repo. No behavioral changes in this extension.

2026.09.18.1

2026.09.18.1

Upgrade note: Normalized npm:zod dependency version to 4.6.5 across the repo. No behavioral changes in this extension.

2026.09.17.2

2026.09.17.2

No changes to this extension's methods. Regenerated to refresh the shared _lib/api.ts helper library after PR #427 review fixes to cfApiPaginatedCursor (used by r2, kv, durable-objects, and workers-ai, but emitted into every extension's api.ts since it's part of the shared template).

2026.09.15.1

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.

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.

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

2026.08.21.2

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/.../logpush/jobs 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.

No breaking changes.

2026.08.21.1

2026.08.21.1

Changed: Added .describe() and .min(1) to the zone_id, job_id, and dataset_id identifier arguments used across most methods, and added a .describe() to the destination_conf argument. No behavioral changes.

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.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/logpush with 26 methods covering the Cloudflare logpush API surface.

05Stats
A
100 / 100
Downloads
43
Archive size
18.4 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
  • Docs keep secrets in a vault1/1earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License2/2earned
  • Verified public repository2/2earned
06Platforms
07Labels