@jhits/plugin-blog 0.0.14 → 0.0.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jhits/plugin-blog",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "description": "Professional blog management system for the JHITS ecosystem",
   "publishConfig": {
     "access": "public"
@@ -30,9 +30,9 @@
     "lucide-react": "^0.564.0",
     "mongodb": "^7.1.0",
     "next-auth": "^4.24.13",
-    "@jhits/plugin-content": "0.0.12",
-    "@jhits/plugin-core": "0.0.7",
-    "@jhits/plugin-images": "0.0.10"
+    "@jhits/plugin-content": "0.0.14",
+    "@jhits/plugin-core": "0.0.9",
+    "@jhits/plugin-images": "0.0.12"
   },
   "peerDependencies": {
     "next": ">=15.0.0",
@@ -58,6 +58,7 @@
     "typescript": "^5.9.3"
   },
   "files": [
+    "src",
     "dist",
     "package.json"
   ],

package/src/api/categories.ts

@@ -0,0 +1,43 @@
+/**
+ * Blog Categories API Handler
+ * GET /api/plugin-blog/categories - Get all unique categories
+ */
+
+import { NextRequest, NextResponse } from 'next/server';
+import { BlogApiConfig } from './handler';
+
+export async function GET(req: NextRequest, config: BlogApiConfig): Promise<NextResponse> {
+    try {
+        const dbConnection = await config.getDb();
+        const db = dbConnection.db();
+        const blogs = db.collection(config.collectionName || 'blogs');
+
+        // Get all unique categories from blog posts
+        const categories = await blogs.distinct('categoryTags.category');
+
+        // Also get categories from Hero blocks in contentBlocks
+        const heroBlocks = await blogs.aggregate([
+            { $unwind: '$contentBlocks' },
+            { $match: { 'contentBlocks.type': 'hero' } },
+            { $project: { category: '$contentBlocks.data.category' } },
+            { $match: { category: { $exists: true, $ne: null, $nin: [''] } } },
+            { $group: { _id: '$category' } },
+        ]).toArray();
+
+        const heroCategories = heroBlocks.map((block: any) => block._id);
+
+        // Combine and deduplicate
+        const allCategories = Array.from(
+            new Set([...categories.filter(Boolean), ...heroCategories.filter(Boolean)])
+        ).sort();
+
+        return NextResponse.json({ categories: allCategories });
+    } catch (err: any) {
+        console.error('[BlogAPI] Categories error:', err);
+        return NextResponse.json(
+            { error: 'Failed to fetch categories', detail: err.message },
+            { status: 500 }
+        );
+    }
+}
+

package/src/api/check-title.ts

@@ -0,0 +1,60 @@
+/**
+ * Blog Check Title API Handler
+ * GET /api/plugin-blog/check-title - Check if a blog title already exists
+ */
+
+import { NextRequest, NextResponse } from 'next/server';
+import { BlogApiConfig } from './handler';
+
+export async function GET(req: NextRequest, config: BlogApiConfig): Promise<NextResponse> {
+    try {
+        const url = new URL(req.url);
+        const title = url.searchParams.get('title');
+        const excludeSlug = url.searchParams.get('excludeSlug');
+
+        // If title is empty or too short, don't bother the database
+        if (!title || title.trim().length < 3) {
+            return NextResponse.json({ duplicate: false });
+        }
+
+        const dbConnection = await config.getDb();
+        const db = dbConnection.db();
+        const blogs = db.collection(config.collectionName || 'blogs');
+
+        /**
+         * We search for a title match using:
+         * 1. A case-insensitive regex (^ and $ ensure it's the exact full string)
+         * 2. An exclusion of the current slug (so editing an article doesn't flag itself)
+         */
+        const query: any = {
+            title: {
+                $regex: new RegExp(`^${title.trim().replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}$`, 'i')
+            }
+        };
+
+        if (excludeSlug) {
+            query.slug = { $ne: excludeSlug };
+        }
+
+        const duplicate = await blogs.findOne(query);
+
+        if (duplicate) {
+            return NextResponse.json({
+                duplicate: true,
+                blog: {
+                    title: duplicate.title,
+                    slug: duplicate.slug
+                }
+            });
+        }
+
+        return NextResponse.json({ duplicate: false });
+    } catch (err: any) {
+        console.error('[BlogAPI] Check title error:', err);
+        return NextResponse.json(
+            { error: 'Internal server error', detail: err.message },
+            { status: 500 }
+        );
+    }
+}
+

