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

package/dist/templates/contents/themes/default/entities/tasks/migrations/001_tasks_table.sql

@@ -1,105 +0,0 @@
--- Migration: 001_tasks_table.sql
--- Description: Tasks (table, indexes, RLS)
--- Date: 2025-01-19
--- Updated: 2025-11-26 (Phase 2 - Team Isolation)
-
--- ============================================
--- TABLE
--- ============================================
-DROP TABLE IF EXISTS public."tasks" CASCADE;
-
-CREATE TABLE IF NOT EXISTS public."tasks" (
-  -- Primary Key
-  id           TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
-
-  -- Relational Fields (al inicio)
-  "userId"     TEXT NOT NULL REFERENCES public."users"(id) ON DELETE CASCADE,
-  "teamId"     TEXT NOT NULL REFERENCES public."teams"(id) ON DELETE CASCADE,
-
-  -- Entity-specific fields
-  title              TEXT NOT NULL,
-  description        TEXT,
-  completed          BOOLEAN DEFAULT false,
-  status             TEXT NOT NULL DEFAULT 'todo',
-  priority           TEXT NOT NULL DEFAULT 'medium',
-  tags               JSONB DEFAULT '[]'::jsonb,
-  "dueDate"          DATE,
-  "estimatedHours"   NUMERIC(5,2),
-
-  -- System fields
-  "createdAt"  TIMESTAMPTZ NOT NULL DEFAULT now(),
-  "updatedAt"  TIMESTAMPTZ NOT NULL DEFAULT now(),
-
-  -- Constraints
-  CONSTRAINT tasks_status_check CHECK (status IN ('todo', 'in-progress', 'review', 'done', 'blocked')),
-  CONSTRAINT tasks_priority_check CHECK (priority IN ('low', 'medium', 'high', 'urgent')),
-  CONSTRAINT tasks_estimated_hours_positive CHECK ("estimatedHours" IS NULL OR "estimatedHours" > 0)
-);
-
-COMMENT ON TABLE  public."tasks"                  IS 'Tasks table with team isolation via RLS';
-COMMENT ON COLUMN public."tasks"."userId"         IS 'Owner user id (user isolation handled at app level)';
-COMMENT ON COLUMN public."tasks"."teamId"         IS 'Team context for isolation';
-COMMENT ON COLUMN public."tasks".title            IS 'Task title or name';
-COMMENT ON COLUMN public."tasks".description      IS 'Detailed task description';
-COMMENT ON COLUMN public."tasks".completed        IS 'Task completion status (legacy)';
-COMMENT ON COLUMN public."tasks".status           IS 'Task status: todo, in-progress, review, done, blocked';
-COMMENT ON COLUMN public."tasks".priority         IS 'Task priority: low, medium, high, urgent';
-COMMENT ON COLUMN public."tasks".tags             IS 'Task tags for categorization';
-COMMENT ON COLUMN public."tasks"."dueDate"        IS 'Task deadline (date only)';
-COMMENT ON COLUMN public."tasks"."estimatedHours" IS 'Estimated time to complete in hours';
-
--- ============================================
--- TRIGGER updatedAt (uses Better Auth function)
--- ============================================
-DROP TRIGGER IF EXISTS tasks_set_updated_at ON public."tasks";
-CREATE TRIGGER tasks_set_updated_at
-BEFORE UPDATE ON public."tasks"
-FOR EACH ROW EXECUTE FUNCTION public.set_updated_at();
-
--- ============================================
--- INDEXES
--- ============================================
-CREATE INDEX IF NOT EXISTS idx_tasks_user_id         ON public."tasks"("userId");
-CREATE INDEX IF NOT EXISTS idx_tasks_team_id         ON public."tasks"("teamId");
-CREATE INDEX IF NOT EXISTS idx_tasks_user_team       ON public."tasks"("userId", "teamId");
-CREATE INDEX IF NOT EXISTS idx_tasks_user_created_at ON public."tasks"("userId", "createdAt");
-CREATE INDEX IF NOT EXISTS idx_tasks_completed       ON public."tasks"(completed);
-CREATE INDEX IF NOT EXISTS idx_tasks_status          ON public."tasks"(status);
-CREATE INDEX IF NOT EXISTS idx_tasks_priority        ON public."tasks"(priority);
-CREATE INDEX IF NOT EXISTS idx_tasks_due_date        ON public."tasks"("dueDate") WHERE "dueDate" IS NOT NULL;
-CREATE INDEX IF NOT EXISTS idx_tasks_tags            ON public."tasks" USING GIN(tags);
-CREATE INDEX IF NOT EXISTS idx_tasks_user_status_due ON public."tasks"("userId", status, "dueDate");
-CREATE INDEX IF NOT EXISTS idx_tasks_team_created    ON public."tasks"("teamId", "createdAt" DESC);
-
--- ============================================
--- RLS
--- ============================================
-ALTER TABLE public."tasks" ENABLE ROW LEVEL SECURITY;
-
--- Cleanup existing policies
-DROP POLICY IF EXISTS "Tasks owner can do all" ON public."tasks";
-DROP POLICY IF EXISTS "Tasks team can do all"  ON public."tasks";
-DROP POLICY IF EXISTS tasks_owner_policy       ON public."tasks";
-DROP POLICY IF EXISTS tasks_owner_all          ON public."tasks";
-
--- ============================
--- RLS: TEAM ISOLATION ONLY
--- ============================
--- IMPORTANTE: RLS solo verifica team membership
--- La lógica de access.shared (user isolation) se maneja a NIVEL APP
--- Esto permite cambiar el comportamiento desde el config sin modificar RLS
-CREATE POLICY "Tasks team can do all"
-ON public."tasks"
-FOR ALL TO authenticated
-USING (
-  -- Superadmin bypass
-  public.is_superadmin()
-  OR
-  -- Team isolation: user must be member of the team
-  "teamId" = ANY(public.get_user_team_ids())
-)
-WITH CHECK (
-  public.is_superadmin()
-  OR
-  "teamId" = ANY(public.get_user_team_ids())
-);

