@jhits/plugin-blog 0.0.1 → 0.0.4

package/package.json

@@ -1,57 +1,60 @@
 {
     "name": "@jhits/plugin-blog",
-    "version": "0.0.1",
+    "version": "0.0.4",
     "description": "Professional blog management system for the JHITS ecosystem",
     "publishConfig": {
-      "access": "public"
+        "access": "public"
     },
     "main": "./src/index.tsx",
     "types": "./src/index.tsx",
     "exports": {
-      ".": {
-        "types": "./src/index.tsx",
-        "default": "./src/index.tsx"
-      },
-      "./server": {
-        "types": "./src/index.server.ts",
-        "default": "./src/index.server.ts"
-      }
+        ".": {
+            "types": "./src/index.tsx",
+            "default": "./src/index.tsx"
+        },
+        "./server": {
+            "types": "./src/index.server.ts",
+            "default": "./src/index.server.ts"
+        }
     },
     "dependencies": {
-      "@jhits/plugin-core": "^0.0.1",
-      "@jhits/plugin-content": "^0.0.1",
-      "@jhits/plugin-images": "^0.0.1",
-      "bcrypt": "^6.0.0",
-      "framer-motion": "^12.23.26",
-      "lucide-react": "^0.562.0",
-      "mongodb": "^7.0.0",
-      "next-auth": "^4.24.13"
+        "@jhits/plugin-core": "^0.0.1",
+        "@jhits/plugin-content": "^0.0.1",
+        "@jhits/plugin-images": "^0.0.1",
+        "bcrypt": "^6.0.0",
+        "framer-motion": "^12.23.26",
+        "lucide-react": "^0.562.0",
+        "mongodb": "^7.0.0",
+        "next-auth": "^4.24.13"
     },
     "peerDependencies": {
-      "next": ">=15.0.0",
-      "next-intl": ">=4.0.0",
-      "next-themes": ">=0.4.0",
-      "react": ">=18.0.0",
-      "react-dom": ">=18.0.0"
+        "next": ">=15.0.0",
+        "next-intl": ">=4.0.0",
+        "next-themes": ">=0.4.0",
+        "react": ">=18.0.0",
+        "react-dom": ">=18.0.0"
     },
     "devDependencies": {
-      "@tailwindcss/postcss": "^4",
-      "@types/bcrypt": "^6.0.0",
-      "@types/node": "^20.19.27",
-      "@types/react": "^19",
-      "@types/react-dom": "^19",
-      "eslint": "^9",
-      "eslint-config-next": "16.1.1",
-      "next": "16.1.1",
-      "next-intl": "4.6.1",
-      "next-themes": "0.4.6",
-      "react": "19.2.3",
-      "react-dom": "19.2.3",
-      "tailwindcss": "^4",
-      "typescript": "^5"
+        "@tailwindcss/postcss": "^4",
+        "@types/bcrypt": "^6.0.0",
+        "@types/node": "^20.19.27",
+        "@types/react": "^19",
+        "@types/react-dom": "^19",
+        "eslint": "^9",
+        "eslint-config-next": "16.1.1",
+        "next": "16.1.1",
+        "next-intl": "4.6.1",
+        "next-themes": "0.4.6",
+        "react": "19.2.3",
+        "react-dom": "19.2.3",
+        "tailwindcss": "^4",
+        "typescript": "^5"
     },
     "files": [
-      "src",
-      "package.json"
+        "src/**/*.{ts,tsx,json}",
+        "!src/**/*.md",
+        "!src/**/README.md",
+        "!README.md",
+        "package.json"
     ]
-  }
+}

package/src/index.server.ts

@@ -1,3 +1,5 @@
+import 'server-only';
+
 /**
  * Plugin Blog - Server-Only Entry Point
  * This file exports only server-side API handlers

package/src/utils/index.ts

@@ -4,6 +4,5 @@
  */
 
 export * from './client';
-export * from './blockHelpers';
-export * from './slugify';
+export * from '../lib/utils/blockHelpers';
 

package/src/api/README.md