package/src/api/config-handler.ts

@@ -0,0 +1,76 @@
+/**
+ * Blog Config API Handler
+ * Handles saving/loading plugin configuration
+ */
+
+import { NextRequest, NextResponse } from 'next/server';
+import { getPluginConfig, savePluginConfig } from '../lib/config-storage';
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export interface ConfigApiConfig {
+    getDb: () => Promise<{ db: any }>;
+    getUserId: (req: NextRequest) => Promise<string | null>;
+    siteId?: string;
+}
+
+/**
+ * GET /api/plugin-blog/config - Get plugin config
+ */
+export async function GET(req: NextRequest, config: ConfigApiConfig): Promise<NextResponse> {
+    try {
+        const siteId = config.siteId || 'default';
+        
+        const pluginConfig = await getPluginConfig(
+            config.getDb,
+            'plugin-blog',
+            siteId
+        );
+
+        if (!pluginConfig) {
+            return NextResponse.json({ config: null });
+        }
+
+        return NextResponse.json({ config: pluginConfig.config });
+    } catch (err: any) {
+        console.error('[BlogConfigAPI] GET error:', err);
+        return NextResponse.json(
+            { error: 'Failed to get config', detail: err.message },
+            { status: 500 }
+        );
+    }
+}
+
+/**
+ * POST /api/plugin-blog/config - Save plugin config
+ */
+export async function POST(req: NextRequest, config: ConfigApiConfig): Promise<NextResponse> {
+    try {
+        const userId = await config.getUserId(req);
+        if (!userId) {
+            return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+        }
+
+        const body = await req.json();
+        const siteId = body.siteId || config.siteId || 'default';
+        const pluginConfig = body.config;
+
+        if (!pluginConfig) {
+            return NextResponse.json({ error: 'Config is required' }, { status: 400 });
+        }
+
+        await savePluginConfig(
+            config.getDb,
+            'plugin-blog',
+            siteId,
+            pluginConfig
+        );
+
+        return NextResponse.json({ message: 'Config saved successfully' });
+    } catch (err: any) {
+        console.error('[BlogConfigAPI] POST error:', err);
+        return NextResponse.json(
+            { error: 'Failed to save config', detail: err.message },
+            { status: 500 }
+        );
+    }
+}

package/src/api/handler.ts

