@theholocron/cloudflare-client 1.31.0 → 1.32.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/cloudflare-client",
-  "version": "1.31.0",
+  "version": "1.32.0",
   "description": "A TypeScript client for the Cloudflare API",
   "keywords": [
     "cloudflare",
@@ -33,13 +33,13 @@
   ],
   "dependencies": {
     "@theholocron/observability": "^0.3.0",
-    "@theholocron/http-client": "^1.31.0"
+    "@theholocron/http-client": "^1.32.0"
   },
   "devDependencies": {
-    "@theholocron/cli": "5.0.0-alpha.33",
+    "@theholocron/cli": "5.0.0-alpha.79",
     "@theholocron/eslint-config": "^8.4.3",
     "@theholocron/tsconfig": "^8.2.0",
-    "@theholocron/tsdown-config": "^8.2.0",
+    "@theholocron/tsdown-config": "^8.5.2",
     "@theholocron/vitest-config": "^8.2.0",
     "@types/node": "^26.4.1",
     "@vitest/coverage-v8": "^5.0.0",
@@ -61,7 +61,7 @@
   "releases": "https://github.com/theholocron/clients/releases",
   "wiki": "https://github.com/theholocron/clients/wiki",
   "scripts": {
-    "delivery.build": "tsdown",
+    "delivery.build": "holocron run delivery.build -- && node ../../scripts/check-bundle-size.mjs",
     "sourceQuality.staticAnalysis": "holocron run sourceQuality.staticAnalysis --",
     "test:watch": "vitest",
     "verification.typeSafety": "holocron run verification.typeSafety --",

package/dist/index.d.mts

@@ -1,184 +0,0 @@
-import "@theholocron/http-client";
-import { ErrorSink, Logger } from "@theholocron/observability/core";
-//#region src/utils.d.ts
-interface CloudflareClientOptions {
-  token: string;
-  /** Override base URL for testing. Defaults to https://api.cloudflare.com/client/v4 */
-  baseUrl?: string;
-  /** Override fetch for testing. Defaults to globalThis.fetch. */
-  fetch?: typeof fetch;
-  /** Structured logger for request/response diagnostics. Defaults to a no-op. */
-  logger?: Logger;
-  /** Reports transport failures and unexpected 5xx. Defaults to a no-op. */
-  errors?: ErrorSink;
-}
-interface CfEnvelope<T> {
-  success: boolean;
-  errors: unknown[];
-  result: T;
-}
-//#endregion
-//#region src/dns/dns.d.ts
-type CfDnsRecordType = "A" | "AAAA" | "CNAME" | "TXT" | "MX" | "NS" | "SRV" | "CAA";
-interface CfDnsRecord {
-  id: string;
-  type: CfDnsRecordType;
-  name: string;
-  content: string;
-  ttl: number;
-  proxied: boolean;
-}
-interface CfDnsRecordInput {
-  type: CfDnsRecordType;
-  name: string;
-  content: string;
-  ttl?: number;
-  proxied?: boolean;
-}
-//#endregion
-//#region src/pages/pages.d.ts
-type CfPagesEnvVarType = "plain_text" | "secret_text";
-interface CfPagesEnvVar {
-  value: string;
-  type: CfPagesEnvVarType;
-}
-interface CfPagesEnvConfig {
-  env_vars: Record<string, CfPagesEnvVar>;
-}
-interface CfPagesProject {
-  id: string;
-  name: string;
-  subdomain: string;
-  domains: string[];
-  production_branch: string;
-  deployment_configs: {
-    preview: CfPagesEnvConfig;
-    production: CfPagesEnvConfig;
-  };
-}
-interface CfPagesProjectInput {
-  name: string;
-  production_branch: string;
-}
-interface CfPagesDeploymentStage {
-  name: string;
-  status: "idle" | "active" | "canceled" | "success" | "failure";
-}
-interface CfPagesDomain {
-  id: string;
-  name: string;
-  status: "active" | "pending" | "blocked" | "error" | "moved" | "pending_tls";
-}
-interface CfPagesDeployment {
-  id: string;
-  url: string;
-  environment: "preview" | "production";
-  deployment_trigger: {
-    type: string;
-    metadata: {
-      branch: string;
-      commit_hash: string;
-    };
-  };
-  latest_stage: CfPagesDeploymentStage;
-  created_on: string;
-}
-//#endregion
-//#region src/zones/zones.d.ts
-interface CfZone {
-  id: string;
-  name: string;
-  status: string;
-}
-//#endregion
-//#region src/tunnels/tunnels.d.ts
-interface CfTunnel {
-  id: string;
-  name: string;
-}
-interface CfIngressRule {
-  hostname?: string;
-  service: string;
-  path?: string;
-}
-interface CfTunnelConfig {
-  ingress: CfIngressRule[];
-}
-//#endregion
-//#region src/tokens/tokens.d.ts
-interface CfTokenVerification {
-  id: string;
-  status: "active" | "disabled" | "expired";
-}
-//#endregion
-//#region src/workers/workers.d.ts
-interface CfWorkerRoute {
-  id: string;
-  pattern: string;
-  script: string | null;
-}
-/** https://developers.cloudflare.com/api/operations/worker-script-put-encrypted-secret-binding */
-interface CfWorkerSecret {
-  name: string;
-  type: "secret_text";
-}
-//#endregion
-//#region src/index.d.ts
-declare function createCloudflareClient(opts: CloudflareClientOptions): {
-  dns: {
-    list: (zoneId: string, query?: {
-      type?: string;
-      name?: string;
-    }) => Promise<CfDnsRecord[]>;
-    create: (zoneId: string, record: CfDnsRecordInput) => Promise<CfDnsRecord>;
-    update: (zoneId: string, recordId: string, record: Partial<CfDnsRecordInput>) => Promise<CfDnsRecord>;
-    delete: (zoneId: string, recordId: string) => Promise<{
-      id: string;
-    }>;
-  };
-  pages: {
-    listProjects: (accountId: string) => Promise<CfPagesProject[]>;
-    getProject: (accountId: string, name: string) => Promise<CfPagesProject>;
-    createProject: (accountId: string, input: CfPagesProjectInput) => Promise<CfPagesProject>;
-    updateProject: (accountId: string, name: string, patch: Partial<Pick<CfPagesProject, "deployment_configs" | "production_branch">>) => Promise<CfPagesProject>;
-    createDeployment: (accountId: string, projectName: string, branch: string) => Promise<CfPagesDeployment>;
-    getDeployment: (accountId: string, projectName: string, deploymentId: string) => Promise<CfPagesDeployment>;
-    listDeployments: (accountId: string, projectName: string) => Promise<CfPagesDeployment[]>;
-    deleteDeployment: (accountId: string, projectName: string, deploymentId: string) => Promise<void>;
-    listDomains: (accountId: string, projectName: string) => Promise<CfPagesDomain[]>;
-    addDomain: (accountId: string, projectName: string, hostname: string) => Promise<CfPagesDomain>;
-  };
-  zones: {
-    list: (query?: {
-      name?: string;
-      per_page?: number;
-    }) => Promise<CfZone[]>;
-  };
-  tunnels: {
-    create: (accountId: string, input: {
-      name: string;
-    }) => Promise<CfTunnel>;
-    list: (accountId: string) => Promise<CfTunnel[]>;
-    token: (accountId: string, tunnelId: string) => Promise<string>;
-    delete: (accountId: string, tunnelId: string) => Promise<void>;
-    getConfig: (accountId: string, tunnelId: string) => Promise<{
-      config: CfTunnelConfig;
-    }>;
-    putConfig: (accountId: string, tunnelId: string, config: CfTunnelConfig) => Promise<void>;
-  };
-  tokens: {
-    verify: () => Promise<CfTokenVerification>;
-  };
-  workers: {
-    putScript: (accountId: string, scriptName: string, script: string) => Promise<void>;
-    listRoutes: (zoneId: string) => Promise<CfWorkerRoute[]>;
-    createRoute: (zoneId: string, pattern: string, script: string) => Promise<CfWorkerRoute>;
-    updateRoute: (zoneId: string, routeId: string, pattern: string, script: string) => Promise<CfWorkerRoute>;
-    putSecret: (accountId: string, scriptName: string, name: string, value: string) => Promise<CfWorkerSecret>;
-    listSecrets: (accountId: string, scriptName: string) => Promise<CfWorkerSecret[]>;
-    deleteSecret: (accountId: string, scriptName: string, name: string) => Promise<void>;
-  };
-};
-type CloudflareClient = ReturnType<typeof createCloudflareClient>;
-//#endregion
-export { type CfDnsRecord, type CfDnsRecordInput, type CfDnsRecordType, type CfEnvelope, type CfIngressRule, type CfPagesDeployment, type CfPagesDeploymentStage, type CfPagesDomain, type CfPagesEnvConfig, type CfPagesEnvVar, type CfPagesEnvVarType, type CfPagesProject, type CfPagesProjectInput, type CfTokenVerification, type CfTunnel, type CfTunnelConfig, type CfWorkerRoute, type CfWorkerSecret, type CfZone, CloudflareClient, type CloudflareClientOptions, createCloudflareClient };

package/dist/index.mjs

@@ -1,148 +0,0 @@
-import { ProviderApiError, createRestClient } from "@theholocron/http-client";
-//#region src/utils.ts
-function createCloudflareRestClient(opts) {
-	return createRestClient({
-		baseUrl: opts.baseUrl ?? "https://api.cloudflare.com/client/v4",
-		token: opts.token,
-		vendor: "Cloudflare",
-		fetch: opts.fetch,
-		logger: opts.logger,
-		errors: opts.errors
-	});
-}
-/**
-* Unwrap Cloudflare's `{ result, success, errors }` envelope.
-* `createRestClient` already throws on HTTP 4xx/5xx; this handles the rare
-* 200 + `success: false` case Cloudflare emits for some validation failures.
-*/
-async function cfRequest(rest, method, path, body, query) {
-	const envelope = await rest.request(path, {
-		method,
-		...body !== void 0 ? { body } : {},
-		...query !== void 0 ? { query } : {}
-	});
-	if (!envelope) return void 0;
-	if (!envelope.success) throw new ProviderApiError(`Cloudflare ${method} ${path} returned success:false`, 0, JSON.stringify(envelope.errors));
-	return envelope.result;
-}
-//#endregion
-//#region src/dns/dns.ts
-function dns(rest) {
-	return {
-		list: (zoneId, query) => cfRequest(rest, "GET", `/zones/${zoneId}/dns_records`, void 0, {
-			...query?.type ? { type: query.type } : {},
-			...query?.name ? { name: query.name } : {},
-			per_page: "100"
-		}),
-		create: (zoneId, record) => cfRequest(rest, "POST", `/zones/${zoneId}/dns_records`, {
-			type: record.type,
-			name: record.name,
-			content: record.content,
-			ttl: record.ttl ?? 1,
-			proxied: record.proxied ?? false
-		}),
-		update: (zoneId, recordId, record) => cfRequest(rest, "PATCH", `/zones/${zoneId}/dns_records/${recordId}`, record),
-		delete: (zoneId, recordId) => cfRequest(rest, "DELETE", `/zones/${zoneId}/dns_records/${recordId}`)
-	};
-}
-//#endregion
-//#region src/pages/pages.ts
-function pages(rest) {
-	return {
-		listProjects: (accountId) => cfRequest(rest, "GET", `/accounts/${accountId}/pages/projects`, void 0, { per_page: "100" }),
-		getProject: (accountId, name) => cfRequest(rest, "GET", `/accounts/${accountId}/pages/projects/${name}`),
-		createProject: (accountId, input) => cfRequest(rest, "POST", `/accounts/${accountId}/pages/projects`, input),
-		updateProject: (accountId, name, patch) => cfRequest(rest, "PATCH", `/accounts/${accountId}/pages/projects/${name}`, patch),
-		createDeployment: (accountId, projectName, branch) => cfRequest(rest, "POST", `/accounts/${accountId}/pages/projects/${projectName}/deployments`, { branch }),
-		getDeployment: (accountId, projectName, deploymentId) => cfRequest(rest, "GET", `/accounts/${accountId}/pages/projects/${projectName}/deployments/${deploymentId}`),
-		listDeployments: (accountId, projectName) => cfRequest(rest, "GET", `/accounts/${accountId}/pages/projects/${projectName}/deployments`, void 0, { per_page: "25" }),
-		deleteDeployment: (accountId, projectName, deploymentId) => cfRequest(rest, "DELETE", `/accounts/${accountId}/pages/projects/${projectName}/deployments/${deploymentId}`, void 0, { force: "true" }),
-		listDomains: (accountId, projectName) => cfRequest(rest, "GET", `/accounts/${accountId}/pages/projects/${projectName}/domains`),
-		addDomain: (accountId, projectName, hostname) => cfRequest(rest, "POST", `/accounts/${accountId}/pages/projects/${projectName}/domains`, { name: hostname })
-	};
-}
-//#endregion
-//#region src/tokens/tokens.ts
-function tokens(rest) {
-	return { verify: () => cfRequest(rest, "GET", "/user/tokens/verify") };
-}
-//#endregion
-//#region src/tunnels/tunnels.ts
-function tunnels(rest) {
-	return {
-		create: (accountId, input) => cfRequest(rest, "POST", `/accounts/${accountId}/cfd_tunnel`, {
-			name: input.name,
-			config_src: "cloudflare"
-		}),
-		list: (accountId) => cfRequest(rest, "GET", `/accounts/${accountId}/cfd_tunnel`, void 0, { is_deleted: "false" }),
-		token: (accountId, tunnelId) => cfRequest(rest, "GET", `/accounts/${accountId}/cfd_tunnel/${tunnelId}/token`),
-		delete: (accountId, tunnelId) => cfRequest(rest, "DELETE", `/accounts/${accountId}/cfd_tunnel/${tunnelId}`, void 0, { cascade: "true" }),
-		getConfig: (accountId, tunnelId) => cfRequest(rest, "GET", `/accounts/${accountId}/cfd_tunnel/${tunnelId}/configurations`),
-		putConfig: (accountId, tunnelId, config) => cfRequest(rest, "PUT", `/accounts/${accountId}/cfd_tunnel/${tunnelId}/configurations`, { config })
-	};
-}
-//#endregion
-//#region src/workers/workers.ts
-function workers(rest, opts) {
-	const baseUrl = opts.baseUrl ?? "https://api.cloudflare.com/client/v4";
-	const fetchImpl = opts.fetch ?? globalThis.fetch;
-	return {
-		putScript: async (accountId, scriptName, script) => {
-			const form = new FormData();
-			form.append("metadata", new Blob([JSON.stringify({
-				main_module: "index.js",
-				compatibility_date: "2025-08-31"
-			})], { type: "application/json" }));
-			form.append("index.js", new Blob([script], { type: "application/javascript+module" }), "index.js");
-			const path = `/accounts/${accountId}/workers/scripts/${encodeURIComponent(scriptName)}`;
-			const res = await fetchImpl(`${baseUrl}${path}`, {
-				method: "PUT",
-				headers: { authorization: `Bearer ${opts.token}` },
-				body: form
-			});
-			if (!res.ok) {
-				const body = await res.text().catch(() => "");
-				throw new ProviderApiError(`Cloudflare PUT ${path} → ${res.status}`, res.status, body);
-			}
-		},
-		listRoutes: (zoneId) => cfRequest(rest, "GET", `/zones/${zoneId}/workers/routes`),
-		createRoute: (zoneId, pattern, script) => cfRequest(rest, "POST", `/zones/${zoneId}/workers/routes`, {
-			pattern,
-			script
-		}),
-		updateRoute: (zoneId, routeId, pattern, script) => cfRequest(rest, "PUT", `/zones/${zoneId}/workers/routes/${routeId}`, {
-			pattern,
-			script
-		}),
-		putSecret: (accountId, scriptName, name, value) => cfRequest(rest, "PUT", `/accounts/${accountId}/workers/scripts/${encodeURIComponent(scriptName)}/secrets`, {
-			name,
-			text: value,
-			type: "secret_text"
-		}),
-		listSecrets: (accountId, scriptName) => cfRequest(rest, "GET", `/accounts/${accountId}/workers/scripts/${encodeURIComponent(scriptName)}/secrets`),
-		deleteSecret: (accountId, scriptName, name) => cfRequest(rest, "DELETE", `/accounts/${accountId}/workers/scripts/${encodeURIComponent(scriptName)}/secrets/${encodeURIComponent(name)}`)
-	};
-}
-//#endregion
-//#region src/zones/zones.ts
-function zones(rest) {
-	return { list: (query) => cfRequest(rest, "GET", "/zones", void 0, {
-		...query?.name ? { name: query.name } : {},
-		per_page: String(query?.per_page ?? 100)
-	}) };
-}
-//#endregion
-//#region src/index.ts
-function createCloudflareClient(opts) {
-	const rest = createCloudflareRestClient(opts);
-	return {
-		dns: dns(rest),
-		pages: pages(rest),
-		zones: zones(rest),
-		tunnels: tunnels(rest),
-		tokens: tokens(rest),
-		workers: workers(rest, opts)
-	};
-}
-//#endregion
-export { createCloudflareClient };