@hasna/connectors 0.0.1

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

@@ -0,0 +1,416 @@
+import type { CloudflareClient } from './client';
+import type { SSLCertificate, SSLSettings, SSLVerification, CreateSSLCertificateParams, OriginCACertificate, CreateOriginCACertificateParams, CloudflareResponse } from '../types';
+
+export class SSLApi {
+  constructor(private client: CloudflareClient) {}
+
+  // ============================================
+  // SSL/TLS Settings
+  // ============================================
+
+  /**
+   * Get SSL/TLS mode for a zone
+   */
+  async getMode(zoneId: string): Promise<SSLSettings> {
+    const response = await this.client.get<SSLSettings>(`/zones/${zoneId}/settings/ssl`);
+    return response.result;
+  }
+
+  /**
+   * Set SSL/TLS mode for a zone
+   */
+  async setMode(zoneId: string, mode: 'off' | 'flexible' | 'full' | 'strict'): Promise<SSLSettings> {
+    const response = await this.client.patch<SSLSettings>(
+      `/zones/${zoneId}/settings/ssl`,
+      { value: mode }
+    );
+    return response.result;
+  }
+
+  /**
+   * Get Always Use HTTPS setting
+   */
+  async getAlwaysUseHttps(zoneId: string): Promise<SSLSettings> {
+    const response = await this.client.get<SSLSettings>(`/zones/${zoneId}/settings/always_use_https`);
+    return response.result;
+  }
+
+  /**
+   * Enable Always Use HTTPS
+   */
+  async enableAlwaysUseHttps(zoneId: string): Promise<SSLSettings> {
+    const response = await this.client.patch<SSLSettings>(
+      `/zones/${zoneId}/settings/always_use_https`,
+      { value: 'on' }
+    );
+    return response.result;
+  }
+
+  /**
+   * Disable Always Use HTTPS
+   */
+  async disableAlwaysUseHttps(zoneId: string): Promise<SSLSettings> {
+    const response = await this.client.patch<SSLSettings>(
+      `/zones/${zoneId}/settings/always_use_https`,
+      { value: 'off' }
+    );
+    return response.result;
+  }
+
+  /**
+   * Get Automatic HTTPS Rewrites setting
+   */
+  async getAutomaticHttpsRewrites(zoneId: string): Promise<SSLSettings> {
+    const response = await this.client.get<SSLSettings>(`/zones/${zoneId}/settings/automatic_https_rewrites`);
+    return response.result;
+  }
+
+  /**
+   * Enable Automatic HTTPS Rewrites
+   */
+  async enableAutomaticHttpsRewrites(zoneId: string): Promise<SSLSettings> {
+    const response = await this.client.patch<SSLSettings>(
+      `/zones/${zoneId}/settings/automatic_https_rewrites`,
+      { value: 'on' }
+    );
+    return response.result;
+  }
+
+  /**
+   * Disable Automatic HTTPS Rewrites
+   */
+  async disableAutomaticHttpsRewrites(zoneId: string): Promise<SSLSettings> {
+    const response = await this.client.patch<SSLSettings>(
+      `/zones/${zoneId}/settings/automatic_https_rewrites`,
+      { value: 'off' }
+    );
+    return response.result;
+  }
+
+  /**
+   * Get minimum TLS version
+   */
+  async getMinTlsVersion(zoneId: string): Promise<SSLSettings> {
+    const response = await this.client.get<SSLSettings>(`/zones/${zoneId}/settings/min_tls_version`);
+    return response.result;
+  }
+
+  /**
+   * Set minimum TLS version
+   */
+  async setMinTlsVersion(zoneId: string, version: '1.0' | '1.1' | '1.2' | '1.3'): Promise<SSLSettings> {
+    const response = await this.client.patch<SSLSettings>(
+      `/zones/${zoneId}/settings/min_tls_version`,
+      { value: version }
+    );
+    return response.result;
+  }
+
+  /**
+   * Get Opportunistic Encryption setting
+   */
+  async getOpportunisticEncryption(zoneId: string): Promise<SSLSettings> {
+    const response = await this.client.get<SSLSettings>(`/zones/${zoneId}/settings/opportunistic_encryption`);
+    return response.result;
+  }
+
+  /**
+   * Enable Opportunistic Encryption
+   */
+  async enableOpportunisticEncryption(zoneId: string): Promise<SSLSettings> {
+    const response = await this.client.patch<SSLSettings>(
+      `/zones/${zoneId}/settings/opportunistic_encryption`,
+      { value: 'on' }
+    );
+    return response.result;
+  }
+
+  /**
+   * Disable Opportunistic Encryption
+   */
+  async disableOpportunisticEncryption(zoneId: string): Promise<SSLSettings> {
+    const response = await this.client.patch<SSLSettings>(
+      `/zones/${zoneId}/settings/opportunistic_encryption`,
+      { value: 'off' }
+    );
+    return response.result;
+  }
+
+  // ============================================
+  // Universal SSL
+  // ============================================
+
+  /**
+   * Get Universal SSL settings
+   */
+  async getUniversalSsl(zoneId: string): Promise<{
+    enabled: boolean;
+    certificate_authority?: string;
+  }> {
+    const response = await this.client.get<{
+      enabled: boolean;
+      certificate_authority?: string;
+    }>(`/zones/${zoneId}/ssl/universal/settings`);
+    return response.result;
+  }
+
+  /**
+   * Enable Universal SSL
+   */
+  async enableUniversalSsl(zoneId: string): Promise<void> {
+    await this.client.patch(`/zones/${zoneId}/ssl/universal/settings`, { enabled: true });
+  }
+
+  /**
+   * Disable Universal SSL
+   */
+  async disableUniversalSsl(zoneId: string): Promise<void> {
+    await this.client.patch(`/zones/${zoneId}/ssl/universal/settings`, { enabled: false });
+  }
+
+  // ============================================
+  // Custom Certificates
+  // ============================================
+
+  /**
+   * List custom SSL certificates
+   */
+  async listCertificates(
+    zoneId: string,
+    params?: {
+      page?: number;
+      per_page?: number;
+      match?: 'any' | 'all';
+      status?: string;
+    }
+  ): Promise<CloudflareResponse<SSLCertificate[]>> {
+    return this.client.get<SSLCertificate[]>(`/zones/${zoneId}/custom_certificates`, params);
+  }
+
+  /**
+   * Get a custom SSL certificate
+   */
+  async getCertificate(zoneId: string, certificateId: string): Promise<SSLCertificate> {
+    const response = await this.client.get<SSLCertificate>(
+      `/zones/${zoneId}/custom_certificates/${certificateId}`
+    );
+    return response.result;
+  }
+
+  /**
+   * Upload a custom SSL certificate
+   */
+  async uploadCertificate(zoneId: string, params: CreateSSLCertificateParams): Promise<SSLCertificate> {
+    const response = await this.client.post<SSLCertificate>(
+      `/zones/${zoneId}/custom_certificates`,
+      params as unknown as Record<string, unknown>
+    );
+    return response.result;
+  }
+
+  /**
+   * Update a custom SSL certificate
+   */
+  async updateCertificate(
+    zoneId: string,
+    certificateId: string,
+    params: CreateSSLCertificateParams
+  ): Promise<SSLCertificate> {
+    const response = await this.client.patch<SSLCertificate>(
+      `/zones/${zoneId}/custom_certificates/${certificateId}`,
+      params as unknown as Record<string, unknown>
+    );
+    return response.result;
+  }
+
+  /**
+   * Delete a custom SSL certificate
+   */
+  async deleteCertificate(zoneId: string, certificateId: string): Promise<{ id: string }> {
+    const response = await this.client.delete<{ id: string }>(
+      `/zones/${zoneId}/custom_certificates/${certificateId}`
+    );
+    return response.result;
+  }
+
+  /**
+   * Re-prioritize custom certificates
+   */
+  async prioritizeCertificates(
+    zoneId: string,
+    certificates: Array<{ id: string; priority: number }>
+  ): Promise<SSLCertificate[]> {
+    const response = await this.client.put<SSLCertificate[]>(
+      `/zones/${zoneId}/custom_certificates/prioritize`,
+      { certificates }
+    );
+    return response.result;
+  }
+
+  // ============================================
+  // SSL Verification
+  // ============================================
+
+  /**
+   * Get SSL verification status for a zone
+   */
+  async getVerification(zoneId: string): Promise<SSLVerification[]> {
+    const response = await this.client.get<SSLVerification[]>(`/zones/${zoneId}/ssl/verification`);
+    return response.result;
+  }
+
+  /**
+   * Edit SSL verification method
+   */
+  async editVerification(
+    zoneId: string,
+    certPackId: string,
+    method: 'http' | 'cname' | 'txt' | 'email'
+  ): Promise<SSLVerification> {
+    const response = await this.client.patch<SSLVerification>(
+      `/zones/${zoneId}/ssl/verification/${certPackId}`,
+      { validation_method: method }
+    );
+    return response.result;
+  }
+
+  // ============================================
+  // Origin CA Certificates
+  // ============================================
+
+  /**
+   * List Origin CA certificates
+   */
+  async listOriginCertificates(zoneId: string): Promise<CloudflareResponse<OriginCACertificate[]>> {
+    return this.client.get<OriginCACertificate[]>('/certificates', { zone_id: zoneId });
+  }
+
+  /**
+   * Get an Origin CA certificate
+   */
+  async getOriginCertificate(certificateId: string): Promise<OriginCACertificate> {
+    const response = await this.client.get<OriginCACertificate>(`/certificates/${certificateId}`);
+    return response.result;
+  }
+
+  /**
+   * Create an Origin CA certificate
+   */
+  async createOriginCertificate(params: CreateOriginCACertificateParams): Promise<OriginCACertificate> {
+    const response = await this.client.post<OriginCACertificate>(
+      '/certificates',
+      params as unknown as Record<string, unknown>
+    );
+    return response.result;
+  }
+
+  /**
+   * Revoke an Origin CA certificate
+   */
+  async revokeOriginCertificate(certificateId: string): Promise<{ id: string }> {
+    const response = await this.client.delete<{ id: string }>(`/certificates/${certificateId}`);
+    return response.result;
+  }
+
+  // ============================================
+  // Client Certificates
+  // ============================================
+
+  /**
+   * List client certificates
+   */
+  async listClientCertificates(
+    zoneId: string,
+    params?: {
+      page?: number;
+      per_page?: number;
+      status?: 'all' | 'active' | 'pending_reactivation' | 'pending_revocation' | 'revoked';
+    }
+  ): Promise<CloudflareResponse<Array<{
+    id: string;
+    certificate: string;
+    certificate_authority: {
+      id: string;
+      name: string;
+    };
+    common_name: string;
+    country: string;
+    csr: string;
+    expires_on: string;
+    fingerprint_sha256: string;
+    issued_on: string;
+    location: string;
+    organization: string;
+    organizational_unit: string;
+    serial_number: string;
+    signature: string;
+    ski: string;
+    state: string;
+    status: string;
+    validity_days: number;
+  }>>> {
+    return this.client.get<Array<{
+      id: string;
+      certificate: string;
+      certificate_authority: {
+        id: string;
+        name: string;
+      };
+      common_name: string;
+      country: string;
+      csr: string;
+      expires_on: string;
+      fingerprint_sha256: string;
+      issued_on: string;
+      location: string;
+      organization: string;
+      organizational_unit: string;
+      serial_number: string;
+      signature: string;
+      ski: string;
+      state: string;
+      status: string;
+      validity_days: number;
+    }>>(`/zones/${zoneId}/client_certificates`, params);
+  }
+
+  /**
+   * Create a client certificate
+   */
+  async createClientCertificate(
+    zoneId: string,
+    params: {
+      csr: string;
+      validity_days: number;
+    }
+  ): Promise<{
+    id: string;
+    certificate: string;
+    expires_on: string;
+    issued_on: string;
+    serial_number: string;
+    signature: string;
+    status: string;
+  }> {
+    const response = await this.client.post<{
+      id: string;
+      certificate: string;
+      expires_on: string;
+      issued_on: string;
+      serial_number: string;
+      signature: string;
+      status: string;
+    }>(`/zones/${zoneId}/client_certificates`, params);
+    return response.result;
+  }
+
+  /**
+   * Revoke a client certificate
+   */
+  async revokeClientCertificate(zoneId: string, certificateId: string): Promise<{ id: string }> {
+    const response = await this.client.delete<{ id: string }>(
+      `/zones/${zoneId}/client_certificates/${certificateId}`
+    );
+    return response.result;
+  }
+}

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

