@jhits/plugin-blog 0.0.7 → 0.0.9

package/src/types/block.d.ts

@@ -0,0 +1,221 @@
+/**
+ * Core Block Types
+ * Foundation for the Block-Based Architecture
+ * Multi-Tenant Plugin Architecture - Blocks are provided by client applications
+ */
+import React from 'react';
+/**
+ * Base Block Interface
+ * Every block in the system extends this structure
+ */
+export interface Block {
+    /** Unique identifier for the block */
+    id: string;
+    /** Block type identifier (e.g., 'heading', 'paragraph', 'image', 'plantSpec') */
+    type: string;
+    /** Block-specific data (varies by type) */
+    data: Record<string, unknown>;
+    /**
+     * Child blocks (for container blocks like Section, Columns)
+     * Can be an array of Block IDs (for flat storage) or Block objects (for nested structure)
+     */
+    children?: string[] | Block[];
+    /** Optional metadata for editor state, styling, etc. */
+    meta?: {
+        /** Visual order in the editor */
+        order?: number;
+        /** Whether block is collapsed in editor */
+        collapsed?: boolean;
+        /** Custom styling overrides */
+        style?: Record<string, string>;
+        /** Editor-specific flags */
+        flags?: string[];
+        /** Column index (for column container blocks) */
+        columnIndex?: number;
+        /** Additional custom metadata */
+        [key: string]: unknown;
+    };
+}
+/**
+ * Block Edit Component Props
+ * Props passed to the Edit component in the dashboard editor
+ */
+export interface BlockEditProps {
+    /** The block being edited */
+    block: Block;
+    /** Update handler - call this to update the block's data */
+    onUpdate: (data: Partial<Block['data']>) => void;
+    /** Delete handler - call this to remove the block */
+    onDelete?: () => void;
+    /** Duplicate handler - call this to duplicate the block */
+    onDuplicate?: () => void;
+    /** Whether the block is currently selected */
+    isSelected?: boolean;
+    /** Whether the block is currently being dragged */
+    isDragging?: boolean;
+    /** Focus mode state */
+    focusMode?: boolean;
+    /** Child blocks (for container blocks like Section, Columns) */
+    childBlocks?: Block[];
+    /** Add a child block (for container blocks) */
+    onChildBlockAdd?: (type: string, index?: number, containerId?: string) => void;
+    /** Update a child block (for container blocks) */
+    onChildBlockUpdate?: (id: string, data: Partial<Block['data']>, containerId?: string) => void;
+    /** Delete a child block (for container blocks) */
+    onChildBlockDelete?: (id: string, containerId?: string) => void;
+    /** Move a child block (for container blocks) */
+    onChildBlockMove?: (id: string, newIndex: number, containerId?: string) => void;
+}
+/**
+ * Block Preview Component Props
+ * Props passed to the Preview component for headless rendering
+ */
+export interface BlockPreviewProps {
+    /** The block to render */
+    block: Block;
+    /** Additional rendering context */
+    context?: {
+        /** Site ID */
+        siteId?: string;
+        /** Locale */
+        locale?: string;
+        /** Custom render props */
+        [key: string]: unknown;
+    };
+    /** Child blocks (for container blocks like Section, Columns) */
+    childBlocks?: Block[];
+    /** Render a child block (for container blocks) */
+    renderChild?: (childBlock: Block) => React.ReactElement;
+}
+/**
+ * Strict Block Component Interface
+ * Every client-provided block MUST implement this interface
+ */
+export interface IBlockComponent {
+    /**
+     * Edit Component - Rendered in the dashboard editor
+     * Must use dashboard design system (earth-tone palette, typography)
+     */
+    Edit: React.ComponentType<BlockEditProps>;
+    /**
+     * Preview Component - Rendered in headless/frontend context
+     * Can use client's own design system
+     */
+    Preview: React.ComponentType<BlockPreviewProps>;
+    /**
+     * Icon Component - Shown in block palette
+     * Should be a simple icon (lucide-react recommended)
+     */
+    Icon?: React.ComponentType<{
+        className?: string;
+    }>;
+}
+/**
+ * Block Type Definition
+ * Complete definition of a block type for the registry
+ */
+export interface BlockTypeDefinition {
+    /** Unique type identifier */
+    type: string;
+    /** Human-readable name */
+    name: string;
+    /** Description of the block (shown in tooltips) */
+    description: string;
+    /** Icon component (React component) - Optional, falls back to block component's Icon */
+    icon?: React.ComponentType<{
+        className?: string;
+    }>;
+    /** Default data structure for this block type */
+    defaultData: Record<string, unknown>;
+    /** Validation schema (optional, for runtime validation) */
+    validate?: (data: Record<string, unknown>) => boolean;
+    /** Whether this block can contain nested blocks */
+    isContainer?: boolean;
+    /** Allowed child block types (if container) */
+    allowedChildren?: string[];
+    /** Category for grouping in block palette */
+    category?: 'text' | 'media' | 'layout' | 'interactive' | 'custom';
+    /**
+     * Block Components - REQUIRED for client-provided blocks
+     * Edit and Preview components must be provided
+     */
+    components: IBlockComponent;
+}
+/**
+ * Rich Text Formatting Configuration
+ * Optional configuration for rich text formatting in text blocks
+ */
+export interface RichTextFormattingConfig {
+    /** Whether bold formatting is available */
+    bold?: boolean;
+    /** Whether italic formatting is available */
+    italic?: boolean;
+    /** Whether underline formatting is available */
+    underline?: boolean;
+    /** Whether links are available */
+    links?: boolean;
+    /** Available colors (array of color values or Tailwind classes) */
+    colors?: string[];
+    /** Custom CSS classes for formatted text */
+    styles?: {
+        bold?: string;
+        italic?: string;
+        underline?: string;
+        link?: string;
+        /** Color classes mapped by color value */
+        colorClasses?: Record<string, string>;
+    };
+}
+/**
+ * Client Block Definition
+ * Simplified interface for client apps to provide blocks
+ */
+export interface ClientBlockDefinition {
+    /** Unique type identifier */
+    type: string;
+    /** Human-readable name */
+    name: string;
+    /** Description of the block */
+    description: string;
+    /** Icon component (optional) */
+    icon?: React.ComponentType<{
+        className?: string;
+    }>;
+    /** Default data structure */
+    defaultData: Record<string, unknown>;
+    /** Validation function (optional) */
+    validate?: (data: Record<string, unknown>) => boolean;
+    /** Whether this block can contain nested blocks */
+    isContainer?: boolean;
+    /** Allowed child block types (if container) */
+    allowedChildren?: string[];
+    /** Category for grouping */
+    category?: 'text' | 'media' | 'layout' | 'interactive' | 'custom';
+    /** Block components - REQUIRED */
+    components: IBlockComponent;
+    /** Rich text formatting configuration (optional) */
+    richTextFormatting?: RichTextFormattingConfig;
+}
+/**
+ * Block Registry Configuration
+ * Central registry of all available block types
+ */
+export interface BlockRegistry {
+    /** Map of block type to definition */
+    types: Map<string, BlockTypeDefinition>;
+    /** Register a new block type */
+    register(definition: BlockTypeDefinition): void;
+    /** Register multiple client blocks at once */
+    registerClientBlocks(definitions: ClientBlockDefinition[]): void;
+    /** Get block type definition */
+    get(type: string): BlockTypeDefinition | undefined;
+    /** Get all registered block types */
+    getAll(): BlockTypeDefinition[];
+    /** Get block types by category */
+    getByCategory(category: BlockTypeDefinition['category']): BlockTypeDefinition[];
+    /** Check if a block type is registered */
+    has(type: string): boolean;
+    /** Clear all registered blocks */
+    clear(): void;
+}
+//# sourceMappingURL=block.d.ts.map

