@masuidrive/procman 0.1.0

package/dist/src/services/log-manager.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Log Manager - ログ管理システム
+ *
+ * アプリケーションプロセスのstdout/stderrを集約し、JSONL形式でログを管理する。
+ * リアルタイムログストリーミング機能とファイル管理を提供する。
+ * ログストリーミングはEventEmitterパターンで実装し、new-log イベントを発行する。
+ */
+import { EventEmitter } from 'events';
+import { LogEntry, LogOptions } from '../shared/logs.js';
+import { LogManagerConfig } from './log-manager-config.js';
+/**
+ * ファイル管理のインターフェース（依存性逆転原則）
+ */
+interface IFileManager {
+    /**
+     * ファイルの存在確認・作成
+     */
+    ensureFileExists(filePath: string): void;
+    /**
+     * ログディレクトリの確認・作成
+     */
+    ensureLogDirectory(logDir: string): void;
+    /**
+     * ファイルの末尾から指定行数を効率的に読み込み
+     */
+    readTailLines(filePath: string, maxLines: number): Promise<string[]>;
+    /**
+     * ファイルへのリトライ機能付き書き込み
+     */
+    writeToFileWithRetry(filePath: string, content: string, maxRetries: number): Promise<void>;
+}
+/**
+ * アプリケーション固有のログ設定
+ */
+interface AppLogConfig {
+    /** 統合ログファイルパス */
+    logFile?: string | null;
+    /** stdout専用ログファイルパス */
+    outFile?: string | null;
+    /** stderr専用ログファイルパス */
+    errorFile?: string | null;
+    /** ネームスペース */
+    namespace?: string;
+}
+/**
+ * LogManager - ログ管理システムのメインクラス
+ */
+export declare class LogManager extends EventEmitter {
+    private logDir;
+    private appLoggers;
+    private fileManager;
+    private config;
+    private pathValidator;
+    private securePathBuilder;
+    private readonly cleanup;
+    constructor(logDir?: string, fileManager?: IFileManager, config?: LogManagerConfig);
+    /**
+     * Private method to register and track listeners
+     */
+    private registerListener;
+    /**
+     * ログディレクトリの確認・作成（FileManagerに委譲）
+     */
+    private ensureLogDirectory;
+    /**
+     * Sanitize invalid app names to prevent errors
+     */
+    private sanitizeAppName;
+    /**
+     * アプリケーションのログ設定（セキュリティ検証付き）
+     */
+    setupAppLogs(appName: string, config?: AppLogConfig): void;
+    /**
+     * プロセス出力のキャプチャとログ記録
+     * ProcessManagerからのstdout/stderrイベント処理
+     */
+    captureProcessOutput(appName: string, type: 'stdout' | 'stderr', data: string): void;
+    /**
+     * ログエントリの書き込み（互換性のため維持）
+     */
+    writeLog(appName: string, type: 'stdout' | 'stderr', message: string): void;
+    /**
+     * ファイル監視の開始
+     */
+    startWatching(appName: string): Promise<void>;
+    /**
+     * ファイル監視の停止
+     */
+    stopWatching(appName: string): void;
+    /**
+     * ログの読み込み
+     */
+    readLogs(appName: string, options?: LogOptions): Promise<LogEntry[]>;
+    /**
+     * ログのクリア
+     */
+    clearLogs(appName: string): Promise<void>;
+    /**
+     * ログ統計情報の取得
+     */
+    getLogStats(appName: string): {
+        logFileSize?: number;
+        outFileSize?: number;
+        errorFileSize?: number;
+        lastModified?: number;
+    };
+    /**
+     * バッファ統計情報の取得
+     */
+    getBufferStats(appName: string): {
+        entryCount: number;
+        bufferSize: number;
+        isBackpressured: boolean;
+    };
+    /**
+     * 全アプリケーションのバッファ統計情報の取得
+     */
+    getAllBufferStats(): Record<string, {
+        entryCount: number;
+        bufferSize: number;
+        isBackpressured: boolean;
+    }>;
+    /**
+     * 指定アプリケーションのバッファを強制フラッシュ
+     */
+    flushBuffer(appName: string): Promise<void>;
+    /**
+     * 全アプリケーションのバッファを強制フラッシュ
+     */
+    flushAllBuffers(): Promise<void>;
+    /**
+     * 全てのリソースのクリーンアップ
+     */
+    close(): Promise<void>;
+    /**
+     * 設定のセキュリティ検証とパス正規化
+     */
+    private validateAndSecureConfig;
+    /**
+     * 登録されているアプリケーション一覧の取得
+     */
+    getAppNames(): string[];
+    /**
+     * ログの人間向けフォーマット
+     */
+    formatLogForHuman(logEntry: LogEntry): string;
+    /**
+     * ログストリーミングの開始
+     * 新しいログエントリが追加されるたびにリスナーを呼び出す
+     *
+     * Note: This method now tracks listeners but doesn't use the EventCleanupHelper
+     * because it returns a cleanup function that the caller must use.
+     * The caller is responsible for calling the cleanup function.
+     */
+    startLogStream(appName: string | null, listener: (logEntry: LogEntry) => void): () => void;
+    /**
+     * ログストリーミング状態を取得
+     */
+    isStreamingActive(): boolean;
+    /**
+     * Get statistics about listener management
+     */
+    getListenerStats(): {
+        managedListeners: number;
+        ownListeners: number;
+        streamingListeners: number;
+    };
+}
+export {};
+//# sourceMappingURL=log-manager.d.ts.map

package/dist/src/services/log-manager.d.ts.map

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