@zintrust/workers 0.1.27

package/src/ui/services/workerApi.js

@@ -0,0 +1,240 @@
+/* eslint-disable @typescript-eslint/explicit-function-return-type */
+/**
+ * Worker API Service
+ * HTTP client for worker management operations
+ */
+
+/**
+ * Create HTTP request handler for worker API
+ * @param {string} baseUrl - The base URL for the API
+ * @returns {Function} HTTP request handler function
+ */
+const createRequestHandler = (baseUrl) => {
+  return async (endpoint, options = {}) => {
+    const url = `${baseUrl}${endpoint}`;
+    const config = {
+      headers: {
+        'Content-Type': 'application/json',
+        ...options.headers,
+      },
+      ...options,
+    };
+
+    try {
+      const response = await fetch(url, config);
+      const data = await response.json();
+
+      if (!response.ok) {
+        return {
+          success: false,
+          error: data.error || `HTTP ${response.status}: ${response.statusText}`,
+          code: data.code || 'HTTP_ERROR',
+          status: response.status,
+        };
+      }
+
+      return {
+        success: true,
+        data: data.data || data,
+        message: data.message,
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error.message || 'Network error',
+        code: 'NETWORK_ERROR',
+      };
+    }
+  };
+};
+
+/**
+ * Create query operations for worker API
+ * @param {Function} request - HTTP request handler function
+ * @returns {Object} Query operations object
+ */
+const createQueryOperations = (request) => ({
+  /**
+   * Get all workers with optional query parameters
+   * @param {Object} params - Query parameters
+   * @returns {Promise<Object>} API response
+   */
+  getWorkers: async (params = {}) => {
+    const queryString = new URLSearchParams(params).toString();
+    const endpoint = queryString ? `?${queryString}` : '';
+
+    return await request(endpoint);
+  },
+
+  /**
+   * Get a specific worker by ID
+   * @param {string} workerId - Worker ID
+   * @returns {Promise<Object>} API response
+   */
+  getWorker: async (workerId) => {
+    return await request(`/${workerId}`);
+  },
+
+  /**
+   * Get worker data as JSON
+   * @param {string} workerId - Worker ID
+   * @returns {Promise<Object>} API response
+   */
+  getWorkerJson: async (workerId) => {
+    return await request(`/${workerId}/json`);
+  },
+
+  /**
+   * Get worker metrics
+   * @param {string} workerId - Worker ID
+   * @returns {Promise<Object>} API response
+   */
+  getWorkerMetrics: async (workerId) => {
+    return await request(`/${workerId}/metrics`);
+  },
+
+  /**
+   * Get worker logs with optional query parameters
+   * @param {string} workerId - Worker ID
+   * @param {Object} params - Query parameters
+   * @returns {Promise<Object>} API response
+   */
+  getWorkerLogs: async (workerId, params = {}) => {
+    const queryString = new URLSearchParams(params).toString();
+    const endpoint = queryString ? `/${workerId}/logs?${queryString}` : `/${workerId}/logs`;
+
+    return await request(endpoint);
+  },
+});
+
+/**
+ * Create mutation operations for worker API
+ * @param {Function} request - HTTP request handler function
+ * @returns {Object} Mutation operations object
+ */
+const createMutationOperations = (request) => ({
+  /**
+   * Update a worker
+   * @param {string} workerId - Worker ID
+   * @param {Object} workerData - Worker data to update
+   * @returns {Promise<Object>} API response
+   */
+  updateWorker: async (workerId, workerData) => {
+    return await request(`/${workerId}`, {
+      method: 'PUT',
+      body: JSON.stringify(workerData),
+    });
+  },
+
+  /**
+   * Update worker data as JSON
+   * @param {string} workerId - Worker ID
+   * @param {Object} workerData - Worker data to update
+   * @returns {Promise<Object>} API response
+   */
+  updateWorkerJson: async (workerId, workerData) => {
+    return await request(`/${workerId}/json`, {
+      method: 'PUT',
+      body: JSON.stringify(workerData),
+    });
+  },
+
+  /**
+   * Create a new worker
+   * @param {Object} workerData - Worker data to create
+   * @returns {Promise<Object>} API response
+   */
+  createWorker: async (workerData) => {
+    return await request('', {
+      method: 'POST',
+      body: JSON.stringify(workerData),
+    });
+  },
+
+  /**
+   * Delete a worker
+   * @param {string} workerId - Worker ID
+   * @returns {Promise<Object>} API response
+   */
+  deleteWorker: async (workerId) => {
+    return await request(`/${workerId}`, {
+      method: 'DELETE',
+    });
+  },
+});
+
+/**
+ * Create control operations for worker API
+ * @param {Function} request - HTTP request handler function
+ * @returns {Object} Control operations object
+ */
+const createControlOperations = (request) => ({
+  /**
+   * Start a worker
+   * @param {string} workerId - Worker ID
+   * @param {string} driver - Driver type
+   * @returns {Promise<Object>} API response
+   */
+  startWorker: async (workerId, driver) => {
+    return await request(`/${workerId}/start`, {
+      method: 'POST',
+      body: JSON.stringify({ driver }),
+    });
+  },
+
+  /**
+   * Stop a worker
+   * @param {string} workerId - Worker ID
+   * @param {string} driver - Driver type
+   * @returns {Promise<Object>} API response
+   */
+  stopWorker: async (workerId, driver) => {
+    return await request(`/${workerId}/stop`, {
+      method: 'POST',
+      body: JSON.stringify({ driver }),
+    });
+  },
+
+  /**
+   * Set auto-start configuration for a worker
+   * @param {string} workerId - Worker ID
+   * @param {boolean} autoStart - Auto-start setting
+   * @param {string} driver - Driver type
+   * @returns {Promise<Object>} API response
+   */
+  setAutoStart: async (workerId, autoStart, driver) => {
+    return await request(`/${workerId}/auto-start`, {
+      method: 'POST',
+      body: JSON.stringify({ autoStart, driver }),
+    });
+  },
+});
+
+/**
+ * Worker API service for HTTP requests
+ * @returns {Object} Worker API instance with all operations
+ */
+const createWorkerApi = () => {
+  const baseUrl = '/api/workers';
+  const request = createRequestHandler(baseUrl);
+
+  const queryOps = createQueryOperations(request);
+  const mutationOps = createMutationOperations(request);
+  const controlOps = createControlOperations(request);
+
+  return {
+    ...queryOps,
+    ...mutationOps,
+    ...controlOps,
+  };
+};
+
+/**
+ * Sealed namespace for Worker API
+ */
+export const workerApi = Object.freeze({
+  create: createWorkerApi,
+});
+
+// Create default instance
+export default createWorkerApi();

