@t1mmen/srtd 0.0.0-next-20251227000343

package/dist/services/Orchestrator.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Orchestrator Service - Central coordinator for unidirectional data flow
+ * Manages coordination between FileSystemService, StateService, DatabaseService, and MigrationBuilder
+ * Implements the flow: FileSystem Event → Orchestrator → StateService (check) → Action → StateService (update)
+ */
+import EventEmitter from 'node:events';
+import type { CLIConfig, ProcessedTemplateResult, TemplateStatus } from '../types.js';
+export interface OrchestratorEvent {
+    templateChanged: TemplateStatus;
+    templateApplied: TemplateStatus;
+    templateBuilt: TemplateStatus;
+    templateError: {
+        template: TemplateStatus;
+        error: string;
+    };
+    operationComplete: ProcessedTemplateResult;
+}
+export interface ApplyOptions {
+    force?: boolean;
+    templatePaths?: string[];
+    silent?: boolean;
+}
+export interface BuildOptions {
+    force?: boolean;
+    bundle?: boolean;
+    templatePaths?: string[];
+    silent?: boolean;
+}
+export interface WatchOptions {
+    silent?: boolean;
+    initialProcess?: boolean;
+}
+export interface OrchestratorConfig {
+    baseDir: string;
+    cliConfig: CLIConfig;
+    silent?: boolean;
+}
+export declare class Orchestrator extends EventEmitter implements Disposable {
+    private fileSystemService;
+    private stateService;
+    private databaseService;
+    private migrationBuilder;
+    private config;
+    private processQueue;
+    private pendingRecheck;
+    private processingTemplate;
+    private processing;
+    private watching;
+    constructor(config: OrchestratorConfig);
+    /**
+     * Initialize the orchestrator and all services
+     */
+    initialize(): Promise<void>;
+    /**
+     * Initialize all coordinated services
+     */
+    private initializeServices;
+    /**
+     * Set up event listeners for service coordination
+     */
+    private setupEventListeners;
+    /**
+     * Handle FileSystem events - Entry point for unidirectional flow
+     * Uses queue + pendingRecheck to prevent race conditions from rapid file changes
+     */
+    private handleFileSystemEvent;
+    /**
+     * Process the next template in the queue
+     */
+    private processNextTemplate;
+    /**
+     * Process a single template through the unidirectional flow
+     */
+    private processTemplate;
+    /**
+     * Get template status by coordinating between services
+     */
+    private getTemplateStatus;
+    /**
+     * Execute apply operation for a template
+     */
+    private executeApplyTemplate;
+    /**
+     * Command handler: Apply templates to database
+     */
+    apply(options?: ApplyOptions): Promise<ProcessedTemplateResult>;
+    /**
+     * Command handler: Build migration files from templates
+     */
+    build(options?: BuildOptions): Promise<ProcessedTemplateResult>;
+    /**
+     * Execute bundled migration build
+     */
+    private executeBundledBuild;
+    /**
+     * Execute individual migration builds
+     */
+    private executeIndividualBuilds;
+    /**
+     * Build a single template migration file
+     */
+    private executeBuildTemplate;
+    /**
+     * Command handler: Start watching for template changes
+     */
+    watch(options?: WatchOptions): Promise<{
+        close: () => Promise<void>;
+    }>;
+    /**
+     * Find all templates using FileSystemService
+     */
+    findTemplates(): Promise<string[]>;
+    /**
+     * Get template status for external consumers
+     */
+    getTemplateStatusExternal(templatePath: string): Promise<TemplateStatus>;
+    /**
+     * Register a template in the build log without building it
+     * Used when importing existing migrations that should be tracked
+     */
+    registerTemplate(templatePath: string): Promise<void>;
+    /**
+     * Promote a WIP template by renaming it and updating build logs
+     * @returns The new path after promotion
+     */
+    promoteTemplate(templatePath: string): Promise<string>;
+    /**
+     * Clear build logs via StateService (single source of truth)
+     * @param type - 'local' clears local only, 'shared' clears shared only, 'both' clears all
+     */
+    clearBuildLogs(type: 'local' | 'shared' | 'both'): Promise<void>;
+    /**
+     * Logging utility
+     */
+    private log;
+    /**
+     * Dispose of all services and clean up (async version for proper cleanup)
+     */
+    dispose(): Promise<void>;
+    /**
+     * Async dispose for await using statement - ensures cleanup completes
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+    /**
+     * Synchronous dispose for using statement - schedules async cleanup
+     * Note: For proper cleanup, prefer await using with Symbol.asyncDispose
+     */
+    [Symbol.dispose](): void;
+    /**
+     * Create orchestrator from CLI configuration
+     */
+    static create(baseDir: string, cliConfig: CLIConfig, options?: {
+        silent?: boolean;
+    }): Promise<Orchestrator>;
+}