@nextsparkjs/theme-blog 0.1.0-beta.1

package/entities/posts/messages/es.json

@@ -0,0 +1,100 @@
+{
+  "title": "Posts",
+  "singular": "Post",
+  "plural": "Posts",
+  "description": "Gestiona tus posts del blog",
+
+  "fields": {
+    "title": {
+      "label": "Título",
+      "placeholder": "Escribe un título atractivo...",
+      "description": "El título de tu post"
+    },
+    "slug": {
+      "label": "Slug",
+      "placeholder": "mi-post-del-blog",
+      "description": "Versión amigable para URL del título"
+    },
+    "excerpt": {
+      "label": "Extracto",
+      "placeholder": "Escribe un breve resumen de tu post...",
+      "description": "Un resumen corto que se muestra en los listados"
+    },
+    "content": {
+      "label": "Contenido",
+      "placeholder": "Comienza a escribir tu post...",
+      "description": "El contenido principal de tu post"
+    },
+    "featuredImage": {
+      "label": "Imagen Destacada",
+      "placeholder": "Sube una imagen...",
+      "description": "Imagen principal que se muestra con el post"
+    },
+    "category": {
+      "label": "Categoría",
+      "placeholder": "ej., Tecnología, Viajes, Comida",
+      "description": "Categoría principal del post"
+    },
+    "tags": {
+      "label": "Etiquetas",
+      "placeholder": "Agregar etiquetas...",
+      "description": "Palabras clave para ayudar a encontrar este post"
+    },
+    "status": {
+      "label": "Estado",
+      "placeholder": "Seleccionar estado...",
+      "description": "Estado de publicación",
+      "options": {
+        "draft": "Borrador",
+        "published": "Publicado",
+        "scheduled": "Programado"
+      }
+    },
+    "publishedAt": {
+      "label": "Fecha de Publicación",
+      "placeholder": "Seleccionar fecha...",
+      "description": "Cuándo se publicó/publicará el post"
+    },
+    "createdAt": {
+      "label": "Creado",
+      "description": "Cuándo se creó el post"
+    },
+    "updatedAt": {
+      "label": "Actualizado",
+      "description": "Cuándo se modificó por última vez"
+    }
+  },
+
+  "actions": {
+    "create": "Nuevo Post",
+    "edit": "Editar Post",
+    "delete": "Eliminar Post",
+    "publish": "Publicar",
+    "unpublish": "Despublicar",
+    "saveDraft": "Guardar Borrador",
+    "preview": "Vista Previa"
+  },
+
+  "messages": {
+    "created": "Post creado exitosamente",
+    "updated": "Post actualizado exitosamente",
+    "deleted": "Post eliminado exitosamente",
+    "published": "Post publicado exitosamente",
+    "unpublished": "Post despublicado",
+    "confirmDelete": "¿Estás seguro de que quieres eliminar este post? Esta acción no se puede deshacer."
+  },
+
+  "empty": {
+    "title": "Aún no hay posts",
+    "description": "Comienza escribiendo tu primer post del blog.",
+    "action": "Escribe tu primer post"
+  },
+
+  "filters": {
+    "all": "Todos los Posts",
+    "published": "Publicados",
+    "draft": "Borradores",
+    "scheduled": "Programados"
+  }
+}
+

package/entities/posts/migrations/001_posts_table.sql