package/dist/templates/contents/themes/default/entities/tasks/migrations/002_task_metas.sql

@@ -1,85 +0,0 @@
--- Migration: 002_tasks_metas.sql
--- Description: Tasks metas (table, indexes, RLS) - Updated to new conventions
--- Date: 2025-01-19
--- Updated: 2025-11-26 (Phase 2 - Team Isolation via parent)
-
--- ============================================
--- TABLE
--- ============================================
-CREATE TABLE IF NOT EXISTS public."tasks_metas" (
-                                                    id             TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
-    "entityId"     TEXT NOT NULL REFERENCES public."tasks"(id) ON DELETE CASCADE,
-    "metaKey"      TEXT NOT NULL,
-    "metaValue"    JSONB NOT NULL DEFAULT '{}'::jsonb,
-    "dataType"     TEXT DEFAULT 'json',
-    "isPublic"     BOOLEAN NOT NULL DEFAULT false,
-    "isSearchable" BOOLEAN NOT NULL DEFAULT false,
-    "createdAt"    TIMESTAMPTZ NOT NULL DEFAULT now(),
-    "updatedAt"    TIMESTAMPTZ NOT NULL DEFAULT now(),
-    CONSTRAINT tasks_metas_unique_key UNIQUE ("entityId", "metaKey")
-    );
-
-COMMENT ON TABLE  public."tasks_metas"               IS 'Key-value metadata for tasks';
-COMMENT ON COLUMN public."tasks_metas"."entityId"    IS 'Reference to parent task (generic entityId)';
-COMMENT ON COLUMN public."tasks_metas"."metaKey"      IS 'Metadata key identifier';
-COMMENT ON COLUMN public."tasks_metas"."metaValue"    IS 'Metadata value in JSONB format';
-COMMENT ON COLUMN public."tasks_metas"."dataType"     IS 'Type hint for the value: json, string, number, boolean';
-COMMENT ON COLUMN public."tasks_metas"."isPublic"     IS 'Whether this metadata is publicly readable';
-COMMENT ON COLUMN public."tasks_metas"."isSearchable" IS 'Whether this metadata is searchable';
-
--- ============================================
--- TRIGGER updatedAt (uses Better Auth function)
--- ============================================
-DROP TRIGGER IF EXISTS tasks_metas_set_updated_at ON public."tasks_metas";
-CREATE TRIGGER tasks_metas_set_updated_at
-    BEFORE UPDATE ON public."tasks_metas"
-    FOR EACH ROW EXECUTE FUNCTION public.set_updated_at();
-
--- ============================================
--- INDEXES
--- ============================================
-CREATE INDEX IF NOT EXISTS idx_tasks_metas_entity_id      ON public."tasks_metas"("entityId");
-CREATE INDEX IF NOT EXISTS idx_tasks_metas_key           ON public."tasks_metas"("metaKey");
-CREATE INDEX IF NOT EXISTS idx_tasks_metas_is_public     ON public."tasks_metas"("isPublic") WHERE "isPublic" = true;
-CREATE INDEX IF NOT EXISTS idx_tasks_metas_is_searchable ON public."tasks_metas"("isSearchable") WHERE "isSearchable" = true;
-CREATE INDEX IF NOT EXISTS idx_tasks_metas_value_gin     ON public."tasks_metas" USING GIN ("metaValue");
-CREATE INDEX IF NOT EXISTS idx_tasks_metas_value_ops     ON public."tasks_metas" USING GIN ("metaValue" jsonb_path_ops);
-
--- ============================================
--- RLS
--- ============================================
-ALTER TABLE public."tasks_metas" ENABLE ROW LEVEL SECURITY;
-
--- Cleanup existing policies
-DROP POLICY IF EXISTS "Tasks metas owner can do all" ON public."tasks_metas";
-DROP POLICY IF EXISTS "Tasks metas team can do all"  ON public."tasks_metas";
-DROP POLICY IF EXISTS tasks_metas_owner_policy       ON public."tasks_metas";
-
--- ============================
--- RLS: TEAM ISOLATION VIA PARENT
--- ============================
--- Hereda el aislamiento del parent task via teamId
--- La lógica de access.shared se maneja a NIVEL APP
-CREATE POLICY "Tasks metas team can do all"
-ON public."tasks_metas"
-FOR ALL TO authenticated
-USING (
-  -- Superadmin bypass
-  public.is_superadmin()
-  OR
-  -- Team isolation via parent task
-  EXISTS (
-    SELECT 1 FROM public."tasks" t
-    WHERE t.id = "entityId"
-      AND t."teamId" = ANY(public.get_user_team_ids())
-  )
-)
-WITH CHECK (
-  public.is_superadmin()
-  OR
-  EXISTS (
-    SELECT 1 FROM public."tasks" t
-    WHERE t.id = "entityId"
-      AND t."teamId" = ANY(public.get_user_team_ids())
-  )
-);