@@ -1,224 +0,0 @@
-# Blog API
-
-RESTful API handlers for blog posts, included in the `@jhits/plugin-blog` package.
-
-## Installation
-
-The API handlers are automatically available when you install `@jhits/plugin-blog`.
-
-## Setup
-
-### 1. Create API Route in Your App
-
-Create API routes in your Next.js app to mount the blog API handlers:
-
-**`src/app/api/blogs/route.ts`** - List and create blogs:
-```typescript
-import { NextRequest } from 'next/server';
-import { GET, POST, createBlogApiConfig } from '@jhits/plugin-blog/api';
-import clientPromise from '@/lib/mongodb';
-import { cookies } from 'next/headers';
-import jwt from 'jsonwebtoken';
-
-const JWT_SECRET = process.env.JWT_SECRET || 'secret';
-
-async function getUserId(req: NextRequest): Promise<string | null> {
-    try {
-        const cookieStore = await cookies();
-        const token = cookieStore.get('auth_token')?.value;
-        if (!token) return null;
-        const decoded = jwt.verify(token, JWT_SECRET) as { id: string };
-        return decoded.id;
-    } catch {
-        return null;
-    }
-}
-
-const config = createBlogApiConfig({
-    getDb: async () => clientPromise,
-    getUserId,
-    collectionName: 'blogs', // optional, defaults to 'blogs'
-});
-
-export async function GET(req: NextRequest) {
-    return GET(req, undefined, config);
-}
-
-export async function POST(req: NextRequest) {
-    return POST(req, undefined, config);
-}
-```
-
-**`src/app/api/blogs/[slug]/route.ts`** - Get, update, and delete by slug:
-```typescript
-import { NextRequest } from 'next/server';
-import { GET, PUT, DELETE, createBlogApiConfig } from '@jhits/plugin-blog/api';
-import clientPromise from '@/lib/mongodb';
-import { cookies } from 'next/headers';
-import jwt from 'jsonwebtoken';
-
-const JWT_SECRET = process.env.JWT_SECRET || 'secret';
-
-async function getUserId(req: NextRequest): Promise<string | null> {
-    try {
-        const cookieStore = await cookies();
-        const token = cookieStore.get('auth_token')?.value;
-        if (!token) return null;
-        const decoded = jwt.verify(token, JWT_SECRET) as { id: string };
-        return decoded.id;
-    } catch {
-        return null;
-    }
-}
-
-const config = createBlogApiConfig({
-    getDb: async () => clientPromise,
-    getUserId,
-    collectionName: 'blogs',
-});
-
-export async function GET(
-    req: NextRequest,
-    { params }: { params: Promise<{ slug: string }> }
-) {
-    return GET(req, { params }, config);
-}
-
-export async function PUT(
-    req: NextRequest,
-    { params }: { params: Promise<{ slug: string }> }
-) {
-    return PUT(req, { params }, config);
-}
-
-export async function DELETE(
-    req: NextRequest,
-    { params }: { params: Promise<{ slug: string }> }
-) {
-    return DELETE(req, { params }, config);
-}
-```
-
-## API Endpoints
-
-### GET /api/blogs
-List all blog posts.
-
-**Query Parameters:**
-- `limit` (number, default: 10) - Number of posts to return
-- `skip` (number, default: 0) - Number of posts to skip
-- `status` (string, optional) - Filter by status (`published`, `concept`, `draft`)
-- `admin` (boolean, default: false) - If true, returns all posts for authenticated user (including drafts)
-
-**Response:**
-```json
-{
-    "blogs": [...],
-    "total": 100
-}
-```
-
-### POST /api/blogs
-Create a new blog post.
-
-**Request Body:**
-```json
-{
-    "title": "My Blog Post",
-    "summary": "A brief summary",
-    "contentBlocks": [...],
-    "image": {
-        "src": "/uploads/image.jpg",
-        "alt": "Image alt text",
-        "brightness": 100,
-        "blur": 0
-    },
-    "categoryTags": {
-        "category": "Technology",
-        "tags": ["web", "development"]
-    },
-    "publicationData": {
-        "status": "concept" | "published",
-        "date": "2024-01-01T00:00:00.000Z"
-    },
-    "seo": {
-        "title": "SEO Title",
-        "description": "SEO Description",
-        "keywords": ["keyword1", "keyword2"],
-        "ogImage": "/uploads/og-image.jpg",
-        "canonicalUrl": "https://example.com/blog/my-post"
-    }
-}
-```
-
-**Response:**
-```json
-{
-    "message": "Draft saved successfully",
-    "blogId": "...",
-    "slug": "my-blog-post-draft-1234"
-}
-```
-
-### GET /api/blogs/[slug]
-Get a single blog post by slug.
-
-**Response:**
-```json
-{
-    "_id": "...",
-    "title": "My Blog Post",
-    "slug": "my-blog-post",
-    "contentBlocks": [...],
-    ...
-}
-```
-
-### PUT /api/blogs/[slug]
-Update a blog post by slug.
-
-**Request Body:** Same as POST /api/blogs
-
-**Response:**
-```json
-{
-    "message": "Blog updated successfully",
-    "slug": "updated-slug"
-}
-```
-
-### DELETE /api/blogs/[slug]
-Delete a blog post by slug.
-
-**Response:**
-```json
-{
-    "message": "Blog deleted successfully"
-}
-```
-
-## Security
-
-- All endpoints (except public GET) require authentication
-- Users can only access/modify their own posts
-- Published posts are visible to everyone
-- Drafts/concepts are only visible to the author
-
-## Error Responses
-
-All endpoints return standard HTTP status codes:
-- `200` - Success
-- `400` - Bad Request (validation errors)
-- `401` - Unauthorized (not authenticated)
-- `403` - Forbidden (not authorized)
-- `404` - Not Found
-- `500` - Internal Server Error
-
-Error response format:
-```json
-{
-    "error": "Error message",
-    "detail": "Detailed error information"
-}
-```
-

