@reftrixmcp/mcp-server 0.1.8 → 0.2.0

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

@@ -1 +0,0 @@
-{"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

@@ -1,170 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,476 +0,0 @@
-"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