@nextsparkjs/theme-blog 0.1.0-beta.1

package/lib/selectors.ts

@@ -0,0 +1,179 @@
+/**
+ * Blog Theme - Block Selectors
+ *
+ * This file defines selectors for block components in the theme.
+ * It's placed in lib/ instead of tests/ so TypeScript can resolve imports.
+ *
+ * Used by:
+ * - Block components (for data-cy attributes)
+ * - Cypress tests (via tests/cypress/src/selectors.ts)
+ */
+
+import { createSelectorHelpers } from '@nextsparkjs/core/lib/test/selector-factory'
+import { CORE_SELECTORS } from '@nextsparkjs/core/lib/test/core-selectors'
+
+// =============================================================================
+// BLOCK SELECTORS
+// =============================================================================
+
+/**
+ * Block-specific selectors for the blog theme.
+ * Each block has at minimum a 'container' selector.
+ * Dynamic selectors use {index} placeholder.
+ */
+export const BLOCK_SELECTORS = {
+  // Blog theme currently has no custom blocks
+  // Add block selectors here when blocks are created
+} as const
+
+// =============================================================================
+// ENTITY SELECTORS
+// =============================================================================
+
+/**
+ * Entity-specific selectors for the blog theme.
+ */
+export const ENTITY_SELECTORS = {
+  posts: {
+    list: 'posts-list',
+    listItem: 'post-item-{index}',
+    card: 'post-card-{id}',
+    title: 'post-title',
+    excerpt: 'post-excerpt',
+    content: 'post-content',
+    featuredImage: 'post-featured-image',
+    status: 'post-status',
+    publishedAt: 'post-published-at',
+    createButton: 'post-create-button',
+    editButton: 'post-edit-button',
+    deleteButton: 'post-delete-button',
+    publishButton: 'post-publish-button',
+    unpublishButton: 'post-unpublish-button',
+    form: {
+      container: 'post-form',
+      title: 'post-form-title',
+      slug: 'post-form-slug',
+      excerpt: 'post-form-excerpt',
+      content: 'post-form-content',
+      featuredImage: 'post-form-featured-image',
+      featured: 'post-form-featured',
+      status: 'post-form-status',
+      publishedAt: 'post-form-published-at',
+      submit: 'post-form-submit',
+      cancel: 'post-form-cancel',
+    },
+  },
+  categories: {
+    list: 'categories-list',
+    listItem: 'category-item-{index}',
+    card: 'category-card-{id}',
+    name: 'category-name',
+    slug: 'category-slug',
+    description: 'category-description',
+    createButton: 'category-create-button',
+    editButton: 'category-edit-button',
+    deleteButton: 'category-delete-button',
+    form: {
+      container: 'category-form',
+      name: 'category-form-name',
+      slug: 'category-form-slug',
+      description: 'category-form-description',
+      submit: 'category-form-submit',
+      cancel: 'category-form-cancel',
+    },
+  },
+} as const
+
+// =============================================================================
+// BLOG-SPECIFIC SELECTORS
+// =============================================================================
+
+/**
+ * Blog-specific UI selectors.
+ */
+export const BLOG_SELECTORS = {
+  editor: {
+    container: 'post-editor',
+    toolbar: 'editor-toolbar',
+    preview: 'editor-preview',
+    wysiwyg: 'wysiwyg-editor',
+  },
+  publicBlog: {
+    container: 'public-blog',
+    postList: 'public-post-list',
+    postDetail: 'public-post-detail',
+    authorInfo: 'post-author-info',
+    categoryFilter: 'category-filter',
+    searchInput: 'blog-search-input',
+  },
+} as const
+
+// =============================================================================
+// THEME SELECTORS (CORE + BLOCKS + ENTITIES + BLOG)
+// =============================================================================
+
+/**
+ * Complete theme selectors merging core, blocks, and entities.
+ */
+export const THEME_SELECTORS = {
+  ...CORE_SELECTORS,
+  blocks: BLOCK_SELECTORS,
+  entities: ENTITY_SELECTORS,
+  blog: BLOG_SELECTORS,
+} as const
+
+// =============================================================================
+// EXPORTS
+// =============================================================================
+
+/**
+ * Create helpers bound to theme selectors
+ */
+const helpers = createSelectorHelpers(THEME_SELECTORS)
+
+/**
+ * Full selectors object (core + theme extensions)
+ */
+export const SELECTORS = helpers.SELECTORS
+
+/**
+ * Get a selector value by path
+ *
+ * @example
+ * sel('auth.login.form') // 'login-form'
+ * sel('entities.posts.list') // 'posts-list'
+ * sel('entities.posts.listItem', { index: '0' }) // 'post-item-0'
+ */
+export const sel = helpers.sel
+
+/**
+ * Alias for sel
+ */
+export const s = helpers.s
+
+/**
+ * Get selector only in dev/test environments
+ */
+export const selDev = helpers.selDev
+
+/**
+ * Get Cypress selector string [data-cy="..."]
+ *
+ * @example
+ * cySelector('entities.posts.list') // '[data-cy="posts-list"]'
+ */
+export const cySelector = helpers.cySelector
+
+/**
+ * Create entity-specific selector helpers
+ */
+export const entitySelectors = helpers.entitySelectors
+
+/**
+ * Type exports
+ */
+export type ThemeSelectorsType = typeof THEME_SELECTORS
+export type BlockSelectorsType = typeof BLOCK_SELECTORS
+export type EntitySelectorsType = typeof ENTITY_SELECTORS
+export type { Replacements } from '@nextsparkjs/core/lib/test/selector-factory'
+export { CORE_SELECTORS }

