@contentgrowth/content-widget 1.1.0

package/dist/astro/ContentViewer.astro

@@ -0,0 +1,252 @@
+---
+/**
+ * ContentViewer Component
+ * Displays a single article with full content
+ */
+import type { ContentViewerProps } from '../types/index.js';
+import { ContentGrowthClient } from '../core/client.js';
+import { formatDate, calculateReadingTime } from '../core/utils.js';
+import { marked } from 'marked';
+
+interface Props extends ContentViewerProps {}
+
+const {
+  apiKey,
+  uuid,
+  slug,
+  baseUrl,
+  theme = 'light',
+  showBackButton = false,
+  backUrl = '/articles',
+  showAiSummary = true,
+  class: className = ''
+} = Astro.props;
+
+// Validate that either uuid or slug is provided
+if (!uuid && !slug) {
+  throw new Error('Either uuid or slug must be provided to ContentViewer');
+}
+
+// Fetch article
+const client = new ContentGrowthClient({ apiKey, baseUrl });
+const article = slug 
+  ? await client.getArticleBySlug(slug)
+  : await client.getArticle(uuid!);
+
+// Process markdown content to handle custom image syntax
+// Convert: ![alt](url =widthxheight) to ![alt](url){width="width" height="height"}
+function processImageSyntax(markdown: string): string {
+  // Match: ![alt](url =widthxheight)
+  return markdown.replace(
+    /!\[([^\]]*)\]\(([^\s)]+)\s+=(\d+)x(\d+)\)/g,
+    (match, alt, url, width, height) => {
+      return `![${alt}](${url}){width="${width}" height="${height}"}`;
+    }
+  );
+}
+
+const processedContent = processImageSyntax(article.content);
+
+// Configure marked to handle image attributes
+marked.use({
+  renderer: {
+    image(href, title, text) {
+      // Extract width/height from {width="x" height="y"} syntax
+      const attrMatch = text.match(/\{width="(\d+)"\s+height="(\d+)"\}/);
+      if (attrMatch) {
+        const cleanText = text.replace(/\{[^}]+\}/, '').trim();
+        return `<img src="${href}" alt="${cleanText}" width="${attrMatch[1]}" height="${attrMatch[2]}" ${title ? `title="${title}"` : ''} />`;
+      }
+      return `<img src="${href}" alt="${text}" ${title ? `title="${title}"` : ''} />`;
+    }
+  }
+});
+
+// Render markdown to HTML
+const contentHtml = marked(processedContent);
+
+// Format metadata
+const publishedDate = formatDate(article.publishedAt);
+const readingTime = calculateReadingTime(article.wordCount);
+---
+
+<article 
+  class={`cg-content-viewer cg-theme-${theme} ${className}`}
+  data-cg-widget="post"
+>
+  {showBackButton && (
+    <div class="cg-post-header">
+      <a href={backUrl} class="cg-back-btn">
+        <svg width="20" height="20" viewBox="0 0 20 20" fill="none">
+          <path d="M12 16L6 10L12 4" stroke="currentColor" stroke-width="2" stroke-linecap="round"/>
+        </svg>
+        Back to articles
+      </a>
+    </div>
+  )}
+
+  <header class="cg-post-meta">
+    {article.category && (
+      <div class="cg-post-category">
+        <span class="cg-category-badge">{article.category}</span>
+      </div>
+    )}
+    
+    <h1 class="cg-post-title">{article.title}</h1>
+    
+    {showAiSummary && article.summary && (
+      <div class="cg-ai-summary">
+        <div class="cg-ai-summary-header">
+          <svg class="cg-ai-summary-icon" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 10V3L4 14h7v7l9-11h-7z" />
+          </svg>
+          <span class="cg-ai-summary-label">AI Generated Summary</span>
+        </div>
+        <p class="cg-ai-summary-text">{article.summary}</p>
+      </div>
+    )}
+    
+    <div class="cg-post-info">
+      <span class="cg-info-author">{article.authorName}</span>
+      <span class="cg-info-separator">•</span>
+      <time class="cg-info-date" datetime={new Date(article.publishedAt * 1000).toISOString()}>
+        {publishedDate}
+      </time>
+      <span class="cg-info-separator">•</span>
+      <span class="cg-info-reading-time">{readingTime}</span>
+    </div>
+    
+    {article.tags.length > 0 && (
+      <div class="cg-post-tags">
+        {article.tags.map((tag) => (
+          <span class="cg-tag">{tag}</span>
+        ))}
+      </div>
+    )}
+  </header>
+
+  <div class="cg-post-content" set:html={contentHtml} />
+</article>
+
+<style is:global>
+  /* Markdown content styling */
+  .cg-post-content {
+    line-height: 1.7;
+  }
+
+  .cg-post-content h1,
+  .cg-post-content h2,
+  .cg-post-content h3,
+  .cg-post-content h4,
+  .cg-post-content h5,
+  .cg-post-content h6 {
+    margin-top: 2em;
+    margin-bottom: 0.5em;
+    font-weight: 600;
+    line-height: 1.3;
+  }
+
+  .cg-post-content h1 { font-size: 2em; }
+  .cg-post-content h2 { font-size: 1.5em; }
+  .cg-post-content h3 { font-size: 1.25em; }
+  .cg-post-content h4 { font-size: 1.1em; }
+
+  .cg-post-content p {
+    margin-bottom: 1.5em;
+  }
+
+  .cg-post-content a {
+    color: #2563eb;
+    text-decoration: underline;
+  }
+
+  .cg-post-content a:hover {
+    color: #1d4ed8;
+  }
+
+  .cg-post-content ul,
+  .cg-post-content ol {
+    margin-bottom: 1.5em;
+    padding-left: 2em;
+  }
+
+  .cg-post-content li {
+    margin-bottom: 0.5em;
+  }
+
+  .cg-post-content code {
+    background: #f3f4f6;
+    padding: 0.2em 0.4em;
+    border-radius: 3px;
+    font-size: 0.9em;
+    font-family: 'Courier New', monospace;
+  }
+
+  .cg-post-content pre {
+    background: #1f2937;
+    color: #f9fafb;
+    padding: 1.5em;
+    border-radius: 8px;
+    overflow-x: auto;
+    margin-bottom: 1.5em;
+  }
+
+  .cg-post-content pre code {
+    background: none;
+    padding: 0;
+    color: inherit;
+  }
+
+  .cg-post-content blockquote {
+    border-left: 4px solid #e5e7eb;
+    padding-left: 1.5em;
+    margin: 1.5em 0;
+    font-style: italic;
+    color: #6b7280;
+  }
+
+  .cg-post-content img {
+    max-width: 100%;
+    height: auto;
+    border-radius: 8px;
+    margin: 1.5em 0;
+  }
+
+  .cg-post-content table {
+    width: 100%;
+    border-collapse: collapse;
+    margin-bottom: 1.5em;
+  }
+
+  .cg-post-content th,
+  .cg-post-content td {
+    border: 1px solid #e5e7eb;
+    padding: 0.75em;
+    text-align: left;
+  }
+
+  .cg-post-content th {
+    background: #f9fafb;
+    font-weight: 600;
+  }
+
+  /* Dark theme overrides */
+  .cg-theme-dark .cg-post-content code {
+    background: #374151;
+    color: #f9fafb;
+  }
+
+  .cg-theme-dark .cg-post-content blockquote {
+    border-left-color: #4b5563;
+    color: #9ca3af;
+  }
+
+  .cg-theme-dark .cg-post-content th {
+    background: #1f2937;
+  }
+
+  .cg-theme-dark .cg-post-content th,
+  .cg-theme-dark .cg-post-content td {
+    border-color: #374151;
+  }
+</style>

