@reftrixmcp/mcp-server 0.1.7

package/dist/services/motion/frame-analysis-save.helper.js.map

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

package/dist/services/motion/frame-capture.service.d.ts

@@ -0,0 +1,170 @@
+/**
+ * FrameCaptureService
+ *
+ * Playwrightを使用してWebページをスクロールしながらフレームをキャプチャ
+ *
+ * 仕様:
+ * - scroll_px_per_frame デフォルト: 15px（Reftrix仕様）
+ * - frame_interval_ms デフォルト: 33ms（30fps等価）
+ * - output_format デフォルト: 'png'
+ *
+ * 15px/frame の根拠:
+ * - 60fps等価スクロール（216px/秒 / 60 ≈ 3.6px）と50px/frameの中間
+ * - IntersectionObserver閾値（0.1〜0.3）を確実に検出
+ * - cubic-bezier easing曲線の解析に十分なサンプル数
+ * - parallax微動（係数0.02〜0.05）の検出可能
+ *
+ * @module @reftrixmcp/mcp-server/services/motion/frame-capture.service
+ */
+import type { Page } from "playwright";
+/**
+ * フレームキャプチャオプション
+ */
+export interface FrameCaptureServiceOptions {
+    /** スクロール量/フレーム (px)。デフォルト: 15 */
+    scroll_px_per_frame?: number;
+    /** フレーム間隔 (ms)。デフォルト: 33 (30fps等価) */
+    frame_interval_ms?: number;
+    /** 出力ディレクトリ。必須 */
+    output_dir: string;
+    /** 出力形式。デフォルト: 'png' */
+    output_format?: "png" | "jpeg";
+    /** ファイル名パターン。デフォルト: 'frame-{0000}.png' */
+    filename_pattern?: string;
+    /** ページ高さを手動指定 (px)。省略時は自動取得 */
+    page_height_px?: number;
+    /** 実際にスクリーンショットを保存するか。デフォルト: true */
+    save_screenshots?: boolean;
+    /**
+     * 最大フレーム数制限。デフォルト: 1000
+     * 大きなページでのタイムアウト対策。この数を超えるフレームはスキップされる。
+     */
+    max_frames?: number;
+    /**
+     * 最大ページ高さ制限 (px)。デフォルト: 50000
+     * 無限スクロールサイト対策。この高さを超える部分はスキップされる。
+     */
+    max_page_height?: number;
+    /**
+     * タイムアウト (ms)。デフォルト: 90000 (90秒)
+     * フレームキャプチャ全体のタイムアウト。超過時は取得済みフレームで結果を返す。
+     */
+    timeout_ms?: number;
+}
+/**
+ * フレームファイル情報
+ */
+export interface FrameFileInfo {
+    frame_number: number;
+    scroll_position_px: number;
+    timestamp_ms: number;
+    file_path: string;
+}
+/**
+ * キャプチャ設定
+ */
+export interface FrameCaptureConfig {
+    scroll_px_per_frame: number;
+    frame_interval_ms: number;
+    output_format: "png" | "jpeg";
+    output_dir: string;
+    filename_pattern: string;
+}
+/**
+ * フレームキャプチャ結果
+ */
+export interface FrameCaptureServiceResult {
+    total_frames: number;
+    output_dir: string;
+    config: FrameCaptureConfig;
+    files: FrameFileInfo[];
+    duration_ms: number;
+    /**
+     * キャプチャが制限により早期終了したか
+     * - max_frames に達した場合
+     * - max_page_height を超えた場合
+     * - タイムアウトした場合
+     */
+    truncated?: boolean;
+    /** 制限理由 */
+    truncation_reason?: "max_frames" | "max_page_height" | "timeout";
+    /** 元のページ高さ（制限適用前） */
+    original_page_height?: number;
+}
+/**
+ * FrameCaptureService
+ *
+ * Playwrightを使用してWebページのスクロールフレームをキャプチャ
+ */
+export declare class FrameCaptureService {
+    private readonly isDevelopment;
+    constructor();
+    /**
+     * フレームキャプチャを実行
+     *
+     * v0.1.0改善: 制限とタイムアウトを追加
+     * - max_frames: 最大フレーム数制限（デフォルト1000）
+     * - max_page_height: 最大ページ高さ制限（デフォルト50000px）
+     * - timeout_ms: タイムアウト（デフォルト90秒）
+     *
+     * @param page - Playwright Page インスタンス
+     * @param options - キャプチャオプション
+     * @returns キャプチャ結果
+     */
+    capture(page: Page, options: FrameCaptureServiceOptions): Promise<FrameCaptureServiceResult>;
+    /**
+     * ページの総高さを取得
+     *
+     * 動的コンテンツ（SPA、lazy load）に対応するため、
+     * 複数の方法で高さを取得し、最大値を使用
+     *
+     * @param page - Playwright Page インスタンス
+     * @returns ページの総高さ (px)
+     */
+    private getPageHeight;
+    /**
+     * ビューポートの高さを取得
+     */
+    private getViewportHeight;
+    /**
+     * ディレクトリが存在しない場合は作成する
+     *
+     * @param dir - 作成するディレクトリパス
+     * @throws Error ディレクトリ作成に失敗した場合
+     */
+    private ensureDirectoryExists;
+    /**
+     * ディレクトリ内の古いフレーム画像をクリアする
+     *
+     * 新しいキャプチャ開始前に前回のフレームを削除して
+     * 異なるサイトのフレームが混在することを防ぐ
+     *
+     * @param dir - クリアするディレクトリパス
+     */
+    private clearFrameDirectory;
+    /**
+     * 出力ディレクトリを検証・正規化
+     *
+     * セキュリティ対策:
+     * - Path Traversal 検出 (..)
+     * - 許可ディレクトリリストとの照合
+     * - 絶対パスへの正規化
+     *
+     * @throws Error Path Traversal検出時またはディレクトリが許可リスト外の場合
+     */
+    private validateAndNormalizeOutputDir;
+    /**
+     * ファイルパスを生成
+     *
+     * セキュリティ対策:
+     * - path.basename() でディレクトリ成分を除去
+     * - path.join() で安全なパス結合
+     */
+    private generateFilePath;
+}
+/**
+ * FrameCaptureServiceインスタンスを作成
+ */
+export declare function createFrameCaptureService(): FrameCaptureService;
+export default FrameCaptureService;
+//# sourceMappingURL=frame-capture.service.d.ts.map

