@reftrixmcp/mcp-server 0.1.7

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

@@ -0,0 +1 @@
+{"version":3,"file":"frame-worker-pool.service.d.ts","sourceRoot":"","sources":["../../../src/services/motion/frame-worker-pool.service.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAmBxD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU;IACV,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,cAAc;IACd,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,aAAa;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,YAAY;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW;IACX,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,eAAe;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,aAAa;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe;IACf,aAAa,EAAE,OAAO,CAAC;CACxB;AAgHD;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,SAAS,CAA2E;IAC5F,OAAO,CAAC,YAAY,CAGN;IACd,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,WAAW,CAAK;gBAEZ,MAAM,GAAE,qBAA0B;IAsB9C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBjC;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAe9D;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IASpE;;OAEG;IACH,QAAQ,IAAI,SAAS;IAWrB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA8C/B;;OAEG;IACH,OAAO,CAAC,YAAY;IAkCpB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA0C3B;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,YAAY;CA+BrB;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,eAAe,CAErF;AAED,eAAe,eAAe,CAAC"}

package/dist/services/motion/frame-worker-pool.service.js

@@ -0,0 +1,410 @@
+"use strict";
+// SPDX-FileCopyrightText: 2025-2026 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.FrameWorkerPool = void 0;
+exports.createFrameWorkerPool = createFrameWorkerPool;
+/**
+ * Frame Worker Pool Service
+ *
+ * Worker Threadsを使用したフレーム差分計算の並列処理サービス
+ *
+ * 機能:
+ * - CPUコア数に応じたワーカー数自動調整
+ * - タスクキューによる効率的な並列処理
+ * - 100フレーム < 30秒のパフォーマンス目標
+ *
+ * @module @reftrixmcp/mcp-server/services/motion/frame-worker-pool
+ */
+const os = __importStar(require("node:os"));
+const node_worker_threads_1 = require("node:worker_threads");
+// =============================================================================
+// 定数
+// =============================================================================
+const DEFAULTS = {
+    /** デフォルトワーカー数（CPUコア数 - 1、最小1） */
+    WORKER_COUNT: Math.max(1, os.cpus().length - 1),
+    /** タスクタイムアウト（ms） */
+    TASK_TIMEOUT_MS: 10000,
+    /** 差分閾値 */
+    DIFF_THRESHOLD: 0.1,
+};
+// =============================================================================
+// Worker スクリプト（インライン）
+// =============================================================================
+/**
+ * ワーカースクリプトのコード
+ * Worker Threadsはファイルベースなので、インラインで定義してevalで実行
+ */
+const WORKER_SCRIPT = `
+const { parentPort } = require('node:worker_threads');
+
+/**
+ * フレーム差分を計算（シンプル実装）
+ */
+function calculateDiff(task) {
+  const { frame1, frame2, width, height, options } = task;
+  const threshold = (options?.threshold ?? 0.1) * 255 * 3;
+  const totalPixels = width * height;
+  const expectedSize = totalPixels * 4;
+
+  // バッファサイズ検証
+  if (frame1.length !== expectedSize || frame2.length !== expectedSize) {
+    throw new Error(\`Buffer size mismatch: expected \${expectedSize}, got \${frame1.length} and \${frame2.length}\`);
+  }
+
+  // 差分計算
+  let changedPixels = 0;
+  let minX = width;
+  let maxX = -1;
+  let minY = height;
+  let maxY = -1;
+
+  for (let i = 0; i < frame1.length; i += 4) {
+    const r1 = frame1[i] ?? 0;
+    const g1 = frame1[i + 1] ?? 0;
+    const b1 = frame1[i + 2] ?? 0;
+    const r2 = frame2[i] ?? 0;
+    const g2 = frame2[i + 1] ?? 0;
+    const b2 = frame2[i + 2] ?? 0;
+
+    const diff = Math.abs(r1 - r2) + Math.abs(g1 - g2) + Math.abs(b1 - b2);
+    if (diff > threshold) {
+      changedPixels++;
+      const pixelIndex = i / 4;
+      const x = pixelIndex % width;
+      const y = Math.floor(pixelIndex / width);
+
+      if (x < minX) minX = x;
+      if (x > maxX) maxX = x;
+      if (y < minY) minY = y;
+      if (y > maxY) maxY = y;
+    }
+  }
+
+  const changeRatio = changedPixels / totalPixels;
+  const regions = changedPixels > 0 ? [{
+    x: minX,
+    y: minY,
+    width: maxX - minX + 1,
+    height: maxY - minY + 1,
+  }] : [];
+
+  return {
+    changeRatio,
+    changedPixels,
+    totalPixels,
+    regions,
+    hasChange: changeRatio > 0.001,
+  };
+}
+
+// メッセージハンドラ
+parentPort.on('message', (message) => {
+  const { type, taskId, data } = message;
+
+  if (type === 'task') {
+    const startTime = Date.now();
+    try {
+      const result = calculateDiff(data);
+      parentPort.postMessage({
+        type: 'result',
+        taskId,
+        data: result,
+        processingTimeMs: Date.now() - startTime,
+      });
+    } catch (error) {
+      parentPort.postMessage({
+        type: 'error',
+        taskId,
+        error: error instanceof Error ? error.message : String(error),
+      });
+    }
+  }
+});
+`;
+// =============================================================================
+// FrameWorkerPool クラス
+// =============================================================================
+/**
+ * フレーム差分計算用ワーカープール
+ *
+ * Worker Threadsを使用してフレーム差分計算を並列化
+ */
+class FrameWorkerPool {
+    config;
+    workers = [];
+    availableWorkers = [];
+    taskQueue = [];
+    pendingTasks = new Map();
+    isInitialized = false;
+    isShuttingDown = false;
+    completedTasks = 0;
+    failedTasks = 0;
+    constructor(config = {}) {
+        const cpuCount = os.cpus().length;
+        const requestedWorkers = config.workerCount ?? DEFAULTS.WORKER_COUNT;
+        this.config = {
+            workerCount: Math.min(Math.max(1, requestedWorkers), cpuCount),
+            taskTimeoutMs: config.taskTimeoutMs ?? DEFAULTS.TASK_TIMEOUT_MS,
+        };
+        if (process.env.NODE_ENV === "development") {
+            // eslint-disable-next-line no-console -- Intentional debug log in development
+            console.log("[FrameWorkerPool] Created:", {
+                workerCount: this.config.workerCount,
+                cpuCount,
+            });
+        }
+    }
+    // ===========================================================================
+    // Public Methods
+    // ===========================================================================
+    /**
+     * ワーカープールを初期化
+     */
+    async initialize() {
+        if (this.isInitialized) {
+            return;
+        }
+        for (let i = 0; i < this.config.workerCount; i++) {
+            const worker = this.createWorker();
+            this.workers.push(worker);
+            this.availableWorkers.push(worker);
+        }
+        this.isInitialized = true;
+        if (process.env.NODE_ENV === "development") {
+            // eslint-disable-next-line no-console -- Intentional debug log in development
+            console.log("[FrameWorkerPool] Initialized with", this.workers.length, "workers");
+        }
+    }
+    /**
+     * 単一タスクを処理
+     */
+    async processTask(task) {
+        if (!this.isInitialized) {
+            throw new Error("Worker pool is not initialized");
+        }
+        if (this.isShuttingDown) {
+            throw new Error("Worker pool is shutting down");
+        }
+        return new Promise((resolve) => {
+            this.queueTask(task, resolve);
+            this.processQueue();
+        });
+    }
+    /**
+     * バッチタスクを並列処理
+     */
+    async processBatch(tasks) {
+        if (tasks.length === 0) {
+            return [];
+        }
+        const promises = tasks.map((task) => this.processTask(task));
+        return Promise.all(promises);
+    }
+    /**
+     * プール統計を取得
+     */
+    getStats() {
+        return {
+            totalWorkers: this.config.workerCount,
+            busyWorkers: this.workers.length - this.availableWorkers.length,
+            pendingTasks: this.taskQueue.length + this.pendingTasks.size,
+            completedTasks: this.completedTasks,
+            failedTasks: this.failedTasks,
+            isInitialized: this.isInitialized,
+        };
+    }
+    /**
+     * ワーカープールをシャットダウン
+     */
+    async shutdown() {
+        if (!this.isInitialized || this.isShuttingDown) {
+            return;
+        }
+        this.isShuttingDown = true;
+        // 待機中タスクをキャンセル
+        for (const { resolve } of this.taskQueue) {
+            resolve({
+                taskId: "cancelled",
+                success: false,
+                error: "Pool shutdown",
+            });
+        }
+        this.taskQueue = [];
+        // ペンディングタスクをキャンセル
+        for (const [taskId, { resolve }] of this.pendingTasks) {
+            resolve({
+                taskId,
+                success: false,
+                error: "Pool shutdown",
+            });
+        }
+        this.pendingTasks.clear();
+        // ワーカーを終了
+        const terminationPromises = this.workers.map((worker) => worker.terminate());
+        await Promise.all(terminationPromises);
+        this.workers = [];
+        this.availableWorkers = [];
+        this.isInitialized = false;
+        this.isShuttingDown = false;
+        if (process.env.NODE_ENV === "development") {
+            // eslint-disable-next-line no-console -- Intentional debug log in development
+            console.log("[FrameWorkerPool] Shutdown complete");
+        }
+    }
+    // ===========================================================================
+    // Private Methods
+    // ===========================================================================
+    /**
+     * ワーカーを作成
+     */
+    createWorker() {
+        // evalを使用してインラインワーカーを作成
+        const worker = new node_worker_threads_1.Worker(WORKER_SCRIPT, {
+            eval: true,
+        });
+        worker.on("message", (message) => {
+            this.handleWorkerMessage(worker, message);
+        });
+        worker.on("error", (error) => {
+            if (process.env.NODE_ENV === "development") {
+                console.error("[FrameWorkerPool] Worker error:", error);
+            }
+        });
+        worker.on("exit", (code) => {
+            if (code !== 0 && !this.isShuttingDown) {
+                if (process.env.NODE_ENV === "development") {
+                    console.warn("[FrameWorkerPool] Worker exited with code:", code);
+                }
+                // ワーカーを再作成
+                const index = this.workers.indexOf(worker);
+                if (index !== -1) {
+                    const newWorker = this.createWorker();
+                    this.workers[index] = newWorker;
+                    this.availableWorkers.push(newWorker);
+                }
+            }
+        });
+        return worker;
+    }
+    /**
+     * ワーカーメッセージを処理
+     */
+    handleWorkerMessage(worker, message) {
+        const pending = this.pendingTasks.get(message.taskId);
+        if (!pending) {
+            return;
+        }
+        this.pendingTasks.delete(message.taskId);
+        // ワーカーを利用可能に戻す
+        this.availableWorkers.push(worker);
+        // 結果を返す
+        if (message.type === "result") {
+            this.completedTasks++;
+            const resultObj = {
+                taskId: message.taskId,
+                success: true,
+                result: message.data,
+            };
+            if (message.processingTimeMs !== undefined) {
+                resultObj.processingTimeMs = message.processingTimeMs;
+            }
+            pending.resolve(resultObj);
+        }
+        else {
+            this.failedTasks++;
+            const errorObj = {
+                taskId: message.taskId,
+                success: false,
+            };
+            if (message.error !== undefined) {
+                errorObj.error = message.error;
+            }
+            pending.resolve(errorObj);
+        }
+        // 次のタスクを処理
+        this.processQueue();
+    }
+    /**
+     * タスクをキューに追加
+     */
+    queueTask(task, resolve) {
+        this.taskQueue.push({ task, resolve });
+    }
+    /**
+     * キューからタスクを処理
+     */
+    processQueue() {
+        while (this.availableWorkers.length > 0 && this.taskQueue.length > 0) {
+            const worker = this.availableWorkers.pop();
+            const queued = this.taskQueue.shift();
+            if (!worker || !queued) {
+                break;
+            }
+            const { task, resolve } = queued;
+            // ペンディングに追加
+            this.pendingTasks.set(task.taskId, {
+                resolve,
+                startTime: Date.now(),
+            });
+            // ワーカーにタスクを送信
+            worker.postMessage({
+                type: "task",
+                taskId: task.taskId,
+                data: {
+                    frame1: task.frame1,
+                    frame2: task.frame2,
+                    width: task.width,
+                    height: task.height,
+                    options: task.options,
+                },
+            });
+        }
+    }
+}
+exports.FrameWorkerPool = FrameWorkerPool;
+// =============================================================================
+// Factory Functions
+// =============================================================================
+/**
+ * FrameWorkerPoolインスタンスを作成
+ */
+function createFrameWorkerPool(config) {
+    return new FrameWorkerPool(config);
+}
+exports.default = FrameWorkerPool;
+//# sourceMappingURL=frame-worker-pool.service.js.map

package/dist/services/motion/frame-worker-pool.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-worker-pool.service.js","sourceRoot":"","sources":["../../../src/services/motion/frame-worker-pool.service.ts"],"names":[],"mappings":";AAAA,yDAAyD;AACzD,yCAAyC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAigBzC,sDAEC;AAjgBD;;;;;;;;;;;GAWG;AAEH,4CAA8B;AAC9B,6DAA6C;AAI7C,gFAAgF;AAChF,KAAK;AACL,gFAAgF;AAEhF,MAAM,QAAQ,GAAG;IACf,iCAAiC;IACjC,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/C,oBAAoB;IACpB,eAAe,EAAE,KAAK;IACtB,WAAW;IACX,cAAc,EAAE,GAAG;CACX,CAAC;AA8FX,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsFrB,CAAC;AAEF,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF;;;;GAIG;AACH,MAAa,eAAe;IACT,MAAM,CAAkC;IACjD,OAAO,GAAa,EAAE,CAAC;IACvB,gBAAgB,GAAa,EAAE,CAAC;IAChC,SAAS,GAAwE,EAAE,CAAC;IACpF,YAAY,GAGhB,IAAI,GAAG,EAAE,CAAC;IACN,aAAa,GAAG,KAAK,CAAC;IACtB,cAAc,GAAG,KAAK,CAAC;IACvB,cAAc,GAAG,CAAC,CAAC;IACnB,WAAW,GAAG,CAAC,CAAC;IAExB,YAAY,SAAgC,EAAE;QAC5C,MAAM,QAAQ,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC;QAClC,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,IAAI,QAAQ,CAAC,YAAY,CAAC;QAErE,IAAI,CAAC,MAAM,GAAG;YACZ,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,CAAC,EAAE,QAAQ,CAAC;YAC9D,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,QAAQ,CAAC,eAAe;SAChE,CAAC;QAEF,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;YAC3C,8EAA8E;YAC9E,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE;gBACxC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;gBACpC,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,iBAAiB;IACjB,8EAA8E;IAE9E;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;YACjD,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QAED,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAE1B,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;YAC3C,8EAA8E;YAC9E,OAAO,CAAC,GAAG,CAAC,oCAAoC,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,IAAgB;QAChC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QAED,OAAO,IAAI,OAAO,CAAmB,CAAC,OAAO,EAAE,EAAE;YAC/C,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC9B,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,KAAmB;QACpC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;YACrC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM;YAC/D,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI;YAC5D,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC/C,OAAO;QACT,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAE3B,eAAe;QACf,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACzC,OAAO,CAAC;gBACN,MAAM,EAAE,WAAW;gBACnB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,eAAe;aACvB,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QAEpB,kBAAkB;QAClB,KAAK,MAAM,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtD,OAAO,CAAC;gBACN,MAAM;gBACN,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,eAAe;aACvB,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAE1B,UAAU;QACV,MAAM,mBAAmB,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC7E,MAAM,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QAEvC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC3B,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;QAE5B,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;YAC3C,8EAA8E;YAC9E,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,kBAAkB;IAClB,8EAA8E;IAE9E;;OAEG;IACK,YAAY;QAClB,wBAAwB;QACxB,MAAM,MAAM,GAAG,IAAI,4BAAM,CAAC,aAAa,EAAE;YACvC,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAsD,EAAE,EAAE;YAC9E,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC3B,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;gBAC3C,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;gBACvC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;oBAC3C,OAAO,CAAC,IAAI,CAAC,4CAA4C,EAAE,IAAI,CAAC,CAAC;gBACnE,CAAC;gBACD,WAAW;gBACX,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC3C,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;oBACjB,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;oBACtC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;oBAChC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,mBAAmB,CACzB,MAAc,EACd,OAAsD;QAEtD,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAEzC,eAAe;QACf,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEnC,QAAQ;QACR,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,MAAM,SAAS,GAAqB;gBAClC,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,OAAO,CAAC,IAAwB;aACzC,CAAC;YACF,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;gBAC3C,SAAS,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;YACxD,CAAC;YACD,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,MAAM,QAAQ,GAAqB;gBACjC,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,OAAO,EAAE,KAAK;aACf,CAAC;YACF,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAChC,QAAQ,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YACjC,CAAC;YACD,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;QAED,WAAW;QACX,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACK,SAAS,CAAC,IAAgB,EAAE,OAA2C;QAC7E,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACK,YAAY;QAClB,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrE,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YAEtC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;gBACvB,MAAM;YACR,CAAC;YAED,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;YAEjC,YAAY;YACZ,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE;gBACjC,OAAO;gBACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC,CAAC;YAEH,cAAc;YACd,MAAM,CAAC,WAAW,CAAC;gBACjB,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,IAAI,EAAE;oBACJ,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,OAAO,EAAE,IAAI,CAAC,OAAO;iBACtB;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AAlRD,0CAkRC;AAED,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;GAEG;AACH,SAAgB,qBAAqB,CAAC,MAA8B;IAClE,OAAO,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAED,kBAAe,eAAe,CAAC"}

package/dist/services/motion/infrastructure/frame-loader.d.ts

@@ -0,0 +1,77 @@
+import { type FrameLoaderData, type FrameLoaderMetadata, type FrameLoaderOptions, type FramePair, type PathValidationResult } from "../types";
+/**
+ * フレーム画像読み込みクラス
+ *
+ * @example
+ * ```typescript
+ * const loader = new FrameLoader({
+ *   allowedDirectories: ['/path/to/frames'],
+ *   maxFileSize: 10 * 1024 * 1024,
+ * });
+ *
+ * const frameData = await loader.loadFrame('/path/to/frames/frame_001.png');
+ * console.log(frameData.metadata.width, frameData.metadata.height);
+ * ```
+ */
+export declare class FrameLoader {
+    private readonly allowedDirectories;
+    private readonly maxFileSize;
+    private readonly optimizeMemory;
+    private readonly maxWidth?;
+    private readonly maxHeight?;
+    /**
+     * コンストラクタ
+     * @param options - ローダーオプション
+     */
+    constructor(options?: FrameLoaderOptions);
+    /**
+     * パストラバーサルパターンを検出
+     * @param filePath - チェックするパス
+     * @returns トラバーサルパターンが見つかった場合 true
+     */
+    private detectPathTraversal;
+    /**
+     * パスが許可ディレクトリ内にあるか確認
+     * @param filePath - チェックするパス
+     * @returns 許可ディレクトリ内の場合 true
+     */
+    private isWithinAllowedDirectories;
+    /**
+     * ファイル拡張子を検証
+     * @param filePath - チェックするパス
+     * @returns 有効な拡張子の場合 true
+     */
+    private hasValidExtension;
+    /**
+     * フレームパスを検証
+     * @param filePath - 検証するファイルパス
+     * @returns 検証結果
+     */
+    validateFramePath(filePath: string): Promise<PathValidationResult>;
+    /**
+     * フレーム画像のメタデータを取得
+     * @param filePath - 画像ファイルパス
+     * @returns メタデータ
+     * @throws FrameLoaderError パスが無効な場合
+     */
+    getFrameMetadata(filePath: string): Promise<FrameLoaderMetadata>;
+    /**
+     * 単一フレームを読み込み
+     * @param filePath - 画像ファイルパス
+     * @returns フレームデータ（メタデータ + RGBAバッファ）
+     * @throws FrameLoaderError パスが無効またはロード失敗
+     */
+    loadFrame(filePath: string): Promise<FrameLoaderData>;
+    /**
+     * 2つのフレームをペアで読み込み
+     * 差分比較用に同じサイズであることを検証
+     *
+     * @param path1 - フレーム1のパス
+     * @param path2 - フレーム2のパス
+     * @returns フレームペア
+     * @throws FrameLoaderError パスが無効、サイズ不一致
+     */
+    loadFramePair(path1: string, path2: string): Promise<FramePair>;
+}
+export default FrameLoader;
+//# sourceMappingURL=frame-loader.d.ts.map

package/dist/services/motion/infrastructure/frame-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-loader.d.ts","sourceRoot":"","sources":["../../../../src/services/motion/infrastructure/frame-loader.ts"],"names":[],"mappings":"AAkBA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,oBAAoB,EAE1B,MAAM,UAAU,CAAC;AAgBlB;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAW;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IAEpC;;;OAGG;gBACS,OAAO,GAAE,kBAAuB;IA4B5C;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAwC3B;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAiBlC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;;;OAIG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA8ExE;;;;;OAKG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAoDtE;;;;;OAKG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA6E3D;;;;;;;;OAQG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;CAsCtE;AAMD,eAAe,WAAW,CAAC"}