package/src/types/block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["block.ts"],"names":[],"mappings":"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"}

package/src/types/block.js

@@ -0,0 +1,6 @@
+/**
+ * Core Block Types
+ * Foundation for the Block-Based Architecture
+ * Multi-Tenant Plugin Architecture - Blocks are provided by client applications
+ */
+export {};

package/src/types/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Central type exports
+ */
+export * from './block';
+export * from './post';
+export type { IBlockComponent, BlockEditProps, BlockPreviewProps, ClientBlockDefinition, } from './block';
+export type { BlockRegistry } from './block';
+//# sourceMappingURL=index.d.ts.map

package/src/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AAGvB,YAAY,EACR,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,qBAAqB,GACxB,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/src/types/index.js

@@ -0,0 +1,5 @@
+/**
+ * Central type exports
+ */
+export * from './block';
+export * from './post';

package/src/types/post.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Post Types
+ * Data structures for blog posts
+ */
+import { Block } from './block';
+/**
+ * Post Status
+ */
+export type PostStatus = 'draft' | 'published' | 'scheduled' | 'archived';
+/**
+ * SEO Metadata
+ */
+export interface SEOMetadata {
+    /** SEO title (can differ from post title) */
+    title?: string;
+    /** Meta description */
+    description?: string;
+    /** Open Graph image URL */
+    ogImage?: string;
+    /** Keywords/tags for SEO */
+    keywords?: string[];
+    /** Canonical URL */
+    canonicalUrl?: string;
+}
+/**
+ * Publication Data
+ */
+export interface PublicationData {
+    /** Publication status */
+    status: PostStatus;
+    /** Publication date (ISO string) */
+    date?: string;
+    /** Scheduled publication date (if status is 'scheduled') */
+    scheduledDate?: string;
+    /** Author ID */
+    authorId?: string;
+    /** Last modified date */
+    updatedAt?: string;
+}
+/**
+ * Privacy Settings
+ */
+export interface PrivacySettings {
+    /** Whether the post is private (not publicly accessible) */
+    isPrivate?: boolean;
+    /** Password protection (if set, post requires password to view) */
+    password?: string;
+    /** List of user IDs who have access (from plugin-users) */
+    sharedWithUsers?: string[];
+}
+/**
+ * Post Metadata
+ */
+export interface PostMetadata {
+    /** Featured image */
+    featuredImage?: {
+        id?: string;
+        src?: string;
+        alt?: string;
+        brightness?: number;
+        blur?: number;
+        scale?: number;
+        positionX?: number;
+        positionY?: number;
+        isCustom?: boolean;
+    };
+    /** Categories */
+    categories?: string[];
+    /** Tags */
+    tags?: string[];
+    /** Excerpt/summary */
+    excerpt?: string;
+    /** Language code */
+    lang?: string;
+    /** Privacy settings */
+    privacy?: PrivacySettings;
+}
+/**
+ * Complete Blog Post Structure
+ * This is the headless JSON structure stored in the database
+ */
+export interface BlogPost {
+    /** Unique post identifier */
+    id: string;
+    /** Post title */
+    title: string;
+    /** URL slug (unique, auto-generated from title) */
+    slug: string;
+    /** Array of content blocks */
+    blocks: Block[];
+    /** SEO metadata */
+    seo: SEOMetadata;
+    /** Publication data */
+    publication: PublicationData;
+    /** Additional metadata */
+    metadata: PostMetadata;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Last update timestamp */
+    updatedAt: string;
+    /** Version number for revision tracking */
+    version?: number;
+}
+/**
+ * Post List Item (for list views)
+ * Lightweight version of BlogPost for performance
+ */
+export interface PostListItem {
+    id: string;
+    title: string;
+    slug: string;
+    status: PostStatus;
+    date?: string;
+    excerpt?: string;
+    featuredImage?: string;
+    authorId?: string;
+    updatedAt: string;
+    category?: string;
+}
+/**
+ * Post Filter Options
+ */
+export interface PostFilterOptions {
+    status?: PostStatus | PostStatus[];
+    category?: string;
+    tag?: string;
+    authorId?: string;
+    search?: string;
+    dateFrom?: string;
+    dateTo?: string;
+    limit?: number;
+    skip?: number;
+    sortBy?: 'date' | 'title' | 'updatedAt';
+    sortOrder?: 'asc' | 'desc';
+}
+//# sourceMappingURL=post.d.ts.map