package/messages/en.json

@@ -0,0 +1,113 @@
+{
+  "common": {
+    "blog": {
+      "viewBlog": "View Blog",
+      "export": "Export Posts"
+    }
+  },
+  "blog": {
+    "title": "Blog Platform",
+    "description": "Thoughts, stories, and ideas from our community of writers",
+    "viewBlog": "View Blog",
+    "writtenBy": "Written by",
+    "publishedOn": "Published on",
+    "readMore": "Read more",
+    "backToHome": "Back to Home",
+    "backToPosts": "Back to Posts",
+    "noPosts": "No posts yet",
+    "noPostsDescription": "Check back soon for new content.",
+
+    "publicFeed": {
+      "title": "Latest Stories",
+      "subtitle": "Thoughts, stories, and ideas from our community of writers",
+      "recentPosts": "Recent Posts",
+      "loadMore": "Load More",
+      "noResults": "No posts found",
+      "filterByCategory": "Filter by Category"
+    },
+
+    "newsletter": {
+      "title": "Stay in the loop",
+      "description": "Subscribe to get notified when new articles are published. No spam, unsubscribe anytime.",
+      "placeholder": "your@email.com",
+      "subscribe": "Subscribe"
+    },
+
+    "author": {
+      "profileTitle": "{name}'s Profile",
+      "postsCount": "{count} published posts",
+      "postsCountSingular": "{count} published post",
+      "viewAllPosts": "View all posts",
+      "followOn": "Follow on {platform}",
+      "visitWebsite": "Visit website",
+      "moreFrom": "More from {name}",
+      "notFound": "Author not found",
+      "notFoundDescription": "The author you are looking for does not exist."
+    },
+
+    "category": {
+      "title": "Posts in {category}",
+      "noResults": "No posts in this category yet"
+    },
+
+    "dashboard": {
+      "myPosts": "My Posts",
+      "newPost": "New Post",
+      "editProfile": "Edit Profile",
+      "publishPost": "Publish",
+      "unpublishPost": "Unpublish",
+      "confirmPublish": "Are you sure you want to publish this post?",
+      "confirmUnpublish": "Are you sure you want to unpublish this post?",
+      "statusDraft": "Draft",
+      "statusPublished": "Published"
+    },
+
+    "profile": {
+      "username": "Username",
+      "usernameHint": "This will be your public profile URL: /author/{username}",
+      "bio": "Bio",
+      "bioPlaceholder": "Tell readers about yourself...",
+      "socialLinks": "Social Links",
+      "twitter": "Twitter/X Profile",
+      "linkedin": "LinkedIn Profile",
+      "website": "Personal Website",
+      "saveProfile": "Save Profile",
+      "profileUpdated": "Profile updated successfully"
+    },
+
+    "export": "Export Posts",
+    "import": "Import Posts",
+    "exportDescription": "Download all your posts as a JSON file",
+    "importDescription": "Upload a JSON file to import posts",
+    "exportSuccess": "Posts exported successfully",
+    "importSuccess": "Posts imported successfully",
+    "importError": "Failed to import posts",
+
+    "quickActions": {
+      "writePost": "Write a new post"
+    },
+
+    "categories": {
+      "all": "All Categories",
+      "uncategorized": "Uncategorized"
+    },
+
+    "search": {
+      "placeholder": "Search posts...",
+      "noResults": "No posts found",
+      "resultsFor": "Results for"
+    },
+
+    "pagination": {
+      "previous": "Previous",
+      "next": "Next",
+      "page": "Page"
+    },
+
+    "meta": {
+      "minRead": "min read",
+      "draft": "Draft",
+      "scheduled": "Scheduled for"
+    }
+  }
+}

package/messages/es.json

