@hasna/connectors 0.0.1

package/connectors/connect-cloudflare/src/api/kv.ts

@@ -0,0 +1,171 @@
+import type { CloudflareClient } from './client';
+import type { KVNamespace, KVKey, CreateKVNamespaceParams, ListKVKeysParams, WriteKVParams, BulkWriteKVParams, CloudflareResponse } from '../types';
+
+export class KVApi {
+  constructor(private client: CloudflareClient) {}
+
+  // ============================================
+  // Namespaces
+  // ============================================
+
+  /**
+   * List all KV namespaces for an account
+   */
+  async listNamespaces(
+    accountId: string,
+    params?: {
+      page?: number;
+      per_page?: number;
+      order?: 'id' | 'title';
+      direction?: 'asc' | 'desc';
+    }
+  ): Promise<CloudflareResponse<KVNamespace[]>> {
+    return this.client.get<KVNamespace[]>(
+      `/accounts/${accountId}/storage/kv/namespaces`,
+      params
+    );
+  }
+
+  /**
+   * Get a KV namespace
+   */
+  async getNamespace(accountId: string, namespaceId: string): Promise<KVNamespace> {
+    const response = await this.client.get<KVNamespace>(
+      `/accounts/${accountId}/storage/kv/namespaces/${namespaceId}`
+    );
+    return response.result;
+  }
+
+  /**
+   * Create a KV namespace
+   */
+  async createNamespace(accountId: string, params: CreateKVNamespaceParams): Promise<KVNamespace> {
+    const response = await this.client.post<KVNamespace>(
+      `/accounts/${accountId}/storage/kv/namespaces`,
+      params as unknown as Record<string, unknown>
+    );
+    return response.result;
+  }
+
+  /**
+   * Rename a KV namespace
+   */
+  async renameNamespace(accountId: string, namespaceId: string, title: string): Promise<void> {
+    await this.client.put(
+      `/accounts/${accountId}/storage/kv/namespaces/${namespaceId}`,
+      { title }
+    );
+  }
+
+  /**
+   * Delete a KV namespace
+   */
+  async deleteNamespace(accountId: string, namespaceId: string): Promise<void> {
+    await this.client.delete(`/accounts/${accountId}/storage/kv/namespaces/${namespaceId}`);
+  }
+
+  // ============================================
+  // Keys
+  // ============================================
+
+  /**
+   * List keys in a KV namespace
+   */
+  async listKeys(
+    accountId: string,
+    namespaceId: string,
+    params?: ListKVKeysParams
+  ): Promise<CloudflareResponse<KVKey[]>> {
+    return this.client.get<KVKey[]>(
+      `/accounts/${accountId}/storage/kv/namespaces/${namespaceId}/keys`,
+      params as Record<string, string | number | boolean | undefined> | undefined
+    );
+  }
+
+  /**
+   * Get metadata for a specific key
+   */
+  async getKeyMetadata(
+    accountId: string,
+    namespaceId: string,
+    key: string
+  ): Promise<{ name: string; expiration?: number; metadata?: Record<string, unknown> }> {
+    const response = await this.client.get<{ name: string; expiration?: number; metadata?: Record<string, unknown> }>(
+      `/accounts/${accountId}/storage/kv/namespaces/${namespaceId}/metadata/${encodeURIComponent(key)}`
+    );
+    return response.result;
+  }
+
+  // ============================================
+  // Values
+  // ============================================
+
+  /**
+   * Read a value from KV
+   */
+  async get(accountId: string, namespaceId: string, key: string): Promise<string> {
+    return this.client.request<string>(
+      `/accounts/${accountId}/storage/kv/namespaces/${namespaceId}/values/${encodeURIComponent(key)}`,
+      { method: 'GET' }
+    );
+  }
+
+  /**
+   * Write a value to KV
+   */
+  async put(accountId: string, namespaceId: string, params: WriteKVParams): Promise<void> {
+    const queryParams: Record<string, string | number | boolean | undefined> = {};
+    if (params.expiration) {
+      queryParams.expiration = params.expiration;
+    }
+    if (params.expiration_ttl) {
+      queryParams.expiration_ttl = params.expiration_ttl;
+    }
+
+    await this.client.request(
+      `/accounts/${accountId}/storage/kv/namespaces/${namespaceId}/values/${encodeURIComponent(params.key)}`,
+      {
+        method: 'PUT',
+        body: params.value,
+        params: queryParams,
+        rawBody: true,
+        headers: {
+          'Content-Type': 'text/plain',
+        },
+      }
+    );
+  }
+
+  /**
+   * Delete a key-value pair from KV
+   */
+  async delete(accountId: string, namespaceId: string, key: string): Promise<void> {
+    await this.client.delete(
+      `/accounts/${accountId}/storage/kv/namespaces/${namespaceId}/values/${encodeURIComponent(key)}`
+    );
+  }
+
+  // ============================================
+  // Bulk Operations
+  // ============================================
+
+  /**
+   * Write multiple key-value pairs to KV
+   */
+  async bulkWrite(accountId: string, namespaceId: string, items: BulkWriteKVParams[]): Promise<void> {
+    await this.client.put(
+      `/accounts/${accountId}/storage/kv/namespaces/${namespaceId}/bulk`,
+      items as unknown as Record<string, unknown>
+    );
+  }
+
+  /**
+   * Delete multiple keys from KV
+   */
+  async bulkDelete(accountId: string, namespaceId: string, keys: string[]): Promise<void> {
+    await this.client.delete(
+      `/accounts/${accountId}/storage/kv/namespaces/${namespaceId}/bulk`,
+      { keys: keys.join(',') }
+    );
+  }
+}