package/dist/templates/contents/themes/default/entities/tasks/migrations/sample_data.json

@@ -1,77 +0,0 @@
-[
-  {
-    "title": "Setup project repository and CI/CD pipeline",
-    "description": "Initialize git repository, configure GitHub Actions for automated testing and deployment",
-    "completed": false
-  },
-  {
-    "title": "Design database schema for user management",
-    "description": "Create ERD and database migrations for user authentication, roles, and permissions",
-    "completed": true
-  },
-  {
-    "title": "Implement API authentication middleware",
-    "description": "Develop JWT-based authentication system with refresh tokens and rate limiting",
-    "completed": false
-  },
-  {
-    "title": "Create responsive frontend components",
-    "description": "Build reusable React components with TypeScript and Tailwind CSS styling",
-    "completed": false
-  },
-  {
-    "title": "Write comprehensive unit tests",
-    "description": "Achieve 80%+ code coverage with Jest and React Testing Library",
-    "completed": false
-  },
-  {
-    "title": "Optimize database queries and indexing",
-    "description": "Analyze slow queries and implement proper database indexes for performance",
-    "completed": true
-  },
-  {
-    "title": "Integrate payment processing system",
-    "description": "Implement Stripe integration for subscription management and billing",
-    "completed": false
-  },
-  {
-    "title": "Setup monitoring and logging infrastructure",
-    "description": "Configure application monitoring with alerts and centralized logging",
-    "completed": false
-  },
-  {
-    "title": "Conduct security vulnerability assessment",
-    "description": "Perform penetration testing and fix identified security issues",
-    "completed": true
-  },
-  {
-    "title": "Implement real-time notifications",
-    "description": "Add WebSocket support for live updates and push notifications",
-    "completed": false
-  },
-  {
-    "title": "Create API documentation with OpenAPI",
-    "description": "Generate interactive API documentation using Swagger/OpenAPI specification",
-    "completed": false
-  },
-  {
-    "title": "Setup email service integration",
-    "description": "Configure transactional email service for user notifications and marketing",
-    "completed": true
-  },
-  {
-    "title": "Implement data backup and recovery system",
-    "description": "Setup automated database backups with disaster recovery procedures",
-    "completed": false
-  },
-  {
-    "title": "Optimize frontend bundle size and performance",
-    "description": "Implement code splitting, lazy loading, and performance optimizations",
-    "completed": false
-  },
-  {
-    "title": "Deploy application to production environment",
-    "description": "Configure production deployment with load balancing and SSL certificates",
-    "completed": false
-  }
-]

