@nextsparkjs/theme-crm 0.1.0-beta.1

package/entities/contacts/messages/en.json

@@ -0,0 +1,117 @@
+{
+  "entity": {
+    "name": "Contact",
+    "plural": "Contacts",
+    "description": "Manage contact persons in companies"
+  },
+  "fields": {
+    "firstName": {
+      "label": "First Name",
+      "description": "Contact first name",
+      "placeholder": "Enter first name..."
+    },
+    "lastName": {
+      "label": "Last Name",
+      "description": "Contact last name",
+      "placeholder": "Enter last name..."
+    },
+    "email": {
+      "label": "Email",
+      "description": "Contact email address",
+      "placeholder": "Enter email address..."
+    },
+    "phone": {
+      "label": "Phone",
+      "description": "Office phone number",
+      "placeholder": "Enter phone number..."
+    },
+    "mobile": {
+      "label": "Mobile",
+      "description": "Mobile phone number",
+      "placeholder": "Enter mobile number..."
+    },
+    "companyId": {
+      "label": "Company",
+      "description": "Associated company",
+      "placeholder": "Select company..."
+    },
+    "position": {
+      "label": "Position",
+      "description": "Job position or title",
+      "placeholder": "Enter position..."
+    },
+    "department": {
+      "label": "Department",
+      "description": "Department in company",
+      "placeholder": "Enter department..."
+    },
+    "isPrimary": {
+      "label": "Primary Contact",
+      "description": "Is primary contact for company"
+    },
+    "birthDate": {
+      "label": "Birth Date",
+      "description": "Contact birth date",
+      "placeholder": "Select date..."
+    },
+    "linkedin": {
+      "label": "LinkedIn",
+      "description": "LinkedIn profile URL",
+      "placeholder": "https://linkedin.com/in/..."
+    },
+    "twitter": {
+      "label": "Twitter",
+      "description": "Twitter/X handle",
+      "placeholder": "@username"
+    },
+    "preferredChannel": {
+      "label": "Preferred Channel",
+      "description": "Preferred communication channel",
+      "placeholder": "Select channel..."
+    },
+    "timezone": {
+      "label": "Timezone",
+      "description": "Contact timezone",
+      "placeholder": "UTC"
+    },
+    "lastContactedAt": {
+      "label": "Last Contacted",
+      "description": "Last time this contact was reached"
+    },
+    "createdAt": {
+      "label": "Created At",
+      "description": "When the contact was created"
+    },
+    "updatedAt": {
+      "label": "Updated At",
+      "description": "When the contact was last updated"
+    }
+  },
+  "options": {
+    "preferredChannel": {
+      "email": "Email",
+      "phone": "Phone",
+      "whatsapp": "WhatsApp",
+      "linkedin": "LinkedIn",
+      "slack": "Slack",
+      "other": "Other"
+    }
+  },
+  "actions": {
+    "create": "Create Contact",
+    "edit": "Edit Contact",
+    "delete": "Delete Contact",
+    "view": "View Contact",
+    "list": "List Contacts",
+    "search": "Search Contacts",
+    "export": "Export Contacts",
+    "import": "Import Contacts"
+  },
+  "messages": {
+    "created": "Contact created successfully",
+    "updated": "Contact updated successfully",
+    "deleted": "Contact deleted successfully",
+    "notFound": "Contact not found",
+    "error": "An error occurred while processing the contact"
+  }
+}

package/entities/contacts/messages/es.json