@@ -0,0 +1,418 @@
+/**
+ * Blog API Handler
+ * RESTful API handler for blog posts
+ * Compatible with Next.js API routes
+ * 
+ * IMPORTANT: This file should ONLY be imported in server-side API routes.
+ * Do NOT import this in client-side code.
+ */
+
+import { NextRequest, NextResponse } from 'next/server';
+import { slugify } from '../lib/utils/slugify';
+
+export interface BlogApiConfig {
+    /** MongoDB client promise (from clientPromise) - should return { db: () => Database } */
+    getDb: () => Promise<{ db: () => any }>;
+    /** Function to get authenticated user ID from request */
+    getUserId: (req: NextRequest) => Promise<string | null>;
+    /** Collection name (default: 'blogs') */
+    collectionName?: string;
+}
+
+/**
+ * GET /api/blogs - List all blog posts
+ * GET /api/blogs?admin=true - List all posts for admin (includes drafts)
+ * GET /api/blogs?status=published - Filter by status
+ */
+export async function GET(req: NextRequest, config: BlogApiConfig): Promise<NextResponse> {
+    try {
+        const url = new URL(req.url);
+        const limit = Number(url.searchParams.get('limit') ?? 10);
+        const skip = Number(url.searchParams.get('skip') ?? 0);
+        const statusFilter = url.searchParams.get('status');
+        const isAdminView = url.searchParams.get('admin') === 'true';
+
+        const userId = await config.getUserId(req);
+        const dbConnection = await config.getDb();
+        const db = dbConnection.db();
+        const blogs = db.collection(config.collectionName || 'blogs');
+
+        // Build query
+        let query: any = {};
+
+        if (isAdminView && userId) {
+            // Admin view: show all posts owned by user
+            if (statusFilter) {
+                query = {
+                    'publicationData.status': statusFilter,
+                    authorId: userId,
+                };
+            } else {
+                query = { authorId: userId };
+            }
+        } else {
+            // Public view: only published posts
+            query = {
+                'publicationData.status': 'published',
+                'publicationData.date': { $lte: new Date() },
+            };
+            if (statusFilter && statusFilter !== 'published') {
+                // Non-admin can't filter by non-published status
+                return NextResponse.json({ error: 'Invalid status filter' }, { status: 400 });
+            }
+        }
+
+        const [data, totalCount] = await Promise.all([
+            blogs
+                .find(query)
+                .sort({ 'publicationData.date': -1 })
+                .skip(skip)
+                .limit(isAdminView ? 0 : limit)
+                .toArray(),
+            blogs.countDocuments(query),
+        ]);
+
+        const formatted = data.map((doc: any) => ({
+            ...doc,
+            _id: doc._id.toString(),
+        }));
+
+        return NextResponse.json({
+            blogs: formatted,
+            total: totalCount,
+        });
+    } catch (err: any) {
+        console.error('[BlogAPI] GET error:', err);
+        return NextResponse.json(
+            { error: 'Failed to fetch blogs', detail: err.message },
+            { status: 500 }
+        );
+    }
+}
+
+/**
+ * POST /api/blogs - Create new blog post
+ */
+export async function POST(req: NextRequest, config: BlogApiConfig): Promise<NextResponse> {
+    try {
+        const userId = await config.getUserId(req);
+        if (!userId) {
+            return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+        }
+
+        const body = await req.json();
+        const {
+            title,
+            summary,
+            content,
+            contentBlocks,
+            image,
+            categoryTags,
+            publicationData,
+            seo,
+        } = body;
+
+        const isPublishing = publicationData?.status === 'published';
+        const isConcept = publicationData?.status === 'concept' || publicationData?.status === 'draft';
+
+        // Validation
+        const errors: string[] = [];
+        if (!title?.trim()) {
+            errors.push('Title is required');
+        }
+
+        if (isPublishing) {
+            // Publishing requires all fields
+            if (!summary?.trim()) errors.push('Summary is required for publishing');
+            if (!image?.id?.trim()) errors.push('Featured image is required for publishing');
+            // Only require category if it's explicitly provided and empty
+            // If categoryTags is undefined or category is undefined, that's also missing
+            if (!categoryTags || !categoryTags.category || !categoryTags.category.trim()) {
+                errors.push('Category is required for publishing');
+            }
+            const hasContent =
+                (contentBlocks && Array.isArray(contentBlocks) && contentBlocks.length > 0) ||
+                (content && Array.isArray(content) && content.length > 0);
+            if (!hasContent) {
+                errors.push('Content is required for publishing');
+            }
+            if (!publicationData?.date) errors.push('Publication date is required');
+        }
+
+        if (errors.length > 0) {
+            return NextResponse.json({ message: errors[0], allErrors: errors }, { status: 400 });
+        }
+
+        // Create slug
+        let baseSlug = slugify(title);
+        const slug = isPublishing
+            ? baseSlug
+            : `${baseSlug}-draft-${Date.now().toString().slice(-4)}`;
+
+        const dbConnection = await config.getDb();
+        const db = dbConnection.db();
+        const blogs = db.collection(config.collectionName || 'blogs');
+
+        // Determine the final status: if publishing, set to 'published', otherwise convert draft to concept
+        let finalStatus = publicationData?.status;
+        if (isPublishing) {
+            finalStatus = 'published';
+        } else if (publicationData?.status === 'draft') {
+            finalStatus = 'concept';
+        } else {
+            finalStatus = publicationData?.status || 'concept';
+        }
+
+        const blogDocument = {
+            title: title.trim(),
+            summary: (summary || '').trim(),
+            contentBlocks: contentBlocks || [],
+            content: content || [],
+            image: image || { id: '', alt: '' }, // Only store id and alt - plugin-images handles transforms
+            categoryTags: {
+                category: categoryTags?.category?.trim() || '',
+                tags: categoryTags?.tags || [],
+            },
+            publicationData: {
+                ...publicationData,
+                status: finalStatus,
+                date: publicationData?.date ? new Date(publicationData.date) : new Date(),
+            },
+            seo: seo || { title: '', description: '' },
+            slug,
+            authorId: userId,
+            createdAt: new Date(),
+            updatedAt: new Date(),
+        };
+
+        const result = await blogs.insertOne(blogDocument);
+
+        return NextResponse.json({
+            message: isPublishing ? 'Blog published successfully' : 'Draft saved successfully',
+            blogId: result.insertedId,
+            slug,
+        });
+    } catch (err: any) {
+        console.error('[BlogAPI] POST error:', err);
+        return NextResponse.json(
+            { error: 'Failed to create blog', detail: err.message },
+            { status: 500 }
+        );
+    }
+}
+
+/**
+ * GET /api/blogs/[slug] - Get single blog post by slug
+ */
+export async function GET_BY_SLUG(
+    req: NextRequest,
+    slug: string,
+    config: BlogApiConfig
+): Promise<NextResponse> {
+    try {
+        const userId = await config.getUserId(req);
+        const dbConnection = await config.getDb();
+        const db = dbConnection.db();
+        const blogs = db.collection(config.collectionName || 'blogs');
+
+        const blog = await blogs.findOne({ slug });
+
+        if (!blog) {
+            return NextResponse.json({ error: 'Blog not found' }, { status: 404 });
+        }
+
+        // Security check
+        const isPublished = blog.publicationData?.status === 'published';
+        const isAuthor = userId && blog.authorId === userId;
+
+        if (!isPublished && !isAuthor) {
+            return NextResponse.json({ error: 'Access denied' }, { status: 403 });
+        }
+
+        return NextResponse.json({
+            ...blog,
+            _id: blog._id.toString(),
+        });
+    } catch (err: any) {
+        console.error('[BlogAPI] GET_BY_SLUG error:', err);
+        return NextResponse.json(
+            { error: 'Failed to fetch blog', detail: err.message },
+            { status: 500 }
+        );
+    }
+}
+
+/**
+ * PUT /api/blogs/[slug] - Update blog post by slug
+ */
+export async function PUT_BY_SLUG(
+    req: NextRequest,
+    slug: string,
+    config: BlogApiConfig
+): Promise<NextResponse> {
+    try {
+        const userId = await config.getUserId(req);
+        if (!userId) {
+            return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+        }
+
+        const body = await req.json();
+        const {
+            title,
+            summary,
+            content,
+            contentBlocks,
+            image,
+            categoryTags,
+            publicationData,
+            seo,
+        } = body;
+
+        const dbConnection = await config.getDb();
+        const db = dbConnection.db();
+        const blogs = db.collection(config.collectionName || 'blogs');
+
+        // Check if blog exists and user is author
+        const existingBlog = await blogs.findOne({ slug });
+        if (!existingBlog) {
+            return NextResponse.json({ error: 'Blog not found' }, { status: 404 });
+        }
+        if (existingBlog.authorId !== userId) {
+            return NextResponse.json({ error: 'Forbidden: Not the author' }, { status: 403 });
+        }
+
+        // Validation
+        const isPublishing = publicationData?.status === 'published';
+        if (!title?.trim()) {
+            return NextResponse.json({ message: 'Title is required' }, { status: 400 });
+        }
+
+        if (isPublishing) {
+            const hasContent =
+                (contentBlocks && Array.isArray(contentBlocks) && contentBlocks.length > 0) ||
+                (content && Array.isArray(content) && content.length > 0);
+
+            // Collect all missing fields for better error messages
+            const missingFields: string[] = [];
+            if (!summary?.trim()) missingFields.push('summary');
+            if (!image?.id?.trim()) missingFields.push('featured image');
+            // Only require category if it's explicitly provided and empty
+            // If categoryTags is undefined or category is undefined, that's also missing
+            if (!categoryTags || !categoryTags.category || !categoryTags.category.trim()) {
+                missingFields.push('category');
+            }
+            if (!hasContent) missingFields.push('content');
+
+            if (missingFields.length > 0) {
+                console.log('[BlogAPI] PUT_BY_SLUG validation failed:', {
+                    isPublishing,
+                    missingFields,
+                    summary: summary?.trim() || 'missing',
+                    imageId: image?.id?.trim() || 'missing',
+                    category: categoryTags?.category?.trim() || 'missing',
+                    hasContent,
+                    contentBlocksLength: contentBlocks?.length || 0,
+                    contentLength: content?.length || 0,
+                });
+                return NextResponse.json(
+                    {
+                        message: `Missing required fields for publishing: ${missingFields.join(', ')}`,
+                        missingFields
+                    },
+                    { status: 400 }
+                );
+            }
+        }
+
+        // Slug logic
+        let finalSlug = slug;
+        if (isPublishing) {
+            finalSlug = slugify(title);
+        } else if (publicationData?.status === 'concept' && !slug.includes('-draft-')) {
+            finalSlug = `${slugify(title)}-draft-${Date.now().toString().slice(-4)}`;
+        }
+
+        // Update data
+        // Determine the final status: if publishing, set to 'published', otherwise preserve or convert draft to concept
+        let finalStatus = publicationData?.status;
+        if (isPublishing) {
+            finalStatus = 'published';
+        } else if (publicationData?.status === 'draft') {
+            finalStatus = 'concept';
+        }
+
+        const updateData = {
+            title: title.trim(),
+            summary: (summary || '').trim(),
+            contentBlocks: contentBlocks || [],
+            content: content || [],
+            image: image || {},
+            categoryTags: {
+                category: categoryTags?.category?.trim() || '',
+                tags: categoryTags?.tags || [],
+            },
+            publicationData: {
+                ...publicationData,
+                status: finalStatus,
+                date: publicationData?.date ? new Date(publicationData.date) : new Date(),
+            },
+            seo: seo || {},
+            slug: finalSlug,
+            authorId: userId,
+            updatedAt: new Date(),
+        };
+
+        await blogs.updateOne({ slug }, { $set: updateData });
+
+        return NextResponse.json({
+            message: 'Blog updated successfully',
+            slug: finalSlug,
+        });
+    } catch (err: any) {
+        console.error('[BlogAPI] PUT_BY_SLUG error:', err);
+        return NextResponse.json(
+            { error: 'Failed to update blog', detail: err.message },
+            { status: 500 }
+        );
+    }
+}
+
+/**
+ * DELETE /api/blogs/[slug] - Delete blog post by slug
+ */
+export async function DELETE_BY_SLUG(
+    req: NextRequest,
+    slug: string,
+    config: BlogApiConfig
+): Promise<NextResponse> {
+    try {
+        const userId = await config.getUserId(req);
+        if (!userId) {
+            return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+        }
+
+        const dbConnection = await config.getDb();
+        const db = dbConnection.db();
+        const blogs = db.collection(config.collectionName || 'blogs');
+
+        // Verify ownership
+        const blog = await blogs.findOne({ slug });
+        if (!blog) {
+            return NextResponse.json({ error: 'Blog not found' }, { status: 404 });
+        }
+        if (blog.authorId !== userId) {
+            return NextResponse.json({ error: 'Forbidden: Not the author' }, { status: 403 });
+        }
+
+        await blogs.deleteOne({ slug });
+
+        return NextResponse.json({ message: 'Blog deleted successfully' });
+    } catch (err: any) {
+        console.error('[BlogAPI] DELETE_BY_SLUG error:', err);
+        return NextResponse.json(
+            { error: 'Failed to delete blog', detail: err.message },
+            { status: 500 }
+        );
+    }
+}
+

package/src/api/index.ts

@@ -0,0 +1,33 @@
+/**
+ * Blog API Exports
+ * RESTful API handlers for blog posts
+ */
+
+export {
+    GET,
+    POST,
+    PUT,
+    DELETE,
+    createBlogApiConfig,
+} from './route';
+
+export type { BlogApiConfig } from './handler';
+
+export {
+    GET as GET_HANDLER,
+    POST as POST_HANDLER,
+    GET_BY_SLUG,
+    PUT_BY_SLUG,
+    DELETE_BY_SLUG,
+} from './handler';
+
+// Router exports
+export { handleBlogApi } from './router';
+export type { BlogApiRouterConfig } from './router';
+
+// Categories handler
+export { GET as GET_CATEGORIES } from './categories';
+
+// Check title handler
+export { GET as GET_CHECK_TITLE } from './check-title';
+