@@ -0,0 +1,235 @@
+import type { CloudflareClient } from './client';
+import type { Worker, WorkerRoute, WorkerDeployment, CreateWorkerParams, CloudflareResponse } from '../types';
+
+export class WorkersApi {
+  constructor(private client: CloudflareClient) {}
+
+  /**
+   * List all Workers scripts for an account
+   */
+  async list(accountId: string): Promise<CloudflareResponse<Worker[]>> {
+    return this.client.get<Worker[]>(`/accounts/${accountId}/workers/scripts`);
+  }
+
+  /**
+   * Get Worker script details
+   */
+  async get(accountId: string, scriptName: string): Promise<Worker> {
+    const response = await this.client.get<Worker>(`/accounts/${accountId}/workers/scripts/${scriptName}`);
+    return response.result;
+  }
+
+  /**
+   * Download Worker script content
+   */
+  async getContent(accountId: string, scriptName: string): Promise<string> {
+    return this.client.request<string>(`/accounts/${accountId}/workers/scripts/${scriptName}`, {
+      method: 'GET',
+      headers: { 'Accept': 'application/javascript' },
+    });
+  }
+
+  /**
+   * Create or update a Worker script
+   */
+  async create(accountId: string, scriptName: string, params: CreateWorkerParams): Promise<Worker> {
+    const metadata: Record<string, unknown> = {
+      main_module: 'index.js',
+    };
+
+    if (params.bindings) {
+      metadata.bindings = params.bindings;
+    }
+    if (params.compatibility_date) {
+      metadata.compatibility_date = params.compatibility_date;
+    }
+    if (params.compatibility_flags) {
+      metadata.compatibility_flags = params.compatibility_flags;
+    }
+    if (params.usage_model) {
+      metadata.usage_model = params.usage_model;
+    }
+
+    const response = await this.client.uploadWorkerScript(accountId, scriptName, params.script, metadata);
+    return response.result as Worker;
+  }
+
+  /**
+   * Update a Worker script (alias for create)
+   */
+  async update(accountId: string, scriptName: string, params: CreateWorkerParams): Promise<Worker> {
+    return this.create(accountId, scriptName, params);
+  }
+
+  /**
+   * Delete a Worker script
+   */
+  async delete(accountId: string, scriptName: string): Promise<void> {
+    await this.client.delete(`/accounts/${accountId}/workers/scripts/${scriptName}`);
+  }
+
+  /**
+   * Get Worker script settings
+   */
+  async getSettings(accountId: string, scriptName: string): Promise<Record<string, unknown>> {
+    const response = await this.client.get<Record<string, unknown>>(
+      `/accounts/${accountId}/workers/scripts/${scriptName}/settings`
+    );
+    return response.result;
+  }
+
+  /**
+   * Update Worker script settings
+   */
+  async updateSettings(
+    accountId: string,
+    scriptName: string,
+    settings: Record<string, unknown>
+  ): Promise<Record<string, unknown>> {
+    const response = await this.client.patch<Record<string, unknown>>(
+      `/accounts/${accountId}/workers/scripts/${scriptName}/settings`,
+      settings
+    );
+    return response.result;
+  }
+
+  // ============================================
+  // Worker Routes (Zone-level)
+  // ============================================
+
+  /**
+   * List Worker routes for a zone
+   */
+  async listRoutes(zoneId: string): Promise<CloudflareResponse<WorkerRoute[]>> {
+    return this.client.get<WorkerRoute[]>(`/zones/${zoneId}/workers/routes`);
+  }
+
+  /**
+   * Get a Worker route
+   */
+  async getRoute(zoneId: string, routeId: string): Promise<WorkerRoute> {
+    const response = await this.client.get<WorkerRoute>(`/zones/${zoneId}/workers/routes/${routeId}`);
+    return response.result;
+  }
+
+  /**
+   * Create a Worker route
+   */
+  async createRoute(zoneId: string, pattern: string, script?: string): Promise<WorkerRoute> {
+    const response = await this.client.post<WorkerRoute>(`/zones/${zoneId}/workers/routes`, {
+      pattern,
+      script,
+    });
+    return response.result;
+  }
+
+  /**
+   * Update a Worker route
+   */
+  async updateRoute(zoneId: string, routeId: string, pattern: string, script?: string): Promise<WorkerRoute> {
+    const response = await this.client.put<WorkerRoute>(`/zones/${zoneId}/workers/routes/${routeId}`, {
+      pattern,
+      script,
+    });
+    return response.result;
+  }
+
+  /**
+   * Delete a Worker route
+   */
+  async deleteRoute(zoneId: string, routeId: string): Promise<{ id: string }> {
+    const response = await this.client.delete<{ id: string }>(`/zones/${zoneId}/workers/routes/${routeId}`);
+    return response.result;
+  }
+
+  // ============================================
+  // Worker Deployments
+  // ============================================
+
+  /**
+   * List deployments for a Worker
+   */
+  async listDeployments(accountId: string, scriptName: string): Promise<CloudflareResponse<WorkerDeployment[]>> {
+    return this.client.get<WorkerDeployment[]>(
+      `/accounts/${accountId}/workers/scripts/${scriptName}/deployments`
+    );
+  }
+
+  /**
+   * Create a new deployment (deploy the Worker)
+   */
+  async deploy(
+    accountId: string,
+    scriptName: string,
+    options?: {
+      strategy?: 'percentage' | 'all';
+      annotations?: Record<string, string>;
+    }
+  ): Promise<WorkerDeployment> {
+    const body: Record<string, unknown> = {};
+    if (options?.strategy) {
+      body.strategy = options.strategy;
+    }
+    if (options?.annotations) {
+      body.annotations = options.annotations;
+    }
+
+    const response = await this.client.post<WorkerDeployment>(
+      `/accounts/${accountId}/workers/scripts/${scriptName}/deployments`,
+      Object.keys(body).length > 0 ? body : undefined
+    );
+    return response.result;
+  }
+
+  // ============================================
+  // Worker Subdomain
+  // ============================================
+
+  /**
+   * Get Workers subdomain for an account
+   */
+  async getSubdomain(accountId: string): Promise<{ subdomain: string }> {
+    const response = await this.client.get<{ subdomain: string }>(
+      `/accounts/${accountId}/workers/subdomain`
+    );
+    return response.result;
+  }
+
+  /**
+   * Create Workers subdomain for an account
+   */
+  async createSubdomain(accountId: string, subdomain: string): Promise<{ subdomain: string }> {
+    const response = await this.client.put<{ subdomain: string }>(
+      `/accounts/${accountId}/workers/subdomain`,
+      { subdomain }
+    );
+    return response.result;
+  }
+
+  // ============================================
+  // Worker Tail (Logs)
+  // ============================================
+
+  /**
+   * Start a tail session for a Worker
+   */
+  async startTail(accountId: string, scriptName: string): Promise<{
+    id: string;
+    url: string;
+    expires_at: string;
+  }> {
+    const response = await this.client.post<{
+      id: string;
+      url: string;
+      expires_at: string;
+    }>(`/accounts/${accountId}/workers/scripts/${scriptName}/tails`);
+    return response.result;
+  }
+
+  /**
+   * Delete a tail session
+   */
+  async deleteTail(accountId: string, scriptName: string, tailId: string): Promise<void> {
+    await this.client.delete(`/accounts/${accountId}/workers/scripts/${scriptName}/tails/${tailId}`);
+  }
+}