@@ -0,0 +1,117 @@
+{
+  "entity": {
+    "name": "Contacto",
+    "plural": "Contactos",
+    "description": "Gestiona personas de contacto en las empresas"
+  },
+  "fields": {
+    "firstName": {
+      "label": "Nombre",
+      "description": "Nombre del contacto",
+      "placeholder": "Ingrese nombre..."
+    },
+    "lastName": {
+      "label": "Apellido",
+      "description": "Apellido del contacto",
+      "placeholder": "Ingrese apellido..."
+    },
+    "email": {
+      "label": "Email",
+      "description": "Dirección de correo electrónico",
+      "placeholder": "Ingrese email..."
+    },
+    "phone": {
+      "label": "Teléfono",
+      "description": "Número de teléfono de oficina",
+      "placeholder": "Ingrese teléfono..."
+    },
+    "mobile": {
+      "label": "Móvil",
+      "description": "Número de teléfono móvil",
+      "placeholder": "Ingrese móvil..."
+    },
+    "companyId": {
+      "label": "Empresa",
+      "description": "Empresa asociada",
+      "placeholder": "Seleccionar empresa..."
+    },
+    "position": {
+      "label": "Cargo",
+      "description": "Posición o título de trabajo",
+      "placeholder": "Ingrese cargo..."
+    },
+    "department": {
+      "label": "Departamento",
+      "description": "Departamento en la empresa",
+      "placeholder": "Ingrese departamento..."
+    },
+    "isPrimary": {
+      "label": "Contacto Principal",
+      "description": "Es contacto principal de la empresa"
+    },
+    "birthDate": {
+      "label": "Fecha de Nacimiento",
+      "description": "Fecha de nacimiento del contacto",
+      "placeholder": "Seleccionar fecha..."
+    },
+    "linkedin": {
+      "label": "LinkedIn",
+      "description": "URL del perfil de LinkedIn",
+      "placeholder": "https://linkedin.com/in/..."
+    },
+    "twitter": {
+      "label": "Twitter",
+      "description": "Usuario de Twitter/X",
+      "placeholder": "@usuario"
+    },
+    "preferredChannel": {
+      "label": "Canal Preferido",
+      "description": "Canal de comunicación preferido",
+      "placeholder": "Seleccionar canal..."
+    },
+    "timezone": {
+      "label": "Zona Horaria",
+      "description": "Zona horaria del contacto",
+      "placeholder": "UTC"
+    },
+    "lastContactedAt": {
+      "label": "Último Contacto",
+      "description": "Última vez que se contactó"
+    },
+    "createdAt": {
+      "label": "Creado el",
+      "description": "Cuándo se creó el contacto"
+    },
+    "updatedAt": {
+      "label": "Actualizado el",
+      "description": "Cuándo se actualizó por última vez"
+    }
+  },
+  "options": {
+    "preferredChannel": {
+      "email": "Email",
+      "phone": "Teléfono",
+      "whatsapp": "WhatsApp",
+      "linkedin": "LinkedIn",
+      "slack": "Slack",
+      "other": "Otro"
+    }
+  },
+  "actions": {
+    "create": "Crear Contacto",
+    "edit": "Editar Contacto",
+    "delete": "Eliminar Contacto",
+    "view": "Ver Contacto",
+    "list": "Listar Contactos",
+    "search": "Buscar Contactos",
+    "export": "Exportar Contactos",
+    "import": "Importar Contactos"
+  },
+  "messages": {
+    "created": "Contacto creado exitosamente",
+    "updated": "Contacto actualizado exitosamente",
+    "deleted": "Contacto eliminado exitosamente",
+    "notFound": "Contacto no encontrado",
+    "error": "Ocurrió un error al procesar el contacto"
+  }
+}

package/entities/contacts/migrations/001_contacts_table.sql

