CultivaBase — Xata Serverless

// CultivaBase — Cliente Xata para gestión del catálogo de skills
import { getXataClient } from "./xata";

const xata = getXataClient();

// ─────────────────────────────────────────────────────────────
// CRUD — Crear / Leer / Actualizar / Eliminar skills
// ─────────────────────────────────────────────────────────────

export async function createSkill(data: {
  title: string;
  content: string;
  servicioId: string;
  tags: string[];
  embedding: number[];   // generado con OpenAI text-embedding-3-small
}) {
  return await xata.db.skills.create({
    title:     data.title,
    content:   data.content,
    servicio:  data.servicioId,   // enlace a tabla servicios
    tags:      data.tags,
    embedding: data.embedding,
    published: false,
  });
}

export async function getPublishedSkills(page = 1) {
  const results = await xata.db.skills
    .filter({ published: true })
    .sort("publishedAt", "desc")
    .select(["title", "tags", "publishedAt", "servicio.name"])
    .getPaginated({ pagination: { size: 20, offset: (page - 1) * 20 } });

  return {
    skills:   results.records,
    hasMore:  results.hasNextPage(),
    total:    results.totalCount,
  };
}

export async function publishSkill(id: string) {
  await xata.db.skills.update(id, {
    published:   true,
    publishedAt: new Date(),
  });
}

// ─────────────────────────────────────────────────────────────
// BÚSQUEDA FULL-TEXT con highlight (dashboard buscador)
// ─────────────────────────────────────────────────────────────

export async function searchSkills(query: string, servicio?: string) {
  const results = await xata.db.skills.search(query, {
    target:     ["title", "content"],
    fuzziness:  1,               // tolerar 1 typo
    prefix:     "phrase",        // autocomplete
    filter:     {
      published: true,
      ...(servicio && { "servicio.name": servicio }),
    },
    highlight:  { enabled: true },
    page:       { size: 10 },
  });

  return results.records.map((r) => ({
    id:       r.id,
    title:    r.title,
    snippet:  r.getMetadata().highlight?.content ?? r.content?.slice(0, 200),
    score:    r.getMetadata().score,
    tags:     r.tags,
  }));
}

// ─────────────────────────────────────────────────────────────
// BÚSQUEDA VECTORIAL — "Skills parecidas" / Recomendaciones
// ─────────────────────────────────────────────────────────────

export async function findSimilarSkills(skillId: string, top = 5) {
  const skill = await xata.db.skills.read(skillId);
  if (!skill?.embedding) return [];

  const similar = await xata.db.skills.vectorSearch(
    "embedding",
    skill.embedding,
    {
      size:   top,
      filter: {
        published: true,
        id: { $isNot: skillId },
      },
    }
  );

  return similar.records;
}

// ─────────────────────────────────────────────────────────────
// RAG INTEGRADO — Chatbot "¿Qué skill necesito?"
// ─────────────────────────────────────────────────────────────

export async function askSkill(question: string) {
  const result = await xata.db.skills.ask(question, {
    searchType: "hybrid",         // keyword + vector a la vez
    rules: [
      "Responde sólo con skills del catálogo CULTIVA IA",
      "Indica el servicio al que pertenece cada skill",
      "Si hay varias opciones, lista las 3 más relevantes",
      "Responde en español y en menos de 4 oraciones",
    ],
  });

  return {
    answer:  result.answer,
    sources: result.records.map((r) => ({ id: r.id, title: r.title })),
  };
}

💬 Pregunta:  ¿cómo puedo generar leads con contenido?

🤖 Respuesta: Para generar leads con contenido en CULTIVA IA hay tres skills clave:
   (1) lead-magnets (Marketing) — crea recursos descargables de alto valor para capturar emails;
   (2) free-tool-strategy (Marketing) — herramientas gratuitas que posicionan y convierten;
   (3) content-strategy (Contenido) — estrategia editorial alineada con el buyer journey.
   Combina las tres para un funnel de atracción completo.

📚 Fuentes usadas:
   • rec_xyz001 — "Lead Magnets: recursos de valor para captura de emails"
   • rec_xyz002 — "Free Tool Strategy: herramientas gratuitas como canal de adquisición"
   • rec_xyz003 — "Content Strategy: editorial alineada con el funnel de ventas"