@nextsparkjs/core 0.1.0-beta.1 → 0.1.0-beta.3

package/dist/templates/contents/themes/starter/templates/(public)/page.tsx

@@ -0,0 +1,37 @@
+import { getTranslations } from 'next-intl/server'
+import Link from 'next/link'
+import { Button } from '@nextsparkjs/core/components/ui/button'
+
+export default async function HomePage() {
+  const t = await getTranslations('home')
+
+  return (
+    <main className="flex min-h-screen flex-col" data-cy="home-page">
+      {/* Hero Section */}
+      <section className="flex flex-col items-center justify-center px-4 py-24 text-center">
+        <h1 className="text-4xl font-bold tracking-tight sm:text-6xl">
+          {t('hero.title')}
+        </h1>
+        <p className="mt-6 text-lg text-muted-foreground max-w-2xl">
+          {t('hero.subtitle')}
+        </p>
+        <div className="mt-10">
+          <Button asChild size="lg">
+            <Link href="/dashboard">{t('hero.cta')}</Link>
+          </Button>
+        </div>
+      </section>
+
+      {/* Features Section */}
+      <section className="px-4 py-24 bg-muted/50">
+        <div className="max-w-6xl mx-auto">
+          <h2 className="text-3xl font-bold text-center">{t('features.title')}</h2>
+          <p className="mt-4 text-center text-muted-foreground">
+            {t('features.subtitle')}
+          </p>
+          {/* Feature cards would go here */}
+        </div>
+      </section>
+    </main>
+  )
+}

package/dist/templates/contents/themes/starter/templates/(public)/support/page.tsx

@@ -0,0 +1,14 @@
+import { getTranslations } from 'next-intl/server'
+
+export default async function SupportPage() {
+  const t = await getTranslations('common')
+
+  return (
+    <main className="container py-12" data-cy="support-page">
+      <h1 className="text-3xl font-bold">Support</h1>
+      <p className="mt-4 text-muted-foreground">
+        Get help with the Starter theme.
+      </p>
+    </main>
+  )
+}

package/dist/templates/contents/themes/starter/tests/cypress/e2e/tasks/TaskAPIController.js