@@ -0,0 +1,134 @@
+-- ============================================================================
+-- Contacts Table Migration
+-- CRM theme: People contacts at companies
+-- Updated with team support and RLS
+-- ============================================================================
+
+-- ============================================
+-- ENUM TYPES
+-- ============================================
+DO $$ BEGIN
+  CREATE TYPE contact_channel AS ENUM ('email', 'phone', 'whatsapp', 'linkedin', 'slack', 'other');
+EXCEPTION
+  WHEN duplicate_object THEN null;
+END $$;
+
+-- ============================================
+-- TABLE
+-- ============================================
+CREATE TABLE IF NOT EXISTS "contacts" (
+  "id" TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+  
+  -- Contact information
+  "firstName" VARCHAR(100) NOT NULL,
+  "lastName" VARCHAR(100) NOT NULL,
+  "email" VARCHAR(255) NOT NULL,
+  "phone" VARCHAR(50),
+  "mobile" VARCHAR(50),
+  
+  -- Professional information
+  "companyId" TEXT,  -- Reference to companies table
+  "position" VARCHAR(100),
+  "department" VARCHAR(100),
+  "isPrimary" BOOLEAN DEFAULT false,
+  
+  -- Personal information
+  "birthDate" DATE,
+  "linkedin" VARCHAR(500),
+  "twitter" VARCHAR(100),
+  
+  -- Communication preferences
+  "preferredChannel" contact_channel DEFAULT 'email',
+  "timezone" VARCHAR(50) DEFAULT 'UTC',
+  "lastContactedAt" TIMESTAMPTZ,
+  
+  -- Ownership
+  "userId" TEXT NOT NULL REFERENCES "users"("id") ON DELETE CASCADE,
+  "teamId" TEXT NOT NULL REFERENCES "teams"("id") ON DELETE CASCADE,
+  
+  -- Timestamps
+  "createdAt" TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  "updatedAt" TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  
+  -- Constraints
+  CONSTRAINT contacts_email_team_unique UNIQUE ("teamId", "email")
+);
+
+-- ============================================
+-- INDEXES
+-- ============================================
+CREATE INDEX IF NOT EXISTS "contacts_teamId_idx" ON "contacts" ("teamId");
+CREATE INDEX IF NOT EXISTS "contacts_userId_idx" ON "contacts" ("userId");
+CREATE INDEX IF NOT EXISTS "contacts_email_idx" ON "contacts" ("email");
+CREATE INDEX IF NOT EXISTS "contacts_companyId_idx" ON "contacts" ("companyId");
+CREATE INDEX IF NOT EXISTS "contacts_firstName_idx" ON "contacts" ("firstName");
+CREATE INDEX IF NOT EXISTS "contacts_lastName_idx" ON "contacts" ("lastName");
+CREATE INDEX IF NOT EXISTS "contacts_isPrimary_idx" ON "contacts" ("isPrimary") WHERE "isPrimary" = true;
+CREATE INDEX IF NOT EXISTS "contacts_createdAt_idx" ON "contacts" ("createdAt" DESC);
+CREATE INDEX IF NOT EXISTS "contacts_lastContactedAt_idx" ON "contacts" ("lastContactedAt" DESC);
+
+-- ============================================
+-- RLS
+-- ============================================
+ALTER TABLE "contacts" ENABLE ROW LEVEL SECURITY;
+
+-- Drop existing policies
+DROP POLICY IF EXISTS "contacts_select_policy" ON "contacts";
+DROP POLICY IF EXISTS "contacts_insert_policy" ON "contacts";
+DROP POLICY IF EXISTS "contacts_update_policy" ON "contacts";
+DROP POLICY IF EXISTS "contacts_delete_policy" ON "contacts";
+
+-- Policy: Team members can view contacts
+CREATE POLICY "contacts_select_policy" ON "contacts"
+  FOR SELECT
+  USING (
+    "teamId" = ANY(public.get_user_team_ids())
+    OR public.is_superadmin()
+  );
+
+-- Policy: Team members can create contacts
+CREATE POLICY "contacts_insert_policy" ON "contacts"
+  FOR INSERT
+  WITH CHECK (
+    "teamId" = ANY(public.get_user_team_ids())
+  );
+
+-- Policy: Team members can update contacts
+CREATE POLICY "contacts_update_policy" ON "contacts"
+  FOR UPDATE
+  USING (
+    "teamId" = ANY(public.get_user_team_ids())
+    OR public.is_superadmin()
+  );
+
+-- Policy: Team members can delete contacts
+CREATE POLICY "contacts_delete_policy" ON "contacts"
+  FOR DELETE
+  USING (
+    "teamId" = ANY(public.get_user_team_ids())
+    OR public.is_superadmin()
+  );
+
+-- ============================================
+-- TRIGGER updatedAt
+-- ============================================
+CREATE OR REPLACE FUNCTION update_contacts_updated_at()
+RETURNS TRIGGER AS $$
+BEGIN
+  NEW."updatedAt" = NOW();
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+DROP TRIGGER IF EXISTS contacts_updated_at_trigger ON "contacts";
+CREATE TRIGGER contacts_updated_at_trigger
+  BEFORE UPDATE ON "contacts"
+  FOR EACH ROW
+  EXECUTE FUNCTION update_contacts_updated_at();
+
+-- ============================================
+-- COMMENTS
+-- ============================================
+COMMENT ON TABLE "contacts" IS 'People contacts at companies';
+COMMENT ON COLUMN "contacts"."isPrimary" IS 'Is this the primary contact for the company';
+COMMENT ON COLUMN "contacts"."preferredChannel" IS 'Preferred communication channel';

package/entities/contacts/migrations/002_contacts_metas.sql