package/dist/templates/contents/themes/default/entities/tasks/tasks.config.ts

@@ -1,90 +0,0 @@
-/**
- * Task Entity Configuration - REFACTORED
- * 
- * Updated according to new 5-section structure from refactoring plan.
- * All table names, API paths, and metadata are now derived automatically from slug.
- */
-
-import { CheckSquare } from 'lucide-react'
-import type { EntityConfig } from '@nextsparkjs/core/lib/entities/types'
-import { taskFields } from './tasks.fields'
-
-export const taskEntityConfig: EntityConfig = {
-  // ==========================================
-  // 1. BASIC IDENTIFICATION
-  // ==========================================
-  slug: 'tasks',           // Single source of truth - derives tableName, apiPath, metaTableName, i18nNamespace
-  enabled: true,
-  names: {
-    singular: 'task',
-    plural: 'Tasks'
-  },
-  icon: CheckSquare,
-  
-  // ==========================================
-  // 2. ACCESS AND SCOPE CONFIGURATION
-  // ==========================================
-  access: {
-    public: false,          // If accessible without authentication, requires RLS (anon can select)
-    api: true,              // If has external API via API key  
-    metadata: true,         // If supports metadata system
-    shared: false           // CASE 2: Any authenticated user can access all records (no userId filter)
-  },
-  
-  // ==========================================
-  // 3. UI/UX FEATURES
-  // ==========================================
-  ui: {
-    dashboard: {
-      showInMenu: true,
-      showInTopbar: true,
-      filters: [
-        { field: 'status', type: 'multiSelect' },
-        { field: 'priority', type: 'multiSelect' },
-      ],
-    },
-    public: {
-      hasArchivePage: false,
-      hasSinglePage: false
-    },
-    features: {
-      searchable: true,
-      sortable: true,
-      filterable: true,
-      bulkOperations: true,
-      importExport: false
-    }
-  },
-  
-  // ==========================================
-  // 4. PERMISSIONS SYSTEM
-  // ==========================================
-  // Permissions are now centralized in permissions.config.ts
-  // See: contents/themes/default/permissions.config.ts -> entities.tasks
-
-  // ==========================================
-  // 5. INTERNATIONALIZATION
-  // ==========================================
-  i18n: {
-    fallbackLocale: 'en',
-    loaders: {
-      es: () => import('./messages/es.json'),
-      en: () => import('./messages/en.json')
-    }
-  },
-
-  // ==========================================
-  // FIELDS (imported from separate file)
-  // ==========================================
-  fields: taskFields,
-
-  // ==========================================
-  // AUTOMATIC SYSTEM DERIVATIONS
-  // ==========================================
-  // The following properties are automatically derived from the slug:
-  // - tableName: 'tasks' (slug)
-  // - metaTableName: 'tasks_metas' (slug + '_metas')
-  // - apiPath: '/api/v1/tasks' (slug API Route)
-  // - i18nNamespace: 'tasks' (slug as namespace)
-  // - foreignKey in metadata: 'entityId' (generic for all entities)
-}

package/dist/templates/contents/themes/default/entities/tasks/tasks.fields.ts