package/src/types/post.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post.d.ts","sourceRoot":"","sources":["post.ts"],"names":[],"mappings":"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"}

package/src/types/post.js

@@ -0,0 +1,5 @@
+/**
+ * Post Types
+ * Data structures for blog posts
+ */
+export {};

package/src/utils/client.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Client Utilities
+ * Helper functions for fetching blog data in client applications
+ */
+import { PostListItem, BlogPost } from '../types/post';
+export interface FetchBlogsOptions {
+    /** Maximum number of posts to fetch (default: 10) */
+    limit?: number;
+    /** Number of posts to skip (default: 0) */
+    skip?: number;
+    /** Filter by status (published, draft, concept) */
+    status?: string;
+    /** Whether to fetch all posts for admin (includes drafts) */
+    admin?: boolean;
+    /** API base URL (default: '/api/blogs') */
+    apiBaseUrl?: string;
+}
+export interface FetchBlogsResult {
+    /** Array of blog posts */
+    blogs: PostListItem[];
+    /** Total number of posts available */
+    total: number;
+}
+/**
+ * Fetch blog posts from the API
+ *
+ * @example
+ * ```ts
+ * const { blogs, total } = await fetchBlogs({ limit: 5 });
+ * ```
+ */
+export declare function fetchBlogs(options?: FetchBlogsOptions): Promise<FetchBlogsResult>;
+export interface FetchBlogOptions {
+    /** Blog post slug */
+    slug: string;
+    /** API base URL (default: '/api/blogs') */
+    apiBaseUrl?: string;
+}
+/**
+ * Fetch a single blog post by slug
+ *
+ * @example
+ * ```ts
+ * const blog = await fetchBlog({ slug: 'my-blog-post' });
+ * ```
+ */
+export declare function fetchBlog(options: FetchBlogOptions): Promise<BlogPost>;
+//# sourceMappingURL=client.d.ts.map