package/src/ui/types/worker-ui.ts

@@ -0,0 +1,283 @@
+/**
+ * Worker UI Types
+ * Type definitions for worker management UI components
+ */
+
+// DOM types for browser environment
+declare global {
+  interface HTMLElement {
+    appendChild(node: Node): Node;
+    remove(): void;
+    classList: DOMTokenList;
+    style: CSSStyleDeclaration;
+    textContent: string;
+    // Note: innerHTML is included for legitimate use cases (JSON highlighting, safe HTML templates)
+    // Always sanitize content before using innerHTML to prevent XSS attacks
+    // eslint-disable-next-line no-restricted-syntax
+    innerHTML: string;
+    className: string;
+    id: string;
+    querySelector(selector: string): Element | null;
+    addEventListener(type: string, listener: UIEventListener): void;
+    dataset: DOMStringMap;
+  }
+
+  // UIEventListener type for browser environment
+  type UIEventListener = (evt: Event) => void;
+
+  interface Event {
+    target: EventTarget | null;
+  }
+
+  interface Element {
+    querySelector(selector: string): Element | null;
+  }
+
+  interface EventTarget {
+    addEventListener(type: string, listener: UIEventListener): void;
+  }
+
+  interface DOMTokenList {
+    add(token: string): void;
+    remove(token: string): void;
+  }
+
+  interface CSSStyleDeclaration {
+    display:
+      | 'block'
+      | 'none'
+      | 'inline'
+      | 'inline-block'
+      | 'flex'
+      | 'grid'
+      | 'hidden'
+      | 'inherit'
+      | 'initial'
+      | 'revert'
+      | 'unset'
+      | number;
+    [property: string]: string | number;
+  }
+
+  interface DOMStringMap {
+    [key: string]: string;
+  }
+
+  interface Node {
+    remove(): void;
+  }
+}
+
+// Make DOM types available for exported interfaces
+export interface Node {
+  remove(): void;
+}
+
+export interface DOMTokenList {
+  add(token: string): void;
+  remove(token: string): void;
+}
+
+export interface CSSStyleDeclaration {
+  display: string | number;
+  [property: string]: string | number;
+}
+
+export interface DOMStringMap {
+  [key: string]: string;
+}
+
+export interface Element {
+  querySelector(selector: string): Element | null;
+}
+
+export interface EventTarget {
+  addEventListener(type: string, listener: UIEventListener): void;
+}
+
+export interface Event {
+  target: EventTarget | null;
+}
+
+// UIEventListener type for browser environment
+export type UIEventListener = (evt: Event) => void;
+
+export interface HTMLElement {
+  appendChild(node: Node): Node;
+  remove(): void;
+  classList: DOMTokenList;
+  style: CSSStyleDeclaration;
+  textContent: string;
+  // Note: innerHTML is included for legitimate use cases (JSON highlighting, safe HTML templates)
+  // Always sanitize content before using innerHTML to prevent XSS attacks
+  // eslint-disable-next-line no-restricted-syntax
+  innerHTML: string;
+  className: string;
+  id: string;
+  querySelector(selector: string): Element | null;
+  addEventListener(type: string, listener: UIEventListener): void;
+  dataset: DOMStringMap;
+}
+
+/**
+ * Worker instance interface for UI components
+ */
+export interface WorkerInstance {
+  id: string;
+  name: string;
+  status: 'running' | 'stopped' | 'failed' | 'paused';
+  queueName: string;
+  driver: 'database' | 'redis' | 'memory';
+  concurrency: number;
+  autoStart: boolean;
+  createdAt: string;
+  updatedAt: string;
+  lastHealthCheck?: string;
+  lastError?: string;
+  connectionState?: 'connected' | 'disconnected' | 'connecting';
+  version?: string;
+  region?: string;
+  processor?: string;
+  features?: Record<string, boolean>;
+  infrastructure?: Record<string, unknown>;
+  datacenter?: Record<string, unknown>;
+}
+
+/**
+ * Worker card instance interface
+ */
+export interface WorkerCardInstance {
+  element: HTMLElement;
+  worker: WorkerInstance;
+  isExpanded: () => boolean;
+  toggleExpand: () => void;
+  updateWorker: (worker: WorkerInstance) => void;
+  destroy: () => void;
+}
+
+/**
+ * Worker expand panel instance interface
+ */
+export interface WorkerExpandPanelInstance {
+  element: HTMLElement;
+  worker: WorkerInstance;
+  render: () => void;
+  destroy: () => void;
+}
+
+/**
+ * JSON viewer modal instance interface
+ */
+export interface JsonViewerInstance {
+  element: HTMLElement;
+  isOpen: () => boolean;
+  open: (data: unknown) => void;
+  close: () => void;
+  destroy: () => void;
+}
+
+/**
+ * JSON editor modal instance interface
+ */
+export interface JsonEditorInstance {
+  element: HTMLElement;
+  isOpen: () => boolean;
+  open: (data: unknown) => void;
+  close: () => void;
+  getJsonData: () => unknown;
+  setJsonData: (data: unknown) => void;
+  validate: () => ValidationResult;
+  destroy: () => void;
+}
+
+/**
+ * Validation result interface
+ */
+export interface ValidationResult {
+  isValid: boolean;
+  errors: ValidationError[];
+  warnings: ValidationWarning[];
+}
+
+/**
+ * Validation error interface
+ */
+export interface ValidationError {
+  path: string;
+  message: string;
+  code: string;
+  field?: string;
+}
+
+/**
+ * Validation warning interface
+ */
+export interface ValidationWarning {
+  path: string;
+  message: string;
+  code: string;
+  field?: string;
+}
+
+/**
+ * Modal options interface
+ */
+export interface ModalOptions {
+  title?: string;
+  width?: string;
+  height?: string;
+  closable?: boolean;
+  backdrop?: boolean;
+}
+
+/**
+ * JSON viewer options interface
+ */
+export interface JsonViewerOptions extends ModalOptions {
+  expandAll?: boolean;
+  searchEnabled?: boolean;
+  copyEnabled?: boolean;
+  theme?: 'light' | 'dark';
+}
+
+/**
+ * JSON editor options interface
+ */
+export interface JsonEditorOptions extends ModalOptions {
+  validateOnChange?: boolean;
+  autoFormat?: boolean;
+  theme?: 'light' | 'dark';
+  fontSize?: number;
+  wordWrap?: boolean;
+}
+
+/**
+ * API response interface
+ */
+export interface ApiResponse<T = unknown> {
+  success: boolean;
+  data?: T;
+  error?: string;
+  message?: string;
+  code?: string;
+}
+
+/**
+ * Worker API response interface
+ */
+export interface WorkerApiResponse extends ApiResponse<WorkerInstance> {
+  data?: WorkerInstance;
+}
+
+/**
+ * Workers list API response interface
+ */
+export interface WorkersListApiResponse extends ApiResponse<WorkerInstance[]> {
+  data?: WorkerInstance[];
+  pagination?: {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+  };
+}