@@ -0,0 +1,110 @@
+-- ============================================================================
+-- Posts Table Migration
+-- Blog theme: Personal blog posts
+-- ============================================================================
+
+-- Create posts table
+CREATE TABLE IF NOT EXISTS "posts" (
+  "id" TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+  "title" VARCHAR(255) NOT NULL,
+  "slug" VARCHAR(255) NOT NULL,
+  "excerpt" TEXT,
+  "content" TEXT NOT NULL,
+  "featuredImage" VARCHAR(500),
+  "category" VARCHAR(100),
+  "tags" JSONB DEFAULT '[]'::jsonb,
+  "status" VARCHAR(20) NOT NULL DEFAULT 'draft' CHECK ("status" IN ('draft', 'published', 'scheduled')),
+  "publishedAt" TIMESTAMPTZ,
+  "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()
+);
+
+-- Create unique index for slug per user
+CREATE UNIQUE INDEX IF NOT EXISTS "posts_slug_userId_idx" ON "posts" ("slug", "userId");
+
+-- Index for team isolation queries
+CREATE INDEX IF NOT EXISTS "posts_teamId_idx" ON "posts" ("teamId");
+
+-- Index for user queries
+CREATE INDEX IF NOT EXISTS "posts_userId_idx" ON "posts" ("userId");
+
+-- Index for public listing (published posts)
+CREATE INDEX IF NOT EXISTS "posts_status_publishedAt_idx" ON "posts" ("status", "publishedAt" DESC) 
+  WHERE "status" = 'published';
+
+-- Index for category filtering
+CREATE INDEX IF NOT EXISTS "posts_category_idx" ON "posts" ("category");
+
+-- Enable RLS
+ALTER TABLE "posts" ENABLE ROW LEVEL SECURITY;
+
+-- Drop existing policies if any
+DROP POLICY IF EXISTS "posts_select_policy" ON "posts";
+DROP POLICY IF EXISTS "posts_insert_policy" ON "posts";
+DROP POLICY IF EXISTS "posts_update_policy" ON "posts";
+DROP POLICY IF EXISTS "posts_delete_policy" ON "posts";
+DROP POLICY IF EXISTS "posts_public_select_policy" ON "posts";
+
+-- Policy: Users can select their own posts (or superadmin can see all)
+CREATE POLICY "posts_select_policy" ON "posts"
+  FOR SELECT TO authenticated
+  USING (
+    "teamId" = ANY(public.get_user_team_ids())
+    OR public.is_superadmin()
+  );
+
+-- Policy: Public can see published posts (anonymous access)
+CREATE POLICY "posts_public_select_policy" ON "posts"
+  FOR SELECT TO anon
+  USING (
+    "status" = 'published'
+    AND "publishedAt" <= NOW()
+  );
+
+-- Policy: Users can insert their own posts
+CREATE POLICY "posts_insert_policy" ON "posts"
+  FOR INSERT TO authenticated
+  WITH CHECK (
+    "teamId" = ANY(public.get_user_team_ids())
+  );
+
+-- Policy: Users can update their own posts (or superadmin)
+CREATE POLICY "posts_update_policy" ON "posts"
+  FOR UPDATE TO authenticated
+  USING (
+    "teamId" = ANY(public.get_user_team_ids())
+    OR public.is_superadmin()
+  );
+
+-- Policy: Users can delete their own posts (or superadmin)
+CREATE POLICY "posts_delete_policy" ON "posts"
+  FOR DELETE TO authenticated
+  USING (
+    "teamId" = ANY(public.get_user_team_ids())
+    OR public.is_superadmin()
+  );
+
+-- Trigger for auto-updating updatedAt
+CREATE OR REPLACE FUNCTION update_posts_updated_at()
+RETURNS TRIGGER AS $$
+BEGIN
+  NEW."updatedAt" = NOW();
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+DROP TRIGGER IF EXISTS posts_updated_at_trigger ON "posts";
+CREATE TRIGGER posts_updated_at_trigger
+  BEFORE UPDATE ON "posts"
+  FOR EACH ROW
+  EXECUTE FUNCTION update_posts_updated_at();
+
+-- ============================================================================
+-- Comments
+-- ============================================================================
+COMMENT ON TABLE "posts" IS 'Blog posts for personal blog theme';
+COMMENT ON COLUMN "posts"."slug" IS 'URL-friendly identifier, unique per user';
+COMMENT ON COLUMN "posts"."status" IS 'draft, published, or scheduled';
+COMMENT ON COLUMN "posts"."tags" IS 'JSON array of tag strings';

package/entities/posts/migrations/002_add_featured.sql

@@ -0,0 +1,19 @@
+-- ============================================================================
+-- Posts Migration: Add Featured Column
+-- Blog theme: Allows marking posts as featured for homepage display
+-- ============================================================================
+
+-- Add featured column
+ALTER TABLE "posts" ADD COLUMN IF NOT EXISTS "featured" BOOLEAN NOT NULL DEFAULT false;
+
+-- Create index for featured posts queries
+CREATE INDEX IF NOT EXISTS "posts_featured_idx" ON "posts" ("featured") WHERE "featured" = true;
+
+-- Create composite index for featured + published posts
+CREATE INDEX IF NOT EXISTS "posts_featured_published_idx" ON "posts" ("featured", "status", "publishedAt" DESC)
+  WHERE "featured" = true AND "status" = 'published';
+
+-- ============================================================================
+-- Comments
+-- ============================================================================
+COMMENT ON COLUMN "posts"."featured" IS 'Whether this post should be featured on the homepage';

package/entities/posts/migrations/003_post_categories_pivot.sql