@@ -0,0 +1,113 @@
+{
+  "common": {
+    "blog": {
+      "viewBlog": "Ver Blog",
+      "export": "Exportar Posts"
+    }
+  },
+  "blog": {
+    "title": "Plataforma de Blog",
+    "description": "Pensamientos, historias e ideas de nuestra comunidad de escritores",
+    "viewBlog": "Ver Blog",
+    "writtenBy": "Escrito por",
+    "publishedOn": "Publicado el",
+    "readMore": "Leer más",
+    "backToHome": "Volver al Inicio",
+    "backToPosts": "Volver a Posts",
+    "noPosts": "Aún no hay posts",
+    "noPostsDescription": "Vuelve pronto para ver nuevo contenido.",
+
+    "publicFeed": {
+      "title": "Últimas Historias",
+      "subtitle": "Pensamientos, historias e ideas de nuestra comunidad de escritores",
+      "recentPosts": "Posts Recientes",
+      "loadMore": "Cargar Más",
+      "noResults": "No se encontraron posts",
+      "filterByCategory": "Filtrar por Categoría"
+    },
+
+    "newsletter": {
+      "title": "Mantente informado",
+      "description": "Suscríbete para recibir notificaciones cuando se publiquen nuevos artículos. Sin spam, cancela cuando quieras.",
+      "placeholder": "tu@email.com",
+      "subscribe": "Suscribirse"
+    },
+
+    "author": {
+      "profileTitle": "Perfil de {name}",
+      "postsCount": "{count} posts publicados",
+      "postsCountSingular": "{count} post publicado",
+      "viewAllPosts": "Ver todos los posts",
+      "followOn": "Seguir en {platform}",
+      "visitWebsite": "Visitar sitio web",
+      "moreFrom": "Más de {name}",
+      "notFound": "Autor no encontrado",
+      "notFoundDescription": "El autor que buscas no existe."
+    },
+
+    "category": {
+      "title": "Posts en {category}",
+      "noResults": "Aún no hay posts en esta categoría"
+    },
+
+    "dashboard": {
+      "myPosts": "Mis Posts",
+      "newPost": "Nuevo Post",
+      "editProfile": "Editar Perfil",
+      "publishPost": "Publicar",
+      "unpublishPost": "Despublicar",
+      "confirmPublish": "¿Estás seguro de que quieres publicar este post?",
+      "confirmUnpublish": "¿Estás seguro de que quieres despublicar este post?",
+      "statusDraft": "Borrador",
+      "statusPublished": "Publicado"
+    },
+
+    "profile": {
+      "username": "Nombre de usuario",
+      "usernameHint": "Esta será tu URL de perfil público: /author/{username}",
+      "bio": "Biografía",
+      "bioPlaceholder": "Cuéntale a los lectores sobre ti...",
+      "socialLinks": "Enlaces Sociales",
+      "twitter": "Perfil de Twitter/X",
+      "linkedin": "Perfil de LinkedIn",
+      "website": "Sitio Web Personal",
+      "saveProfile": "Guardar Perfil",
+      "profileUpdated": "Perfil actualizado exitosamente"
+    },
+
+    "export": "Exportar Posts",
+    "import": "Importar Posts",
+    "exportDescription": "Descarga todos tus posts como archivo JSON",
+    "importDescription": "Sube un archivo JSON para importar posts",
+    "exportSuccess": "Posts exportados exitosamente",
+    "importSuccess": "Posts importados exitosamente",
+    "importError": "Error al importar posts",
+
+    "quickActions": {
+      "writePost": "Escribir un nuevo post"
+    },
+
+    "categories": {
+      "all": "Todas las Categorías",
+      "uncategorized": "Sin categoría"
+    },
+
+    "search": {
+      "placeholder": "Buscar posts...",
+      "noResults": "No se encontraron posts",
+      "resultsFor": "Resultados para"
+    },
+
+    "pagination": {
+      "previous": "Anterior",
+      "next": "Siguiente",
+      "page": "Página"
+    },
+
+    "meta": {
+      "minRead": "min de lectura",
+      "draft": "Borrador",
+      "scheduled": "Programado para"
+    }
+  }
+}

package/migrations/002_author_profile_fields.sql

