Cloudflare/d1

@webframp/cloudflare/d1v2026.08.28.2· 13d agoMODELS

01README

Cloudflare D1 serverless SQL databases — databases, queries

02Release Notes

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/d1v2026.08.28.2cloudflare/d1.ts

Global Arguments

Argument	Type	Required	Description
apiToken?	string	no	Cloudflare API token; overrides the CLOUDFLARE_API_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
accountId	string	yes	Cloudflare account ID

fn list_databases(name?: string, page?: number, per_page?: number)

List D1 Databases

Argument	Type	Required
name?	string	no
page?	number	no
per_page?	number	no

fn create_database(jurisdiction?: unknown, name: unknown, primary_location_hint?: unknown, read_replication?: unknown)

Create D1 Database

Argument	Type	Required
jurisdiction?	unknown	no
name	unknown	yes
primary_location_hint?	unknown	no
read_replication?	unknown	no

fn get_database(database_id: string, fields?: string)

Get D1 Database

Argument	Type	Required	Description
database_id	string	yes
fields?	string	no	Comma-separated list of fields to include in the response. When omitted, all fields are returned.

fn update_database(database_id: string, read_replication: unknown)

Update D1 Database

Argument	Type	Required	Description
database_id	string	yes
read_replication	unknown	yes

fn update_partial_database(database_id: string, read_replication?: unknown)

Update D1 Database partially

Argument	Type	Required	Description
database_id	string	yes
read_replication?	unknown	no

fn delete_database(database_id: string)

Delete D1 Database

Argument	Type	Required	Description
database_id	string	yes

fn create_d1_export_database(database_id: string, current_bookmark?: string, dump_options?: object, output_format: enum)

Export D1 Database as SQL

Argument	Type	Required	Description
database_id	string	yes
current_bookmark?	string	no
dump_options?	object	no
output_format	enum	yes	Specifies that you will poll this endpoint until the export completes

fn d1_import_database(database_id: string, body: union)

Import SQL into your D1 Database

Argument	Type	Required	Description
database_id	string	yes
body	union	yes

fn d1_query_database(database_id: string, body: union)

Query D1 Database

Argument	Type	Required	Description
database_id	string	yes
body	union	yes	A single query object or a batch query object

fn d1_raw_database_query(database_id: string, body: union)

Raw D1 Database query

Argument	Type	Required	Description
database_id	string	yes
body	union	yes	A single query object or a batch query object

fn get_bookmark(database_id: string, timestamp?: string)

Get D1 database bookmark

Argument	Type	Required	Description
database_id	string	yes
timestamp?	string	no	An optional ISO 8601 timestamp. If provided, returns the nearest available bookmark at or before this timestamp. If omitted, returns the current bookmark.

fn d1_time_travel_restore(database_id: string, bookmark?: string, timestamp?: string)

Restore D1 Database to a bookmark or point in time

Argument	Type	Required	Description
database_id	string	yes
bookmark?	string	no	A bookmark to restore the database to. Required if `timestamp` is not provided.
timestamp?	string	no	An ISO 8601 timestamp to restore the database to. Required if `bookmark` is not provided.

Resources

databases(infinite)— List D1 Databases

database(infinite)— Create D1 Database

partial_database(infinite)— Update D1 Database partially

d1_export_database(infinite)— Export D1 Database as SQL

d1_import_database(infinite)— Import SQL into your D1 Database

d1_query_database(infinite)— Query D1 Database

d1_raw_database_query(infinite)— Raw D1 Database query

bookmark(infinite)— Get D1 database bookmark

d1_time_travel_restore(infinite)— Restore D1 Database to a bookmark or point in time

04Previous Versions6

2026.08.28.1Aug 28, 2026

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.2Aug 27, 2026

2026.08.26.2

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

2026.08.24.1Aug 24, 2026

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.1Aug 22, 2026

2026.08.21.1

Changed: Error messages for API failures and invalid input are now specific instead of generic.

Every method that calls the Cloudflare API now wraps failures with the operation and the database/account ID involved, instead of surfacing the raw SDK error with no context.
All methods that take a database_id now reject an empty value up front with a clear validation error, instead of sending a malformed request to the Cloudflare API.
create_database now validates that name is present before calling the API, instead of letting Cloudflare reject the request with a generic error.
d1_time_travel_restore now requires either bookmark or timestamp to be supplied, instead of silently sending a restore request with neither and letting Cloudflare reject it.

Upgrade note: No behavioral change for valid requests. Callers relying on an empty database_id, a missing name on create, or a restore request with neither bookmark nor timestamp to fail inside the Cloudflare API call will now get an immediate, descriptive validation error instead.

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