@@ -0,0 +1,114 @@
+-- Migration: 002_contacts_metas.sql
+-- Description: Contacts metas (table, indexes, RLS)
+-- Date: 2025-09-27
+
+-- ============================================
+-- TABLE
+-- ============================================
+-- No DROP needed - removed automatically by parent table CASCADE
+CREATE TABLE IF NOT EXISTS public."contacts_metas" (
+  id             TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+  "entityId"     TEXT NOT NULL REFERENCES public."contacts"(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 contacts_metas_unique_key UNIQUE ("entityId", "metaKey")
+);
+
+COMMENT ON TABLE  public."contacts_metas"                   IS 'Contacts metadata table - stores additional key-value pairs for contacts';
+COMMENT ON COLUMN public."contacts_metas"."entityId"        IS 'Generic foreign key to parent contact entity';
+COMMENT ON COLUMN public."contacts_metas"."metaKey"         IS 'Metadata key name';
+COMMENT ON COLUMN public."contacts_metas"."metaValue"       IS 'Metadata value as JSONB';
+COMMENT ON COLUMN public."contacts_metas"."dataType"        IS 'Type hint for the value: json, string, number, boolean';
+COMMENT ON COLUMN public."contacts_metas"."isPublic"        IS 'Whether this metadata is publicly readable';
+COMMENT ON COLUMN public."contacts_metas"."isSearchable"    IS 'Whether this metadata is searchable';
+
+-- ============================================
+-- TRIGGER updatedAt (uses Better Auth function)
+-- ============================================
+DROP TRIGGER IF EXISTS contacts_metas_set_updated_at ON public."contacts_metas";
+CREATE TRIGGER contacts_metas_set_updated_at
+BEFORE UPDATE ON public."contacts_metas"
+FOR EACH ROW EXECUTE FUNCTION public.set_updated_at();
+
+-- ============================================
+-- INDEXES
+-- ============================================
+CREATE INDEX IF NOT EXISTS idx_contacts_metas_entity_id         ON public."contacts_metas"("entityId");
+CREATE INDEX IF NOT EXISTS idx_contacts_metas_key               ON public."contacts_metas"("metaKey");
+CREATE INDEX IF NOT EXISTS idx_contacts_metas_composite         ON public."contacts_metas"("entityId", "metaKey", "isPublic");
+CREATE INDEX IF NOT EXISTS idx_contacts_metas_is_public         ON public."contacts_metas"("isPublic") WHERE "isPublic" = true;
+CREATE INDEX IF NOT EXISTS idx_contacts_metas_is_searchable     ON public."contacts_metas"("isSearchable") WHERE "isSearchable" = true;
+CREATE INDEX IF NOT EXISTS idx_contacts_metas_searchable_key    ON public."contacts_metas"("metaKey") WHERE "isSearchable" = true;
+CREATE INDEX IF NOT EXISTS idx_contacts_metas_value_gin         ON public."contacts_metas" USING GIN ("metaValue");
+CREATE INDEX IF NOT EXISTS idx_contacts_metas_value_ops         ON public."contacts_metas" USING GIN ("metaValue" jsonb_path_ops);
+
+-- ============================================
+-- RLS
+-- ============================================
+ALTER TABLE public."contacts_metas" ENABLE ROW LEVEL SECURITY;
+
+-- Cleanup existing policies
+DROP POLICY IF EXISTS "Users can view contact metas"     ON public."contacts_metas";
+DROP POLICY IF EXISTS "Users can create contact metas"   ON public."contacts_metas";
+DROP POLICY IF EXISTS "Users can update contact metas"   ON public."contacts_metas";
+DROP POLICY IF EXISTS "Users can delete contact metas"   ON public."contacts_metas";
+
+-- ============================
+-- AUTHENTICATED USER POLICIES
+-- ============================
+-- Inherit permissions from parent entity
+CREATE POLICY "Users can view contact metas"
+ON public."contacts_metas"
+FOR SELECT TO authenticated
+USING (
+  EXISTS (
+    SELECT 1 FROM public."contacts" c
+    WHERE c.id = "entityId"
+      AND c."userId" = public.get_auth_user_id()
+  )
+);
+
+CREATE POLICY "Users can create contact metas"
+ON public."contacts_metas"
+FOR INSERT TO authenticated
+WITH CHECK (
+  EXISTS (
+    SELECT 1 FROM public."contacts" c
+    WHERE c.id = "entityId"
+      AND c."userId" = public.get_auth_user_id()
+  )
+);
+
+CREATE POLICY "Users can update contact metas"
+ON public."contacts_metas"
+FOR UPDATE TO authenticated
+USING (
+  EXISTS (
+    SELECT 1 FROM public."contacts" c
+    WHERE c.id = "entityId"
+      AND c."userId" = public.get_auth_user_id()
+  )
+)
+WITH CHECK (
+  EXISTS (
+    SELECT 1 FROM public."contacts" c
+    WHERE c.id = "entityId"
+      AND c."userId" = public.get_auth_user_id()
+  )
+);
+
+CREATE POLICY "Users can delete contact metas"
+ON public."contacts_metas"
+FOR DELETE TO authenticated
+USING (
+  EXISTS (
+    SELECT 1 FROM public."contacts" c
+    WHERE c.id = "entityId"
+      AND c."userId" = public.get_auth_user_id()
+  )
+);