@@ -0,0 +1,37 @@
+-- ============================================================================
+-- Author Profile Fields Migration
+-- Blog theme: Add public profile fields for multi-author platform
+-- ============================================================================
+
+-- Add profile fields to users table
+ALTER TABLE "users" ADD COLUMN IF NOT EXISTS "username" TEXT;
+ALTER TABLE "users" ADD COLUMN IF NOT EXISTS "bio" TEXT;
+ALTER TABLE "users" ADD COLUMN IF NOT EXISTS "social_twitter" TEXT;
+ALTER TABLE "users" ADD COLUMN IF NOT EXISTS "social_linkedin" TEXT;
+ALTER TABLE "users" ADD COLUMN IF NOT EXISTS "social_website" TEXT;
+
+-- Create unique index for username (case-insensitive)
+CREATE UNIQUE INDEX IF NOT EXISTS "users_username_unique_idx"
+  ON "users" (LOWER("username"))
+  WHERE "username" IS NOT NULL;
+
+-- Index for username lookups
+CREATE INDEX IF NOT EXISTS "users_username_idx" ON "users" ("username");
+
+-- Add check constraint for username format (alphanumeric, underscore, min 3 chars)
+DO $$
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1 FROM pg_constraint WHERE conname = 'check_username_format'
+  ) THEN
+    ALTER TABLE "users" ADD CONSTRAINT "check_username_format"
+      CHECK ("username" IS NULL OR "username" ~ '^[a-zA-Z0-9_]{3,30}$');
+  END IF;
+END $$;
+
+-- Add comments
+COMMENT ON COLUMN "users"."username" IS 'Public username for author profile URL (/author/[username])';
+COMMENT ON COLUMN "users"."bio" IS 'Author biography shown on public profile';
+COMMENT ON COLUMN "users"."social_twitter" IS 'Twitter/X profile URL';
+COMMENT ON COLUMN "users"."social_linkedin" IS 'LinkedIn profile URL';
+COMMENT ON COLUMN "users"."social_website" IS 'Personal website URL';

package/migrations/003_categories_table.sql

@@ -0,0 +1,90 @@
+-- ============================================================================
+-- Categories Table Migration
+-- Blog theme: Categories entity for post categorization
+-- ============================================================================
+
+-- Create categories table
+CREATE TABLE IF NOT EXISTS "categories" (
+  "id" TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+  "teamId" TEXT NOT NULL REFERENCES "teams"("id") ON DELETE CASCADE,
+  "userId" TEXT NOT NULL REFERENCES "users"("id") ON DELETE CASCADE,
+  "name" VARCHAR(100) NOT NULL,
+  "slug" VARCHAR(100) NOT NULL,
+  "description" TEXT,
+  "createdAt" TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  "updatedAt" TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+-- Unique slug per team
+CREATE UNIQUE INDEX IF NOT EXISTS "categories_slug_teamId_idx"
+  ON "categories" ("slug", "teamId");
+
+-- Index for team queries
+CREATE INDEX IF NOT EXISTS "categories_teamId_idx" ON "categories" ("teamId");
+
+-- Index for user queries
+CREATE INDEX IF NOT EXISTS "categories_userId_idx" ON "categories" ("userId");
+
+-- Index for slug lookups (public pages)
+CREATE INDEX IF NOT EXISTS "categories_slug_idx" ON "categories" ("slug");
+
+-- Enable RLS
+ALTER TABLE "categories" ENABLE ROW LEVEL SECURITY;
+
+-- Drop existing policies if any
+DROP POLICY IF EXISTS "categories_select_policy" ON "categories";
+DROP POLICY IF EXISTS "categories_insert_policy" ON "categories";
+DROP POLICY IF EXISTS "categories_update_policy" ON "categories";
+DROP POLICY IF EXISTS "categories_delete_policy" ON "categories";
+DROP POLICY IF EXISTS "categories_public_select_policy" ON "categories";
+
+-- Policy: Users can manage their own categories
+CREATE POLICY "categories_select_policy" ON "categories"
+  FOR SELECT TO authenticated
+  USING (
+    "teamId" = ANY(public.get_user_team_ids())
+    OR public.is_superadmin()
+  );
+
+CREATE POLICY "categories_insert_policy" ON "categories"
+  FOR INSERT TO authenticated
+  WITH CHECK (
+    "teamId" = ANY(public.get_user_team_ids())
+  );
+
+CREATE POLICY "categories_update_policy" ON "categories"
+  FOR UPDATE TO authenticated
+  USING (
+    "teamId" = ANY(public.get_user_team_ids())
+    OR public.is_superadmin()
+  );
+
+CREATE POLICY "categories_delete_policy" ON "categories"
+  FOR DELETE TO authenticated
+  USING (
+    "teamId" = ANY(public.get_user_team_ids())
+    OR public.is_superadmin()
+  );
+
+-- Policy: Public can see all categories (for public pages)
+CREATE POLICY "categories_public_select_policy" ON "categories"
+  FOR SELECT TO anon
+  USING (true);
+
+-- Trigger for updatedAt
+CREATE OR REPLACE FUNCTION update_categories_updated_at()
+RETURNS TRIGGER AS $$
+BEGIN
+  NEW."updatedAt" = NOW();
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+DROP TRIGGER IF EXISTS categories_updated_at_trigger ON "categories";
+CREATE TRIGGER categories_updated_at_trigger
+  BEFORE UPDATE ON "categories"
+  FOR EACH ROW
+  EXECUTE FUNCTION update_categories_updated_at();
+
+-- Comments
+COMMENT ON TABLE "categories" IS 'Blog post categories per author (team isolated)';