@@ -0,0 +1,47 @@
+-- ============================================================================
+-- Post Categories Pivot Table Migration
+-- Blog theme: Many-to-many relationship between posts and categories
+-- ============================================================================
+
+-- Create pivot table
+CREATE TABLE IF NOT EXISTS "post_categories" (
+  "postId" TEXT NOT NULL REFERENCES "posts"("id") ON DELETE CASCADE,
+  "categoryId" TEXT NOT NULL REFERENCES "categories"("id") ON DELETE CASCADE,
+  PRIMARY KEY ("postId", "categoryId")
+);
+
+-- Indexes for efficient queries
+CREATE INDEX IF NOT EXISTS "post_categories_postId_idx" ON "post_categories" ("postId");
+CREATE INDEX IF NOT EXISTS "post_categories_categoryId_idx" ON "post_categories" ("categoryId");
+
+-- Enable RLS
+ALTER TABLE "post_categories" ENABLE ROW LEVEL SECURITY;
+
+-- Drop existing policies if any
+DROP POLICY IF EXISTS "post_categories_all_policy" ON "post_categories";
+DROP POLICY IF EXISTS "post_categories_public_select_policy" ON "post_categories";
+
+-- Policies follow post ownership (if user owns the post, they can manage its categories)
+CREATE POLICY "post_categories_all_policy" ON "post_categories"
+  FOR ALL TO authenticated
+  USING (
+    EXISTS (
+      SELECT 1 FROM "posts" p
+      WHERE p.id = "postId"
+      AND p."teamId" = ANY(public.get_user_team_ids())
+    )
+  );
+
+-- Public read access for category pages
+CREATE POLICY "post_categories_public_select_policy" ON "post_categories"
+  FOR SELECT TO anon
+  USING (
+    EXISTS (
+      SELECT 1 FROM "posts" p
+      WHERE p.id = "postId"
+      AND p."status" = 'published'
+    )
+  );
+
+-- Comments
+COMMENT ON TABLE "post_categories" IS 'Many-to-many relationship between posts and categories';

package/entities/posts/posts.config.ts

@@ -0,0 +1,61 @@
+/**
+ * Posts Entity Configuration
+ * 
+ * Blog posts entity for the personal blog theme.
+ */
+
+import { FileText } from 'lucide-react'
+import type { EntityConfig } from '@nextsparkjs/core/lib/entities/types'
+import { postFields } from './posts.fields'
+
+export const postEntityConfig: EntityConfig = {
+  // ==========================================
+  // 1. BASIC IDENTIFICATION
+  // ==========================================
+  slug: 'posts',
+  enabled: true,
+  names: {
+    singular: 'post',
+    plural: 'Posts'
+  },
+  icon: FileText,
+  
+  // ==========================================
+  // 2. ACCESS AND SCOPE CONFIGURATION
+  // ==========================================
+  access: {
+    public: true,           // Published posts are publicly accessible
+    api: true,              // API access enabled
+    metadata: true,         // Supports metadata (SEO, custom fields)
+    shared: false           // Personal posts, filtered by userId
+  },
+  
+  // ==========================================
+  // 3. UI/UX FEATURES
+  // ==========================================
+  ui: {
+    dashboard: {
+      showInMenu: true,
+      showInTopbar: true
+    },
+    public: {
+      hasArchivePage: true,  // /posts - list of all published posts
+      hasSinglePage: true    // /posts/[slug] - individual post page
+    },
+    features: {
+      searchable: true,
+      sortable: true,
+      filterable: true,
+      bulkOperations: true,
+      importExport: true     // Export/Import feature enabled
+    }
+  },
+  
+  // ==========================================
+  // FIELDS
+  // ==========================================
+  fields: postFields,
+}
+
+export default postEntityConfig
+

package/entities/posts/posts.fields.ts