package/dist/services/motion/frame-capture.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-capture.service.d.ts","sourceRoot":"","sources":["../../../src/services/motion/frame-capture.service.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAyB,MAAM,YAAY,CAAC;AAS9D;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,iCAAiC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IAEnB,wBAAwB;IACxB,aAAa,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAE/B,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,+BAA+B;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,KAAK,GAAG,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,WAAW;IACX,iBAAiB,CAAC,EAAE,YAAY,GAAG,iBAAiB,GAAG,SAAS,CAAC;IAEjE,qBAAqB;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAqCD;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;;IAWxC;;;;;;;;;;;OAWG;IACG,OAAO,CACX,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC;IA+LrC;;;;;;;;OAQG;YACW,aAAa;IAmH3B;;OAEG;YACW,iBAAiB;IAI/B;;;;;OAKG;YACW,qBAAqB;IAkBnC;;;;;;;OAOG;YACW,mBAAmB;IA8BjC;;;;;;;;;OASG;IACH,OAAO,CAAC,6BAA6B;IA0BrC;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;CAqBzB;AAMD;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,mBAAmB,CAE/D;AAMD,eAAe,mBAAmB,CAAC"}

package/dist/services/motion/frame-capture.service.js

@@ -0,0 +1,476 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrameCaptureService = void 0;
+exports.createFrameCaptureService = createFrameCaptureService;
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const fs = __importStar(require("fs/promises"));
+// ============================================================================
+// 定数
+// ============================================================================
+/** デフォルト: スクロール量/フレーム (px) */
+const DEFAULT_SCROLL_PX_PER_FRAME = 15;
+/** デフォルト: フレーム間隔 (ms) */
+const DEFAULT_FRAME_INTERVAL_MS = 33;
+/** デフォルト: 出力形式 */
+const DEFAULT_OUTPUT_FORMAT = "png";
+/** デフォルト: ファイル名パターン */
+const DEFAULT_FILENAME_PATTERN = "frame-{0000}.png";
+/** デフォルト: 最大フレーム数 - 大きなページでのタイムアウト対策 */
+const DEFAULT_MAX_FRAMES = 1000;
+/** デフォルト: 最大ページ高さ (px) - 無限スクロールサイト対策 */
+const DEFAULT_MAX_PAGE_HEIGHT = 50000;
+/** デフォルト: タイムアウト (ms) - フレームキャプチャ全体 */
+const DEFAULT_TIMEOUT_MS = 90000;
+/** 許可されたベースディレクトリ */
+const ALLOWED_BASE_DIRS = [process.cwd(), "/tmp", os.tmpdir()];
+/** セキュリティ: Path Traversal パターン */
+const PATH_TRAVERSAL_PATTERN = /\.\./;
+// ============================================================================
+// FrameCaptureService クラス
+// ============================================================================
+/**
+ * FrameCaptureService
+ *
+ * Playwrightを使用してWebページのスクロールフレームをキャプチャ
+ */
+class FrameCaptureService {
+    isDevelopment;
+    constructor() {
+        this.isDevelopment = process.env.NODE_ENV === "development";
+        if (this.isDevelopment) {
+            // eslint-disable-next-line no-console -- Intentional debug log in development
+            console.log("[FrameCaptureService] Initialized");
+        }
+    }
+    /**
+     * フレームキャプチャを実行
+     *
+     * v0.1.0改善: 制限とタイムアウトを追加
+     * - max_frames: 最大フレーム数制限（デフォルト1000）
+     * - max_page_height: 最大ページ高さ制限（デフォルト50000px）
+     * - timeout_ms: タイムアウト（デフォルト90秒）
+     *
+     * @param page - Playwright Page インスタンス
+     * @param options - キャプチャオプション
+     * @returns キャプチャ結果
+     */
+    async capture(page, options) {
+        const startTime = Date.now();
+        // オプションのデフォルト適用
+        const scrollPxPerFrame = options.scroll_px_per_frame ?? DEFAULT_SCROLL_PX_PER_FRAME;
+        const frameIntervalMs = options.frame_interval_ms ?? DEFAULT_FRAME_INTERVAL_MS;
+        const outputFormat = options.output_format ?? DEFAULT_OUTPUT_FORMAT;
+        const outputDir = this.validateAndNormalizeOutputDir(options.output_dir);
+        const filenamePattern = options.filename_pattern ?? DEFAULT_FILENAME_PATTERN;
+        const saveScreenshots = options.save_screenshots ?? true;
+        // v0.1.0: 新しい制限オプション
+        const maxFrames = options.max_frames ?? DEFAULT_MAX_FRAMES;
+        const maxPageHeight = options.max_page_height ?? DEFAULT_MAX_PAGE_HEIGHT;
+        const timeoutMs = options.timeout_ms ?? DEFAULT_TIMEOUT_MS;
+        if (this.isDevelopment) {
+            // eslint-disable-next-line no-console -- Intentional debug log in development
+            console.log("[FrameCaptureService] Starting capture:", {
+                scrollPxPerFrame,
+                frameIntervalMs,
+                outputFormat,
+                outputDir,
+                filenamePattern,
+                maxFrames,
+                maxPageHeight,
+                timeoutMs,
+            });
+        }
+        // 出力ディレクトリを作成（存在しない場合）
+        await this.ensureDirectoryExists(outputDir);
+        // 古いフレームをクリア（前回のキャプチャと混在を防ぐ）
+        await this.clearFrameDirectory(outputDir);
+        // ページ寸法を取得
+        const originalPageHeight = options.page_height_px ?? (await this.getPageHeight(page));
+        const viewportHeight = await this.getViewportHeight(page);
+        // v0.1.0: ページ高さ制限を適用
+        let pageHeight = originalPageHeight;
+        let truncated = false;
+        let truncationReason;
+        if (pageHeight > maxPageHeight) {
+            if (this.isDevelopment) {
+                // eslint-disable-next-line no-console -- Intentional debug log in development
+                console.log("[FrameCaptureService] Page height exceeds limit, truncating:", {
+                    originalPageHeight,
+                    maxPageHeight,
+                });
+            }
+            pageHeight = maxPageHeight;
+            truncated = true;
+            truncationReason = "max_page_height";
+        }
+        const maxScroll = Math.max(0, pageHeight - viewportHeight);
+        // total_frames 計算
+        let totalFrames = maxScroll > 0 ? Math.ceil(maxScroll / scrollPxPerFrame) + 1 : 1;
+        // v0.1.0: フレーム数制限を適用
+        if (totalFrames > maxFrames) {
+            if (this.isDevelopment) {
+                // eslint-disable-next-line no-console -- Intentional debug log in development
+                console.log("[FrameCaptureService] Frame count exceeds limit, truncating:", {
+                    originalFrameCount: totalFrames,
+                    maxFrames,
+                });
+            }
+            totalFrames = maxFrames;
+            truncated = true;
+            truncationReason = "max_frames";
+        }
+        if (this.isDevelopment) {
+            // eslint-disable-next-line no-console -- Intentional debug log in development
+            console.log("[FrameCaptureService] Page dimensions:", {
+                originalPageHeight,
+                pageHeight,
+                viewportHeight,
+                maxScroll,
+                totalFrames,
+                truncated,
+                truncationReason,
+            });
+        }
+        const files = [];
+        const config = {
+            scroll_px_per_frame: scrollPxPerFrame,
+            frame_interval_ms: frameIntervalMs,
+            output_format: outputFormat,
+            output_dir: outputDir,
+            filename_pattern: filenamePattern,
+        };
+        // フレームをキャプチャ
+        for (let i = 0; i < totalFrames; i++) {
+            // v0.1.0: タイムアウトチェック
+            const elapsed = Date.now() - startTime;
+            if (elapsed >= timeoutMs) {
+                if (this.isDevelopment) {
+                    // eslint-disable-next-line no-console -- Intentional debug log in development
+                    console.log("[FrameCaptureService] Timeout reached, stopping capture:", {
+                        capturedFrames: i,
+                        totalFrames,
+                        elapsedMs: elapsed,
+                        timeoutMs,
+                    });
+                }
+                truncated = true;
+                truncationReason = "timeout";
+                break;
+            }
+            const scrollY = Math.min(i * scrollPxPerFrame, maxScroll);
+            // スクロール（ブラウザコンテキストで実行）
+            await page.evaluate((y) => window.scrollTo(0, y), scrollY);
+            // アニメーション安定待機
+            await page.waitForTimeout(frameIntervalMs);
+            // ファイルパス生成
+            const filePath = this.generateFilePath(outputDir, filenamePattern, i, outputFormat);
+            // スクリーンショット
+            if (saveScreenshots) {
+                const screenshotOptions = {
+                    path: filePath,
+                    type: outputFormat,
+                };
+                await page.screenshot(screenshotOptions);
+            }
+            // フレーム情報を記録
+            files.push({
+                frame_number: i,
+                scroll_position_px: scrollY,
+                timestamp_ms: i * frameIntervalMs,
+                file_path: filePath,
+            });
+            // 進捗ログ
+            if (this.isDevelopment && i > 0 && i % 100 === 0) {
+                // eslint-disable-next-line no-console -- Intentional debug log in development
+                console.log(`[FrameCaptureService] Captured frame ${i}/${totalFrames}`);
+            }
+        }
+        const durationMs = Date.now() - startTime;
+        if (this.isDevelopment) {
+            // eslint-disable-next-line no-console -- Intentional debug log in development
+            console.log("[FrameCaptureService] Capture complete:", {
+                capturedFrames: files.length,
+                totalFrames,
+                durationMs: `${durationMs}ms`,
+                truncated,
+                truncationReason,
+            });
+        }
+        // 結果を構築
+        const result = {
+            total_frames: files.length,
+            output_dir: outputDir,
+            config,
+            files,
+            duration_ms: durationMs,
+        };
+        // 制限情報を追加（truncatedの場合のみ）
+        // exactOptionalPropertyTypes対応: truncationReasonがundefinedでない場合のみ設定
+        if (truncated && truncationReason !== undefined) {
+            result.truncated = true;
+            result.truncation_reason = truncationReason;
+            result.original_page_height = originalPageHeight;
+        }
+        return result;
+    }
+    // ============================================================================
+    // プライベートメソッド
+    // ============================================================================
+    /**
+     * ページの総高さを取得
+     *
+     * 動的コンテンツ（SPA、lazy load）に対応するため、
+     * 複数の方法で高さを取得し、最大値を使用
+     *
+     * @param page - Playwright Page インスタンス
+     * @returns ページの総高さ (px)
+     */
+    async getPageHeight(page) {
+        // Step 1: 初期の全高さ情報を取得（複数ソース）
+        const initialMetrics = await page.evaluate(() => ({
+            scrollHeight: document.documentElement.scrollHeight,
+            bodyScrollHeight: document.body?.scrollHeight ?? 0,
+            offsetHeight: document.documentElement.offsetHeight,
+            bodyOffsetHeight: document.body?.offsetHeight ?? 0,
+            innerHeight: window.innerHeight,
+        }));
+        // 複数ソースから最大値を取得
+        let currentHeight = Math.max(initialMetrics.scrollHeight, initialMetrics.bodyScrollHeight, initialMetrics.offsetHeight, initialMetrics.bodyOffsetHeight);
+        if (this.isDevelopment) {
+            // eslint-disable-next-line no-console -- Intentional debug log in development
+            console.log("[FrameCaptureService] Initial page metrics:", {
+                ...initialMetrics,
+                maxHeight: currentHeight,
+            });
+        }
+        // Step 2: ページ高さが viewport と同じ場合、JSレンダリング待機
+        const viewportHeight = initialMetrics.innerHeight;
+        if (currentHeight <= viewportHeight) {
+            if (this.isDevelopment) {
+                // eslint-disable-next-line no-console -- Intentional debug log in development
+                console.log("[FrameCaptureService] Page height equals viewport, waiting for JS render...");
+            }
+            // JavaScript レンダリング完了を待つ
+            await page.waitForTimeout(2000);
+            // 再度高さを取得
+            const afterWaitMetrics = await page.evaluate(() => ({
+                scrollHeight: document.documentElement.scrollHeight,
+                bodyScrollHeight: document.body?.scrollHeight ?? 0,
+            }));
+            currentHeight = Math.max(afterWaitMetrics.scrollHeight, afterWaitMetrics.bodyScrollHeight, currentHeight);
+            if (this.isDevelopment) {
+                // eslint-disable-next-line no-console -- Intentional debug log in development
+                console.log("[FrameCaptureService] After JS wait:", {
+                    ...afterWaitMetrics,
+                    maxHeight: currentHeight,
+                });
+            }
+        }
+        // Step 3: 最下部までスクロールして遅延コンテンツを読み込む
+        const maxAttempts = 10; // 無限ループ防止
+        let attempts = 0;
+        while (attempts < maxAttempts) {
+            // 最下部へスクロール
+            await page.evaluate(() => window.scrollTo(0, document.documentElement.scrollHeight));
+            // 遅延読み込みを待つ（画像やセクションのロード）
+            await page.waitForTimeout(500);
+            // 新しい高さを取得（複数ソース）
+            const newMetrics = await page.evaluate(() => ({
+                scrollHeight: document.documentElement.scrollHeight,
+                bodyScrollHeight: document.body?.scrollHeight ?? 0,
+            }));
+            const newHeight = Math.max(newMetrics.scrollHeight, newMetrics.bodyScrollHeight);
+            attempts++;
+            if (newHeight > currentHeight) {
+                if (this.isDevelopment) {
+                    // eslint-disable-next-line no-console -- Intentional debug log in development
+                    console.log("[FrameCaptureService] Page height increased:", {
+                        from: currentHeight,
+                        to: newHeight,
+                        attempt: attempts,
+                    });
+                }
+                currentHeight = newHeight;
+            }
+            else {
+                // 高さが変わらなくなったら終了
+                if (this.isDevelopment) {
+                    // eslint-disable-next-line no-console -- Intentional debug log in development
+                    console.log("[FrameCaptureService] Page height stabilized at attempt:", attempts);
+                }
+                break;
+            }
+        }
+        // Step 4: ページ先頭に戻す（フレームキャプチャ開始位置）
+        await page.evaluate(() => window.scrollTo(0, 0));
+        await page.waitForTimeout(200); // スクロール完了を待つ
+        if (this.isDevelopment) {
+            // eslint-disable-next-line no-console -- Intentional debug log in development
+            console.log("[FrameCaptureService] Final page height:", {
+                finalHeight: currentHeight,
+                viewportHeight,
+                scrollableHeight: currentHeight - viewportHeight,
+                estimatedFrames: Math.ceil((currentHeight - viewportHeight) / 15) + 1,
+            });
+        }
+        return currentHeight;
+    }
+    /**
+     * ビューポートの高さを取得
+     */
+    async getViewportHeight(page) {
+        return page.evaluate(() => window.innerHeight);
+    }
+    /**
+     * ディレクトリが存在しない場合は作成する
+     *
+     * @param dir - 作成するディレクトリパス
+     * @throws Error ディレクトリ作成に失敗した場合
+     */
+    async ensureDirectoryExists(dir) {
+        try {
+            await fs.mkdir(dir, { recursive: true });
+            if (this.isDevelopment) {
+                // eslint-disable-next-line no-console -- Intentional debug log in development
+                console.log("[FrameCaptureService] Ensured directory exists:", dir);
+            }
+        }
+        catch (err) {
+            const error = err;
+            // EEXIST以外のエラーは再スロー（既存ディレクトリはOK）
+            if (error.code !== "EEXIST") {
+                throw new Error(`Failed to create output directory: ${dir} - ${error.message ?? "Unknown error"}`);
+            }
+        }
+    }
+    /**
+     * ディレクトリ内の古いフレーム画像をクリアする
+     *
+     * 新しいキャプチャ開始前に前回のフレームを削除して
+     * 異なるサイトのフレームが混在することを防ぐ
+     *
+     * @param dir - クリアするディレクトリパス
+     */
+    async clearFrameDirectory(dir) {
+        try {
+            const files = await fs.readdir(dir);
+            const frameFiles = files.filter((f) => f.startsWith("frame-") && f.endsWith(".png"));
+            if (frameFiles.length > 0) {
+                if (this.isDevelopment) {
+                    // eslint-disable-next-line no-console -- Intentional debug log in development
+                    console.log(`[FrameCaptureService] Clearing ${frameFiles.length} old frame files from ${dir}`);
+                }
+                await Promise.all(frameFiles.map((file) => fs.unlink(`${dir}/${file}`).catch(() => {
+                    // ファイル削除エラーは無視（既に削除されている可能性）
+                })));
+            }
+        }
+        catch {
+            // ディレクトリ読み取りエラーは無視（空のディレクトリなど）
+            if (this.isDevelopment) {
+                // eslint-disable-next-line no-console -- Intentional debug log in development
+                console.log("[FrameCaptureService] Could not clear directory (may be empty):", dir);
+            }
+        }
+    }
+    /**
+     * 出力ディレクトリを検証・正規化
+     *
+     * セキュリティ対策:
+     * - Path Traversal 検出 (..)
+     * - 許可ディレクトリリストとの照合
+     * - 絶対パスへの正規化
+     *
+     * @throws Error Path Traversal検出時またはディレクトリが許可リスト外の場合
+     */
+    validateAndNormalizeOutputDir(dir) {
+        // P1: Path Traversal 検出
+        if (PATH_TRAVERSAL_PATTERN.test(dir)) {
+            throw new Error("Security: Path traversal detected in output_dir");
+        }
+        // 絶対パスに解決
+        const resolved = path.resolve(dir);
+        // 許可ディレクトリリストとの照合
+        const isAllowed = ALLOWED_BASE_DIRS.some((allowedDir) => {
+            const resolvedAllowed = path.resolve(allowedDir);
+            return resolved.startsWith(resolvedAllowed);
+        });
+        if (!isAllowed) {
+            throw new Error(`Security: output_dir is outside allowed directories. ` +
+                `Allowed: ${ALLOWED_BASE_DIRS.join(", ")}`);
+        }
+        // 末尾スラッシュを保証
+        return resolved.endsWith("/") ? resolved : `${resolved}/`;
+    }
+    /**
+     * ファイルパスを生成
+     *
+     * セキュリティ対策:
+     * - path.basename() でディレクトリ成分を除去
+     * - path.join() で安全なパス結合
+     */
+    generateFilePath(outputDir, pattern, frameNumber, format) {
+        // パターン置換: {0000} -> 0001, {000} -> 001
+        let filename = pattern.replace(/\{(\d+)\}/g, (_, digits) => {
+            const padLength = digits.length;
+            return String(frameNumber).padStart(padLength, "0");
+        });
+        // 拡張子の置換
+        filename = filename.replace(/\.(png|jpeg)$/, `.${format}`);
+        // P2: ディレクトリ成分を除去して安全なファイル名のみを抽出
+        const safeFilename = path.basename(filename);
+        // 安全なパス結合
+        return path.join(outputDir, safeFilename);
+    }
+}
+exports.FrameCaptureService = FrameCaptureService;
+// ============================================================================
+// ファクトリ関数
+// ============================================================================
+/**
+ * FrameCaptureServiceインスタンスを作成
+ */
+function createFrameCaptureService() {
+    return new FrameCaptureService();
+}
+// ============================================================================
+// デフォルトエクスポート
+// ============================================================================
+exports.default = FrameCaptureService;
+//# sourceMappingURL=frame-capture.service.js.map