@nextsparkjs/theme-productivity 0.1.0-beta.1

package/entities/cards/migrations/020_cards_table.sql

@@ -0,0 +1,92 @@
+-- ============================================================================
+-- Cards Table Migration
+-- Productivity theme: Task cards within lists
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS "cards" (
+  "id" TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+  "title" VARCHAR(500) NOT NULL,
+  "description" TEXT,
+  "position" INTEGER DEFAULT 0,
+  "priority" VARCHAR(20) DEFAULT 'medium' CHECK ("priority" IN ('low', 'medium', 'high', 'urgent')),
+  "dueDate" DATE,
+  "labels" JSONB DEFAULT '[]'::jsonb,
+  "assigneeId" TEXT REFERENCES "users"("id") ON DELETE SET NULL,
+  "listId" TEXT NOT NULL REFERENCES "lists"("id") ON DELETE CASCADE,
+  "boardId" TEXT NOT NULL REFERENCES "boards"("id") ON DELETE CASCADE,
+  "userId" TEXT NOT NULL REFERENCES "users"("id") ON DELETE CASCADE,
+  "teamId" TEXT NOT NULL REFERENCES "teams"("id") ON DELETE CASCADE,
+  "createdAt" TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  "updatedAt" TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+-- Indexes
+CREATE INDEX IF NOT EXISTS "cards_listId_idx" ON "cards" ("listId");
+CREATE INDEX IF NOT EXISTS "cards_boardId_idx" ON "cards" ("boardId");
+CREATE INDEX IF NOT EXISTS "cards_teamId_idx" ON "cards" ("teamId");
+CREATE INDEX IF NOT EXISTS "cards_assigneeId_idx" ON "cards" ("assigneeId");
+CREATE INDEX IF NOT EXISTS "cards_position_idx" ON "cards" ("listId", "position");
+CREATE INDEX IF NOT EXISTS "cards_dueDate_idx" ON "cards" ("dueDate") WHERE "dueDate" IS NOT NULL;
+CREATE INDEX IF NOT EXISTS "cards_labels_idx" ON "cards" USING GIN ("labels");
+
+-- Enable RLS
+ALTER TABLE "cards" ENABLE ROW LEVEL SECURITY;
+
+-- Drop existing policies
+DROP POLICY IF EXISTS "cards_select_policy" ON "cards";
+DROP POLICY IF EXISTS "cards_insert_policy" ON "cards";
+DROP POLICY IF EXISTS "cards_update_policy" ON "cards";
+DROP POLICY IF EXISTS "cards_delete_policy" ON "cards";
+
+-- Policy: Team members can view cards
+CREATE POLICY "cards_select_policy" ON "cards"
+  FOR SELECT TO authenticated
+  USING (
+    "teamId" = ANY(public.get_user_team_ids())
+    OR public.is_superadmin()
+  );
+
+-- Policy: Team members can create cards
+CREATE POLICY "cards_insert_policy" ON "cards"
+  FOR INSERT TO authenticated
+  WITH CHECK (
+    "teamId" = ANY(public.get_user_team_ids())
+  );
+
+-- Policy: Team members can update cards
+CREATE POLICY "cards_update_policy" ON "cards"
+  FOR UPDATE TO authenticated
+  USING (
+    "teamId" = ANY(public.get_user_team_ids())
+    OR public.is_superadmin()
+  );
+
+-- Policy: Team members can delete cards
+CREATE POLICY "cards_delete_policy" ON "cards"
+  FOR DELETE TO authenticated
+  USING (
+    "teamId" = ANY(public.get_user_team_ids())
+    OR public.is_superadmin()
+  );
+
+-- Trigger for updatedAt
+CREATE OR REPLACE FUNCTION update_cards_updated_at()
+RETURNS TRIGGER AS $$
+BEGIN
+  NEW."updatedAt" = NOW();
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+DROP TRIGGER IF EXISTS cards_updated_at_trigger ON "cards";
+CREATE TRIGGER cards_updated_at_trigger
+  BEFORE UPDATE ON "cards"
+  FOR EACH ROW
+  EXECUTE FUNCTION update_cards_updated_at();
+
+-- Comments
+COMMENT ON TABLE "cards" IS 'Task cards within lists - the main work items';
+COMMENT ON COLUMN "cards"."labels" IS 'JSON array of label strings';
+COMMENT ON COLUMN "cards"."position" IS 'Display order within the parent list';
+COMMENT ON COLUMN "cards"."assigneeId" IS 'Team member assigned to this card';
+COMMENT ON COLUMN "cards"."priority" IS 'Card priority: low, medium, high, urgent';

package/entities/lists/lists.config.ts

@@ -0,0 +1,61 @@
+/**
+ * Lists Entity Configuration
+ * 
+ * Columns within boards (To Do, In Progress, Done, etc.)
+ */
+
+import { List } from 'lucide-react'
+import type { EntityConfig } from '@nextsparkjs/core/lib/entities/types'
+import { listFields } from './lists.fields'
+
+export const listEntityConfig: EntityConfig = {
+  // ==========================================
+  // 1. BASIC IDENTIFICATION
+  // ==========================================
+  slug: 'lists',
+  enabled: true,
+  names: {
+    singular: 'list',
+    plural: 'Lists'
+  },
+  icon: List,
+  
+  // ==========================================
+  // 2. ACCESS AND SCOPE CONFIGURATION
+  // ==========================================
+  access: {
+    public: false,
+    api: true,
+    metadata: false,
+    shared: true
+  },
+  
+  // ==========================================
+  // 3. UI/UX FEATURES
+  // ==========================================
+  ui: {
+    dashboard: {
+      showInMenu: false,    // Lists shown within boards, not separately
+      showInTopbar: false
+    },
+    public: {
+      hasArchivePage: false,
+      hasSinglePage: false
+    },
+    features: {
+      searchable: true,
+      sortable: true,
+      filterable: true,
+      bulkOperations: false,
+      importExport: false
+    }
+  },
+  
+  // ==========================================
+  // FIELDS
+  // ==========================================
+  fields: listFields,
+}
+
+export default listEntityConfig
+

package/entities/lists/lists.fields.ts

@@ -0,0 +1,105 @@
+/**
+ * Lists Entity Fields Configuration
+ */
+
+import type { EntityField } from '@nextsparkjs/core/lib/entities/types'
+
+export const listFields: EntityField[] = [
+  {
+    name: 'name',
+    type: 'text',
+    required: true,
+    display: {
+      label: 'Name',
+      description: 'List name',
+      placeholder: 'Enter list name...',
+      showInList: true,
+      showInDetail: true,
+      showInForm: true,
+      order: 1,
+      columnWidth: 12,
+    },
+    api: {
+      readOnly: false,
+      searchable: true,
+      sortable: true,
+    },
+  },
+  {
+    name: 'position',
+    type: 'number',
+    required: false,
+    defaultValue: 0,
+    display: {
+      label: 'Position',
+      description: 'Display order within board',
+      showInList: false,
+      showInDetail: false,
+      showInForm: false,
+      order: 2,
+    },
+    api: {
+      readOnly: false,
+      searchable: false,
+      sortable: true,
+    },
+  },
+  {
+    name: 'boardId',
+    type: 'reference',
+    required: true,
+    referenceEntity: 'boards',
+    display: {
+      label: 'Board',
+      description: 'Parent board',
+      placeholder: 'Select board...',
+      showInList: true,
+      showInDetail: true,
+      showInForm: true,
+      order: 3,
+      columnWidth: 12,
+    },
+    api: {
+      readOnly: false,
+      searchable: false,
+      sortable: false,
+    },
+  },
+  {
+    name: 'createdAt',
+    type: 'datetime',
+    required: false,
+    display: {
+      label: 'Created At',
+      description: 'When the list was created',
+      showInList: false,
+      showInDetail: true,
+      showInForm: false,
+      order: 98,
+    },
+    api: {
+      readOnly: true,
+      searchable: false,
+      sortable: true,
+    },
+  },
+  {
+    name: 'updatedAt',
+    type: 'datetime',
+    required: false,
+    display: {
+      label: 'Updated At',
+      description: 'When the list was last modified',
+      showInList: false,
+      showInDetail: true,
+      showInForm: false,
+      order: 99,
+    },
+    api: {
+      readOnly: true,
+      searchable: false,
+      sortable: true,
+    },
+  },
+]
+

package/entities/lists/lists.service.ts

@@ -0,0 +1,252 @@
+/**
+ * Lists Service
+ * Provides data access methods for lists entity.
+ */
+import { queryOneWithRLS, queryWithRLS, mutateWithRLS } from '@nextsparkjs/core/lib/db'
+
+export interface List {
+  id: string
+  name: string
+  boardId: string
+  position: number
+  isArchived: boolean
+  userId: string
+  teamId: string
+  createdAt: Date
+  updatedAt: Date
+}
+
+export interface ListListOptions {
+  limit?: number
+  offset?: number
+  orderBy?: string
+  orderDir?: 'asc' | 'desc'
+  teamId?: string
+  boardId?: string
+  isArchived?: boolean
+}
+
+export interface ListListResult {
+  lists: List[]
+  total: number
+}
+
+export interface ListCreateData {
+  name: string
+  boardId: string
+  position?: number
+  isArchived?: boolean
+  teamId: string
+}
+
+export interface ListUpdateData {
+  name?: string
+  boardId?: string
+  position?: number
+  isArchived?: boolean
+}
+
+interface DbList {
+  id: string
+  name: string
+  board_id: string
+  position: number
+  is_archived: boolean
+  user_id: string
+  team_id: string
+  created_at: string
+  updated_at: string
+}
+
+function mapDbList(dbList: DbList): List {
+  return {
+    id: dbList.id,
+    name: dbList.name,
+    boardId: dbList.board_id,
+    position: dbList.position,
+    isArchived: dbList.is_archived,
+    userId: dbList.user_id,
+    teamId: dbList.team_id,
+    createdAt: new Date(dbList.created_at),
+    updatedAt: new Date(dbList.updated_at),
+  }
+}
+
+export class ListsService {
+  /**
+   * Get a list by ID with RLS
+   */
+  static async getById(id: string, userId: string): Promise<List | null> {
+    const result = await queryOneWithRLS<DbList>(
+      userId,
+      `SELECT * FROM lists WHERE id = $1`,
+      [id]
+    )
+
+    return result ? mapDbList(result) : null
+  }
+
+  /**
+   * List lists with RLS and filtering
+   */
+  static async list(userId: string, options: ListListOptions = {}): Promise<ListListResult> {
+    const {
+      limit = 50,
+      offset = 0,
+      orderBy = 'position',
+      orderDir = 'asc',
+      teamId,
+      boardId,
+      isArchived,
+    } = options
+
+    const conditions: string[] = []
+    const params: any[] = []
+    let paramIndex = 1
+
+    if (teamId) {
+      conditions.push(`team_id = $${paramIndex++}`)
+      params.push(teamId)
+    }
+
+    if (boardId) {
+      conditions.push(`board_id = $${paramIndex++}`)
+      params.push(boardId)
+    }
+
+    if (isArchived !== undefined) {
+      conditions.push(`is_archived = $${paramIndex++}`)
+      params.push(isArchived)
+    }
+
+    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : ''
+
+    // Get total count
+    const countResult = await queryOneWithRLS<{ count: string }>(
+      userId,
+      `SELECT COUNT(*) as count FROM lists ${whereClause}`,
+      params
+    )
+    const total = parseInt(countResult?.count || '0', 10)
+
+    // Get lists
+    const validOrderBy = ['position', 'name', 'created_at', 'updated_at'].includes(orderBy)
+      ? orderBy
+      : 'position'
+    const validOrderDir = orderDir === 'desc' ? 'DESC' : 'ASC'
+
+    params.push(limit, offset)
+    const lists = await queryWithRLS<DbList>(
+      userId,
+      `SELECT * FROM lists ${whereClause} ORDER BY ${validOrderBy} ${validOrderDir} LIMIT $${paramIndex++} OFFSET $${paramIndex++}`,
+      params
+    )
+
+    return {
+      lists: lists.map(mapDbList),
+      total,
+    }
+  }
+
+  /**
+   * Get all lists for a specific board
+   */
+  static async getByBoard(boardId: string, userId: string): Promise<List[]> {
+    const result = await this.list(userId, {
+      boardId,
+      orderBy: 'position',
+      orderDir: 'asc',
+      isArchived: false,
+    })
+
+    return result.lists
+  }
+
+  /**
+   * Create a new list with RLS
+   */
+  static async create(userId: string, data: ListCreateData): Promise<List> {
+    const {
+      name,
+      boardId,
+      position = 0,
+      isArchived = false,
+      teamId,
+    } = data
+
+    const result = await mutateWithRLS<DbList>(
+      userId,
+      `INSERT INTO lists (name, board_id, position, is_archived, user_id, team_id)
+       VALUES ($1, $2, $3, $4, $5, $6)
+       RETURNING *`,
+      [name, boardId, position, isArchived, userId, teamId]
+    )
+
+    if (!result) {
+      throw new Error('Failed to create list')
+    }
+
+    return mapDbList(result)
+  }
+
+  /**
+   * Update a list with RLS
+   */
+  static async update(userId: string, id: string, data: ListUpdateData): Promise<List> {
+    const updates: string[] = []
+    const params: any[] = []
+    let paramIndex = 1
+
+    if (data.name !== undefined) {
+      updates.push(`name = $${paramIndex++}`)
+      params.push(data.name)
+    }
+
+    if (data.boardId !== undefined) {
+      updates.push(`board_id = $${paramIndex++}`)
+      params.push(data.boardId)
+    }
+
+    if (data.position !== undefined) {
+      updates.push(`position = $${paramIndex++}`)
+      params.push(data.position)
+    }
+
+    if (data.isArchived !== undefined) {
+      updates.push(`is_archived = $${paramIndex++}`)
+      params.push(data.isArchived)
+    }
+
+    if (updates.length === 0) {
+      throw new Error('No fields to update')
+    }
+
+    updates.push(`updated_at = NOW()`)
+    params.push(id)
+
+    const result = await mutateWithRLS<DbList>(
+      userId,
+      `UPDATE lists SET ${updates.join(', ')} WHERE id = $${paramIndex} RETURNING *`,
+      params
+    )
+
+    if (!result) {
+      throw new Error('List not found or access denied')
+    }
+
+    return mapDbList(result)
+  }
+
+  /**
+   * Delete a list with RLS
+   */
+  static async delete(userId: string, id: string): Promise<boolean> {
+    const result = await mutateWithRLS<DbList>(
+      userId,
+      `DELETE FROM lists WHERE id = $1 RETURNING *`,
+      [id]
+    )
+
+    return result !== null
+  }
+}

package/entities/lists/lists.types.ts

@@ -0,0 +1,55 @@
+/**
+ * List Service Types
+ *
+ * Type definitions for the ListsService.
+ * Lists represent columns within a board that contain cards.
+ *
+ * @module ListsTypes
+ */
+
+// Main entity interface
+export interface List {
+  id: string
+  name: string
+  boardId: string
+  position: number
+  isArchived: boolean
+  teamId: string
+  userId: string
+  createdAt: string
+  updatedAt: string
+}
+
+// List options
+export interface ListListOptions {
+  limit?: number
+  offset?: number
+  teamId?: string
+  boardId?: string
+  isArchived?: boolean
+  orderBy?: 'name' | 'position' | 'createdAt'
+  orderDir?: 'asc' | 'desc'
+}
+
+// List result
+export interface ListListResult {
+  lists: List[]
+  total: number
+}
+
+// Create data (required fields + teamId + optional fields)
+export interface ListCreateData {
+  name: string
+  boardId: string
+  teamId: string
+  position?: number
+  isArchived?: boolean
+}
+
+// Update data (all fields optional)
+export interface ListUpdateData {
+  name?: string
+  boardId?: string
+  position?: number
+  isArchived?: boolean
+}

package/entities/lists/messages/en.json

@@ -0,0 +1,60 @@
+{
+  "title": "Lists",
+  "singular": "List",
+  "plural": "Lists",
+  "description": "Columns within boards to organize cards",
+
+  "fields": {
+    "name": {
+      "label": "Name",
+      "placeholder": "Enter list name...",
+      "description": "List name"
+    },
+    "position": {
+      "label": "Position",
+      "description": "Display order within board"
+    },
+    "boardId": {
+      "label": "Board",
+      "placeholder": "Select board...",
+      "description": "Parent board"
+    },
+    "createdAt": {
+      "label": "Created At",
+      "description": "When the list was created"
+    },
+    "updatedAt": {
+      "label": "Updated At",
+      "description": "When the list was last modified"
+    }
+  },
+
+  "actions": {
+    "create": "Add List",
+    "edit": "Edit List",
+    "delete": "Delete List",
+    "moveLeft": "Move Left",
+    "moveRight": "Move Right"
+  },
+
+  "messages": {
+    "created": "List created successfully",
+    "updated": "List updated successfully",
+    "deleted": "List deleted successfully",
+    "moved": "List moved",
+    "confirmDelete": "Are you sure you want to delete this list? All cards within it will be permanently removed."
+  },
+
+  "empty": {
+    "title": "No lists yet",
+    "description": "Add a list to start organizing your cards.",
+    "action": "Add a list"
+  },
+
+  "defaults": {
+    "todo": "To Do",
+    "inProgress": "In Progress",
+    "done": "Done"
+  }
+}
+

package/entities/lists/messages/es.json

@@ -0,0 +1,60 @@
+{
+  "title": "Listas",
+  "singular": "Lista",
+  "plural": "Listas",
+  "description": "Columnas dentro de los tableros para organizar tarjetas",
+
+  "fields": {
+    "name": {
+      "label": "Nombre",
+      "placeholder": "Ingresa el nombre de la lista...",
+      "description": "Nombre de la lista"
+    },
+    "position": {
+      "label": "Posición",
+      "description": "Orden de visualización dentro del tablero"
+    },
+    "boardId": {
+      "label": "Tablero",
+      "placeholder": "Seleccionar tablero...",
+      "description": "Tablero padre"
+    },
+    "createdAt": {
+      "label": "Creado",
+      "description": "Cuándo se creó la lista"
+    },
+    "updatedAt": {
+      "label": "Actualizado",
+      "description": "Cuándo se modificó por última vez"
+    }
+  },
+
+  "actions": {
+    "create": "Agregar Lista",
+    "edit": "Editar Lista",
+    "delete": "Eliminar Lista",
+    "moveLeft": "Mover a la Izquierda",
+    "moveRight": "Mover a la Derecha"
+  },
+
+  "messages": {
+    "created": "Lista creada exitosamente",
+    "updated": "Lista actualizada exitosamente",
+    "deleted": "Lista eliminada exitosamente",
+    "moved": "Lista movida",
+    "confirmDelete": "¿Estás seguro de que quieres eliminar esta lista? Todas las tarjetas dentro de ella serán eliminadas permanentemente."
+  },
+
+  "empty": {
+    "title": "Aún no hay listas",
+    "description": "Agrega una lista para comenzar a organizar tus tarjetas.",
+    "action": "Agregar una lista"
+  },
+
+  "defaults": {
+    "todo": "Por Hacer",
+    "inProgress": "En Progreso",
+    "done": "Hecho"
+  }
+}
+