@nextsparkjs/theme-blog 0.1.0-beta.19 → 0.1.0-beta.191

package/components/public/PostCard.tsx

@@ -11,6 +11,7 @@ import Link from 'next/link'
 import Image from 'next/image'
 import { Calendar, Clock, User } from 'lucide-react'
 import { cn } from '@nextsparkjs/core/lib/utils'
+import { withBasePathIfInApp } from '@nextsparkjs/core/lib/base-path'
 
 interface PostCardProps {
   id: string
@@ -73,7 +74,7 @@ export function PostCard({
         <div data-cy={`post-card-image-${id}`} className="aspect-[21/9] relative overflow-hidden">
           {featuredImage ? (
             <Image
-              src={featuredImage}
+              src={withBasePathIfInApp(featuredImage)}
               alt={title}
               fill
               className="object-cover transition-transform duration-500 group-hover:scale-105"
@@ -115,7 +116,7 @@ export function PostCard({
               <Link href={authorUrl} data-cy={`post-card-author-${id}`} className="flex items-center gap-2 hover:text-foreground transition-colors">
                 {authorAvatar ? (
                   <Image
-                    src={authorAvatar}
+                    src={withBasePathIfInApp(authorAvatar)}
                     alt={authorName}
                     width={24}
                     height={24}
@@ -132,7 +133,7 @@ export function PostCard({
               <div data-cy={`post-card-author-${id}`} className="flex items-center gap-2">
                 {authorAvatar ? (
                   <Image
-                    src={authorAvatar}
+                    src={withBasePathIfInApp(authorAvatar)}
                     alt={authorName}
                     width={24}
                     height={24}
@@ -174,7 +175,7 @@ export function PostCard({
         <div data-cy={`post-card-image-${id}`} className="flex-shrink-0 w-24 h-24 relative overflow-hidden rounded-md">
           {featuredImage ? (
             <Image
-              src={featuredImage}
+              src={withBasePathIfInApp(featuredImage)}
               alt={title}
               fill
               className="object-cover"
@@ -216,7 +217,7 @@ export function PostCard({
       <div data-cy={`post-card-image-${id}`} className="aspect-[16/10] relative overflow-hidden">
         {featuredImage ? (
           <Image
-            src={featuredImage}
+            src={withBasePathIfInApp(featuredImage)}
             alt={title}
             fill
             className="object-cover transition-transform duration-500 group-hover:scale-105"
@@ -256,7 +257,7 @@ export function PostCard({
             <Link href={authorUrl} data-cy={`post-card-author-${id}`} className="flex items-center gap-2 hover:text-foreground transition-colors">
               {authorAvatar ? (
                 <Image
-                  src={authorAvatar}
+                  src={withBasePathIfInApp(authorAvatar)}
                   alt={authorName}
                   width={20}
                   height={20}
@@ -273,7 +274,7 @@ export function PostCard({
             <div data-cy={`post-card-author-${id}`} className="flex items-center gap-2">
               {authorAvatar ? (
                 <Image
-                  src={authorAvatar}
+                  src={withBasePathIfInApp(authorAvatar)}
                   alt={authorName}
                   width={20}
                   height={20}

package/components/public/RelatedPosts.tsx

@@ -9,6 +9,7 @@
 import Link from 'next/link'
 import Image from 'next/image'
 import { Clock } from 'lucide-react'
+import { withBasePathIfInApp } from '@nextsparkjs/core/lib/base-path'
 
 interface RelatedPost {
   id: string
@@ -45,7 +46,7 @@ export function RelatedPosts({
             <div data-cy={`related-post-image-${post.id}`} className="aspect-[16/9] relative overflow-hidden">
               {post.featuredImage ? (
                 <Image
-                  src={post.featuredImage}
+                  src={withBasePathIfInApp(post.featuredImage)}
                   alt={post.title}
                   fill
                   className="object-cover transition-transform duration-300 group-hover:scale-105"

package/config/app.config.ts

@@ -86,11 +86,10 @@ export const APP_CONFIG_OVERRIDES = {
   // =============================================================================
   api: {
     cors: {
-      allowedOrigins: {
-        development: [
-          'http://localhost:3000',
-          'http://localhost:5173',
-        ],
+      // Theme-specific CORS origins (extends core defaults, does not replace)
+      // No additional origins needed for blog theme - uses core defaults
+      additionalOrigins: {
+        development: [],
         production: [],
       },
     },
@@ -101,25 +100,19 @@ export const APP_CONFIG_OVERRIDES = {
   // =============================================================================
   docs: {
     enabled: true,
-    public: true,
+    publicAccess: true,
     searchEnabled: true,
     breadcrumbs: true,
-    theme: {
+    public: {
       enabled: true,
       open: true,
       label: "Blog Theme",
     },
-    plugins: {
-      enabled: false,
-      open: false,
-      label: "Plugins",
-    },
-    core: {
+    superadmin: {
       enabled: true,
       open: false,
-      label: "Core",
+      label: "Admin Docs",
     },
-    showPluginsDocsInProd: false,
   },
 
   // =============================================================================

package/config/billing.config.ts

@@ -79,8 +79,7 @@ export const billingConfig: BillingConfig = {
         storage_gb: 1,
         authors: 1,
       },
-      stripePriceIdMonthly: null,
-      stripePriceIdYearly: null,
+      providerPriceIds: { monthly: null, yearly: null },
     },
     {
       slug: 'pro',
@@ -100,9 +99,8 @@ export const billingConfig: BillingConfig = {
         storage_gb: 10,
         authors: 5,
       },
-      // Configure these in Stripe Dashboard
-      stripePriceIdMonthly: 'price_blog_pro_monthly',
-      stripePriceIdYearly: 'price_blog_pro_yearly',
+      // Configure price IDs in your payment provider dashboard
+      providerPriceIds: { monthly: 'price_blog_pro_monthly', yearly: 'price_blog_pro_yearly' },
     },
     {
       slug: 'enterprise',
@@ -118,8 +116,7 @@ export const billingConfig: BillingConfig = {
         storage_gb: -1,
         authors: -1,
       },
-      stripePriceIdMonthly: null,
-      stripePriceIdYearly: null,
+      providerPriceIds: { monthly: null, yearly: null },
     },
   ],
 

package/config/dashboard.config.ts

@@ -48,6 +48,19 @@ export const DASHBOARD_CONFIG = {
     devtoolsAccess: {
       enabled: true,
     },
+    /**
+     * Settings menu dropdown (gear icon)
+     */
+    settingsMenu: {
+      enabled: true,
+      links: [
+        {
+          label: 'navigation.patterns',
+          href: '/dashboard/patterns',
+          icon: 'layers',
+        },
+      ],
+    },
     userMenu: {
       enabled: true,
       showAvatar: true,

package/config/permissions.config.ts

@@ -48,6 +48,17 @@ export const PERMISSIONS_CONFIG_OVERRIDES: ThemePermissionsConfig = {
       { action: 'update', label: 'Edit categories', description: 'Can modify category information', roles: ['owner'] },
       { action: 'delete', label: 'Delete categories', description: 'Can delete categories', roles: ['owner'], dangerous: true },
     ],
+
+    // ------------------------------------------
+    // PATTERNS
+    // ------------------------------------------
+    patterns: [
+      { action: 'create', label: 'Create Patterns', description: 'Can create reusable patterns', roles: ['owner'] },
+      { action: 'read', label: 'View Patterns', description: 'Can view pattern details', roles: ['owner'] },
+      { action: 'list', label: 'List Patterns', description: 'Can see the patterns list', roles: ['owner'] },
+      { action: 'update', label: 'Edit Patterns', description: 'Can modify patterns', roles: ['owner'] },
+      { action: 'delete', label: 'Delete Patterns', description: 'Can delete patterns', roles: ['owner'], dangerous: true },
+    ],
   },
 
   // ==========================================

package/entities/categories/api/docs.md

@@ -0,0 +1,119 @@
+# Categories API
+
+Manage blog categories for organizing and filtering posts.
+
+## Overview
+
+The Categories API allows you to create, read, update, and delete category records. Categories provide a hierarchical organization system for blog posts through a many-to-many relationship.
+
+## Authentication
+
+All endpoints require authentication via:
+- **Session cookie** (for browser-based requests)
+- **API Key** header (for server-to-server requests)
+
+## Endpoints
+
+### List Categories
+`GET /api/v1/categories`
+
+Returns a paginated list of categories.
+
+**Query Parameters:**
+- `limit` (number, optional): Maximum records to return. Default: 20
+- `offset` (number, optional): Number of records to skip. Default: 0
+- `search` (string, optional): Search by name, description
+- `sortBy` (string, optional): Field to sort by
+- `sortOrder` (string, optional): Sort direction (asc, desc)
+
+**Example Response:**
+```json
+{
+  "data": [
+    {
+      "id": "category_abc123",
+      "name": "Technology",
+      "slug": "technology",
+      "description": "Posts about tech and software development",
+      "createdAt": "2024-01-15T10:30:00Z",
+      "updatedAt": "2024-01-15T10:30:00Z"
+    }
+  ],
+  "pagination": {
+    "total": 8,
+    "limit": 20,
+    "offset": 0
+  }
+}
+```
+
+### Get Single Category
+`GET /api/v1/categories/[id]`
+
+Returns a single category by ID.
+
+### Create Category
+`POST /api/v1/categories`
+
+Create a new category.
+
+**Request Body:**
+```json
+{
+  "name": "Technology",
+  "slug": "technology",
+  "description": "Posts about tech and software development"
+}
+```
+
+### Update Category
+`PATCH /api/v1/categories/[id]`
+
+Update an existing category. Supports partial updates.
+
+### Delete Category
+`DELETE /api/v1/categories/[id]`
+
+Delete a category record. This will remove the category from all associated posts.
+
+## Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| name | text | Yes | Category name |
+| slug | text | Yes | URL-friendly slug (auto-generated if not provided) |
+| description | textarea | No | Category description |
+| createdAt | datetime | Auto | Creation timestamp |
+| updatedAt | datetime | Auto | Last update timestamp |
+
+## Post-Category Relationship
+
+Categories are linked to posts through a `post_categories` pivot table. When filtering posts by category:
+
+1. Use the [Public Posts API](/api/v1/theme/blog/posts/public) with `category` query parameter
+2. Query the pivot table directly for advanced filtering
+
+## Features
+
+- **Searchable**: name, description
+- **Sortable**: All fields
+- **Metadata**: Supported
+
+## Permissions
+
+- **Create/Update/Delete**: Owner only
+
+## Error Responses
+
+| Status | Description |
+|--------|-------------|
+| 400 | Bad Request - Invalid parameters |
+| 401 | Unauthorized - Missing or invalid auth |
+| 403 | Forbidden - Insufficient permissions |
+| 404 | Not Found - Category doesn't exist |
+| 422 | Validation Error - Invalid data |
+
+## Related APIs
+
+- **[Posts](/api/v1/posts)** - Blog posts
+- **[Public Posts](/api/v1/theme/blog/posts/public)** - Filter by category

package/entities/categories/api/presets.ts

@@ -0,0 +1,67 @@
+/**
+ * API Presets for Categories Entity
+ */
+
+import { defineApiEndpoint } from '@nextsparkjs/core/types/api-presets'
+
+export default defineApiEndpoint({
+  summary: 'Manage blog categories for organizing posts',
+  presets: [
+    {
+      id: 'list-all',
+      title: 'List All Categories',
+      description: 'Get all categories with pagination',
+      method: 'GET',
+      params: {
+        limit: 50
+      },
+      tags: ['read', 'list']
+    },
+    {
+      id: 'search-by-name',
+      title: 'Search by Name',
+      description: 'Search categories by name',
+      method: 'GET',
+      params: {
+        search: '{{name}}'
+      },
+      tags: ['read', 'search']
+    },
+    {
+      id: 'create-category',
+      title: 'Create Category',
+      description: 'Create a new category',
+      method: 'POST',
+      payload: {
+        name: 'New Category',
+        slug: 'new-category',
+        description: 'Category description'
+      },
+      tags: ['write', 'create']
+    },
+    {
+      id: 'update-category',
+      title: 'Update Category',
+      description: 'Update an existing category',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        name: '{{name}}',
+        description: '{{description}}'
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'delete-category',
+      title: 'Delete Category',
+      description: 'Delete a category record',
+      method: 'DELETE',
+      pathParams: {
+        id: '{{id}}'
+      },
+      tags: ['write', 'delete']
+    }
+  ]
+})

package/entities/posts/api/docs.md

@@ -0,0 +1,174 @@
+# Posts API
+
+Manage blog posts with content builder, featured images, categories, and publication workflow.
+
+## Overview
+
+The Posts API allows you to create, read, update, and delete blog posts. Posts support a flexible content builder system, category organization, and a draft-to-published workflow.
+
+## Authentication
+
+All endpoints require authentication via:
+- **Session cookie** (for browser-based requests)
+- **API Key** header (for server-to-server requests)
+
+**Note:** For public access to published posts, use the [Public Posts API](/api/v1/theme/blog/posts/public) instead.
+
+## Endpoints
+
+### List Posts
+`GET /api/v1/posts`
+
+Returns a paginated list of posts.
+
+**Query Parameters:**
+- `limit` (number, optional): Maximum records to return. Default: 20
+- `offset` (number, optional): Number of records to skip. Default: 0
+- `status` (string, optional): Filter by status (draft, published)
+- `featured` (boolean, optional): Filter by featured flag
+- `search` (string, optional): Search by title, excerpt, content
+- `sortBy` (string, optional): Field to sort by
+- `sortOrder` (string, optional): Sort direction (asc, desc)
+
+**Example Response:**
+```json
+{
+  "data": [
+    {
+      "id": "post_abc123",
+      "title": "Getting Started with Next.js",
+      "slug": "getting-started-with-nextjs",
+      "excerpt": "A comprehensive guide to building modern web apps",
+      "content": "[{\"type\":\"text\",\"content\":\"...\"}]",
+      "featuredImage": "https://example.com/image.jpg",
+      "featured": true,
+      "status": "published",
+      "publishedAt": "2024-01-15T10:30:00Z",
+      "createdAt": "2024-01-10T08:00:00Z",
+      "updatedAt": "2024-01-15T10:30:00Z"
+    }
+  ],
+  "pagination": {
+    "total": 25,
+    "limit": 20,
+    "offset": 0
+  }
+}
+```
+
+### Get Single Post
+`GET /api/v1/posts/[id]`
+
+Returns a single post by ID.
+
+### Create Post
+`POST /api/v1/posts`
+
+Create a new blog post.
+
+**Request Body:**
+```json
+{
+  "title": "My New Post",
+  "slug": "my-new-post",
+  "excerpt": "A brief description of the post",
+  "content": "[{\"type\":\"text\",\"content\":\"Post content here\"}]",
+  "featuredImage": "https://example.com/image.jpg",
+  "featured": false,
+  "status": "draft"
+}
+```
+
+### Update Post
+`PATCH /api/v1/posts/[id]`
+
+Update an existing post. Supports partial updates.
+
+### Publish Post
+`PATCH /api/v1/posts/[id]`
+
+Publish a draft post by setting status and publishedAt.
+
+**Request Body:**
+```json
+{
+  "status": "published",
+  "publishedAt": "2024-01-15T10:30:00Z"
+}
+```
+
+### Delete Post
+`DELETE /api/v1/posts/[id]`
+
+Delete a post record.
+
+## Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| title | text | Yes | Post title |
+| slug | text | Yes | URL-friendly slug (auto-generated if not provided) |
+| excerpt | text | No | Brief description for previews |
+| content | json | No | Page builder content blocks |
+| featuredImage | url | No | Featured image URL |
+| featured | boolean | No | Whether post is featured. Default: false |
+| status | select | No | Status: draft, published. Default: draft |
+| publishedAt | datetime | No | Publication date/time |
+| createdAt | datetime | Auto | Creation timestamp |
+| updatedAt | datetime | Auto | Last update timestamp |
+
+## Content Builder
+
+Posts use a flexible content builder system. The `content` field stores an array of content blocks in JSON format:
+
+```json
+[
+  {
+    "type": "text",
+    "content": "Paragraph content here..."
+  },
+  {
+    "type": "heading",
+    "level": 2,
+    "content": "Section Title"
+  },
+  {
+    "type": "image",
+    "src": "https://example.com/image.jpg",
+    "alt": "Image description"
+  }
+]
+```
+
+## Categories
+
+Posts can be organized into categories using a many-to-many relationship. Categories are managed via the `/api/v1/categories` endpoint and linked to posts through a pivot table.
+
+To filter posts by category, use the Public Posts API with the `category` query parameter.
+
+## Features
+
+- **Searchable**: title, excerpt, content
+- **Sortable**: Most fields
+- **Public Access**: Published posts available via public API
+- **Metadata**: Supported
+
+## Permissions
+
+- **Create/Update/Delete**: Owner only (single-user blog mode)
+
+## Error Responses
+
+| Status | Description |
+|--------|-------------|
+| 400 | Bad Request - Invalid parameters |
+| 401 | Unauthorized - Missing or invalid auth |
+| 403 | Forbidden - Insufficient permissions |
+| 404 | Not Found - Post doesn't exist |
+| 422 | Validation Error - Invalid data |
+
+## Related APIs
+
+- **[Categories](/api/v1/categories)** - Post categorization
+- **[Public Posts](/api/v1/theme/blog/posts/public)** - Public feed (no auth required)
+- **[Authors](/api/v1/theme/blog/authors)** - Author profiles