@next-md-blog/core 1.0.0

package/dist/core/type-guards.js

@@ -0,0 +1,83 @@
+/**
+ * Type guard to check if a value is a non-empty string
+ */
+export function isString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+/**
+ * Type guard to check if a value is a string array
+ */
+export function isStringArray(value) {
+    return Array.isArray(value) && value.every(item => typeof item === 'string');
+}
+/**
+ * Type guard to check if a value is a number
+ */
+export function isNumber(value) {
+    return typeof value === 'number' && !isNaN(value);
+}
+/**
+ * Type guard to check if a value is an Author object
+ */
+export function isAuthorObject(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'name' in value &&
+        typeof value.name === 'string');
+}
+/**
+ * Type guard to check if a value is an Author
+ */
+export function isAuthor(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'name' in value &&
+        typeof value.name === 'string');
+}
+/**
+ * Gets a string field from frontmatter with fallback
+ * @param frontmatter - Blog post frontmatter object
+ * @param field - Field name to extract
+ * @param fallback - Optional fallback value if field is missing or invalid
+ * @returns String value or undefined
+ */
+export function getStringField(frontmatter, field, fallback) {
+    const value = frontmatter[field];
+    return isString(value) ? value : fallback;
+}
+/**
+ * Gets a number field from frontmatter with fallback
+ * @param frontmatter - Blog post frontmatter object
+ * @param field - Field name to extract
+ * @param fallback - Optional fallback value if field is missing or invalid
+ * @returns Number value or undefined
+ */
+export function getNumberField(frontmatter, field, fallback) {
+    const value = frontmatter[field];
+    return isNumber(value) ? value : fallback;
+}
+/**
+ * Resolves a frontmatter field from multiple possible field names
+ * Checks fields in order and returns the first valid value found
+ * @param fields - Array of field names to check (in priority order)
+ * @param frontmatter - Blog post frontmatter object
+ * @param fallback - Optional fallback value if no fields are found
+ * @returns First valid field value or fallback
+ * @example
+ * ```typescript
+ * const title = resolveFrontmatterField<string>(
+ *   ['seoTitle', 'title'],
+ *   frontmatter,
+ *   'Default Title'
+ * );
+ * ```
+ */
+export function resolveFrontmatterField(fields, frontmatter, fallback) {
+    for (const field of fields) {
+        const value = frontmatter[field];
+        if (value !== undefined && value !== null && value !== '') {
+            return value;
+        }
+    }
+    return fallback;
+}