@@ -0,0 +1,240 @@
+/**
+ * TaskAPIController - Controller for interacting with the Tasks API
+ * Encapsulates all CRUD operations for /api/v1/tasks endpoints
+ *
+ * Requires:
+ * - API Key with tasks:read, tasks:write scopes (or superadmin with *)
+ * - x-team-id header for team context
+ */
+const BaseAPIController = require('../../src/controllers/BaseAPIController')
+const entitiesConfig = require('../../fixtures/entities.json')
+
+const { slug } = entitiesConfig.entities.tasks
+
+class TaskAPIController extends BaseAPIController {
+  /**
+   * @param {string} baseUrl - Base URL for API requests
+   * @param {string|null} apiKey - API key for authentication
+   * @param {string|null} teamId - Team ID for x-team-id header
+   */
+  constructor(baseUrl = 'http://localhost:5173', apiKey = null, teamId = null) {
+    super(baseUrl, apiKey, teamId, { slug })
+  }
+
+  // ============================================================
+  // SEMANTIC ALIASES (for backward compatibility)
+  // ============================================================
+
+  /**
+   * GET /api/v1/tasks - Get list of tasks
+   * @param {Object} options - Query options
+   * @param {number} [options.page] - Page number
+   * @param {number} [options.limit] - Results per page
+   * @param {string} [options.status] - Filter by status (todo, in-progress, review, done, blocked)
+   * @param {string} [options.priority] - Filter by priority (low, medium, high, urgent)
+   * @param {string} [options.metas] - Metadata parameter ('all', 'key1,key2', etc.)
+   * @param {string} [options.search] - Search in title/description
+   * @param {Object} [options.headers] - Additional headers
+   * @returns {Cypress.Chainable} Cypress response
+   */
+  getTasks(options = {}) {
+    return this.list(options)
+  }
+
+  /**
+   * GET /api/v1/tasks/{id} - Get specific task by ID
+   * @param {string} id - Task ID
+   * @param {Object} options - Additional options
+   * @returns {Cypress.Chainable} Cypress response
+   */
+  getTaskById(id, options = {}) {
+    return this.getById(id, options)
+  }
+
+  /**
+   * POST /api/v1/tasks - Create new task
+   * @param {Object} taskData - Task data
+   * @param {string} taskData.title - Task title (required)
+   * @param {string} [taskData.description] - Task description
+   * @param {string} [taskData.status] - Status: todo, in-progress, review, done, blocked
+   * @param {string} [taskData.priority] - Priority: low, medium, high, urgent
+   * @param {string[]} [taskData.tags] - Array of tags
+   * @param {string} [taskData.dueDate] - Due date YYYY-MM-DD
+   * @param {number} [taskData.estimatedHours] - Estimated hours
+   * @param {Object} [taskData.metas] - Metadata object
+   * @param {Object} options - Additional options
+   * @returns {Cypress.Chainable} Cypress response
+   */
+  createTask(taskData, options = {}) {
+    return this.create(taskData, options)
+  }
+
+  /**
+   * PATCH /api/v1/tasks/{id} - Update task
+   * @param {string} id - Task ID
+   * @param {Object} updateData - Data to update
+   * @param {Object} options - Additional options
+   * @returns {Cypress.Chainable} Cypress response
+   */
+  updateTask(id, updateData, options = {}) {
+    return this.update(id, updateData, options)
+  }
+
+  /**
+   * DELETE /api/v1/tasks/{id} - Delete task
+   * @param {string} id - Task ID
+   * @param {Object} options - Additional options
+   * @returns {Cypress.Chainable} Cypress response
+   */
+  deleteTask(id, options = {}) {
+    return this.delete(id, options)
+  }
+
+  // ============================================================
+  // DATA GENERATORS
+  // ============================================================
+
+  /**
+   * Generate random task data for testing
+   * @param {Object} overrides - Specific data to override
+   * @returns {Object} Generated task data
+   */
+  generateRandomData(overrides = {}) {
+    return this.generateRandomTaskData(overrides)
+  }
+
+  /**
+   * Generate random task data for testing
+   * @param {Object} overrides - Specific data to override
+   * @returns {Object} Generated task data
+   */
+  generateRandomTaskData(overrides = {}) {
+    const timestamp = Date.now()
+    const randomId = Math.random().toString(36).substring(2, 8)
+
+    return {
+      title: `Test Task ${randomId} - ${timestamp}`,
+      description: `Description for test task created at ${new Date().toISOString()}`,
+      status: 'todo',
+      priority: 'medium',
+      tags: [],
+      ...overrides
+    }
+  }
+
+  /**
+   * Create a test task and return its data
+   * @param {Object} taskData - Task data (optional)
+   * @returns {Cypress.Chainable} Promise resolving with created task data
+   */
+  createTestTask(taskData = {}) {
+    return this.createTestEntity(taskData)
+  }
+
+  /**
+   * Clean up a test task (delete it)
+   * @param {string} id - Task ID
+   * @returns {Cypress.Chainable} Delete response
+   */
+  cleanupTestTask(id) {
+    return this.cleanup(id)
+  }
+
+  // ============================================================
+  // ENTITY-SPECIFIC VALIDATORS
+  // ============================================================
+
+  /**
+   * Validate task object structure
+   * @param {Object} task - Task object
+   * @param {boolean} allowMetas - If metas property is allowed
+   */
+  validateTaskObject(task, allowMetas = false) {
+    // Base fields
+    this.validateBaseEntityFields(task)
+
+    // Required entity fields
+    expect(task).to.have.property('title')
+    expect(task.title).to.be.a('string')
+
+    // Optional fields with defaults
+    expect(task).to.have.property('status')
+    expect(task.status).to.be.oneOf(['todo', 'in-progress', 'review', 'done', 'blocked'])
+
+    expect(task).to.have.property('priority')
+    expect(task.priority).to.be.oneOf(['low', 'medium', 'high', 'urgent'])
+
+    expect(task).to.have.property('completed')
+    expect(task.completed).to.be.a('boolean')
+
+    expect(task).to.have.property('tags')
+    expect(task.tags).to.be.an('array')
+
+    // Optional fields that can be null
+    if (task.description !== null && task.description !== undefined) {
+      expect(task.description).to.be.a('string')
+    }
+
+    if (task.dueDate !== null && task.dueDate !== undefined) {
+      expect(task.dueDate).to.be.a('string')
+    }
+
+    if (task.estimatedHours !== null && task.estimatedHours !== undefined) {
+      // Note: NUMERIC type comes back as string from PostgreSQL
+      expect(typeof task.estimatedHours === 'number' || typeof task.estimatedHours === 'string').to.be.true
+    }
+
+    // Validate metas if present
+    if (allowMetas && task.hasOwnProperty('metas')) {
+      expect(task.metas).to.be.an('object')
+    }
+  }
+
+  // ============================================================
+  // METADATA HELPERS
+  // ============================================================
+
+  /**
+   * Generate sample metadata for testing
+   * @param {string} type - Type of metadata ('uiPreferences', 'notifications', 'tracking', 'customFields')
+   * @returns {Object} Sample metadata
+   */
+  generateSampleMetadata(type = 'uiPreferences') {
+    const sampleMetas = {
+      uiPreferences: {
+        colorLabel: 'blue',
+        showInKanban: true,
+        collapsed: false,
+        customIcon: 'star'
+      },
+      notifications: {
+        emailOnDue: true,
+        reminderDays: 3,
+        notifyAssignee: true,
+        channels: ['email', 'slack']
+      },
+      tracking: {
+        actualHours: 5.5,
+        startedAt: '2025-12-01T10:00:00Z',
+        completedAt: null,
+        progressPercent: 75
+      },
+      customFields: {
+        clientRef: 'PRJ-001',
+        department: 'Engineering',
+        billable: true,
+        hourlyRate: 150
+      }
+    }
+
+    return { [type]: sampleMetas[type] || sampleMetas.uiPreferences }
+  }
+}
+
+// Export class for use in tests
+module.exports = TaskAPIController
+
+// For global use in Cypress
+if (typeof window !== 'undefined') {
+  window.TaskAPIController = TaskAPIController
+}

