proagents 1.0.0

package/proagents/scaffolding/react/templates/service.ts.template

@@ -0,0 +1,155 @@
+/**
+ * {{ServiceName}} Service
+ *
+ * {{description}}
+ *
+ * @example
+ * ```ts
+ * const service = new {{ServiceName}}();
+ * const result = await service.getById('123');
+ * ```
+ */
+
+import { api } from '@/lib/api';
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface {{EntityName}} {
+  id: string;
+  name: string;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface Create{{EntityName}}Input {
+  name: string;
+}
+
+export interface Update{{EntityName}}Input {
+  name?: string;
+}
+
+export interface {{EntityName}}ListParams {
+  page?: number;
+  limit?: number;
+  search?: string;
+  sortBy?: keyof {{EntityName}};
+  sortOrder?: 'asc' | 'desc';
+}
+
+export interface {{EntityName}}ListResponse {
+  data: {{EntityName}}[];
+  total: number;
+  page: number;
+  limit: number;
+  totalPages: number;
+}
+
+// ============================================================================
+// Service Class
+// ============================================================================
+
+/**
+ * {{ServiceName}}
+ *
+ * Handles all {{entityName}} related operations
+ */
+export class {{ServiceName}} {
+  private readonly basePath = '/api/{{kebabCase entityName}}s';
+
+  // ==========================================================================
+  // CRUD Operations
+  // ==========================================================================
+
+  /**
+   * Get all {{entityName}}s with pagination
+   */
+  async getAll(params: {{EntityName}}ListParams = {}): Promise<{{EntityName}}ListResponse> {
+    const {
+      page = 1,
+      limit = 10,
+      search,
+      sortBy = 'createdAt',
+      sortOrder = 'desc',
+    } = params;
+
+    const queryParams = new URLSearchParams({
+      page: String(page),
+      limit: String(limit),
+      sortBy,
+      sortOrder,
+      ...(search && { search }),
+    });
+
+    const response = await api.get<{{EntityName}}ListResponse>(
+      `${this.basePath}?${queryParams}`
+    );
+
+    return response;
+  }
+
+  /**
+   * Get a single {{entityName}} by ID
+   */
+  async getById(id: string): Promise<{{EntityName}}> {
+    const response = await api.get<{{EntityName}}>(`${this.basePath}/${id}`);
+    return response;
+  }
+
+  /**
+   * Create a new {{entityName}}
+   */
+  async create(input: Create{{EntityName}}Input): Promise<{{EntityName}}> {
+    const response = await api.post<{{EntityName}}>(this.basePath, input);
+    return response;
+  }
+
+  /**
+   * Update an existing {{entityName}}
+   */
+  async update(id: string, input: Update{{EntityName}}Input): Promise<{{EntityName}}> {
+    const response = await api.patch<{{EntityName}}>(`${this.basePath}/${id}`, input);
+    return response;
+  }
+
+  /**
+   * Delete a {{entityName}}
+   */
+  async delete(id: string): Promise<void> {
+    await api.delete(`${this.basePath}/${id}`);
+  }
+
+  // ==========================================================================
+  // Additional Operations
+  // ==========================================================================
+
+  /**
+   * Check if a {{entityName}} exists
+   */
+  async exists(id: string): Promise<boolean> {
+    try {
+      await this.getById(id);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * Search {{entityName}}s
+   */
+  async search(query: string): Promise<{{EntityName}}[]> {
+    const response = await this.getAll({ search: query, limit: 20 });
+    return response.data;
+  }
+}
+
+// ============================================================================
+// Singleton Export
+// ============================================================================
+
+export const {{camelCase serviceName}} = new {{ServiceName}}();
+
+export default {{camelCase serviceName}};

package/proagents/scaffolding/react/templates/test.tsx.template

@@ -0,0 +1,149 @@
+/**
+ * {{ComponentName}} Component Tests
+ */
+
+import React from 'react';
+import { render, screen, fireEvent, waitFor } from '@testing-library/react';
+import userEvent from '@testing-library/user-event';
+import { {{ComponentName}} } from './{{ComponentName}}';
+import type { {{ComponentName}}Props } from './{{ComponentName}}';
+
+// ============================================================================
+// Test Utilities
+// ============================================================================
+
+const defaultProps: {{ComponentName}}Props = {
+  title: 'Test Title',
+  description: 'Test Description',
+};
+
+function renderComponent(props: Partial<{{ComponentName}}Props> = {}) {
+  const mergedProps = { ...defaultProps, ...props };
+  return render(<{{ComponentName}} {...mergedProps} />);
+}
+
+// ============================================================================
+// Tests
+// ============================================================================
+
+describe('{{ComponentName}}', () => {
+  // ==========================================================================
+  // Rendering Tests
+  // ==========================================================================
+
+  describe('rendering', () => {
+    it('should render with required props', () => {
+      renderComponent();
+
+      expect(screen.getByTestId('{{kebabCase ComponentName}}')).toBeInTheDocument();
+      expect(screen.getByText('Test Title')).toBeInTheDocument();
+    });
+
+    it('should render description when provided', () => {
+      renderComponent({ description: 'My description' });
+
+      expect(screen.getByText('My description')).toBeInTheDocument();
+    });
+
+    it('should not render description when not provided', () => {
+      renderComponent({ description: undefined });
+
+      expect(screen.queryByText('Test Description')).not.toBeInTheDocument();
+    });
+
+    it('should render children when provided', () => {
+      render(
+        <{{ComponentName}} title="Title">
+          <span>Child content</span>
+        </{{ComponentName}}>
+      );
+
+      expect(screen.getByText('Child content')).toBeInTheDocument();
+    });
+
+    it('should apply custom className', () => {
+      renderComponent({ className: 'custom-class' });
+
+      expect(screen.getByTestId('{{kebabCase ComponentName}}')).toHaveClass('custom-class');
+    });
+  });
+
+  // ==========================================================================
+  // Interaction Tests
+  // ==========================================================================
+
+  describe('interactions', () => {
+    it('should call onClick when clicked', async () => {
+      const handleClick = jest.fn();
+      renderComponent({ onClick: handleClick });
+
+      await userEvent.click(screen.getByTestId('{{kebabCase ComponentName}}'));
+
+      expect(handleClick).toHaveBeenCalledTimes(1);
+    });
+
+    it('should call onClick when Enter key is pressed', async () => {
+      const handleClick = jest.fn();
+      renderComponent({ onClick: handleClick });
+
+      const element = screen.getByTestId('{{kebabCase ComponentName}}');
+      element.focus();
+      await userEvent.keyboard('{Enter}');
+
+      expect(handleClick).toHaveBeenCalledTimes(1);
+    });
+
+    it('should not have button role when onClick is not provided', () => {
+      renderComponent({ onClick: undefined });
+
+      expect(screen.getByTestId('{{kebabCase ComponentName}}')).not.toHaveAttribute('role');
+    });
+
+    it('should have button role when onClick is provided', () => {
+      renderComponent({ onClick: jest.fn() });
+
+      expect(screen.getByTestId('{{kebabCase ComponentName}}')).toHaveAttribute('role', 'button');
+    });
+  });
+
+  // ==========================================================================
+  // Accessibility Tests
+  // ==========================================================================
+
+  describe('accessibility', () => {
+    it('should be focusable when clickable', () => {
+      renderComponent({ onClick: jest.fn() });
+
+      const element = screen.getByTestId('{{kebabCase ComponentName}}');
+      expect(element).toHaveAttribute('tabIndex', '0');
+    });
+
+    it('should not be focusable when not clickable', () => {
+      renderComponent({ onClick: undefined });
+
+      const element = screen.getByTestId('{{kebabCase ComponentName}}');
+      expect(element).not.toHaveAttribute('tabIndex');
+    });
+  });
+
+  // ==========================================================================
+  // Snapshot Tests
+  // ==========================================================================
+
+  describe('snapshots', () => {
+    it('should match snapshot with default props', () => {
+      const { container } = renderComponent();
+      expect(container).toMatchSnapshot();
+    });
+
+    it('should match snapshot with all props', () => {
+      const { container } = renderComponent({
+        title: 'Full Title',
+        description: 'Full Description',
+        className: 'custom-class',
+        onClick: jest.fn(),
+      });
+      expect(container).toMatchSnapshot();
+    });
+  });
+});