Skip to main content

Cloudflare/registrar

@webframp/cloudflare/registrarv2026.08.28.2· 13d agoMODELS
01README

Cloudflare Registrar — domain registration, transfers, contacts

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/registrarv2026.08.28.2cloudflare/registrar.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 create_sandbox_registrar_domain_discovery_check(domains: array)
Check domain availability
ArgumentTypeDescription
domainsarrayList of fully qualified domain names (FQDNs) to check for availability. Each ...
fn get_sandbox_registrar_domain_discovery_search(q?: string, extensions?: string, limit?: number)
Search for available domains
ArgumentTypeDescription
q?stringThe search term to find domain suggestions. Accepts keywords, phrases, or full domain names. - Phrases: "coffee shop" returns coffeeshop.com, mycoffeeshop.net, etc. - Domain names: "example.com" returns example.com and variations across extensions
extensions?stringLimits results to specific domain extensions from the supported set. If not specified, returns results across all supported extensions. Extensions not in the supported set are silently ignored.
limit?numberMaximum number of domain suggestions to return. Defaults to 20 if not specified.
fn list(sort_by?: enum)
List Registrations
ArgumentTypeDescription
sort_by?enumColumn to sort results by. Defaults to registration date (`registry_created_at`) when omitted.
fn create(auto_renew?: boolean, contacts?: unknown, domain_name: unknown, privacy_mode?: union, years?: number)
Create Registration
ArgumentTypeDescription
auto_renew?booleanEnable or disable automatic renewal. Defaults to `false` if omitted. Setting ...
contacts?unknown
domain_nameunknown
privacy_mode?unionWHOIS privacy mode for the registration. Defaults to `redaction`. - `off`: Do...
years?numberNumber of years to register (1–10). If omitted, defaults to the minimum regis...
fn get(domain_name: string)
Get Registration
ArgumentTypeDescription
domain_namestringDomain name to retrieve.
fn update(domain_name: string, auto_renew?: boolean)
Update Registration
ArgumentTypeDescription
domain_namestringDomain name to update.
auto_renew?booleanEnable or disable automatic renewal. Setting this field to `true` authorizes ...
fn get_status(domain_name: string)
Get Registration Status
ArgumentTypeDescription
domain_namestring
fn get_update_status(domain_name: string)
Get Update Status
ArgumentTypeDescription
domain_namestring
fn create_registrar_domain_discovery_check(domains: array)
Check domain availability
ArgumentTypeDescription
domainsarrayList of fully qualified domain names (FQDNs) to check for availability. Each ...
fn get_registrar_domain_discovery_search(q?: string, extensions?: string, limit?: number)
Search for available domains
ArgumentTypeDescription
q?stringThe search term to find domain suggestions. Accepts keywords, phrases, or full domain names. - Phrases: "coffee shop" returns coffeeshop.com, mycoffeeshop.net, etc. - Domain names: "example.com" returns example.com and variations across extensions
extensions?stringLimits results to specific domain extensions from the supported set. If not specified, returns results across all supported extensions. Extensions not in the supported set are silently ignored.
limit?numberMaximum number of domain suggestions to return. Defaults to 20 if not specified.

Resources

sandbox_registrar_domain_discovery_check(infinite)— Check domain availability
sandbox_registrar_domain_discovery_search(infinite)— Search for available domains
list(infinite)— List Registrations
create(infinite)— Create Registration
get(infinite)— Get Registration
update(infinite)— Update Registration
status(infinite)— Get Registration Status
update_status(infinite)— Get Update Status
registrar_domain_discovery_check(infinite)— Check domain availability
registrar_domain_discovery_search(infinite)— Search for available domains
04Previous Versions8
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.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/.../registrar/domains/discovery 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_registrar_domain_discovery_check and create_sandbox_registrar_domain_discovery_check now reject an empty domains array before making a request, instead of sending a no-op availability check to Cloudflare.

No breaking changes. Existing calls that already supplied at least one domain are unaffected.

2026.08.21.1

2026.08.21.1

Changed: Added .describe() to the create method's domain_name argument, and added .describe()/.min(1) to the domain_name arguments on get_status and get_update_status. 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/registrar with 10 methods covering the Cloudflare registrar API surface.

05Stats
A
100 / 100
Downloads
1
Archive size
17.1 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