package/dist/templates/contents/themes/starter/tests/cypress/e2e/tasks/TasksPOM.ts

@@ -0,0 +1,246 @@
+/**
+ * TasksPOM - Page Object Model for Tasks entity
+ *
+ * Extends DashboardEntityPOM with task-specific form handling and workflows.
+ *
+ * @example
+ * // Instance usage with chaining
+ * TasksPOM.create()
+ *   .visitList()
+ *   .waitForList()
+ *   .clickAdd()
+ *   .fillTaskForm({ title: 'New Task', priority: 'high' })
+ *   .submitForm()
+ *
+ * // API-aware workflow
+ * const tasks = new TasksPOM()
+ * tasks.createTaskWithApiWait({
+ *   title: 'New Task',
+ *   description: 'Task description',
+ *   status: 'todo',
+ *   priority: 'high'
+ * })
+ */
+
+import { DashboardEntityPOM } from '../../src/core/DashboardEntityPOM'
+import entitiesConfig from '../../fixtures/entities.json'
+
+export interface TaskFormData {
+  title: string
+  description?: string
+  status?: 'todo' | 'in-progress' | 'review' | 'done' | 'blocked'
+  priority?: 'low' | 'medium' | 'high' | 'urgent'
+  dueDate?: string
+  estimatedHours?: string
+  completed?: boolean
+}
+
+export class TasksPOM extends DashboardEntityPOM {
+  constructor() {
+    super(entitiesConfig.entities.tasks.slug)
+  }
+
+  // ============================================
+  // FACTORY METHOD
+  // ============================================
+
+  static create(): TasksPOM {
+    return new TasksPOM()
+  }
+
+  // ============================================
+  // ENTITY-SPECIFIC FORM METHODS
+  // ============================================
+
+  /**
+   * Fill task form with provided data
+   * Only fills fields that are provided in the data object
+   */
+  fillTaskForm(data: TaskFormData) {
+    if (data.title) {
+      this.fillTextField('title', data.title)
+    }
+    if (data.description) {
+      this.fillTextarea('description', data.description)
+    }
+    if (data.status) {
+      this.selectOption('status', data.status)
+    }
+    if (data.priority) {
+      this.selectOption('priority', data.priority)
+    }
+    if (data.dueDate) {
+      this.fillTextField('dueDate', data.dueDate)
+    }
+    if (data.estimatedHours) {
+      this.fillTextField('estimatedHours', data.estimatedHours)
+    }
+    return this
+  }
+
+  // ============================================
+  // WORKFLOW METHODS
+  // ============================================
+
+  /**
+   * Complete create flow without API waits
+   */
+  createTask(data: TaskFormData) {
+    this.visitCreate()
+    this.waitForForm()
+    this.fillTaskForm(data)
+    this.submitForm()
+    return this
+  }
+
+  /**
+   * Create task with API intercepts and waits
+   * Deterministic: waits for actual API responses
+   */
+  createTaskWithApiWait(data: TaskFormData) {
+    this.setupApiIntercepts()
+    this.clickAdd()
+    this.waitForForm()
+    this.fillTaskForm(data)
+    this.submitForm()
+    this.api.waitForCreate()
+    return this
+  }
+
+  /**
+   * Create task from list page and wait for refresh
+   */
+  createTaskFromListWithApiWait(data: TaskFormData) {
+    this.setupApiIntercepts()
+    this.clickAdd()
+    this.waitForForm()
+    this.fillTaskForm(data)
+    this.submitForm()
+    this.api.waitForCreateAndRefresh()
+    return this
+  }
+
+  /**
+   * Update task with API waits
+   */
+  updateTaskWithApiWait(data: Partial<TaskFormData>) {
+    this.fillTaskForm(data as TaskFormData)
+    this.submitForm()
+    this.api.waitForUpdate()
+    return this
+  }
+
+  /**
+   * Delete task with API waits
+   * Flow: Navigate to detail -> Delete -> Confirm
+   */
+  deleteTaskWithApiWait(id: string) {
+    this.visitDetailWithApiWait(id)
+    this.clickDelete()
+    this.confirmDelete()
+    this.api.waitForDelete()
+    return this
+  }
+
+  /**
+   * Delete task by finding it in the list by name
+   */
+  deleteTaskByNameWithApiWait(name: string) {
+    this.clickRowByText(name)
+    this.waitForDetail()
+    this.clickDelete()
+    this.confirmDelete()
+    this.api.waitForDelete()
+    return this
+  }
+
+  // ============================================
+  // FILTER METHODS
+  // ============================================
+
+  /**
+   * Filter tasks by status
+   */
+  filterByStatus(status: string) {
+    this.selectFilter('status', status)
+    return this
+  }
+
+  /**
+   * Filter tasks by priority
+   */
+  filterByPriority(priority: string) {
+    this.selectFilter('priority', priority)
+    return this
+  }
+
+  /**
+   * Clear status filter
+   */
+  clearStatusFilter() {
+    this.clearFilter('status')
+    return this
+  }
+
+  /**
+   * Clear priority filter
+   */
+  clearPriorityFilter() {
+    this.clearFilter('priority')
+    return this
+  }
+
+  // ============================================
+  // ENTITY-SPECIFIC ASSERTIONS
+  // ============================================
+
+  /**
+   * Assert task appears in list
+   */
+  assertTaskInList(title: string) {
+    return this.assertInList(title)
+  }
+
+  /**
+   * Assert task does not appear in list
+   */
+  assertTaskNotInList(title: string) {
+    return this.assertNotInList(title)
+  }
+
+  /**
+   * Assert task has specific status in list
+   */
+  assertTaskStatus(title: string, status: string) {
+    cy.contains(this.selectors.rowGeneric, title)
+      .should('contain.text', status)
+    return this
+  }
+
+  /**
+   * Assert task has specific priority in list
+   */
+  assertTaskPriority(title: string, priority: string) {
+    cy.contains(this.selectors.rowGeneric, title)
+      .should('contain.text', priority)
+    return this
+  }
+
+  /**
+   * Assert task count in list
+   */
+  assertTaskCount(count: number) {
+    cy.get(this.selectors.rowGeneric).should('have.length', count)
+    return this
+  }
+
+  /**
+   * Assert no tasks in list
+   */
+  assertNoTasks() {
+    cy.get(this.selectors.rowGeneric).should('not.exist')
+    return this
+  }
+}
+
+export default TasksPOM