package/connectors/connect-cloudflare/src/api/pages.ts

@@ -0,0 +1,241 @@
+import type { CloudflareClient } from './client';
+import type { PagesProject, PagesDeployment, CreatePagesProjectParams, CloudflareResponse } from '../types';
+
+export class PagesApi {
+  constructor(private client: CloudflareClient) {}
+
+  /**
+   * List all Pages projects for an account
+   */
+  async list(accountId: string): Promise<CloudflareResponse<PagesProject[]>> {
+    return this.client.get<PagesProject[]>(`/accounts/${accountId}/pages/projects`);
+  }
+
+  /**
+   * Get a Pages project
+   */
+  async get(accountId: string, projectName: string): Promise<PagesProject> {
+    const response = await this.client.get<PagesProject>(
+      `/accounts/${accountId}/pages/projects/${projectName}`
+    );
+    return response.result;
+  }
+
+  /**
+   * Create a new Pages project
+   */
+  async create(accountId: string, params: CreatePagesProjectParams): Promise<PagesProject> {
+    const response = await this.client.post<PagesProject>(
+      `/accounts/${accountId}/pages/projects`,
+      params as unknown as Record<string, unknown>
+    );
+    return response.result;
+  }
+
+  /**
+   * Update a Pages project
+   */
+  async update(
+    accountId: string,
+    projectName: string,
+    params: Partial<CreatePagesProjectParams>
+  ): Promise<PagesProject> {
+    const response = await this.client.patch<PagesProject>(
+      `/accounts/${accountId}/pages/projects/${projectName}`,
+      params as Record<string, unknown>
+    );
+    return response.result;
+  }
+
+  /**
+   * Delete a Pages project
+   */
+  async delete(accountId: string, projectName: string): Promise<void> {
+    await this.client.delete(`/accounts/${accountId}/pages/projects/${projectName}`);
+  }
+
+  // ============================================
+  // Deployments
+  // ============================================
+
+  /**
+   * List deployments for a Pages project
+   */
+  async listDeployments(
+    accountId: string,
+    projectName: string,
+    params?: {
+      env?: 'production' | 'preview';
+      page?: number;
+      per_page?: number;
+    }
+  ): Promise<CloudflareResponse<PagesDeployment[]>> {
+    return this.client.get<PagesDeployment[]>(
+      `/accounts/${accountId}/pages/projects/${projectName}/deployments`,
+      params
+    );
+  }
+
+  /**
+   * Get a specific deployment
+   */
+  async getDeployment(
+    accountId: string,
+    projectName: string,
+    deploymentId: string
+  ): Promise<PagesDeployment> {
+    const response = await this.client.get<PagesDeployment>(
+      `/accounts/${accountId}/pages/projects/${projectName}/deployments/${deploymentId}`
+    );
+    return response.result;
+  }
+
+  /**
+   * Create a deployment (trigger a new build)
+   */
+  async createDeployment(
+    accountId: string,
+    projectName: string,
+    options?: {
+      branch?: string;
+    }
+  ): Promise<PagesDeployment> {
+    const formData = new FormData();
+    if (options?.branch) {
+      formData.append('branch', options.branch);
+    }
+
+    const response = await this.client.request<CloudflareResponse<PagesDeployment>>(
+      `/accounts/${accountId}/pages/projects/${projectName}/deployments`,
+      {
+        method: 'POST',
+        body: formData,
+      }
+    );
+    return response.result;
+  }
+
+  /**
+   * Retry a deployment
+   */
+  async retryDeployment(
+    accountId: string,
+    projectName: string,
+    deploymentId: string
+  ): Promise<PagesDeployment> {
+    const response = await this.client.post<PagesDeployment>(
+      `/accounts/${accountId}/pages/projects/${projectName}/deployments/${deploymentId}/retry`
+    );
+    return response.result;
+  }
+
+  /**
+   * Rollback to a specific deployment
+   */
+  async rollback(
+    accountId: string,
+    projectName: string,
+    deploymentId: string
+  ): Promise<PagesDeployment> {
+    const response = await this.client.post<PagesDeployment>(
+      `/accounts/${accountId}/pages/projects/${projectName}/deployments/${deploymentId}/rollback`
+    );
+    return response.result;
+  }
+
+  /**
+   * Delete a deployment
+   */
+  async deleteDeployment(
+    accountId: string,
+    projectName: string,
+    deploymentId: string
+  ): Promise<void> {
+    await this.client.delete(
+      `/accounts/${accountId}/pages/projects/${projectName}/deployments/${deploymentId}`
+    );
+  }
+
+  /**
+   * Get deployment logs
+   */
+  async getDeploymentLogs(
+    accountId: string,
+    projectName: string,
+    deploymentId: string
+  ): Promise<{
+    total: number;
+    data: Array<{
+      ts: string;
+      line: string;
+    }>;
+  }> {
+    const response = await this.client.get<{
+      total: number;
+      data: Array<{
+        ts: string;
+        line: string;
+      }>;
+    }>(
+      `/accounts/${accountId}/pages/projects/${projectName}/deployments/${deploymentId}/history/logs`
+    );
+    return response.result;
+  }
+
+  // ============================================
+  // Domains
+  // ============================================
+
+  /**
+   * List custom domains for a Pages project
+   */
+  async listDomains(
+    accountId: string,
+    projectName: string
+  ): Promise<CloudflareResponse<Array<{
+    id: string;
+    name: string;
+    status: string;
+    created_on: string;
+  }>>> {
+    return this.client.get<Array<{
+      id: string;
+      name: string;
+      status: string;
+      created_on: string;
+    }>>(`/accounts/${accountId}/pages/projects/${projectName}/domains`);
+  }
+
+  /**
+   * Add a custom domain to a Pages project
+   */
+  async addDomain(
+    accountId: string,
+    projectName: string,
+    domain: string
+  ): Promise<{
+    id: string;
+    name: string;
+    status: string;
+  }> {
+    const response = await this.client.post<{
+      id: string;
+      name: string;
+      status: string;
+    }>(`/accounts/${accountId}/pages/projects/${projectName}/domains`, { name: domain });
+    return response.result;
+  }
+
+  /**
+   * Delete a custom domain from a Pages project
+   */
+  async deleteDomain(
+    accountId: string,
+    projectName: string,
+    domainName: string
+  ): Promise<void> {
+    await this.client.delete(
+      `/accounts/${accountId}/pages/projects/${projectName}/domains/${domainName}`
+    );
+  }
+}

