@t1mmen/srtd 0.0.0-next-20251227000343

package/dist/services/FileSystemService.js

@@ -0,0 +1,237 @@
+/**
+ * FileSystemService - Handles all file system operations for templates
+ * Decoupled from business logic, only handles raw file operations
+ */
+import crypto from 'node:crypto';
+import { EventEmitter } from 'node:events';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { glob } from 'glob';
+export class FileSystemService extends EventEmitter {
+    config;
+    watcher = null;
+    debouncedHandlers = new Map();
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    /**
+     * Find all template files matching the configured pattern
+     */
+    async findTemplates() {
+        const templatePath = path.join(this.config.baseDir, this.config.templateDir, this.config.filter);
+        const matches = await glob(templatePath);
+        return matches.sort(); // Ensure consistent ordering
+    }
+    /**
+     * Read a template file and return its content with metadata
+     */
+    async readTemplate(templatePath) {
+        try {
+            const content = await fs.readFile(templatePath, 'utf-8');
+            const hash = this.calculateHash(content);
+            const name = path.basename(templatePath, '.sql');
+            const relativePath = path.relative(this.config.baseDir, templatePath);
+            return {
+                path: templatePath,
+                name,
+                content,
+                hash,
+                relativePath,
+            };
+        }
+        catch (error) {
+            if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+                throw new Error(`Template file not found: ${templatePath}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Check if a file exists
+     */
+    async fileExists(filePath) {
+        try {
+            await fs.stat(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Write content to a file
+     */
+    async writeFile(filePath, content) {
+        const dir = path.dirname(filePath);
+        await fs.mkdir(dir, { recursive: true });
+        await fs.writeFile(filePath, content, 'utf-8');
+    }
+    /**
+     * Delete a file
+     */
+    async deleteFile(filePath) {
+        try {
+            await fs.unlink(filePath);
+        }
+        catch (error) {
+            if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+                // File doesn't exist, ignore
+                return;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Rename a file
+     */
+    async renameFile(oldPath, newPath) {
+        await fs.rename(oldPath, newPath);
+    }
+    /**
+     * Get file stats
+     */
+    async getFileStats(filePath) {
+        return fs.stat(filePath);
+    }
+    /**
+     * Calculate MD5 hash of content
+     */
+    calculateHash(content) {
+        return crypto.createHash('md5').update(content).digest('hex');
+    }
+    /**
+     * Watch templates for changes
+     */
+    async watchTemplates() {
+        if (this.watcher) {
+            throw new Error('Already watching templates');
+        }
+        const chokidar = await import('chokidar');
+        const templatePath = path.join(this.config.baseDir, this.config.templateDir);
+        const watchOptions = {
+            ignoreInitial: this.config.watchOptions?.ignoreInitial ?? false,
+            ignored: ['**/!(*.sql)'],
+            persistent: true,
+            awaitWriteFinish: {
+                stabilityThreshold: this.config.watchOptions?.stabilityThreshold ?? 200,
+                pollInterval: this.config.watchOptions?.pollInterval ?? 100,
+            },
+        };
+        this.watcher = chokidar.watch(templatePath, watchOptions);
+        // Handle initial files if not ignoring
+        if (!watchOptions.ignoreInitial) {
+            const existingFiles = await this.findTemplates();
+            for (const file of existingFiles) {
+                this.emitWatchEvent('added', file);
+            }
+        }
+        // Set up event handlers with debouncing
+        this.watcher
+            .on('add', (filepath) => {
+            if (path.extname(filepath) === '.sql') {
+                this.debouncedEmit('added', filepath);
+            }
+        })
+            .on('change', (filepath) => {
+            if (path.extname(filepath) === '.sql') {
+                this.debouncedEmit('changed', filepath);
+            }
+        })
+            .on('unlink', (filepath) => {
+            if (path.extname(filepath) === '.sql') {
+                this.debouncedEmit('removed', filepath);
+            }
+        })
+            .on('error', (error) => {
+            this.emit('error', error instanceof Error ? error : new Error(String(error)));
+        });
+    }
+    /**
+     * Stop watching templates
+     */
+    async stopWatching() {
+        // Clear any pending debounced handlers
+        for (const timer of this.debouncedHandlers.values()) {
+            clearTimeout(timer);
+        }
+        this.debouncedHandlers.clear();
+        if (this.watcher) {
+            await this.watcher.close();
+            this.watcher = null;
+        }
+    }
+    /**
+     * Emit watch event with debouncing
+     */
+    debouncedEmit(type, filepath) {
+        const key = `${type}:${filepath}`;
+        // Clear existing timer for this event
+        const existingTimer = this.debouncedHandlers.get(key);
+        if (existingTimer) {
+            clearTimeout(existingTimer);
+        }
+        // Set new timer
+        const timer = setTimeout(() => {
+            this.emitWatchEvent(type, filepath);
+            this.debouncedHandlers.delete(key);
+        }, 100);
+        this.debouncedHandlers.set(key, timer);
+    }
+    /**
+     * Emit a watch event
+     */
+    emitWatchEvent(type, filepath) {
+        const relativePath = path.relative(this.config.baseDir, filepath);
+        const name = path.basename(filepath, '.sql');
+        const event = {
+            type,
+            path: filepath,
+            relativePath,
+            name,
+        };
+        // Emit specific event types
+        switch (type) {
+            case 'added':
+                this.emit('template:added', event);
+                break;
+            case 'changed':
+                this.emit('template:changed', event);
+                break;
+            case 'removed':
+                this.emit('template:removed', event);
+                break;
+        }
+        // Also emit generic event
+        this.emit('template:event', event);
+    }
+    /**
+     * Clean up resources
+     */
+    async dispose() {
+        await this.stopWatching();
+        this.removeAllListeners();
+    }
+    /**
+     * Get migration file path for a template
+     */
+    getMigrationPath(templateName, timestamp) {
+        const migrationName = `${timestamp}_${templateName}.sql`;
+        return path.join(this.config.baseDir, this.config.migrationDir, migrationName);
+    }
+    /**
+     * List all migration files
+     */
+    async listMigrations() {
+        const migrationPath = path.join(this.config.baseDir, this.config.migrationDir, '*.sql');
+        const matches = await glob(migrationPath);
+        return matches.sort(); // Ensure chronological order
+    }
+    /**
+     * Read a migration file
+     */
+    async readMigration(migrationPath) {
+        return fs.readFile(migrationPath, 'utf-8');
+    }
+}
+//# sourceMappingURL=FileSystemService.js.map

package/dist/services/FileSystemService.js.map

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

package/dist/services/MigrationBuilder.d.ts

@@ -0,0 +1,106 @@
+/**
+ * MigrationBuilder Service - Generates Supabase migration files from templates
+ * Pure service that takes template content and metadata and produces formatted migration files
+ */
+import type { BuildLog, CLIConfig } from '../types.js';
+export interface TemplateMetadata {
+    name: string;
+    templatePath: string;
+    relativePath: string;
+    content: string;
+    hash: string;
+    lastBuildAt?: string;
+}
+export interface MigrationOptions {
+    force?: boolean;
+    wrapInTransaction?: boolean;
+    bundleMode?: boolean;
+    templateName?: string;
+}
+export interface MigrationResult {
+    fileName: string;
+    filePath: string;
+    content: string;
+    timestamp: string;
+}
+export interface BundleMigrationResult {
+    fileName: string;
+    filePath: string;
+    content: string;
+    timestamp: string;
+    includedTemplates: string[];
+}
+export interface MigrationBuilderConfig {
+    baseDir: string;
+    templateDir: string;
+    migrationDir: string;
+    migrationPrefix?: string;
+    banner?: string;
+    footer?: string;
+    wrapInTransaction?: boolean;
+}
+export declare class MigrationBuilder {
+    private config;
+    constructor(config: MigrationBuilderConfig);
+    /**
+     * Generate a migration file from a single template
+     */
+    generateMigration(template: TemplateMetadata, buildLog: BuildLog, options?: MigrationOptions): Promise<MigrationResult>;
+    /**
+     * Generate a bundled migration file from multiple templates
+     */
+    generateBundledMigration(templates: TemplateMetadata[], buildLog: BuildLog, options?: MigrationOptions): Promise<BundleMigrationResult>;
+    /**
+     * Format migration content with headers, footers, and transaction wrapping
+     */
+    private formatMigrationContent;
+    /**
+     * Create MigrationBuilder from CLI config
+     */
+    static fromConfig(config: CLIConfig, baseDir: string): MigrationBuilder;
+    /**
+     * Generate migration file path for a template
+     */
+    getMigrationPath(templateName: string, timestamp: string): string;
+    /**
+     * Generate absolute migration file path for a template
+     */
+    getAbsoluteMigrationPath(templateName: string, timestamp: string): string;
+    /**
+     * Validate migration configuration
+     */
+    validateConfig(): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Write migration file to disk
+     */
+    writeMigration(migrationResult: MigrationResult): Promise<string>;
+    /**
+     * Write bundled migration file to disk
+     */
+    writeBundledMigration(migrationResult: BundleMigrationResult): Promise<string>;
+    /**
+     * Generate and write migration file in one operation
+     */
+    generateAndWriteMigration(template: TemplateMetadata, buildLog: BuildLog, options?: MigrationOptions): Promise<{
+        result: MigrationResult;
+        filePath: string;
+    }>;
+    /**
+     * Generate and write bundled migration file in one operation
+     */
+    generateAndWriteBundledMigration(templates: TemplateMetadata[], buildLog: BuildLog, options?: MigrationOptions): Promise<{
+        result: BundleMigrationResult;
+        filePath: string;
+    }>;
+    /**
+     * Check if migration file already exists
+     */
+    migrationExists(fileName: string): Promise<boolean>;
+    /**
+     * Get current configuration
+     */
+    getConfig(): Readonly<MigrationBuilderConfig>;
+}

package/dist/services/MigrationBuilder.js

@@ -0,0 +1,193 @@
+/**
+ * MigrationBuilder Service - Generates Supabase migration files from templates
+ * Pure service that takes template content and metadata and produces formatted migration files
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { getNextTimestamp } from '../utils/getNextTimestamp.js';
+export class MigrationBuilder {
+    config;
+    constructor(config) {
+        this.config = {
+            migrationPrefix: '',
+            banner: '',
+            footer: '',
+            wrapInTransaction: true,
+            ...config,
+        };
+    }
+    /**
+     * Generate a migration file from a single template
+     */
+    async generateMigration(template, buildLog, options = {}) {
+        const timestamp = await getNextTimestamp(buildLog);
+        const prefix = this.config.migrationPrefix ? `${this.config.migrationPrefix}-` : '';
+        const fileName = `${timestamp}_${prefix}${template.name}.sql`;
+        const filePath = path.join(this.config.migrationDir, fileName);
+        const content = this.formatMigrationContent(template, {
+            isBundled: false,
+            ...options,
+        });
+        return {
+            fileName,
+            filePath,
+            content,
+            timestamp,
+        };
+    }
+    /**
+     * Generate a bundled migration file from multiple templates
+     */
+    async generateBundledMigration(templates, buildLog, options = {}) {
+        const timestamp = await getNextTimestamp(buildLog);
+        const prefix = this.config.migrationPrefix ? `${this.config.migrationPrefix}-` : '';
+        const fileName = `${timestamp}_${prefix}bundle.sql`;
+        const filePath = path.join(this.config.migrationDir, fileName);
+        let content = '';
+        const includedTemplates = [];
+        for (const template of templates) {
+            const templateContent = this.formatMigrationContent(template, {
+                isBundled: true,
+                ...options,
+            });
+            content += `${templateContent}\n\n`;
+            includedTemplates.push(template.name);
+        }
+        return {
+            fileName,
+            filePath,
+            content: content.trim(),
+            timestamp,
+            includedTemplates,
+        };
+    }
+    /**
+     * Format migration content with headers, footers, and transaction wrapping
+     */
+    formatMigrationContent(template, options = {}) {
+        const { isBundled = false, wrapInTransaction = this.config.wrapInTransaction } = options;
+        // Generate header
+        const headerPrefix = isBundled ? 'Template' : 'Generated with srtd from template';
+        const header = `-- ${headerPrefix}: ${this.config.templateDir}/${template.name}.sql\n`;
+        // Generate banner
+        const banner = this.config.banner ? `-- ${this.config.banner}\n` : '\n';
+        // Generate footer
+        const lastBuildInfo = template.lastBuildAt || 'Never';
+        const footerText = this.config.footer ? `${this.config.footer}\n` : '';
+        const footer = `${footerText}-- Last built: ${lastBuildInfo}\n-- Built with https://github.com/t1mmen/srtd\n`;
+        // Wrap content in transaction if needed
+        const safeContent = wrapInTransaction
+            ? `BEGIN;\n\n${template.content}\n\nCOMMIT;`
+            : template.content;
+        // Assemble final content
+        return `${header}${banner}\n${safeContent}\n${footer}`;
+    }
+    /**
+     * Create MigrationBuilder from CLI config
+     */
+    static fromConfig(config, baseDir) {
+        return new MigrationBuilder({
+            baseDir,
+            templateDir: config.templateDir,
+            migrationDir: config.migrationDir,
+            migrationPrefix: config.migrationPrefix,
+            banner: config.banner,
+            footer: config.footer,
+            wrapInTransaction: config.wrapInTransaction,
+        });
+    }
+    /**
+     * Generate migration file path for a template
+     */
+    getMigrationPath(templateName, timestamp) {
+        const prefix = this.config.migrationPrefix ? `${this.config.migrationPrefix}-` : '';
+        const fileName = `${timestamp}_${prefix}${templateName}.sql`;
+        return path.join(this.config.migrationDir, fileName);
+    }
+    /**
+     * Generate absolute migration file path for a template
+     */
+    getAbsoluteMigrationPath(templateName, timestamp) {
+        const migrationPath = this.getMigrationPath(templateName, timestamp);
+        return path.resolve(this.config.baseDir, migrationPath);
+    }
+    /**
+     * Validate migration configuration
+     */
+    validateConfig() {
+        const errors = [];
+        if (!this.config.baseDir) {
+            errors.push('baseDir is required');
+        }
+        if (!this.config.templateDir) {
+            errors.push('templateDir is required');
+        }
+        if (!this.config.migrationDir) {
+            errors.push('migrationDir is required');
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    /**
+     * Write migration file to disk
+     */
+    async writeMigration(migrationResult) {
+        const fullPath = path.resolve(this.config.baseDir, migrationResult.filePath);
+        const directory = path.dirname(fullPath);
+        // Ensure migration directory exists
+        await fs.mkdir(directory, { recursive: true });
+        // Write migration file
+        await fs.writeFile(fullPath, migrationResult.content, 'utf-8');
+        return fullPath;
+    }
+    /**
+     * Write bundled migration file to disk
+     */
+    async writeBundledMigration(migrationResult) {
+        const fullPath = path.resolve(this.config.baseDir, migrationResult.filePath);
+        const directory = path.dirname(fullPath);
+        // Ensure migration directory exists
+        await fs.mkdir(directory, { recursive: true });
+        // Write bundled migration file
+        await fs.writeFile(fullPath, migrationResult.content, 'utf-8');
+        return fullPath;
+    }
+    /**
+     * Generate and write migration file in one operation
+     */
+    async generateAndWriteMigration(template, buildLog, options = {}) {
+        const result = await this.generateMigration(template, buildLog, options);
+        const filePath = await this.writeMigration(result);
+        return { result, filePath };
+    }
+    /**
+     * Generate and write bundled migration file in one operation
+     */
+    async generateAndWriteBundledMigration(templates, buildLog, options = {}) {
+        const result = await this.generateBundledMigration(templates, buildLog, options);
+        const filePath = await this.writeBundledMigration(result);
+        return { result, filePath };
+    }
+    /**
+     * Check if migration file already exists
+     */
+    async migrationExists(fileName) {
+        const fullPath = path.resolve(this.config.baseDir, this.config.migrationDir, fileName);
+        try {
+            await fs.access(fullPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+//# sourceMappingURL=MigrationBuilder.js.map

package/dist/services/MigrationBuilder.js.map

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