@tpitre/story-ui 3.1.0 → 3.3.0

package/dist/story-generator/productionGitignoreManager.js

@@ -1,340 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-import { logger } from './logger.js';
-/**
- * Production-ready gitignore manager that handles both development and server environments
- */
-export class ProductionGitignoreManager {
-    constructor(config, projectRoot = process.cwd()) {
-        this.config = config;
-        this.projectRoot = projectRoot;
-        this.isProduction = this.detectProductionEnvironment();
-    }
-    /**
-     * Detects if we're running in a production/read-only environment
-     */
-    detectProductionEnvironment() {
-        // Explicit override: Force development mode for file-based story generation
-        // Use this on Railway/Render when running Storybook dev mode
-        if (process.env.STORY_UI_DEV_MODE === 'true') {
-            logger.log('📁 STORY_UI_DEV_MODE=true - forcing file-based story generation');
-            return false;
-        }
-        // Check common production environment indicators
-        const prodIndicators = [
-            process.env.NODE_ENV === 'production',
-            process.env.VERCEL === '1',
-            process.env.NETLIFY === 'true',
-            process.env.CF_PAGES === '1', // Cloudflare Pages
-            process.env.RENDER === 'true',
-            process.env.RAILWAY_ENVIRONMENT === 'production',
-            // Check if we can't write to project root
-            !this.canWriteToProjectRoot()
-        ];
-        return prodIndicators.some(indicator => indicator);
-    }
-    /**
-     * Tests if we can write to the project root
-     */
-    canWriteToProjectRoot() {
-        try {
-            const testFile = path.join(this.projectRoot, '.story-ui-write-test');
-            fs.writeFileSync(testFile, 'test');
-            fs.unlinkSync(testFile);
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Main setup method that adapts to environment
-     */
-    setupGitignoreIntegration() {
-        if (this.isProduction) {
-            this.handleProductionEnvironment();
-        }
-        else {
-            this.handleDevelopmentEnvironment();
-        }
-    }
-    /**
-     * Production environment: Use in-memory story generation
-     */
-    handleProductionEnvironment() {
-        logger.log('🌐 Production environment detected - using in-memory story generation');
-        // Validate that gitignore is already set up
-        this.validateProductionSetup();
-        // Set up temporary directory for story generation if needed
-        this.setupTemporaryDirectory();
-    }
-    /**
-     * Development environment: Full gitignore management
-     */
-    handleDevelopmentEnvironment() {
-        logger.log('🔧 Development environment - setting up gitignore integration');
-        this.ensureGeneratedDirectoryExists();
-        this.ensureGeneratedDirectoryIgnored();
-        this.createGeneratedDirectoryReadme();
-    }
-    /**
-     * Validates that production environment is properly configured
-     */
-    validateProductionSetup() {
-        const gitignorePath = path.join(this.projectRoot, '.gitignore');
-        if (!fs.existsSync(gitignorePath)) {
-            console.warn('⚠️  No .gitignore found in production. Stories will be generated in memory only.');
-            return;
-        }
-        const gitignoreContent = fs.readFileSync(gitignorePath, 'utf-8');
-        const generatedPath = this.getRelativeGeneratedPath();
-        if (generatedPath && !this.isPathIgnored(gitignoreContent, generatedPath)) {
-            console.warn(`⚠️  Generated path not in .gitignore: ${generatedPath}`);
-            console.warn('   Run "npx story-ui setup-gitignore" in development to fix this.');
-        }
-        else {
-            logger.log('✅ Production gitignore configuration validated');
-        }
-    }
-    /**
-     * Sets up temporary directory for production story generation
-     */
-    setupTemporaryDirectory() {
-        try {
-            const tempDir = this.getProductionTempDirectory();
-            if (!fs.existsSync(tempDir)) {
-                fs.mkdirSync(tempDir, { recursive: true });
-                logger.log(`✅ Created temporary directory: ${tempDir}`);
-            }
-        }
-        catch (error) {
-            console.warn('⚠️  Could not create temporary directory, using in-memory generation only');
-        }
-    }
-    /**
-     * Gets a writable temporary directory for production
-     */
-    getProductionTempDirectory() {
-        // Try various temporary directory locations
-        const tempOptions = [
-            process.env.TMPDIR,
-            process.env.TMP,
-            process.env.TEMP,
-            '/tmp',
-            path.join(process.cwd(), '.tmp')
-        ].filter(Boolean);
-        for (const tempPath of tempOptions) {
-            try {
-                const storyTempDir = path.join(tempPath, 'story-ui-generated');
-                fs.mkdirSync(storyTempDir, { recursive: true });
-                return storyTempDir;
-            }
-            catch {
-                continue;
-            }
-        }
-        throw new Error('No writable temporary directory found');
-    }
-    /**
-     * Creates the generated directory if it doesn't exist (development only)
-     */
-    ensureGeneratedDirectoryExists() {
-        const generatedDir = this.config.generatedStoriesPath;
-        if (!fs.existsSync(generatedDir)) {
-            fs.mkdirSync(generatedDir, { recursive: true });
-            logger.log(`✅ Created generated stories directory: ${generatedDir}`);
-        }
-    }
-    /**
-     * Ensures the generated stories directory is added to .gitignore (development only)
-     */
-    ensureGeneratedDirectoryIgnored() {
-        const gitignorePath = path.join(this.projectRoot, '.gitignore');
-        const generatedPath = this.getRelativeGeneratedPath();
-        if (!generatedPath) {
-            console.warn('Could not determine relative path for generated stories directory');
-            return;
-        }
-        // Create .gitignore if it doesn't exist
-        if (!fs.existsSync(gitignorePath)) {
-            this.createGitignore(gitignorePath, generatedPath);
-            return;
-        }
-        // Check if the path is already ignored
-        const gitignoreContent = fs.readFileSync(gitignorePath, 'utf-8');
-        if (this.isPathIgnored(gitignoreContent, generatedPath)) {
-            logger.log(`✅ Generated stories directory already ignored: ${generatedPath}`);
-            return;
-        }
-        // Add the ignore rule
-        this.addIgnoreRule(gitignorePath, generatedPath);
-    }
-    /**
-     * Gets the relative path from project root to generated stories directory
-     */
-    getRelativeGeneratedPath() {
-        try {
-            const absoluteGeneratedPath = path.resolve(this.config.generatedStoriesPath);
-            const absoluteProjectRoot = path.resolve(this.projectRoot);
-            let relativePath = path.relative(absoluteProjectRoot, absoluteGeneratedPath);
-            relativePath = relativePath.replace(/\\/g, '/');
-            if (!relativePath.startsWith('../') && !relativePath.startsWith('/')) {
-                relativePath = './' + relativePath;
-            }
-            return relativePath;
-        }
-        catch (error) {
-            console.error('Error calculating relative path:', error);
-            return null;
-        }
-    }
-    /**
-     * Creates a new .gitignore file with Story UI section
-     */
-    createGitignore(gitignorePath, generatedPath) {
-        const content = this.generateGitignoreSection(generatedPath);
-        fs.writeFileSync(gitignorePath, content);
-        logger.log(`✅ Created .gitignore with Story UI generated directory: ${generatedPath}`);
-    }
-    /**
-     * Checks if the generated path is already ignored
-     */
-    isPathIgnored(gitignoreContent, generatedPath) {
-        const lines = gitignoreContent.split('\n').map(line => line.trim());
-        const pathVariations = [
-            generatedPath,
-            generatedPath.replace(/^\.\//, ''),
-            generatedPath + '/',
-            generatedPath.replace(/^\.\//, '') + '/',
-            generatedPath + '/**',
-            generatedPath.replace(/^\.\//, '') + '/**'
-        ];
-        return pathVariations.some(variation => lines.includes(variation) ||
-            lines.includes(variation.replace(/\/$/, '')));
-    }
-    /**
-     * Adds ignore rule to existing .gitignore
-     */
-    addIgnoreRule(gitignorePath, generatedPath) {
-        const existingContent = fs.readFileSync(gitignorePath, 'utf-8');
-        const newSection = this.generateGitignoreSection(generatedPath);
-        const separator = existingContent.endsWith('\n') ? '\n' : '\n\n';
-        const updatedContent = existingContent + separator + newSection;
-        fs.writeFileSync(gitignorePath, updatedContent);
-        logger.log(`✅ Added Story UI generated directory to .gitignore: ${generatedPath}`);
-    }
-    /**
-     * Generates the gitignore section for Story UI
-     */
-    generateGitignoreSection(generatedPath) {
-        return `# Story UI - AI Generated Stories (ephemeral, not for version control)
-# These are temporary stories for testing layouts and should not be committed
-${generatedPath}/
-${generatedPath}/**`;
-    }
-    /**
-     * Creates a README in the generated directory explaining its purpose (development only)
-     */
-    createGeneratedDirectoryReadme() {
-        const generatedDir = this.config.generatedStoriesPath;
-        const readmePath = path.join(generatedDir, 'README.md');
-        if (fs.existsSync(readmePath)) {
-            return; // Don't overwrite existing README
-        }
-        const readmeContent = `# AI Generated Stories
-
-This directory contains stories generated by Story UI for testing and iteration purposes.
-
-## ⚠️ Important Notes
-
-- **These stories are ephemeral** - they are meant for testing layouts and sharing with stakeholders
-- **Do not commit these files** - they are automatically ignored by git
-- **Stories are regenerated** - feel free to delete and regenerate as needed
-
-## Purpose
-
-These stories are designed for:
-- 🎨 **Layout Testing** - Test different component arrangements
-- 👥 **Stakeholder Review** - Share layouts with product owners, designers, and project managers
-- 🔄 **Rapid Iteration** - Quickly generate and modify layouts
-- 📱 **Design Validation** - Validate designs before implementation
-
-## Usage
-
-Stories in this directory will appear in Storybook under the "${this.config.storyPrefix}" section.
-
-Generated by [Story UI](https://github.com/your-org/story-ui) - AI-powered Storybook story generator.
-`;
-        try {
-            fs.writeFileSync(readmePath, readmeContent);
-            logger.log(`✅ Created README in generated directory`);
-        }
-        catch (error) {
-            console.warn('⚠️  Could not create README in generated directory');
-        }
-    }
-    /**
-     * Cleans up old generated stories (safe for both environments)
-     */
-    cleanupOldStories(maxAge = 7 * 24 * 60 * 60 * 1000) {
-        const directories = [
-            this.config.generatedStoriesPath,
-            this.isProduction ? this.getProductionTempDirectory() : null
-        ].filter(Boolean);
-        for (const dir of directories) {
-            if (!dir || !fs.existsSync(dir))
-                continue;
-            try {
-                const files = fs.readdirSync(dir);
-                const now = Date.now();
-                let cleanedCount = 0;
-                for (const file of files) {
-                    if (!file.endsWith('.stories.tsx'))
-                        continue;
-                    const filePath = path.join(dir, file);
-                    const stats = fs.statSync(filePath);
-                    const age = now - stats.mtime.getTime();
-                    if (age > maxAge) {
-                        fs.unlinkSync(filePath);
-                        cleanedCount++;
-                    }
-                }
-                if (cleanedCount > 0) {
-                    logger.log(`🧹 Cleaned up ${cleanedCount} old generated stories from ${dir}`);
-                }
-            }
-            catch (error) {
-                console.warn(`⚠️  Could not clean up stories in ${dir}`);
-            }
-        }
-    }
-    /**
-     * Gets the appropriate directory for story generation based on environment
-     */
-    getStoryGenerationPath() {
-        if (this.isProduction) {
-            try {
-                return this.getProductionTempDirectory();
-            }
-            catch {
-                // Fallback to in-memory only
-                return '';
-            }
-        }
-        return this.config.generatedStoriesPath;
-    }
-    /**
-     * Checks if we're in production mode
-     */
-    isProductionMode() {
-        return this.isProduction;
-    }
-}
-/**
- * Convenience function to set up gitignore for Story UI (production-ready)
- */
-export function setupProductionGitignore(config, projectRoot) {
-    const manager = new ProductionGitignoreManager(config, projectRoot);
-    manager.setupGitignoreIntegration();
-    return manager;
-}

package/dist/story-generator/storySync.d.ts

@@ -1,68 +0,0 @@
-import { StoryUIConfig } from '../story-ui.config.js';
-/**
- * Story synchronization service that keeps chat interface, file system, and memory in sync
- */
-export declare class StorySyncService {
-    private config;
-    private isProduction;
-    constructor(config: StoryUIConfig);
-    /**
-     * Gets all available stories from both file system and memory
-     */
-    getAllStories(): Promise<SyncedStory[]>;
-    /**
-     * Gets stories from the file system
-     */
-    private getFileSystemStories;
-    /**
-     * Deletes a story from both file system and memory
-     */
-    deleteStory(storyId: string): Promise<boolean>;
-    /**
-     * Gets a specific story by ID
-     */
-    getStory(storyId: string): Promise<SyncedStory | null>;
-    /**
-     * Clears all stories
-     */
-    clearAllStories(): Promise<void>;
-    /**
-     * Syncs localStorage chat history with actual stories
-     */
-    syncChatHistory(): Promise<ChatSyncResult>;
-    /**
-     * Validates that a chat session corresponds to an actual story
-     */
-    validateChatSession(chatId: string): Promise<boolean>;
-}
-/**
- * Synced story interface that combines file system and memory stories
- */
-export interface SyncedStory {
-    id: string;
-    title: string;
-    fileName: string;
-    description: string;
-    createdAt: Date;
-    lastAccessed: Date;
-    source: 'filesystem' | 'memory';
-    content: string;
-    prompt?: string;
-}
-/**
- * Chat synchronization result
- */
-export interface ChatSyncResult {
-    actualStories: {
-        id: string;
-        title: string;
-        fileName: string;
-        lastUpdated: number;
-    }[];
-    shouldClearOrphanedChats: boolean;
-}
-/**
- * Gets or creates the global story sync service
- */
-export declare function getStorySyncService(config: StoryUIConfig): StorySyncService;
-//# sourceMappingURL=storySync.d.ts.map

package/dist/story-generator/storySync.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"storySync.d.ts","sourceRoot":"","sources":["../../story-generator/storySync.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAItD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,YAAY,CAAU;gBAElB,MAAM,EAAE,aAAa;IAMjC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IA4C7C;;OAEG;YACW,oBAAoB;IA0DlC;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA8BpD;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAK5D;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBtC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,cAAc,CAAC;IAehD;;OAEG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAI5D;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,EAAE,IAAI,CAAC;IACnB,MAAM,EAAE,YAAY,GAAG,QAAQ,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE;QACb,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;KACrB,EAAE,CAAC;IACJ,wBAAwB,EAAE,OAAO,CAAC;CACnC;AAOD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,CAK3E"}

package/dist/story-generator/storySync.js

@@ -1,201 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-import { getInMemoryStoryService } from './inMemoryStoryService.js';
-import { setupProductionGitignore } from './productionGitignoreManager.js';
-/**
- * Story synchronization service that keeps chat interface, file system, and memory in sync
- */
-export class StorySyncService {
-    constructor(config) {
-        this.config = config;
-        const gitignoreManager = setupProductionGitignore(config);
-        this.isProduction = gitignoreManager.isProductionMode();
-    }
-    /**
-     * Gets all available stories from both file system and memory
-     */
-    async getAllStories() {
-        const stories = [];
-        if (this.isProduction) {
-            // Production: Get from memory
-            const memoryService = getInMemoryStoryService(this.config);
-            const memoryStories = memoryService.getAllStories();
-            stories.push(...memoryStories.map(story => ({
-                id: story.id,
-                title: story.title,
-                fileName: `${story.id}.stories.tsx`,
-                description: story.description,
-                createdAt: story.createdAt,
-                lastAccessed: story.lastAccessed,
-                source: 'memory',
-                content: story.content,
-                prompt: story.prompt
-            })));
-        }
-        else {
-            // Development: Get from file system
-            const fileSystemStories = await this.getFileSystemStories();
-            stories.push(...fileSystemStories);
-            // Also include any memory stories (for hybrid scenarios)
-            const memoryService = getInMemoryStoryService(this.config);
-            const memoryStories = memoryService.getAllStories();
-            stories.push(...memoryStories.map(story => ({
-                id: story.id,
-                title: story.title,
-                fileName: `${story.id}.stories.tsx`,
-                description: story.description,
-                createdAt: story.createdAt,
-                lastAccessed: story.lastAccessed,
-                source: 'memory',
-                content: story.content,
-                prompt: story.prompt
-            })));
-        }
-        // Sort by creation date (newest first)
-        return stories.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
-    }
-    /**
-     * Gets stories from the file system
-     */
-    async getFileSystemStories() {
-        const stories = [];
-        if (!fs.existsSync(this.config.generatedStoriesPath)) {
-            return stories;
-        }
-        const files = fs.readdirSync(this.config.generatedStoriesPath);
-        const storyFiles = files.filter(file => file.endsWith('.stories.tsx'));
-        for (const file of storyFiles) {
-            try {
-                const filePath = path.join(this.config.generatedStoriesPath, file);
-                const stats = fs.statSync(filePath);
-                const content = fs.readFileSync(filePath, 'utf-8');
-                // Extract title from file content - handle escaped quotes more robustly
-                let title = file.replace('.stories.tsx', ''); // fallback
-                // Find the title line - look for the pattern and extract until the closing quote + comma
-                const titleStart = content.indexOf("title: '");
-                if (titleStart !== -1) {
-                    const startPos = titleStart + "title: '".length;
-                    const endPos = content.indexOf("',", startPos);
-                    if (endPos !== -1) {
-                        title = content.substring(startPos, endPos);
-                    }
-                }
-                // Remove the story prefix and unescape characters
-                title = title
-                    .replace(this.config.storyPrefix, '')
-                    .replace(/\\"/g, '"')
-                    .replace(/\\'/g, "'")
-                    .replace(/\\\\/g, '\\');
-                // Generate ID from filename
-                const id = file.replace('.stories.tsx', '');
-                stories.push({
-                    id,
-                    title,
-                    fileName: file,
-                    description: `Generated story: ${title}`,
-                    createdAt: stats.birthtime,
-                    lastAccessed: stats.atime,
-                    source: 'filesystem',
-                    content,
-                    prompt: undefined
-                });
-            }
-            catch (error) {
-                console.warn(`Failed to read story file ${file}:`, error);
-            }
-        }
-        return stories;
-    }
-    /**
-     * Deletes a story from both file system and memory
-     */
-    async deleteStory(storyId) {
-        let deleted = false;
-        // Delete from memory
-        const memoryService = getInMemoryStoryService(this.config);
-        if (memoryService.deleteStory(storyId)) {
-            deleted = true;
-        }
-        // Delete from file system (if not production)
-        if (!this.isProduction) {
-            const files = fs.readdirSync(this.config.generatedStoriesPath);
-            const matchingFiles = files.filter(file => file.includes(storyId) || file.startsWith(storyId));
-            for (const file of matchingFiles) {
-                try {
-                    const filePath = path.join(this.config.generatedStoriesPath, file);
-                    fs.unlinkSync(filePath);
-                    deleted = true;
-                }
-                catch (error) {
-                    console.warn(`Failed to delete story file ${file}:`, error);
-                }
-            }
-        }
-        return deleted;
-    }
-    /**
-     * Gets a specific story by ID
-     */
-    async getStory(storyId) {
-        const allStories = await this.getAllStories();
-        return allStories.find(story => story.id === storyId) || null;
-    }
-    /**
-     * Clears all stories
-     */
-    async clearAllStories() {
-        // Clear memory
-        const memoryService = getInMemoryStoryService(this.config);
-        memoryService.clearAllStories();
-        // Clear file system (if not production)
-        if (!this.isProduction && fs.existsSync(this.config.generatedStoriesPath)) {
-            const files = fs.readdirSync(this.config.generatedStoriesPath);
-            const storyFiles = files.filter(file => file.endsWith('.stories.tsx'));
-            for (const file of storyFiles) {
-                try {
-                    const filePath = path.join(this.config.generatedStoriesPath, file);
-                    fs.unlinkSync(filePath);
-                }
-                catch (error) {
-                    console.warn(`Failed to delete story file ${file}:`, error);
-                }
-            }
-        }
-    }
-    /**
-     * Syncs localStorage chat history with actual stories
-     */
-    async syncChatHistory() {
-        const actualStories = await this.getAllStories();
-        // This would be called from the frontend to sync localStorage
-        return {
-            actualStories: actualStories.map(story => ({
-                id: story.id,
-                title: story.title,
-                fileName: story.fileName,
-                lastUpdated: story.createdAt.getTime()
-            })),
-            shouldClearOrphanedChats: true
-        };
-    }
-    /**
-     * Validates that a chat session corresponds to an actual story
-     */
-    async validateChatSession(chatId) {
-        const story = await this.getStory(chatId);
-        return story !== null;
-    }
-}
-/**
- * Global story sync service instance
- */
-let globalStorySyncService = null;
-/**
- * Gets or creates the global story sync service
- */
-export function getStorySyncService(config) {
-    if (!globalStorySyncService) {
-        globalStorySyncService = new StorySyncService(config);
-    }
-    return globalStorySyncService;
-}