package/src/utils/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAC9B,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC7B,0BAA0B;IAC1B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiD3F;AAED,MAAM,WAAW,gBAAgB;IAC7B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAkB5E"}

package/src/utils/client.js

@@ -0,0 +1,77 @@
+/**
+ * Client Utilities
+ * Helper functions for fetching blog data in client applications
+ */
+import { apiToBlogPost } from '../lib/mappers/apiMapper';
+/**
+ * Fetch blog posts from the API
+ *
+ * @example
+ * ```ts
+ * const { blogs, total } = await fetchBlogs({ limit: 5 });
+ * ```
+ */
+export async function fetchBlogs(options = {}) {
+    const { limit = 10, skip = 0, status, admin = false, apiBaseUrl = '/api/plugin-blog', } = options;
+    const params = new URLSearchParams();
+    if (limit)
+        params.set('limit', limit.toString());
+    if (skip)
+        params.set('skip', skip.toString());
+    if (status)
+        params.set('status', status);
+    if (admin)
+        params.set('admin', 'true');
+    const url = `${apiBaseUrl}?${params.toString()}`;
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch blogs: ${response.status}`);
+    }
+    const data = await response.json();
+    // Handle error response
+    if (data.error) {
+        throw new Error(data.error || 'Failed to fetch blogs');
+    }
+    // Convert API format to PostListItem format
+    const blogsArray = Array.isArray(data.blogs) ? data.blogs : [];
+    const convertedBlogs = blogsArray.map((apiDoc) => {
+        const blogPost = apiToBlogPost(apiDoc);
+        return {
+            id: blogPost.id,
+            title: blogPost.title,
+            slug: blogPost.slug,
+            excerpt: blogPost.metadata.excerpt || '',
+            status: blogPost.publication.status,
+            authorId: blogPost.publication.authorId || '',
+            updatedAt: blogPost.updatedAt,
+            featuredImage: blogPost.metadata.featuredImage,
+        };
+    });
+    return {
+        blogs: convertedBlogs,
+        total: data.total || convertedBlogs.length,
+    };
+}
+/**
+ * Fetch a single blog post by slug
+ *
+ * @example
+ * ```ts
+ * const blog = await fetchBlog({ slug: 'my-blog-post' });
+ * ```
+ */
+export async function fetchBlog(options) {
+    const { slug, apiBaseUrl = '/api/plugin-blog' } = options;
+    if (!slug) {
+        throw new Error('Slug is required');
+    }
+    const response = await fetch(`${apiBaseUrl}/${slug}`);
+    if (!response.ok) {
+        if (response.status === 404) {
+            throw new Error('Blog post not found');
+        }
+        throw new Error(`Failed to fetch blog: ${response.status}`);
+    }
+    const apiDoc = await response.json();
+    return apiToBlogPost(apiDoc);
+}

package/src/utils/index.ts

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

package/src/views/CanvasEditor/BlockWrapper.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Block Wrapper Component
+ * Provides hover controls (Delete, Move, Settings) for each block
+ */
+import { Block } from '../../types/block';
+export interface BlockWrapperProps {
+    block: Block;
+    onUpdate: (data: Partial<Block['data']>) => void;
+    onDelete: () => void;
+    onMoveUp?: () => void;
+    onMoveDown?: () => void;
+    /** All blocks in the editor (for resolving child block IDs) */
+    allBlocks?: Block[];
+}
+export declare function BlockWrapper({ block, onUpdate, onDelete, onMoveUp, onMoveDown, allBlocks, }: BlockWrapperProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=BlockWrapper.d.ts.map

package/src/views/CanvasEditor/BlockWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockWrapper.d.ts","sourceRoot":"","sources":["BlockWrapper.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAK1C,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC;IACjD,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC;CACvB;AAED,wBAAgB,YAAY,CAAC,EACzB,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,SAAc,GACjB,EAAE,iBAAiB,2CAyenB"}