package/connectors/connect-cloudflare/src/api/r2.ts

@@ -0,0 +1,270 @@
+import type { CloudflareClient } from './client';
+import type { R2Bucket, R2Object, R2ObjectList, CreateR2BucketParams, ListR2ObjectsParams, CloudflareResponse } from '../types';
+
+export class R2Api {
+  constructor(private client: CloudflareClient) {}
+
+  // ============================================
+  // Buckets
+  // ============================================
+
+  /**
+   * List all R2 buckets for an account
+   */
+  async listBuckets(
+    accountId: string,
+    params?: {
+      cursor?: string;
+      per_page?: number;
+      name_contains?: string;
+      start_after?: string;
+      direction?: 'asc' | 'desc';
+      order?: 'name';
+    }
+  ): Promise<CloudflareResponse<{ buckets: R2Bucket[] }>> {
+    return this.client.get<{ buckets: R2Bucket[] }>(
+      `/accounts/${accountId}/r2/buckets`,
+      params
+    );
+  }
+
+  /**
+   * Get bucket details
+   */
+  async getBucket(accountId: string, bucketName: string): Promise<R2Bucket> {
+    const response = await this.client.get<R2Bucket>(
+      `/accounts/${accountId}/r2/buckets/${bucketName}`
+    );
+    return response.result;
+  }
+
+  /**
+   * Create a new R2 bucket
+   */
+  async createBucket(accountId: string, params: CreateR2BucketParams): Promise<R2Bucket> {
+    const response = await this.client.post<R2Bucket>(
+      `/accounts/${accountId}/r2/buckets`,
+      params as unknown as Record<string, unknown>
+    );
+    return response.result;
+  }
+
+  /**
+   * Delete an R2 bucket
+   */
+  async deleteBucket(accountId: string, bucketName: string): Promise<void> {
+    await this.client.delete(`/accounts/${accountId}/r2/buckets/${bucketName}`);
+  }
+
+  // ============================================
+  // Objects (via S3 API compatibility)
+  // Note: Most object operations use S3 API, but these are what's available via Cloudflare API
+  // ============================================
+
+  /**
+   * List objects in a bucket
+   * Note: This is a simplified version. For full S3 compatibility, use the S3 API directly.
+   */
+  async listObjects(
+    accountId: string,
+    bucketName: string,
+    params?: ListR2ObjectsParams
+  ): Promise<R2ObjectList> {
+    // R2 object listing via Cloudflare API
+    // Note: Full object operations should use S3-compatible endpoint
+    const queryParams: Record<string, string | number | boolean | undefined> = {};
+    if (params?.prefix) queryParams.prefix = params.prefix;
+    if (params?.delimiter) queryParams.delimiter = params.delimiter;
+    if (params?.cursor) queryParams.cursor = params.cursor;
+    if (params?.limit) queryParams.limit = params.limit;
+
+    const response = await this.client.get<R2ObjectList>(
+      `/accounts/${accountId}/r2/buckets/${bucketName}/objects`,
+      queryParams
+    );
+    return response.result;
+  }
+
+  /**
+   * Get object metadata
+   */
+  async getObjectMetadata(
+    accountId: string,
+    bucketName: string,
+    objectKey: string
+  ): Promise<R2Object> {
+    const response = await this.client.get<R2Object>(
+      `/accounts/${accountId}/r2/buckets/${bucketName}/objects/${encodeURIComponent(objectKey)}`
+    );
+    return response.result;
+  }
+
+  /**
+   * Delete an object
+   */
+  async deleteObject(accountId: string, bucketName: string, objectKey: string): Promise<void> {
+    await this.client.delete(
+      `/accounts/${accountId}/r2/buckets/${bucketName}/objects/${encodeURIComponent(objectKey)}`
+    );
+  }
+
+  // ============================================
+  // CORS Configuration
+  // ============================================
+
+  /**
+   * Get CORS configuration for a bucket
+   */
+  async getCors(accountId: string, bucketName: string): Promise<{
+    rules: Array<{
+      allowed_headers?: string[];
+      allowed_methods: string[];
+      allowed_origins: string[];
+      expose_headers?: string[];
+      max_age_seconds?: number;
+    }>;
+  }> {
+    const response = await this.client.get<{
+      rules: Array<{
+        allowed_headers?: string[];
+        allowed_methods: string[];
+        allowed_origins: string[];
+        expose_headers?: string[];
+        max_age_seconds?: number;
+      }>;
+    }>(`/accounts/${accountId}/r2/buckets/${bucketName}/cors`);
+    return response.result;
+  }
+
+  /**
+   * Set CORS configuration for a bucket
+   */
+  async setCors(
+    accountId: string,
+    bucketName: string,
+    rules: Array<{
+      allowed_headers?: string[];
+      allowed_methods: string[];
+      allowed_origins: string[];
+      expose_headers?: string[];
+      max_age_seconds?: number;
+    }>
+  ): Promise<void> {
+    await this.client.put(
+      `/accounts/${accountId}/r2/buckets/${bucketName}/cors`,
+      { rules }
+    );
+  }
+
+  /**
+   * Delete CORS configuration for a bucket
+   */
+  async deleteCors(accountId: string, bucketName: string): Promise<void> {
+    await this.client.delete(`/accounts/${accountId}/r2/buckets/${bucketName}/cors`);
+  }
+
+  // ============================================
+  // Lifecycle Rules
+  // ============================================
+
+  /**
+   * Get lifecycle rules for a bucket
+   */
+  async getLifecycle(accountId: string, bucketName: string): Promise<{
+    rules: Array<{
+      id: string;
+      enabled: boolean;
+      conditions?: {
+        prefix?: string;
+      };
+      actions?: {
+        type: 'Delete' | 'AbortIncompleteMultipartUpload';
+        days_after_creation?: number;
+      };
+    }>;
+  }> {
+    const response = await this.client.get<{
+      rules: Array<{
+        id: string;
+        enabled: boolean;
+        conditions?: {
+          prefix?: string;
+        };
+        actions?: {
+          type: 'Delete' | 'AbortIncompleteMultipartUpload';
+          days_after_creation?: number;
+        };
+      }>;
+    }>(`/accounts/${accountId}/r2/buckets/${bucketName}/lifecycle`);
+    return response.result;
+  }
+
+  /**
+   * Set lifecycle rules for a bucket
+   */
+  async setLifecycle(
+    accountId: string,
+    bucketName: string,
+    rules: Array<{
+      id: string;
+      enabled: boolean;
+      conditions?: {
+        prefix?: string;
+      };
+      actions?: {
+        type: 'Delete' | 'AbortIncompleteMultipartUpload';
+        days_after_creation?: number;
+      };
+    }>
+  ): Promise<void> {
+    await this.client.put(
+      `/accounts/${accountId}/r2/buckets/${bucketName}/lifecycle`,
+      { rules }
+    );
+  }
+
+  /**
+   * Delete lifecycle rules for a bucket
+   */
+  async deleteLifecycle(accountId: string, bucketName: string): Promise<void> {
+    await this.client.delete(`/accounts/${accountId}/r2/buckets/${bucketName}/lifecycle`);
+  }
+
+  // ============================================
+  // Public Access
+  // ============================================
+
+  /**
+   * Get public access configuration for a bucket
+   */
+  async getPublicAccess(accountId: string, bucketName: string): Promise<{
+    enabled: boolean;
+    custom_domain?: string;
+  }> {
+    const response = await this.client.get<{
+      enabled: boolean;
+      custom_domain?: string;
+    }>(`/accounts/${accountId}/r2/buckets/${bucketName}/public`);
+    return response.result;
+  }
+
+  /**
+   * Enable public access for a bucket
+   */
+  async enablePublicAccess(accountId: string, bucketName: string): Promise<void> {
+    await this.client.put(
+      `/accounts/${accountId}/r2/buckets/${bucketName}/public`,
+      { enabled: true }
+    );
+  }
+
+  /**
+   * Disable public access for a bucket
+   */
+  async disablePublicAccess(accountId: string, bucketName: string): Promise<void> {
+    await this.client.put(
+      `/accounts/${accountId}/r2/buckets/${bucketName}/public`,
+      { enabled: false }
+    );
+  }
+}