@fayz-ai/plugin-tasks 0.1.1

package/src/migrations/001_tasks_base.sql

@@ -0,0 +1,57 @@
+-- Tasks Plugin: Base Tables
+-- Prefix: tsk_
+
+-- Label definitions for categorizing tasks
+CREATE TABLE IF NOT EXISTS public.tsk_labels (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES saas_core.tenants(id) ON DELETE CASCADE,
+  name text NOT NULL,
+  color text NOT NULL DEFAULT '#6366f1',
+  is_active boolean NOT NULL DEFAULT true,
+  created_at timestamptz NOT NULL DEFAULT now()
+);
+ALTER TABLE public.tsk_labels ENABLE ROW LEVEL SECURITY;
+CREATE INDEX IF NOT EXISTS idx_tsk_labels_tenant ON public.tsk_labels(tenant_id);
+
+-- Main tasks table (subtasks via parent_id self-reference)
+CREATE TABLE IF NOT EXISTS public.tsk_tasks (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES saas_core.tenants(id) ON DELETE CASCADE,
+  title text NOT NULL,
+  description text,
+  status text NOT NULL DEFAULT 'todo'
+    CHECK (status IN ('todo', 'in_progress', 'done', 'cancelled')),
+  priority text NOT NULL DEFAULT 'medium'
+    CHECK (priority IN ('low', 'medium', 'high', 'urgent')),
+  due_date date,
+  assigned_to_id uuid,
+  assigned_to_name text,
+  parent_id uuid REFERENCES public.tsk_tasks(id) ON DELETE CASCADE,
+  labels jsonb NOT NULL DEFAULT '[]'::jsonb,
+  position integer NOT NULL DEFAULT 0,
+  created_by_id uuid,
+  created_by_name text,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+ALTER TABLE public.tsk_tasks ENABLE ROW LEVEL SECURITY;
+CREATE INDEX IF NOT EXISTS idx_tsk_tasks_tenant ON public.tsk_tasks(tenant_id);
+CREATE INDEX IF NOT EXISTS idx_tsk_tasks_status ON public.tsk_tasks(tenant_id, status);
+CREATE INDEX IF NOT EXISTS idx_tsk_tasks_parent ON public.tsk_tasks(parent_id);
+CREATE INDEX IF NOT EXISTS idx_tsk_tasks_assigned ON public.tsk_tasks(assigned_to_id);
+CREATE INDEX IF NOT EXISTS idx_tsk_tasks_due ON public.tsk_tasks(tenant_id, due_date)
+  WHERE due_date IS NOT NULL;
+
+-- RLS policies for tsk_tasks
+CREATE POLICY tsk_tasks_select ON public.tsk_tasks FOR SELECT TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY tsk_tasks_insert ON public.tsk_tasks FOR INSERT TO authenticated WITH CHECK (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY tsk_tasks_update ON public.tsk_tasks FOR UPDATE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY tsk_tasks_delete ON public.tsk_tasks FOR DELETE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+GRANT SELECT, INSERT, UPDATE, DELETE ON public.tsk_tasks TO authenticated;
+
+-- RLS policies for tsk_labels
+CREATE POLICY tsk_labels_select ON public.tsk_labels FOR SELECT TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY tsk_labels_insert ON public.tsk_labels FOR INSERT TO authenticated WITH CHECK (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY tsk_labels_update ON public.tsk_labels FOR UPDATE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY tsk_labels_delete ON public.tsk_labels FOR DELETE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+GRANT SELECT, INSERT, UPDATE, DELETE ON public.tsk_labels TO authenticated;

package/src/registries.ts

@@ -0,0 +1,32 @@
+import type { PluginRegistryDef } from '@fayz-ai/core'
+import type { EntityDef } from '@fayz-ai/core'
+
+const taskLabelEntity: EntityDef = {
+  name: 'Task Label',
+  namePlural: 'Task Labels',
+  icon: 'Tag',
+  displayField: 'name',
+  defaultSort: 'name',
+  fields: [
+    { key: 'name', label: 'Name', type: 'text', required: true, showInTable: true },
+    { key: 'color', label: 'Color', type: 'text', showInTable: true, defaultValue: '#6366f1' },
+    { key: 'isActive', label: 'Active', type: 'boolean', showInTable: true, defaultValue: true },
+  ],
+  data: { table: 'tsk_labels', tenantScoped: true },
+}
+
+export const tasksRegistries: PluginRegistryDef[] = [
+  {
+    id: 'task-labels',
+    entity: taskLabelEntity,
+    icon: 'Tag',
+    description: 'Labels for categorizing tasks',
+    display: 'table',
+    seedData: [
+      { id: 'lbl-bug', name: 'Bug', color: '#ef4444', isActive: true },
+      { id: 'lbl-feature', name: 'Feature', color: '#3b82f6', isActive: true },
+      { id: 'lbl-urgent', name: 'Urgent', color: '#f59e0b', isActive: true },
+      { id: 'lbl-personal', name: 'Personal', color: '#8b5cf6', isActive: true },
+    ],
+  },
+]

package/src/store.ts

@@ -0,0 +1,148 @@
+import { createStore, type StoreApi } from 'zustand/vanilla'
+import { dedup } from '@fayz-ai/saas'
+import type { TasksDataProvider } from './data/types'
+import type {
+  Task, TaskLabel, TasksSummary, TaskQuery,
+  CreateTaskInput, UpdateTaskInput, TaskStatus,
+} from './types'
+
+export interface TasksUIState {
+  // Data
+  tasks: Task[]
+  tasksLoading: boolean
+  labels: TaskLabel[]
+  summary: TasksSummary | null
+  summaryLoading: boolean
+
+  // Drawer UI
+  drawerOpen: boolean
+  selectedTaskId: string | null
+  activeFilter: TaskStatus | 'all'
+
+  // Actions — data
+  fetchTasks(query?: TaskQuery): Promise<void>
+  fetchLabels(): Promise<void>
+  fetchSummary(): Promise<void>
+  createTask(input: CreateTaskInput): Promise<Task>
+  updateTask(id: string, input: UpdateTaskInput): Promise<Task>
+  deleteTask(id: string): Promise<void>
+  reorderTask(id: string, newPosition: number, status: TaskStatus): Promise<void>
+
+  // Actions — UI
+  openDrawer(): void
+  closeDrawer(): void
+  toggleDrawer(): void
+  selectTask(id: string | null): void
+  setFilter(filter: TaskStatus | 'all'): void
+}
+
+export function createTasksStore(provider: TasksDataProvider): StoreApi<TasksUIState> {
+  return createStore<TasksUIState>((set, get) => ({
+    tasks: [],
+    tasksLoading: false,
+    labels: [],
+    summary: null,
+    summaryLoading: false,
+
+    drawerOpen: false,
+    selectedTaskId: null,
+    activeFilter: 'all',
+
+    // ----- Data actions -----
+
+    async fetchTasks(query?: TaskQuery) {
+      return dedup('tasks:list', async () => {
+        set({ tasksLoading: true })
+        try {
+          const filter = get().activeFilter
+          const q: TaskQuery = {
+            parentId: null,
+            ...query,
+            ...(filter !== 'all' ? { status: filter } : {}),
+          }
+          const tasks = await provider.getTasks(q)
+          set({ tasks, tasksLoading: false })
+        } catch {
+          set({ tasksLoading: false })
+        }
+      })
+    },
+
+    async fetchLabels() {
+      return dedup('tasks:labels', async () => {
+        try {
+          const labels = await provider.getLabels()
+          set({ labels })
+        } catch { /* silent */ }
+      })
+    },
+
+    async fetchSummary() {
+      return dedup('tasks:summary', async () => {
+        set({ summaryLoading: true })
+        try {
+          const summary = await provider.getSummary()
+          set({ summary, summaryLoading: false })
+        } catch {
+          set({ summaryLoading: false })
+        }
+      })
+    },
+
+    async createTask(input) {
+      const task = await provider.createTask(input)
+      // Re-fetch to get correct ordering
+      await get().fetchTasks()
+      await get().fetchSummary()
+      return task
+    },
+
+    async updateTask(id, input) {
+      const task = await provider.updateTask(id, input)
+      // Update in-place for snappy UI, then re-fetch
+      set((s) => ({ tasks: s.tasks.map((t) => (t.id === id ? task : t)) }))
+      await get().fetchSummary()
+      return task
+    },
+
+    async deleteTask(id) {
+      await provider.deleteTask(id)
+      set((s) => ({ tasks: s.tasks.filter((t) => t.id !== id), selectedTaskId: null }))
+      await get().fetchSummary()
+    },
+
+    async reorderTask(id, newPosition, status) {
+      await provider.reorderTask(id, newPosition, status)
+      await get().fetchTasks()
+    },
+
+    // ----- UI actions -----
+
+    openDrawer() {
+      set({ drawerOpen: true })
+      // Refresh data when opening
+      get().fetchTasks()
+      get().fetchLabels()
+      get().fetchSummary()
+    },
+
+    closeDrawer() {
+      set({ drawerOpen: false, selectedTaskId: null })
+    },
+
+    toggleDrawer() {
+      const { drawerOpen } = get()
+      if (drawerOpen) get().closeDrawer()
+      else get().openDrawer()
+    },
+
+    selectTask(id) {
+      set({ selectedTaskId: id })
+    },
+
+    setFilter(filter) {
+      set({ activeFilter: filter })
+      get().fetchTasks()
+    },
+  }))
+}

package/src/types.ts

@@ -0,0 +1,94 @@
+// ---------------------------------------------------------------------------
+// Tasks Plugin — Domain Types
+// ---------------------------------------------------------------------------
+
+export type TaskStatus = 'todo' | 'in_progress' | 'done' | 'cancelled'
+export type TaskPriority = 'low' | 'medium' | 'high' | 'urgent'
+
+export const TASK_STATUSES: TaskStatus[] = ['todo', 'in_progress', 'done', 'cancelled']
+export const TASK_PRIORITIES: TaskPriority[] = ['low', 'medium', 'high', 'urgent']
+
+// ---------------------------------------------------------------------------
+// Core entities
+// ---------------------------------------------------------------------------
+
+export interface Task {
+  id: string
+  title: string
+  description: string | null
+  status: TaskStatus
+  priority: TaskPriority
+  dueDate: string | null
+  assignedToId: string | null
+  assignedToName: string | null
+  parentId: string | null
+  labels: string[]
+  position: number
+  createdById: string | null
+  createdByName: string | null
+  tenantId: string
+  createdAt: string
+  updatedAt: string
+}
+
+export interface TaskLabel {
+  id: string
+  name: string
+  color: string
+  isActive: boolean
+  tenantId: string
+  createdAt: string
+}
+
+// ---------------------------------------------------------------------------
+// Input types
+// ---------------------------------------------------------------------------
+
+export interface CreateTaskInput {
+  title: string
+  description?: string
+  status?: TaskStatus
+  priority?: TaskPriority
+  dueDate?: string | null
+  assignedToId?: string | null
+  parentId?: string | null
+  labels?: string[]
+}
+
+export interface UpdateTaskInput {
+  title?: string
+  description?: string | null
+  status?: TaskStatus
+  priority?: TaskPriority
+  dueDate?: string | null
+  assignedToId?: string | null
+  labels?: string[]
+  position?: number
+}
+
+// ---------------------------------------------------------------------------
+// Query types
+// ---------------------------------------------------------------------------
+
+export interface TaskQuery {
+  status?: TaskStatus | TaskStatus[]
+  priority?: TaskPriority | TaskPriority[]
+  assignedToId?: string
+  parentId?: string | null
+  search?: string
+  overdue?: boolean
+}
+
+// ---------------------------------------------------------------------------
+// Aggregation
+// ---------------------------------------------------------------------------
+
+export interface TasksSummary {
+  total: number
+  todo: number
+  inProgress: number
+  done: number
+  overdue: number
+  dueToday: number
+  highPriority: number
+}