@tpitre/story-ui 3.3.0 → 3.4.0

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

@@ -0,0 +1,56 @@
+import type { IStoryService, GeneratedStory, StoryMetadata, StorageStats } from './storyServiceInterface.js';
+/**
+ * PostgreSQL Story Service
+ * Persistent story storage using PostgreSQL database
+ * Designed for Railway PostgreSQL deployments
+ */
+export declare class PostgresStoryService implements IStoryService {
+    private pool;
+    private initialized;
+    constructor(connectionString: string);
+    /**
+     * Initialize database schema
+     */
+    initialize(): Promise<void>;
+    /**
+     * Store a generated story
+     */
+    storeStory(story: GeneratedStory): Promise<void>;
+    /**
+     * Retrieve a story by ID
+     */
+    getStory(id: string): Promise<GeneratedStory | null>;
+    /**
+     * Get all stored stories
+     */
+    getAllStories(): Promise<GeneratedStory[]>;
+    /**
+     * Delete a story by ID
+     */
+    deleteStory(id: string): Promise<boolean>;
+    /**
+     * Clear all stories
+     */
+    clearAllStories(): Promise<void>;
+    /**
+     * Get story content for Storybook integration
+     */
+    getStoryContent(id: string): Promise<string | null>;
+    /**
+     * Get story metadata for listing
+     */
+    getStoryMetadata(): Promise<StoryMetadata[]>;
+    /**
+     * Get storage usage statistics
+     */
+    getStorageStats(): Promise<StorageStats>;
+    /**
+     * Count unique components in story content
+     */
+    private countComponents;
+    /**
+     * Close the connection pool
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=postgresStoryService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgresStoryService.d.ts","sourceRoot":"","sources":["../../story-generator/postgresStoryService.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI7G;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IACxD,OAAO,CAAC,IAAI,CAAU;IACtB,OAAO,CAAC,WAAW,CAAkB;gBAEzB,gBAAgB,EAAE,MAAM;IAUpC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BjC;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCtD;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAiC1D;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IA0BhD;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB/C;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtC;;OAEG;IACG,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKzD;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAwBlD;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC;IA4B9C;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/story-generator/postgresStoryService.js

@@ -0,0 +1,240 @@
+import pg from 'pg';
+const { Pool } = pg;
+/**
+ * PostgreSQL Story Service
+ * Persistent story storage using PostgreSQL database
+ * Designed for Railway PostgreSQL deployments
+ */
+export class PostgresStoryService {
+    constructor(connectionString) {
+        this.initialized = false;
+        this.pool = new Pool({
+            connectionString,
+            ssl: process.env.NODE_ENV === 'production' ? { rejectUnauthorized: false } : false,
+            max: 10,
+            idleTimeoutMillis: 30000,
+            connectionTimeoutMillis: 10000,
+        });
+    }
+    /**
+     * Initialize database schema
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        const client = await this.pool.connect();
+        try {
+            await client.query(`
+        CREATE TABLE IF NOT EXISTS stories (
+          id VARCHAR(255) PRIMARY KEY,
+          title VARCHAR(500) NOT NULL,
+          description TEXT,
+          content TEXT NOT NULL,
+          prompt TEXT,
+          components TEXT[],
+          created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+          last_accessed TIMESTAMP WITH TIME ZONE DEFAULT NOW()
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_stories_created_at ON stories(created_at DESC);
+        CREATE INDEX IF NOT EXISTS idx_stories_last_accessed ON stories(last_accessed DESC);
+      `);
+            this.initialized = true;
+            console.log('✅ PostgreSQL story service initialized');
+        }
+        finally {
+            client.release();
+        }
+    }
+    /**
+     * Store a generated story
+     */
+    async storeStory(story) {
+        await this.initialize();
+        const client = await this.pool.connect();
+        try {
+            await client.query(`INSERT INTO stories (id, title, description, content, prompt, components, created_at, last_accessed)
+         VALUES ($1, $2, $3, $4, $5, $6, $7, $8)
+         ON CONFLICT (id) DO UPDATE SET
+           title = EXCLUDED.title,
+           description = EXCLUDED.description,
+           content = EXCLUDED.content,
+           prompt = EXCLUDED.prompt,
+           components = EXCLUDED.components,
+           last_accessed = EXCLUDED.last_accessed`, [
+                story.id,
+                story.title,
+                story.description,
+                story.content,
+                story.prompt || null,
+                story.components || [],
+                story.createdAt || new Date(),
+                new Date()
+            ]);
+            console.log(`✅ Stored story in PostgreSQL: ${story.id}`);
+        }
+        finally {
+            client.release();
+        }
+    }
+    /**
+     * Retrieve a story by ID
+     */
+    async getStory(id) {
+        await this.initialize();
+        const client = await this.pool.connect();
+        try {
+            // Update last_accessed and return the story
+            const result = await client.query(`UPDATE stories SET last_accessed = NOW()
+         WHERE id = $1
+         RETURNING id, title, description, content, prompt, components, created_at, last_accessed`, [id]);
+            if (result.rows.length === 0) {
+                return null;
+            }
+            const row = result.rows[0];
+            return {
+                id: row.id,
+                title: row.title,
+                description: row.description,
+                content: row.content,
+                prompt: row.prompt,
+                components: row.components || [],
+                createdAt: new Date(row.created_at),
+                lastAccessed: new Date(row.last_accessed)
+            };
+        }
+        finally {
+            client.release();
+        }
+    }
+    /**
+     * Get all stored stories
+     */
+    async getAllStories() {
+        await this.initialize();
+        const client = await this.pool.connect();
+        try {
+            const result = await client.query(`SELECT id, title, description, content, prompt, components, created_at, last_accessed
+         FROM stories
+         ORDER BY created_at DESC`);
+            return result.rows.map(row => ({
+                id: row.id,
+                title: row.title,
+                description: row.description,
+                content: row.content,
+                prompt: row.prompt,
+                components: row.components || [],
+                createdAt: new Date(row.created_at),
+                lastAccessed: new Date(row.last_accessed)
+            }));
+        }
+        finally {
+            client.release();
+        }
+    }
+    /**
+     * Delete a story by ID
+     */
+    async deleteStory(id) {
+        await this.initialize();
+        const client = await this.pool.connect();
+        try {
+            const result = await client.query(`DELETE FROM stories WHERE id = $1 RETURNING id`, [id]);
+            const deleted = result.rowCount !== null && result.rowCount > 0;
+            if (deleted) {
+                console.log(`✅ Deleted story from PostgreSQL: ${id}`);
+            }
+            return deleted;
+        }
+        finally {
+            client.release();
+        }
+    }
+    /**
+     * Clear all stories
+     */
+    async clearAllStories() {
+        await this.initialize();
+        const client = await this.pool.connect();
+        try {
+            await client.query('TRUNCATE TABLE stories');
+            console.log('✅ Cleared all stories from PostgreSQL');
+        }
+        finally {
+            client.release();
+        }
+    }
+    /**
+     * Get story content for Storybook integration
+     */
+    async getStoryContent(id) {
+        const story = await this.getStory(id);
+        return story ? story.content : null;
+    }
+    /**
+     * Get story metadata for listing
+     */
+    async getStoryMetadata() {
+        await this.initialize();
+        const client = await this.pool.connect();
+        try {
+            const result = await client.query(`SELECT id, title, description, content, created_at, last_accessed
+         FROM stories
+         ORDER BY created_at DESC`);
+            return result.rows.map(row => ({
+                id: row.id,
+                title: row.title,
+                description: row.description,
+                createdAt: new Date(row.created_at),
+                lastAccessed: new Date(row.last_accessed),
+                componentCount: this.countComponents(row.content)
+            }));
+        }
+        finally {
+            client.release();
+        }
+    }
+    /**
+     * Get storage usage statistics
+     */
+    async getStorageStats() {
+        await this.initialize();
+        const client = await this.pool.connect();
+        try {
+            const result = await client.query(`
+        SELECT
+          COUNT(*)::int as story_count,
+          COALESCE(SUM(LENGTH(content)), 0)::bigint as total_size,
+          COALESCE(AVG(LENGTH(content)), 0)::int as avg_size,
+          MIN(created_at) as oldest,
+          MAX(created_at) as newest
+        FROM stories
+      `);
+            const row = result.rows[0];
+            return {
+                storyCount: row.story_count,
+                totalSizeBytes: parseInt(row.total_size) || 0,
+                averageSizeBytes: row.avg_size || 0,
+                oldestStory: row.oldest ? new Date(row.oldest) : null,
+                newestStory: row.newest ? new Date(row.newest) : null
+            };
+        }
+        finally {
+            client.release();
+        }
+    }
+    /**
+     * Count unique components in story content
+     */
+    countComponents(content) {
+        const componentMatches = content.match(/<[A-Z][A-Za-z0-9]*\s/g);
+        return componentMatches ? new Set(componentMatches).size : 0;
+    }
+    /**
+     * Close the connection pool
+     */
+    async close() {
+        await this.pool.end();
+        console.log('PostgreSQL connection pool closed');
+    }
+}

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

@@ -0,0 +1,91 @@
+import { StoryUIConfig } from '../story-ui.config.js';
+/**
+ * Production-ready gitignore manager that handles both development and server environments
+ */
+export declare class ProductionGitignoreManager {
+    private config;
+    private projectRoot;
+    private isProduction;
+    constructor(config: StoryUIConfig, projectRoot?: string);
+    /**
+     * Detects if we're running in a production/read-only environment
+     */
+    private detectProductionEnvironment;
+    /**
+     * Tests if we can write to the project root
+     */
+    private canWriteToProjectRoot;
+    /**
+     * Main setup method that adapts to environment
+     */
+    setupGitignoreIntegration(): void;
+    /**
+     * Production environment: Use in-memory story generation
+     */
+    private handleProductionEnvironment;
+    /**
+     * Development environment: Full gitignore management
+     */
+    private handleDevelopmentEnvironment;
+    /**
+     * Validates that production environment is properly configured
+     */
+    private validateProductionSetup;
+    /**
+     * Sets up temporary directory for production story generation
+     */
+    private setupTemporaryDirectory;
+    /**
+     * Gets a writable temporary directory for production
+     */
+    getProductionTempDirectory(): string;
+    /**
+     * Creates the generated directory if it doesn't exist (development only)
+     */
+    private ensureGeneratedDirectoryExists;
+    /**
+     * Ensures the generated stories directory is added to .gitignore (development only)
+     */
+    private ensureGeneratedDirectoryIgnored;
+    /**
+     * Gets the relative path from project root to generated stories directory
+     */
+    private getRelativeGeneratedPath;
+    /**
+     * Creates a new .gitignore file with Story UI section
+     */
+    private createGitignore;
+    /**
+     * Checks if the generated path is already ignored
+     */
+    private isPathIgnored;
+    /**
+     * Adds ignore rule to existing .gitignore
+     */
+    private addIgnoreRule;
+    /**
+     * Generates the gitignore section for Story UI
+     */
+    private generateGitignoreSection;
+    /**
+     * Creates a README in the generated directory explaining its purpose (development only)
+     */
+    private createGeneratedDirectoryReadme;
+    /**
+     * Cleans up old generated stories (safe for both environments)
+     */
+    cleanupOldStories(maxAge?: number): void;
+    /**
+     * Gets the appropriate directory for story generation based on environment
+     */
+    getStoryGenerationPath(): string;
+    /**
+     * Checks if we're in production mode
+     */
+    isProductionMode(): boolean;
+}
+/**
+ * Convenience function to set up gitignore for Story UI (production-ready)
+ */
+export declare function setupProductionGitignore(config: StoryUIConfig, projectRoot?: string): ProductionGitignoreManager;
+//# sourceMappingURL=productionGitignoreManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"productionGitignoreManager.d.ts","sourceRoot":"","sources":["../../story-generator/productionGitignoreManager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;GAEG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAU;gBAElB,MAAM,EAAE,aAAa,EAAE,WAAW,GAAE,MAAsB;IAMtE;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAuBnC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAW7B;;OAEG;IACH,yBAAyB,IAAI,IAAI;IAQjC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAUnC;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAQpC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAmB/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAY/B;;OAEG;IACH,0BAA0B,IAAI,MAAM;IAuBpC;;OAEG;IACH,OAAO,CAAC,8BAA8B;IAStC;;OAEG;IACH,OAAO,CAAC,+BAA+B;IA0BvC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAmBhC;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAOhC;;OAEG;IACH,OAAO,CAAC,8BAA8B;IAyCtC;;OAEG;IACH,iBAAiB,CAAC,MAAM,GAAE,MAAgC,GAAG,IAAI;IAoCjE;;OAEG;IACH,sBAAsB,IAAI,MAAM;IAYhC;;OAEG;IACH,gBAAgB,IAAI,OAAO;CAG5B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,0BAA0B,CAIhH"}