package/dist/astro/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Content Growth Content Widget - Astro Components
+ *
+ * Note: Astro components are not compiled by TypeScript.
+ * They are copied directly to dist/ during the build process.
+ * Import them directly from the .astro files in your Astro project.
+ */
+export type { ContentListProps, ContentViewerProps } from '../types/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/astro/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/astro/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/astro/index.js

@@ -0,0 +1,8 @@
+/**
+ * Content Growth Content Widget - Astro Components
+ *
+ * Note: Astro components are not compiled by TypeScript.
+ * They are copied directly to dist/ during the build process.
+ * Import them directly from the .astro files in your Astro project.
+ */
+export {};

package/dist/core/client.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Content Growth API Client
+ * Framework-agnostic API client for fetching articles
+ */
+import type { ClientConfig, ListArticlesOptions, ArticlesResponse, ArticleWithContent, CategoriesResponse, TagsResponse } from '../types/index.js';
+/**
+ * Content Growth API Client
+ *
+ * @example
+ * ```typescript
+ * const client = new ContentGrowthClient({
+ *   apiKey: 'pk_your_key_here'
+ * });
+ *
+ * const { articles, pagination } = await client.listArticles({
+ *   page: 1,
+ *   limit: 12,
+ *   tags: ['tutorial']
+ * });
+ * ```
+ */
+export declare class ContentGrowthClient {
+    private config;
+    private cache;
+    constructor(config: ClientConfig);
+    /**
+     * List articles with pagination and filtering
+     */
+    listArticles(options?: ListArticlesOptions): Promise<ArticlesResponse>;
+    /**
+     * Get a single article by UUID
+     */
+    getArticle(uuid: string): Promise<ArticleWithContent>;
+    /**
+     * Get a single article by slug
+     */
+    getArticleBySlug(slug: string): Promise<ArticleWithContent>;
+    /**
+     * Get all categories with article counts
+     */
+    getCategories(): Promise<CategoriesResponse>;
+    /**
+     * Get all tags with article counts
+     */
+    getTags(): Promise<TagsResponse>;
+    /**
+     * Clear the cache
+     */
+    clearCache(): void;
+    /**
+     * Internal fetch wrapper with error handling
+     */
+    private fetch;
+    /**
+     * Get from cache if not expired
+     */
+    private getFromCache;
+    /**
+     * Set cache entry
+     */
+    private setCache;
+    /**
+     * Debug logging
+     */
+    private log;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EAEb,MAAM,mBAAmB,CAAC;AAG3B;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,KAAK,CAA+B;gBAEhC,MAAM,EAAE,YAAY;IAmBhC;;OAEG;IACG,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAwChF;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAmB3D;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAmBjE;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAelD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;IAetC;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;YACW,KAAK;IAoDnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAQhB;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ"}

package/dist/core/client.js

@@ -0,0 +1,217 @@
+/**
+ * Content Growth API Client
+ * Framework-agnostic API client for fetching articles
+ */
+import { ContentGrowthError } from '../types/index.js';
+/**
+ * Content Growth API Client
+ *
+ * @example
+ * ```typescript
+ * const client = new ContentGrowthClient({
+ *   apiKey: 'pk_your_key_here'
+ * });
+ *
+ * const { articles, pagination } = await client.listArticles({
+ *   page: 1,
+ *   limit: 12,
+ *   tags: ['tutorial']
+ * });
+ * ```
+ */
+export class ContentGrowthClient {
+    config;
+    cache;
+    constructor(config) {
+        this.config = {
+            apiKey: config.apiKey,
+            baseUrl: config.baseUrl || 'https://api.content-growth.com',
+            cacheTTL: config.cacheTTL ?? 300000, // 5 minutes default
+            debug: config.debug ?? false
+        };
+        this.cache = new Map();
+        if (!this.config.apiKey) {
+            throw new ContentGrowthError('API key is required');
+        }
+        if (!this.config.apiKey.startsWith('pk_')) {
+            console.warn('[ContentGrowth] API key should start with "pk_" for public use');
+        }
+    }
+    /**
+     * List articles with pagination and filtering
+     */
+    async listArticles(options = {}) {
+        const { page = 1, limit = 12, tags = [], category } = options;
+        this.log('[ContentGrowthClient] listArticles called with options:', options);
+        // Build query params
+        const params = new URLSearchParams({
+            page: page.toString(),
+            limit: limit.toString()
+        });
+        if (tags.length > 0) {
+            params.set('tags', tags.join(','));
+        }
+        if (category) {
+            params.set('category', category);
+        }
+        const cacheKey = `articles:${params.toString()}`;
+        const cached = this.getFromCache(cacheKey);
+        if (cached) {
+            this.log('[ContentGrowthClient] Cache hit:', cacheKey);
+            return cached;
+        }
+        const url = `${this.config.baseUrl}/widget/articles?${params}`;
+        this.log('[ContentGrowthClient] Fetching from URL:', url);
+        const data = await this.fetch(url);
+        this.log('[ContentGrowthClient] Response received:', data);
+        this.setCache(cacheKey, data);
+        return data;
+    }
+    /**
+     * Get a single article by UUID
+     */
+    async getArticle(uuid) {
+        if (!uuid) {
+            throw new ContentGrowthError('Article UUID is required');
+        }
+        const cacheKey = `article:${uuid}`;
+        const cached = this.getFromCache(cacheKey);
+        if (cached) {
+            this.log('Cache hit:', cacheKey);
+            return cached;
+        }
+        const url = `${this.config.baseUrl}/widget/articles/${uuid}`;
+        const data = await this.fetch(url);
+        this.setCache(cacheKey, data);
+        return data;
+    }
+    /**
+     * Get a single article by slug
+     */
+    async getArticleBySlug(slug) {
+        if (!slug) {
+            throw new ContentGrowthError('Article slug is required');
+        }
+        const cacheKey = `article:slug:${slug}`;
+        const cached = this.getFromCache(cacheKey);
+        if (cached) {
+            this.log('Cache hit:', cacheKey);
+            return cached;
+        }
+        const url = `${this.config.baseUrl}/widget/articles/slug/${slug}`;
+        const data = await this.fetch(url);
+        this.setCache(cacheKey, data);
+        return data;
+    }
+    /**
+     * Get all categories with article counts
+     */
+    async getCategories() {
+        const cacheKey = 'categories';
+        const cached = this.getFromCache(cacheKey);
+        if (cached) {
+            this.log('Cache hit:', cacheKey);
+            return cached;
+        }
+        const url = `${this.config.baseUrl}/widget/categories`;
+        const data = await this.fetch(url);
+        this.setCache(cacheKey, data);
+        return data;
+    }
+    /**
+     * Get all tags with article counts
+     */
+    async getTags() {
+        const cacheKey = 'tags';
+        const cached = this.getFromCache(cacheKey);
+        if (cached) {
+            this.log('Cache hit:', cacheKey);
+            return cached;
+        }
+        const url = `${this.config.baseUrl}/widget/tags`;
+        const data = await this.fetch(url);
+        this.setCache(cacheKey, data);
+        return data;
+    }
+    /**
+     * Clear the cache
+     */
+    clearCache() {
+        this.cache.clear();
+        this.log('Cache cleared');
+    }
+    /**
+     * Internal fetch wrapper with error handling
+     */
+    async fetch(url) {
+        console.log('[ContentGrowthClient] Fetching:', url);
+        console.log('[ContentGrowthClient] API Key:', this.config.apiKey);
+        try {
+            const response = await fetch(url, {
+                headers: {
+                    'X-API-Key': this.config.apiKey,
+                    'Content-Type': 'application/json'
+                }
+            });
+            console.log('[ContentGrowthClient] Response status:', response.status, response.statusText);
+            if (!response.ok) {
+                const errorText = await response.text();
+                console.error('[ContentGrowthClient] Error response:', errorText);
+                let errorMessage = `HTTP ${response.status}: ${response.statusText}`;
+                try {
+                    const errorJson = JSON.parse(errorText);
+                    errorMessage = errorJson.error || errorJson.message || errorMessage;
+                }
+                catch {
+                    // Use default error message
+                }
+                throw new ContentGrowthError(errorMessage, response.status, errorText);
+            }
+            const data = await response.json();
+            console.log('[ContentGrowthClient] Response data:', data);
+            return data;
+        }
+        catch (error) {
+            if (error instanceof ContentGrowthError) {
+                console.error('[ContentGrowthClient] ContentGrowthError:', error);
+                throw error;
+            }
+            // Network or parsing error
+            console.error('[ContentGrowthClient] Network/Parse error:', error);
+            throw new ContentGrowthError(`Failed to fetch from Content Growth API: ${error.message}`, undefined, error);
+        }
+    }
+    /**
+     * Get from cache if not expired
+     */
+    getFromCache(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return null;
+        const now = Date.now();
+        if (now - entry.timestamp > this.config.cacheTTL) {
+            this.cache.delete(key);
+            this.log('Cache expired:', key);
+            return null;
+        }
+        return entry.data;
+    }
+    /**
+     * Set cache entry
+     */
+    setCache(key, data) {
+        this.cache.set(key, {
+            data,
+            timestamp: Date.now()
+        });
+        this.log('Cache set:', key);
+    }
+    /**
+     * Debug logging
+     */
+    log(...args) {
+        if (this.config.debug) {
+            console.log('[ContentGrowth]', ...args);
+        }
+    }
+}

package/dist/core/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Content Growth Content Widget - Core API Client
+ * Framework-agnostic API client for fetching articles
+ */
+export { ContentGrowthClient } from './client.js';
+export * from './utils.js';
+export * from '../types/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,7 @@
+/**
+ * Content Growth Content Widget - Core API Client
+ * Framework-agnostic API client for fetching articles
+ */
+export { ContentGrowthClient } from './client.js';
+export * from './utils.js';
+export * from '../types/index.js';

package/dist/core/utils.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Utility functions for the Content Growth widget
+ */
+/**
+ * Format a Unix timestamp to a readable date string
+ */
+export declare function formatDate(timestamp: number, locale?: string): string;
+/**
+ * Calculate reading time based on word count
+ */
+export declare function calculateReadingTime(wordCount: number, wordsPerMinute?: number): string;
+/**
+ * Truncate text to a maximum length
+ */
+export declare function truncate(text: string, maxLength: number): string;
+/**
+ * Generate excerpt from content
+ */
+export declare function generateExcerpt(content: string, maxLength?: number): string;
+/**
+ * Slugify a string for URLs
+ */
+export declare function slugify(text: string): string;
+/**
+ * Parse tags from comma-separated string
+ */
+export declare function parseTags(tags: string | string[]): string[];
+/**
+ * Build article URL
+ */
+export declare function buildArticleUrl(uuid: string, pattern?: string): string;
+//# 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;;GAEG;AAEH;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,MAAgB,GAAG,MAAM,CAO9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,GAAE,MAAY,GAAG,MAAM,CAG5F;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM,CAahF;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO5C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAG3D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAA2B,GAAG,MAAM,CAE1F"}

package/dist/core/utils.js

@@ -0,0 +1,70 @@
+/**
+ * Utility functions for the Content Growth widget
+ */
+/**
+ * Format a Unix timestamp to a readable date string
+ */
+export function formatDate(timestamp, locale = 'en-US') {
+    const date = new Date(timestamp * 1000);
+    return date.toLocaleDateString(locale, {
+        year: 'numeric',
+        month: 'long',
+        day: 'numeric'
+    });
+}
+/**
+ * Calculate reading time based on word count
+ */
+export function calculateReadingTime(wordCount, wordsPerMinute = 200) {
+    const minutes = Math.ceil(wordCount / wordsPerMinute);
+    return `${minutes} min read`;
+}
+/**
+ * Truncate text to a maximum length
+ */
+export function truncate(text, maxLength) {
+    if (text.length <= maxLength)
+        return text;
+    return text.substring(0, maxLength).trim() + '...';
+}
+/**
+ * Generate excerpt from content
+ */
+export function generateExcerpt(content, maxLength = 200) {
+    // Remove markdown formatting
+    const plainText = content
+        .replace(/#{1,6}\s/g, '') // Remove headers
+        .replace(/\*\*(.+?)\*\*/g, '$1') // Remove bold
+        .replace(/\*(.+?)\*/g, '$1') // Remove italic
+        .replace(/\[(.+?)\]\(.+?\)/g, '$1') // Remove links
+        .replace(/`(.+?)`/g, '$1') // Remove inline code
+        .replace(/```[\s\S]*?```/g, '') // Remove code blocks
+        .replace(/\n+/g, ' ') // Replace newlines with spaces
+        .trim();
+    return truncate(plainText, maxLength);
+}
+/**
+ * Slugify a string for URLs
+ */
+export function slugify(text) {
+    return text
+        .toLowerCase()
+        .trim()
+        .replace(/[^\w\s-]/g, '')
+        .replace(/[\s_-]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+/**
+ * Parse tags from comma-separated string
+ */
+export function parseTags(tags) {
+    if (Array.isArray(tags))
+        return tags;
+    return tags.split(',').map(t => t.trim()).filter(Boolean);
+}
+/**
+ * Build article URL
+ */
+export function buildArticleUrl(uuid, pattern = '/articles/{uuid}') {
+    return pattern.replace('{uuid}', uuid).replace('{id}', uuid);
+}