patchwork-os 0.2.0-beta.1 → 0.2.0-beta.10.canary.95

package/dist/connectors/cloudflare.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Cloudflare connector — zones, DNS, cache, Pages, Workers, analytics.
+ *
+ * Auth: API token (Bearer).
+ *   - Env var: CLOUDFLARE_API_TOKEN (+ optional CLOUDFLARE_ACCOUNT_ID)
+ *   - Stored: getSecretJsonSync("cloudflare") → CloudflareTokens
+ *   - Header: Authorization: Bearer <apiToken>
+ *
+ * Tools: listZones, getZone, listDnsRecords, createDnsRecord, updateDnsRecord,
+ *         deleteDnsRecord, purgeCache, listPagesProjects, getPagesProject,
+ *         createPagesDeployment, listWorkers, getZoneAnalytics
+ *
+ * Extends BaseConnector for unified auth, retry, rate-limit, error handling.
+ */
+import { type AuthContext, BaseConnector, type ConnectorError, type ConnectorStatus } from "./baseConnector.js";
+export interface CloudflareTokens {
+    apiToken: string;
+    accountId?: string;
+    email?: string;
+    connected_at: string;
+}
+export interface CloudflareZone {
+    id: string;
+    name: string;
+    status: "active" | "pending" | "paused" | "deactivated";
+    nameservers: string[];
+    plan: {
+        name: string;
+    };
+}
+export interface CloudflareDnsRecord {
+    id: string;
+    type: string;
+    name: string;
+    content: string;
+    ttl: number;
+    proxied: boolean;
+    proxiable: boolean;
+    created_on: string;
+    modified_on: string;
+}
+export interface CloudflarePagesProject {
+    id: string;
+    name: string;
+    subdomain: string;
+    domains: string[];
+    source?: {
+        type: string;
+        config?: {
+            owner?: string;
+            repo_name?: string;
+            production_branch?: string;
+        };
+    };
+    created_on: string;
+    latest_deployment?: {
+        id: string;
+        url: string;
+        environment: string;
+        created_on: string;
+    };
+}
+export interface CloudflareWorkerScript {
+    id: string;
+    etag: string;
+    handlers: string[];
+    modified_on: string;
+}
+export declare class CloudflareConnector extends BaseConnector {
+    readonly providerName = "cloudflare";
+    private tokens;
+    protected getOAuthConfig(): null;
+    authenticate(): Promise<AuthContext>;
+    healthCheck(): Promise<{
+        ok: boolean;
+        error?: ConnectorError;
+    }>;
+    normalizeError(error: unknown): ConnectorError;
+    getStatus(): ConnectorStatus;
+    listZones(name?: string): Promise<CloudflareZone[]>;
+    getZone(zoneId: string): Promise<CloudflareZone>;
+    listDnsRecords(zoneId: string, type?: string, name?: string): Promise<CloudflareDnsRecord[]>;
+    createDnsRecord(zoneId: string, type: string, name: string, content: string, ttl?: number, proxied?: boolean): Promise<CloudflareDnsRecord>;
+    updateDnsRecord(zoneId: string, recordId: string, fields: Partial<Pick<CloudflareDnsRecord, "type" | "name" | "content" | "ttl" | "proxied">>): Promise<CloudflareDnsRecord>;
+    deleteDnsRecord(zoneId: string, recordId: string): Promise<{
+        id: string;
+    }>;
+    purgeCache(zoneId: string, params?: {
+        files?: string[];
+        tags?: string[];
+        hosts?: string[];
+        prefixes?: string[];
+    }): Promise<{
+        id: string;
+    }>;
+    listPagesProjects(accountId?: string): Promise<CloudflarePagesProject[]>;
+    getPagesProject(accountId: string, projectName: string): Promise<CloudflarePagesProject>;
+    createPagesDeployment(accountId: string, projectName: string): Promise<{
+        id: string;
+        url: string;
+        created_on: string;
+    }>;
+    listWorkers(accountId?: string): Promise<CloudflareWorkerScript[]>;
+    getZoneAnalytics(zoneId: string, since?: string, until?: string): Promise<Record<string, unknown>>;
+    private buildHeaders;
+    private ensureTokens;
+}
+export declare function loadTokens(): CloudflareTokens | null;
+export declare function saveTokens(tokens: CloudflareTokens): void;
+export declare function clearTokens(): void;
+export declare function getCloudflareConnector(): CloudflareConnector;
+export { getCloudflareConnector as cloudflare };
+export interface ConnectorHandlerResult {
+    status: number;
+    body: string;
+    contentType?: string;
+}
+/**
+ * POST /connections/cloudflare/connect  { apiToken, accountId? }
+ *
+ * Validates the token via GET /user/tokens/verify.
+ * If no accountId is supplied, fetches GET /accounts and uses the first one.
+ */
+export declare function handleCloudflareConnect(body: string): Promise<ConnectorHandlerResult>;
+/**
+ * POST /connections/cloudflare/test
+ */
+export declare function handleCloudflareTest(): Promise<ConnectorHandlerResult>;
+/**
+ * DELETE /connections/cloudflare
+ */
+export declare function handleCloudflareDisconnect(): ConnectorHandlerResult;