@@ -1,196 +0,0 @@
-/**
- * Task Entity Fields Configuration
- * 
- * Separated from main config according to new refactoring plan.
- * Contains all field definitions for the tasks entity.
- */
-
-import type { EntityField } from '@nextsparkjs/core/lib/entities/types'
-
-export const taskFields: EntityField[] = [
-  {
-    name: 'title',
-    type: 'text',
-    required: true,
-    display: {
-      label: 'Title',
-      description: 'Task title or name',
-      placeholder: 'Enter task title...',
-      showInList: true,
-      showInDetail: true,
-      showInForm: true,
-      order: 1,
-      columnWidth: 12,
-    },
-    api: {
-      readOnly: false,
-      searchable: true,
-      sortable: true,
-      
-    },
-  },
-  {
-    name: 'description',
-    type: 'textarea',
-    required: false,
-    display: {
-      label: 'Description',
-      description: 'Detailed task description',
-      placeholder: 'Enter task description...',
-      showInList: false,
-      showInDetail: true,
-      showInForm: true,
-      order: 2,
-      columnWidth: 12,
-    },
-    api: {
-      readOnly: false,
-      searchable: true,
-      sortable: false,
-      
-    },
-  },
-  {
-    name: 'status',
-    type: 'select',
-    required: false,
-    defaultValue: 'todo',
-    options: [
-      { value: 'todo', label: 'To Do' },
-      { value: 'in-progress', label: 'In Progress' },
-      { value: 'review', label: 'In Review' },
-      { value: 'done', label: 'Done' },
-      { value: 'blocked', label: 'Blocked' },
-    ],
-    display: {
-      label: 'Status',
-      description: 'Current task status',
-      placeholder: 'Select status...',
-      showInList: true,
-      showInDetail: true,
-      showInForm: true,
-      order: 3,
-      columnWidth: 4,
-    },
-    api: {
-      readOnly: false,
-      searchable: false,
-      sortable: true,
-      
-    },
-  },
-  {
-    name: 'priority',
-    type: 'select',
-    required: false,
-    defaultValue: 'medium',
-    options: [
-      { value: 'low', label: 'Low' },
-      { value: 'medium', label: 'Medium' },
-      { value: 'high', label: 'High' },
-      { value: 'urgent', label: 'Urgent' },
-    ],
-    display: {
-      label: 'Priority',
-      description: 'Task priority level',
-      placeholder: 'Select priority...',
-      showInList: true,
-      showInDetail: true,
-      showInForm: true,
-      order: 4,
-      columnWidth: 4,
-    },
-    api: {
-      readOnly: false,
-      searchable: false,
-      sortable: true,
-      
-    },
-  },
-  {
-    name: 'tags',
-    type: 'tags',
-    required: false,
-    display: {
-      label: 'Tags',
-      description: 'Task tags for categorization',
-      placeholder: 'Add tags...',
-      showInList: false,
-      showInDetail: true,
-      showInForm: true,
-      order: 5,
-      columnWidth: 6,
-    },
-    api: {
-      readOnly: false,
-      searchable: true,
-      sortable: false,
-      
-    },
-  },
-  {
-    name: 'dueDate',
-    type: 'date',
-    required: false,
-    display: {
-      label: 'Due Date',
-      description: 'Task deadline',
-      placeholder: 'Select due date...',
-      showInList: true,
-      showInDetail: true,
-      showInForm: true,
-      order: 6,
-      columnWidth: 4,
-    },
-    api: {
-      readOnly: false,
-      searchable: false,
-      sortable: true,
-      
-    },
-  },
-  {
-    name: 'estimatedHours',
-    type: 'number',
-    required: false,
-    display: {
-      label: 'Estimated Hours',
-      description: 'Estimated time to complete (in hours)',
-      placeholder: '0',
-      showInList: false,
-      showInDetail: true,
-      showInForm: true,
-      order: 7,
-      columnWidth: 4,
-    },
-    api: {
-      readOnly: false,
-      searchable: false,
-      sortable: true,
-      
-    },
-  },
-  {
-    name: 'completed',
-    type: 'boolean',
-    required: false,
-    defaultValue: false,
-    display: {
-      label: 'Completed',
-      description: 'Mark as completed (legacy field, use status instead)',
-      showInList: false,
-      showInDetail: true,
-      showInForm: false,
-      order: 8,
-      columnWidth: 4,
-    },
-    api: {
-      readOnly: false,
-      searchable: false,
-      sortable: true,
-    },
-  },
-  // NOTE: createdAt and updatedAt are implicit system fields
-  // They are automatically included by the API and frontend components
-  // Do NOT declare them here - see core/lib/entities/system-fields.ts
-]