@@ -0,0 +1,234 @@
+/**
+ * Posts Entity Fields Configuration
+ * 
+ * Complete fields for a blog post including SEO and categorization.
+ */
+
+import type { EntityField } from '@nextsparkjs/core/lib/entities/types'
+
+export const postFields: EntityField[] = [
+  // ==========================================
+  // MAIN CONTENT
+  // ==========================================
+  {
+    name: 'title',
+    type: 'text',
+    required: true,
+    display: {
+      label: 'Title',
+      description: 'The title of your blog post',
+      placeholder: 'Enter a compelling title...',
+      showInList: true,
+      showInDetail: true,
+      showInForm: true,
+      order: 1,
+      columnWidth: 12,
+    },
+    api: {
+      readOnly: false,
+      searchable: true,
+      sortable: true,
+    },
+  },
+  {
+    name: 'slug',
+    type: 'text',
+    required: true,
+    display: {
+      label: 'Slug',
+      description: 'URL-friendly version of the title (auto-generated)',
+      placeholder: 'my-blog-post',
+      showInList: false,
+      showInDetail: true,
+      showInForm: true,
+      order: 2,
+      columnWidth: 12,
+    },
+    api: {
+      readOnly: false,
+      searchable: false,
+      sortable: false,
+    },
+  },
+  {
+    name: 'excerpt',
+    type: 'textarea',
+    required: false,
+    display: {
+      label: 'Excerpt',
+      description: 'A short summary shown in post listings',
+      placeholder: 'Write a brief summary of your post...',
+      showInList: true,
+      showInDetail: true,
+      showInForm: true,
+      order: 3,
+      columnWidth: 12,
+    },
+    api: {
+      readOnly: false,
+      searchable: true,
+      sortable: false,
+    },
+  },
+  {
+    name: 'content',
+    type: 'richtext',
+    required: true,
+    display: {
+      label: 'Content',
+      description: 'The main content of your blog post',
+      placeholder: 'Start writing your post...',
+      showInList: false,
+      showInDetail: true,
+      showInForm: true,
+      order: 4,
+      columnWidth: 12,
+    },
+    api: {
+      readOnly: false,
+      searchable: true,
+      sortable: false,
+    },
+  },
+
+  // ==========================================
+  // MEDIA
+  // ==========================================
+  {
+    name: 'featuredImage',
+    type: 'image',
+    required: false,
+    display: {
+      label: 'Featured Image',
+      description: 'Main image displayed with the post',
+      placeholder: 'Upload an image...',
+      showInList: true,
+      showInDetail: true,
+      showInForm: true,
+      order: 5,
+      columnWidth: 12,
+    },
+    api: {
+      readOnly: false,
+      searchable: false,
+      sortable: false,
+    },
+  },
+
+
+  // ==========================================
+  // FEATURING
+  // ==========================================
+  {
+    name: 'featured',
+    type: 'boolean',
+    required: false,
+    defaultValue: false,
+    display: {
+      label: 'Featured',
+      description: 'Show this post in the featured section on the homepage',
+      showInList: true,
+      showInDetail: true,
+      showInForm: true,
+      order: 6,
+      columnWidth: 4,
+    },
+    api: {
+      readOnly: false,
+      searchable: false,
+      sortable: true,
+    },
+  },
+
+  // ==========================================
+  // PUBLISHING
+  // ==========================================
+  {
+    name: 'status',
+    type: 'select',
+    required: true,
+    defaultValue: 'draft',
+    options: [
+      { value: 'draft', label: 'Draft' },
+      { value: 'published', label: 'Published' },
+      { value: 'scheduled', label: 'Scheduled' },
+    ],
+    display: {
+      label: 'Status',
+      description: 'Publication status',
+      placeholder: 'Select status...',
+      showInList: true,
+      showInDetail: true,
+      showInForm: true,
+      order: 8,
+      columnWidth: 4,
+    },
+    api: {
+      readOnly: false,
+      searchable: false,
+      sortable: true,
+    },
+  },
+  {
+    name: 'publishedAt',
+    type: 'datetime',
+    required: false,
+    display: {
+      label: 'Publish Date',
+      description: 'When the post was/will be published',
+      placeholder: 'Select date...',
+      showInList: true,
+      showInDetail: true,
+      showInForm: true,
+      order: 9,
+      columnWidth: 4,
+    },
+    api: {
+      readOnly: false,
+      searchable: false,
+      sortable: true,
+    },
+  },
+
+  // ==========================================
+  // TIMESTAMPS
+  // ==========================================
+  {
+    name: 'createdAt',
+    type: 'datetime',
+    required: false,
+    display: {
+      label: 'Created At',
+      description: 'When the post was created',
+      showInList: false,
+      showInDetail: true,
+      showInForm: false,
+      order: 98,
+      columnWidth: 4,
+    },
+    api: {
+      readOnly: true,
+      searchable: false,
+      sortable: true,
+    },
+  },
+  {
+    name: 'updatedAt',
+    type: 'datetime',
+    required: false,
+    display: {
+      label: 'Updated At',
+      description: 'When the post was last modified',
+      showInList: false,
+      showInDetail: true,
+      showInForm: false,
+      order: 99,
+    },
+    api: {
+      readOnly: true,
+      searchable: false,
+      sortable: true,
+    },
+  },
+]
+