package/src/hooks/README.md

@@ -1,91 +0,0 @@
-# Blog Plugin Hooks
-
-React hooks for fetching blog data in client applications.
-
-## useBlogs
-
-Fetch a list of blog posts with automatic loading and error handling.
-
-### Usage
-
-```tsx
-import { useBlogs } from '@jhits/plugin-blog';
-
-function MyComponent() {
-    const { blogs, loading, error, total, refetch } = useBlogs({
-        limit: 10,
-        skip: 0,
-        status: 'published',
-        admin: false,
-        apiBaseUrl: '/api/blogs',
-    });
-
-    if (loading) return <div>Loading...</div>;
-    if (error) return <div>Error: {error}</div>;
-
-    return (
-        <div>
-            {blogs.map(blog => (
-                <div key={blog.id}>
-                    <h2>{blog.title}</h2>
-                    <p>{blog.excerpt}</p>
-                </div>
-            ))}
-        </div>
-    );
-}
-```
-
-### Options
-
-- `limit` (number, default: 10): Maximum number of posts to fetch
-- `skip` (number, default: 0): Number of posts to skip (for pagination)
-- `status` (string, optional): Filter by status ('published', 'draft', 'concept')
-- `admin` (boolean, default: false): Whether to fetch all posts for admin (includes drafts)
-- `apiBaseUrl` (string, default: '/api/blogs'): API base URL
-
-### Returns
-
-- `blogs` (PostListItem[]): Array of blog posts
-- `loading` (boolean): Whether data is currently loading
-- `error` (string | null): Error message if fetch failed
-- `total` (number): Total number of posts available
-- `refetch` (function): Function to manually refetch blogs
-
-## useBlog
-
-Fetch a single blog post by slug.
-
-### Usage
-
-```tsx
-import { useBlog } from '@jhits/plugin-blog';
-
-function BlogPost({ slug }: { slug: string }) {
-    const { blog, loading, error, refetch } = useBlog({ slug });
-
-    if (loading) return <div>Loading...</div>;
-    if (error) return <div>Error: {error}</div>;
-    if (!blog) return <div>Post not found</div>;
-
-    return (
-        <article>
-            <h1>{blog.title}</h1>
-            <div>{/* Render blog content */}</div>
-        </article>
-    );
-}
-```
-
-### Options
-
-- `slug` (string, required): Blog post slug
-- `apiBaseUrl` (string, default: '/api/blogs'): API base URL
-
-### Returns
-
-- `blog` (BlogPost | null): Blog post data
-- `loading` (boolean): Whether data is currently loading
-- `error` (string | null): Error message if fetch failed
-- `refetch` (function): Function to manually refetch the blog post
-

package/src/utils/README.md