package/dist/core/types.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Blog configuration
+ */
+export interface Config {
+    /** Site name */
+    siteName?: string;
+    /** Default site URL */
+    siteUrl?: string;
+    /** Default author name */
+    defaultAuthor?: string;
+    /** Array of author objects with detailed information */
+    authors?: Author[];
+    /** Twitter handle */
+    twitterHandle?: string;
+    /** Default OG image URL */
+    defaultOgImage?: string;
+    /** Default language code */
+    defaultLang?: string;
+    /** Alternate language URLs for hreflang (e.g., { 'en': 'https://example.com/blog/post', 'fr': 'https://example.com/fr/blog/post' }) */
+    alternateLanguages?: Record<string, string>;
+}
+/**
+ * Author information
+ */
+export interface Author {
+    name: string;
+    email?: string;
+    bio?: string;
+    avatar?: string;
+    twitter?: string;
+    github?: string;
+    url?: string;
+}
+/**
+ * Frontmatter metadata for blog posts
+ */
+export interface BlogPostFrontmatter {
+    title?: string;
+    date?: string;
+    description?: string;
+    /** Author can be a string, an object with name property (Quarto format), or an array of either */
+    author?: string | {
+        name: string;
+        [key: string]: unknown;
+    } | (string | {
+        name: string;
+        [key: string]: unknown;
+    })[];
+    /** Authors can be an array of strings or objects with name property */
+    authors?: (string | {
+        name: string;
+        [key: string]: unknown;
+    })[];
+    tags?: string[];
+    /** Custom OG image URL */
+    ogImage?: string;
+    /** Featured image URL (fallback for OG image) */
+    image?: string;
+    /** Robots meta directive (e.g., 'noindex, nofollow' or 'index, follow') */
+    robots?: string;
+    /** Whether to exclude from search engine indexing */
+    noindex?: boolean;
+    /** Whether to exclude from following links */
+    nofollow?: boolean;
+    /** Reading time in minutes (auto-calculated if not provided) */
+    readingTime?: number;
+    [key: string]: unknown;
+}
+/**
+ * Complete blog post with content and metadata
+ */
+export interface BlogPost {
+    /** The slug identifier for the post (filename without extension) */
+    slug: string;
+    /** The markdown content of the post */
+    content: string;
+    /** Frontmatter metadata parsed from the markdown file */
+    frontmatter: BlogPostFrontmatter;
+    /** Reading time in minutes (auto-calculated) */
+    readingTime: number;
+    /** Word count (auto-calculated) */
+    wordCount: number;
+    /** Normalized authors array (string or Author objects) */
+    authors: (string | Author)[];
+}
+/**
+ * Blog post metadata without content (for listings)
+ */
+export interface BlogPostMetadata {
+    /** The slug identifier for the post */
+    slug: string;
+    /** Frontmatter metadata parsed from the markdown file */
+    frontmatter: BlogPostFrontmatter;
+    /** Normalized authors array (string or Author objects) */
+    authors: (string | Author)[];
+}
+/**
+ * Options for reading blog posts
+ */
+export interface GetBlogPostOptions {
+    /** Custom path to posts directory */
+    postsDir?: string;
+    /** Locale code for multi-language support (e.g., 'en', 'fr') */
+    locale?: string;
+    /** Blog configuration for author resolution */
+    config?: Config;
+}
+/**
+ * Result of file system operations
+ */
+export interface FileSystemResult<T> {
+    success: boolean;
+    data?: T;
+    error?: Error;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uIAAuI;IACvI,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kGAAkG;IAClG,MAAM,CAAC,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,EAAE,CAAC;IACnH,uEAAuE;IACvE,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,EAAE,CAAC;IAChE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,WAAW,EAAE,mBAAmB,CAAC;IACjC,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,OAAO,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,WAAW,EAAE,mBAAmB,CAAC;IACjC,0DAA0D;IAC1D,OAAO,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,KAAK,CAAC;CACf"}

package/dist/core/types.js

@@ -0,0 +1 @@
+export {};

package/dist/core/utils.d.ts

@@ -0,0 +1,49 @@
+import type { Author } from './types.js';
+/**
+ * Calculates reading time in minutes from markdown content
+ * Assumes average reading speed of 200 words per minute
+ * @param content - The markdown content
+ * @returns Reading time in minutes (rounded up)
+ */
+export declare function calculateReadingTime(content: string): number;
+/**
+ * Calculates word count from markdown content
+ * @param content - The markdown content
+ * @returns Word count
+ */
+export declare function calculateWordCount(content: string): number;
+/**
+ * Resolves author names to full Author objects from config
+ * Matches by full name only (case-insensitive)
+ * @param authorName - Author name to resolve
+ * @param configAuthors - Array of authors from config
+ * @returns Author object if found, otherwise returns the name as string
+ */
+export declare function resolveAuthorFromConfig(authorName: string, configAuthors?: Author[]): string | Author;
+/**
+ * Normalizes authors to an array of strings or Author objects
+ * Supports:
+ * - author: "John Doe" (string)
+ * - author: { name: "John Doe", affiliation: "..." } (single object with name property - Quarto format)
+ * - author: ["John Doe", "Jane Smith"] (array of strings)
+ * - author: [{ name: "John Doe" }, { name: "Jane Smith" }] (array of objects with name)
+ * - authors: ["John Doe", "Jane Smith"] (array of strings)
+ * - authors: [{ name: "John Doe" }, { name: "Jane Smith" }] (array of objects with name)
+ * If configAuthors is provided, resolves author names to full Author objects by matching full name
+ * Falls back to string names if authors array is not configured (backward compatible)
+ * @param author - Author field from frontmatter (string, object with name, string[], or array of objects with name)
+ * @param authors - Authors field from frontmatter (string[] or array of objects with name)
+ * @param configAuthors - Optional array of authors from config to resolve against
+ * @returns Normalized array of author names or Author objects
+ */
+export declare function normalizeAuthors(author?: string | {
+    name: string;
+    [key: string]: unknown;
+} | (string | {
+    name: string;
+    [key: string]: unknown;
+})[], authors?: (string | {
+    name: string;
+    [key: string]: unknown;
+})[], configAuthors?: Author[]): (string | Author)[];
+//# sourceMappingURL=utils.d.ts.map

package/dist/core/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/core/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AA+DzC;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAqB5D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAU1D;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,MAAM,GAAG,MAAM,CAYjB;AAsBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,CAAC,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAAG,CAAC,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC,EAAE,EAClH,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC,EAAE,EAC/D,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CA0CrB"}

package/dist/core/utils.js

@@ -0,0 +1,175 @@
+// Regex patterns for markdown stripping (compiled once at module level)
+const CODE_BLOCK_REGEX = /```[\s\S]*?```/g;
+const INLINE_CODE_REGEX = /`[^`]*`/g;
+const LINK_REGEX = /\[([^\]]*)\]\([^\)]*\)/g;
+const IMAGE_REGEX = /!\[([^\]]*)\]\([^\)]*\)/g;
+const HTML_TAG_REGEX = /<[^>]*>/g;
+const HEADER_REGEX = /#+\s+/g;
+const HORIZONTAL_RULE_REGEX = /---+/g;
+const LIST_MARKER_REGEX = /^[\s]*[-*+]\s+/gm;
+const BLOCKQUOTE_REGEX = /^>\s+/gm;
+const WHITESPACE_REGEX = /\s+/g;
+// Constants
+const WORDS_PER_MINUTE = 200;
+const MIN_READING_TIME = 1;
+/**
+ * Strips markdown syntax from content to get plain text
+ * @param content - The markdown content
+ * @param options - Options for what to strip
+ * @returns Plain text with markdown syntax removed
+ */
+function stripMarkdownSyntax(content, options = {}) {
+    let plainText = content
+        // Remove code blocks
+        .replace(CODE_BLOCK_REGEX, '')
+        // Remove inline code
+        .replace(INLINE_CODE_REGEX, '')
+        // Remove links but keep text
+        .replace(LINK_REGEX, '$1')
+        // Remove images
+        .replace(IMAGE_REGEX, '')
+        // Remove HTML tags
+        .replace(HTML_TAG_REGEX, '');
+    // Conditionally remove additional markdown elements
+    if (options.includeHeaders) {
+        plainText = plainText.replace(HEADER_REGEX, '');
+    }
+    if (options.includeHorizontalRules) {
+        plainText = plainText.replace(HORIZONTAL_RULE_REGEX, '');
+    }
+    if (options.includeLists) {
+        plainText = plainText.replace(LIST_MARKER_REGEX, '');
+    }
+    if (options.includeBlockquotes) {
+        plainText = plainText.replace(BLOCKQUOTE_REGEX, '');
+    }
+    // Remove extra whitespace
+    return plainText.replace(WHITESPACE_REGEX, ' ').trim();
+}
+/**
+ * Calculates reading time in minutes from markdown content
+ * Assumes average reading speed of 200 words per minute
+ * @param content - The markdown content
+ * @returns Reading time in minutes (rounded up)
+ */
+export function calculateReadingTime(content) {
+    if (!content || typeof content !== 'string') {
+        return 0;
+    }
+    // Strip all markdown syntax including headers, lists, blockquotes, etc.
+    const plainText = stripMarkdownSyntax(content, {
+        includeHeaders: true,
+        includeLists: true,
+        includeBlockquotes: true,
+        includeHorizontalRules: true,
+    });
+    // Count words (split by whitespace)
+    const wordCount = plainText.split(/\s+/).filter((word) => word.length > 0).length;
+    // Calculate reading time
+    const readingTime = Math.ceil(wordCount / WORDS_PER_MINUTE);
+    // Minimum reading time is 1 minute
+    return Math.max(MIN_READING_TIME, readingTime);
+}
+/**
+ * Calculates word count from markdown content
+ * @param content - The markdown content
+ * @returns Word count
+ */
+export function calculateWordCount(content) {
+    if (!content || typeof content !== 'string') {
+        return 0;
+    }
+    // Strip basic markdown syntax (no headers, lists, etc. for word count)
+    const plainText = stripMarkdownSyntax(content);
+    // Count words (split by whitespace)
+    return plainText.split(/\s+/).filter((word) => word.length > 0).length;
+}
+/**
+ * Resolves author names to full Author objects from config
+ * Matches by full name only (case-insensitive)
+ * @param authorName - Author name to resolve
+ * @param configAuthors - Array of authors from config
+ * @returns Author object if found, otherwise returns the name as string
+ */
+export function resolveAuthorFromConfig(authorName, configAuthors) {
+    // If no config authors, return name as-is (backward compatibility)
+    if (!configAuthors || configAuthors.length === 0) {
+        return authorName;
+    }
+    // Match by full name (case-insensitive)
+    const found = configAuthors.find((a) => a.name.toLowerCase() === authorName.toLowerCase());
+    return found || authorName;
+}
+/**
+ * Extracts author name from various formats (string, object with name property, etc.)
+ * @param item - Author item that could be a string or object
+ * @returns Author name as string, or undefined if invalid
+ */
+function extractAuthorName(item) {
+    if (typeof item === 'string') {
+        return item.trim() || undefined;
+    }
+    if (typeof item === 'object' && item !== null) {
+        // Handle objects with name property: { name: "John Doe" }
+        if ('name' in item && typeof item.name === 'string') {
+            return item.name.trim() || undefined;
+        }
+    }
+    return undefined;
+}
+/**
+ * Normalizes authors to an array of strings or Author objects
+ * Supports:
+ * - author: "John Doe" (string)
+ * - author: { name: "John Doe", affiliation: "..." } (single object with name property - Quarto format)
+ * - author: ["John Doe", "Jane Smith"] (array of strings)
+ * - author: [{ name: "John Doe" }, { name: "Jane Smith" }] (array of objects with name)
+ * - authors: ["John Doe", "Jane Smith"] (array of strings)
+ * - authors: [{ name: "John Doe" }, { name: "Jane Smith" }] (array of objects with name)
+ * If configAuthors is provided, resolves author names to full Author objects by matching full name
+ * Falls back to string names if authors array is not configured (backward compatible)
+ * @param author - Author field from frontmatter (string, object with name, string[], or array of objects with name)
+ * @param authors - Authors field from frontmatter (string[] or array of objects with name)
+ * @param configAuthors - Optional array of authors from config to resolve against
+ * @returns Normalized array of author names or Author objects
+ */
+export function normalizeAuthors(author, authors, configAuthors) {
+    const authorList = [];
+    // First, collect from authors field
+    if (Array.isArray(authors) && authors.length > 0) {
+        authors.forEach((a) => {
+            const name = extractAuthorName(a);
+            if (name) {
+                authorList.push(name);
+            }
+        });
+    }
+    // Then, collect from author field
+    if (author) {
+        if (Array.isArray(author)) {
+            author.forEach((a) => {
+                const name = extractAuthorName(a);
+                if (name) {
+                    authorList.push(name);
+                }
+            });
+        }
+        else if (typeof author === 'string' && author.trim().length > 0) {
+            authorList.push(author.trim());
+        }
+        else if (typeof author === 'object' && author !== null && 'name' in author) {
+            // Handle single object: { name: "John Doe" }
+            const name = extractAuthorName(author);
+            if (name) {
+                authorList.push(name);
+            }
+        }
+    }
+    // Remove duplicates while preserving order
+    const uniqueAuthors = authorList.filter((a, i, arr) => arr.indexOf(a) === i);
+    // Resolve authors from config if available
+    if (configAuthors && configAuthors.length > 0) {
+        return uniqueAuthors.map((name) => resolveAuthorFromConfig(name, configAuthors));
+    }
+    return uniqueAuthors;
+}

package/dist/core/validation.d.ts

@@ -0,0 +1,22 @@
+import type { BlogPostFrontmatter } from './types';
+/**
+ * Validates that a slug is safe and valid
+ * @param slug - The slug to validate
+ * @returns True if valid, throws error if invalid
+ * @throws {Error} If slug is invalid
+ */
+export declare function validateSlug(slug: string): boolean;
+/**
+ * Validates frontmatter data
+ * @param frontmatter - The frontmatter to validate
+ * @returns Validated frontmatter
+ */
+export declare function validateFrontmatter(frontmatter: unknown): BlogPostFrontmatter;
+/**
+ * Validates markdown content
+ * @param content - The content to validate
+ * @returns True if valid
+ * @throws {Error} If content is invalid
+ */
+export declare function validateContent(content: string): boolean;
+//# sourceMappingURL=validation.d.ts.map

package/dist/core/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAoBlD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,OAAO,GAAG,mBAAmB,CAW7E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAKxD"}

package/dist/core/validation.js

@@ -0,0 +1,50 @@
+/**
+ * Validates that a slug is safe and valid
+ * @param slug - The slug to validate
+ * @returns True if valid, throws error if invalid
+ * @throws {Error} If slug is invalid
+ */
+export function validateSlug(slug) {
+    if (!slug || typeof slug !== 'string') {
+        throw new Error('Slug must be a non-empty string');
+    }
+    if (slug.trim().length === 0) {
+        throw new Error('Slug cannot be empty or whitespace');
+    }
+    // Prevent directory traversal and invalid characters
+    if (slug.includes('..') || slug.includes('/') || slug.includes('\\')) {
+        throw new Error('Slug cannot contain path separators or directory traversal sequences');
+    }
+    // Prevent null bytes
+    if (slug.includes('\0')) {
+        throw new Error('Slug cannot contain null bytes');
+    }
+    return true;
+}
+/**
+ * Validates frontmatter data
+ * @param frontmatter - The frontmatter to validate
+ * @returns Validated frontmatter
+ */
+export function validateFrontmatter(frontmatter) {
+    if (!frontmatter || typeof frontmatter !== 'object') {
+        return {};
+    }
+    // Ensure it's a plain object
+    if (Array.isArray(frontmatter)) {
+        return {};
+    }
+    return frontmatter;
+}
+/**
+ * Validates markdown content
+ * @param content - The content to validate
+ * @returns True if valid
+ * @throws {Error} If content is invalid
+ */
+export function validateContent(content) {
+    if (typeof content !== 'string') {
+        throw new Error('Content must be a string');
+    }
+    return true;
+}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { MarkdownContent } from './components/MarkdownContent.js';
+export type { MarkdownContentProps, MarkdownComponents } from './components/MarkdownContent.js';
+export { defaultMarkdownComponents } from './components/markdown/defaults.js';
+export { OgImage } from './components/OgImage.js';
+export type { OgImageProps } from './components/OgImage.js';
+export { BlogPostSEO } from './components/BlogPostSEO.js';
+export type { BlogPostSEOProps } from './components/BlogPostSEO.js';
+export { getBlogPost, getAllBlogPosts, getAllBlogPostSlugs } from './core/file-utils.js';
+export { generateBlogPostMetadata, generateBlogListMetadata, generateBlogPostSchema, generateBreadcrumbsSchema, generateSitemap, generateRSSFeed, } from './core/seo.js';
+export { createConfig, loadConfig, getConfig } from './core/config.js';
+export type { BlogPost, BlogPostMetadata, BlogPostFrontmatter, GetBlogPostOptions, Author, Config, } from './core/types.js';
+export { MdxBlogError, BlogPostNotFoundError, FileReadError, DirectoryError, } from './core/errors.js';
+export { POSTS_DIR_NAME, getPostsDirectory } from './core/constants.js';
+export { calculateReadingTime, calculateWordCount, normalizeAuthors } from './core/utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAChG,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGzF,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,EACzB,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGvE,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,MAAM,EACN,MAAM,GACP,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,aAAa,EACb,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxE,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+// Components
+export { MarkdownContent } from './components/MarkdownContent.js';
+export { defaultMarkdownComponents } from './components/markdown/defaults.js';
+export { OgImage } from './components/OgImage.js';
+export { BlogPostSEO } from './components/BlogPostSEO.js';
+// Utilities
+export { getBlogPost, getAllBlogPosts, getAllBlogPostSlugs } from './core/file-utils.js';
+// SEO
+export { generateBlogPostMetadata, generateBlogListMetadata, generateBlogPostSchema, generateBreadcrumbsSchema, generateSitemap, generateRSSFeed, } from './core/seo.js';
+// Config
+export { createConfig, loadConfig, getConfig } from './core/config.js';
+// Errors
+export { MdxBlogError, BlogPostNotFoundError, FileReadError, DirectoryError, } from './core/errors.js';
+// Constants
+export { POSTS_DIR_NAME, getPostsDirectory } from './core/constants.js';
+// Utilities
+export { calculateReadingTime, calculateWordCount, normalizeAuthors } from './core/utils.js';

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@next-md-blog/core",
+  "version": "1.0.0",
+  "description": "A React library for parsing and displaying markdown blog posts in Next.js",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "module": "dist/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepare": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build && npm run test"
+  },
+  "keywords": [
+    "react",
+    "nextjs",
+    "markdown",
+    "blog",
+    "mdx",
+    "content"
+  ],
+  "author": "florianamette",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/florianamette/next-mdx-blog.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/florianamette/next-mdx-blog#readme",
+  "bugs": {
+    "url": "https://github.com/florianamette/next-mdx-blog/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@tailwindcss/typography": "^0.5.19",
+    "c12": "^2.0.4",
+    "gray-matter": "^4.0.3",
+    "react-markdown": "^10.1.0",
+    "rehype-react": "^7.0.0",
+    "remark": "^15.0.1",
+    "remark-emoji": "^5.0.2",
+    "remark-gfm": "^4.0.0",
+    "remark-rehype": "^11.1.1",
+    "tailwindcss": "^4.0.0",
+    "unist-util-visit": "^5.0.0"
+  },
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.0.0",
+    "@types/react-dom": "^18.0.0",
+    "@vitest/coverage-v8": "^4.0.8",
+    "semantic-release": "^23.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.0.8"
+  },
+  "peerDependencies": {
+    "next": "^16.0.1",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  }
+}