@hasna/connectors 0.4.0 → 0.4.2

package/connectors/connect-zendesk/src/index.ts

@@ -0,0 +1,36 @@
+// Zendesk API Connector
+// A TypeScript wrapper for the Zendesk API
+
+export { Zendesk } from './api';
+export * from './types';
+
+// Re-export individual API classes for advanced usage
+export {
+  ZendeskClient,
+  TicketsApi,
+  UsersApi,
+  OrganizationsApi,
+  GroupsApi,
+  TicketFieldsApi,
+  ViewsApi,
+  TriggersApi,
+  AutomationsApi,
+  SlaPoliciesApi,
+  WebhooksApi,
+  MacrosApi,
+  BrandsApi,
+  BulkApi,
+  FilterParser,
+} from './api';
+
+// Re-export bulk operation types
+export type {
+  BulkUpdateOptions,
+  BulkUpdateResult,
+  BulkPreviewResult,
+  BulkSchema,
+  BulkResourceType,
+  ParsedFilter,
+  ParsedUpdate,
+  FieldSchema,
+} from './api';

package/connectors/connect-zendesk/src/server/index.ts

@@ -0,0 +1,204 @@
+#!/usr/bin/env bun
+/**
+ * connect-zendesk server
+ * Remote API server for Zendesk connector
+ * Deployed at https://connect.hasna.com/zendesk
+ */
+
+const PORT = parseInt(process.env.PORT || '3000');
+const HOST = process.env.HOST || '0.0.0.0';
+const API_KEY = process.env.CONNECTOR_API_KEY || '';
+
+if (!API_KEY) {
+  console.error('WARNING: CONNECTOR_API_KEY not set - server will reject all authenticated requests');
+}
+
+interface ServerInfo {
+  name: string;
+  version: string;
+  uptime: number;
+  timestamp: string;
+  environment: string;
+}
+
+const startTime = Date.now();
+
+function getServerInfo(): ServerInfo {
+  return {
+    name: 'connect-zendesk',
+    version: '1.0.0',
+    uptime: Math.floor((Date.now() - startTime) / 1000),
+    timestamp: new Date().toISOString(),
+    environment: process.env.NODE_ENV || 'development',
+  };
+}
+
+function jsonResponse(data: unknown, status = 200): Response {
+  return new Response(JSON.stringify(data, null, 2), {
+    status,
+    headers: {
+      'Content-Type': 'application/json',
+      'Access-Control-Allow-Origin': '*',
+      'Access-Control-Allow-Methods': 'GET, POST, PUT, DELETE, OPTIONS',
+      'Access-Control-Allow-Headers': 'Content-Type, Authorization, X-API-Key',
+    },
+  });
+}
+
+function handleCORS(): Response {
+  return new Response(null, {
+    status: 204,
+    headers: {
+      'Access-Control-Allow-Origin': '*',
+      'Access-Control-Allow-Methods': 'GET, POST, PUT, DELETE, OPTIONS',
+      'Access-Control-Allow-Headers': 'Content-Type, Authorization, X-API-Key',
+    },
+  });
+}
+
+function validateApiKey(req: Request): boolean {
+  const apiKey = req.headers.get('X-API-Key');
+  return apiKey === API_KEY && API_KEY !== '';
+}
+
+const server = Bun.serve({
+  port: PORT,
+  hostname: HOST,
+
+  async fetch(req) {
+    const url = new URL(req.url);
+    const path = url.pathname;
+
+    // Handle CORS preflight
+    if (req.method === 'OPTIONS') {
+      return handleCORS();
+    }
+
+    // Health check endpoint - NO AUTH (needed for ALB health checks)
+    // Only returns minimal info, no sensitive data
+    if (path === '/health' || path === '/zendesk/health') {
+      return jsonResponse({ status: 'healthy' });
+    }
+
+    // All other endpoints require API key authentication
+    if (!validateApiKey(req)) {
+      return jsonResponse(
+        {
+          error: 'Unauthorized',
+          code: 'INVALID_API_KEY',
+          hint: 'Provide valid API key via X-API-Key header'
+        },
+        401
+      );
+    }
+
+    // Status endpoint (authenticated)
+    if (path === '/status' || path === '/zendesk/status') {
+      return jsonResponse({
+        status: 'ok',
+        service: 'connect-zendesk',
+        ...getServerInfo(),
+        endpoints: {
+          health: '/zendesk/health',
+          status: '/zendesk/status',
+          api: '/zendesk/api/*',
+        },
+      });
+    }
+
+    // Root endpoint (authenticated)
+    if (path === '/' || path === '/zendesk' || path === '/zendesk/') {
+      return jsonResponse({
+        service: 'connect-zendesk',
+        description: 'Zendesk API connector service',
+        version: '1.0.0',
+        documentation: 'https://github.com/hasna/connect-zendesk',
+        endpoints: {
+          health: 'GET /zendesk/health (no auth)',
+          status: 'GET /zendesk/status (requires X-API-Key)',
+          api: 'See Zendesk API documentation (requires X-API-Key)',
+        },
+      });
+    }
+
+    // API proxy endpoint (requires API key + Zendesk auth)
+    if (path.startsWith('/zendesk/api/') || path.startsWith('/api/')) {
+      const authHeader = req.headers.get('Authorization');
+
+      if (!authHeader) {
+        return jsonResponse(
+          { error: 'Authorization header required for Zendesk API', code: 'ZENDESK_AUTH_REQUIRED' },
+          401
+        );
+      }
+
+      // Extract the Zendesk subdomain from query params or header
+      const subdomain = url.searchParams.get('subdomain') || req.headers.get('X-Zendesk-Subdomain');
+
+      if (!subdomain) {
+        return jsonResponse(
+          {
+            error: 'Zendesk subdomain required',
+            code: 'MISSING_SUBDOMAIN',
+            hint: 'Provide subdomain via query param (?subdomain=xxx) or X-Zendesk-Subdomain header'
+          },
+          400
+        );
+      }
+
+      // Build the Zendesk API URL
+      const apiPath = path.replace('/zendesk/api/', '').replace('/api/', '');
+      const zendeskUrl = `https://${subdomain}.zendesk.com/api/v2/${apiPath}${url.search}`;
+
+      try {
+        // Forward the request to Zendesk
+        const response = await fetch(zendeskUrl, {
+          method: req.method,
+          headers: {
+            'Authorization': authHeader,
+            'Content-Type': 'application/json',
+            'Accept': 'application/json',
+          },
+          body: req.method !== 'GET' && req.method !== 'HEAD' ? await req.text() : undefined,
+        });
+
+        const data = await response.json();
+        return jsonResponse(data, response.status);
+      } catch (err) {
+        return jsonResponse(
+          {
+            error: 'Failed to proxy request to Zendesk',
+            code: 'PROXY_ERROR',
+            details: String(err),
+          },
+          502
+        );
+      }
+    }
+
+    // 404 for unknown routes
+    return jsonResponse(
+      {
+        error: 'Not found',
+        code: 'NOT_FOUND',
+        path,
+      },
+      404
+    );
+  },
+
+  error(error) {
+    console.error('Server error:', error);
+    return jsonResponse(
+      { error: 'Internal server error', code: 'INTERNAL_ERROR' },
+      500
+    );
+  },
+});
+
+console.log(`🚀 connect-zendesk server running at http://${HOST}:${PORT}`);
+console.log(`   Health: http://${HOST}:${PORT}/zendesk/health (no auth)`);
+console.log(`   Status: http://${HOST}:${PORT}/zendesk/status (requires X-API-Key)`);
+console.log(`   API Key configured: ${API_KEY ? 'Yes' : 'No'}`);
+
+export { server };