@@ -1,75 +0,0 @@
-# Blog Plugin Client Utilities
-
-Helper functions for fetching blog data in client applications (non-React).
-
-## fetchBlogs
-
-Fetch blog posts from the API (returns a Promise).
-
-### Usage
-
-```ts
-import { fetchBlogs } from '@jhits/plugin-blog';
-
-async function loadBlogs() {
-    try {
-        const { blogs, total } = await fetchBlogs({
-            limit: 10,
-            skip: 0,
-            status: 'published',
-            admin: false,
-            apiBaseUrl: '/api/blogs',
-        });
-
-        console.log(`Found ${total} posts`);
-        blogs.forEach(blog => {
-            console.log(blog.title);
-        });
-    } catch (error) {
-        console.error('Failed to fetch blogs:', error);
-    }
-}
-```
-
-### Options
-
-- `limit` (number, default: 10): Maximum number of posts to fetch
-- `skip` (number, default: 0): Number of posts to skip (for pagination)
-- `status` (string, optional): Filter by status ('published', 'draft', 'concept')
-- `admin` (boolean, default: false): Whether to fetch all posts for admin (includes drafts)
-- `apiBaseUrl` (string, default: '/api/blogs'): API base URL
-
-### Returns
-
-Promise resolving to:
-- `blogs` (PostListItem[]): Array of blog posts
-- `total` (number): Total number of posts available
-
-## fetchBlog
-
-Fetch a single blog post by slug (returns a Promise).
-
-### Usage
-
-```ts
-import { fetchBlog } from '@jhits/plugin-blog';
-
-async function loadBlogPost(slug: string) {
-    try {
-        const blog = await fetchBlog({ slug });
-        console.log(blog.title);
-    } catch (error) {
-        console.error('Failed to fetch blog:', error);
-    }
-}
-```
-
-### Options
-
-- `slug` (string, required): Blog post slug
-- `apiBaseUrl` (string, default: '/api/blogs'): API base URL
-
-### Returns
-
-Promise resolving to a `BlogPost` object.
-

package/src/views/README.md

@@ -1,82 +0,0 @@
-# Blog Plugin Views
-
-## Directory Structure
-
-```
-src/views/
-├── PostManager/
-│   ├── PostManagerView.tsx    # Professional table layout for post management
-│   └── index.ts
-├── CanvasEditor/
-│   ├── CanvasEditorView.tsx   # Drag-and-drop block editor workspace
-│   └── index.ts
-├── SlugSEO/
-│   ├── SlugSEOManagerView.tsx # URL slug and SEO metadata management
-│   └── index.ts
-└── Preview/
-    ├── PreviewBridgeView.tsx  # Live preview of blog posts
-    └── index.ts
-```
-
-## Design System Compliance
-
-All views follow the dashboard's earth-tone design system:
-
-- **Colors**: Neutral palette (neutral-100 to neutral-900), primary (violet-700)
-- **Typography**: 
-  - Headings: `font-black uppercase tracking-tighter`
-  - Labels: `text-[10px] font-black uppercase tracking-widest`
-  - Body: `font-sans`
-- **Layout**: 
-  - Containers: `rounded-[2.5rem]`
-  - Padding: `p-8`
-  - Backgrounds: `bg-white dark:bg-neutral-900`
-- **Buttons**: `rounded-full`, uppercase, tracking-widest
-- **Borders**: `border-neutral-300 dark:border-neutral-700`
-
-## PostManagerView
-
-Professional table layout with:
-- Search and filter functionality
-- Status badges (published, draft, scheduled, archived)
-- Empty state with "Create Your First Post" CTA
-- Action buttons (Edit, Preview, Delete)
-- Mock data for development
-
-## CanvasEditorView
-
-Block editor workspace with:
-- Toolbar with Back, Preview, and Save buttons
-- Title input field
-- Block canvas area
-- Empty state for adding first block
-- Integrated with EditorProvider for state management
-
-## SlugSEOManagerView
-
-SEO management interface with:
-- URL slug editor with collision detection placeholder
-- Google-style search result preview
-- Meta description editor with character counter
-
-## PreviewBridgeView
-
-Live preview interface with:
-- Header with Refresh and Open in New Tab buttons
-- Preview container (ready for iframe or side-by-side panel)
-- Placeholder for preview rendering
-
-## Usage
-
-Views are imported and used in the main `BlogPlugin` router:
-
-```typescript
-import { PostManagerView } from './views/PostManager';
-import { CanvasEditorView } from './views/CanvasEditor';
-// ... etc
-
-// In router switch statement:
-case 'posts':
-    return <PostManagerView siteId={siteId} locale={locale} />;
-```
-