@reftrixmcp/mcp-server 0.1.7

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

@@ -0,0 +1,1023 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrameEmbeddingService = exports.motionVectorToTextRepresentation = exports.layoutShiftToTextRepresentation = exports.animationZoneToTextRepresentation = exports.resetFramePrismaClientFactory = exports.setFramePrismaClientFactory = exports.resetFrameEmbeddingServiceFactory = exports.setFrameEmbeddingServiceFactory = exports.DEFAULT_EMBEDDING_DIMENSIONS = exports.DEFAULT_MODEL_NAME = void 0;
+exports.setEmbeddingServiceFactory = setEmbeddingServiceFactory;
+exports.resetEmbeddingServiceFactory = resetEmbeddingServiceFactory;
+exports.setPrismaClientFactory = setPrismaClientFactory;
+exports.resetPrismaClientFactory = resetPrismaClientFactory;
+exports.animationZoneToText = animationZoneToText;
+exports.layoutShiftToText = layoutShiftToText;
+exports.motionVectorToText = motionVectorToText;
+exports.frameAnalysisToText = frameAnalysisToText;
+exports.saveMotionEmbedding = saveMotionEmbedding;
+exports.saveFrameAnalysisWithEmbeddings = saveFrameAnalysisWithEmbeddings;
+exports.getFrameEmbeddingService = getFrameEmbeddingService;
+exports.resetFrameEmbeddingService = resetFrameEmbeddingService;
+/**
+ * FrameEmbeddingService
+ * VideoModeで取得したフレーム解析結果（FrameImageAnalysisOutput）からEmbeddingを生成するサービス
+ *
+ * 設計:
+ * - AnimationZone/MotionVectorInfoをテキスト表現に変換してEmbedding生成
+ * - multilingual-e5-base（768次元）を使用
+ * - L2正規化必須
+ * - DIパターンでEmbeddingServiceを注入可能
+ *
+ * パフォーマンス目標:
+ * - 単一Embedding: < 200ms
+ * - バッチ10件: < 2s
+ *
+ * @module services/motion/frame-embedding.service
+ */
+const logger_1 = require("../../utils/logger");
+const embedding_validation_service_1 = require("../embedding-validation.service");
+// =====================================================
+// 定数
+// =====================================================
+/** デフォルトのモデル名 */
+exports.DEFAULT_MODEL_NAME = "multilingual-e5-base";
+/** デフォルトのEmbedding次元数 */
+exports.DEFAULT_EMBEDDING_DIMENSIONS = 768;
+// =====================================================
+// サービスファクトリ（DI用）
+// =====================================================
+let embeddingServiceFactory = null;
+let prismaClientFactory = null;
+/**
+ * EmbeddingServiceファクトリを設定
+ */
+function setEmbeddingServiceFactory(factory) {
+    embeddingServiceFactory = factory;
+}
+/**
+ * EmbeddingServiceファクトリをリセット
+ */
+function resetEmbeddingServiceFactory() {
+    embeddingServiceFactory = null;
+}
+/**
+ * PrismaClientファクトリを設定
+ */
+function setPrismaClientFactory(factory) {
+    prismaClientFactory = factory;
+}
+/**
+ * PrismaClientファクトリをリセット
+ */
+function resetPrismaClientFactory() {
+    prismaClientFactory = null;
+}
+// Backward compatibility aliases
+exports.setFrameEmbeddingServiceFactory = setEmbeddingServiceFactory;
+exports.resetFrameEmbeddingServiceFactory = resetEmbeddingServiceFactory;
+exports.setFramePrismaClientFactory = setPrismaClientFactory;
+exports.resetFramePrismaClientFactory = resetPrismaClientFactory;
+// =====================================================
+// テキスト表現生成関数
+// =====================================================
+/**
+ * AnimationZoneからテキスト表現を生成
+ *
+ * @example
+ * "scroll-linked animation from 500px to 1200px, duration 700px, 15.5% average change"
+ */
+function animationZoneToText(zone) {
+    const parts = [];
+    // アニメーションタイプ
+    parts.push(`${zone.animationType} animation zone`);
+    // スクロール範囲
+    parts.push(`scroll range: ${zone.scrollStart}px to ${zone.scrollEnd}px`);
+    // 継続時間
+    parts.push(`duration: ${zone.duration}px scroll distance`);
+    // 変化量
+    parts.push(`average change: ${zone.avgDiff}%`);
+    parts.push(`peak change: ${zone.peakDiff}%`);
+    // フレーム範囲
+    parts.push(`frames: ${zone.frameStart} to ${zone.frameEnd}`);
+    return parts.join(". ") + ".";
+}
+/**
+ * LayoutShiftInfoからテキスト表現を生成
+ */
+function layoutShiftToText(layoutShift) {
+    const parts = [];
+    // タイプ
+    parts.push("layout shift detected");
+    // フレーム範囲
+    parts.push(`frame range: ${layoutShift.frameRange}`);
+    // スクロール範囲
+    parts.push(`scroll range: ${layoutShift.scrollRange}`);
+    // 影響度
+    parts.push(`impact fraction: ${layoutShift.impactFraction}`);
+    // 境界ボックス
+    const bbox = layoutShift.boundingBox;
+    parts.push(`bounding box: x=${bbox.x}, y=${bbox.y}, width=${bbox.width}, height=${bbox.height}`);
+    return parts.join(". ") + ".";
+}
+/**
+ * MotionVectorInfoからテキスト表現を生成
+ *
+ * @example
+ * "motion vector moving down at 45 degrees, magnitude 120px"
+ */
+function motionVectorToText(vector) {
+    const parts = [];
+    // タイプ
+    parts.push("motion vector detected");
+    // 方向
+    parts.push(`direction: ${vector.direction}`);
+    // フレーム範囲
+    parts.push(`frame range: ${vector.frameRange}`);
+    // 移動量
+    parts.push(`displacement: dx=${vector.dx}px, dy=${vector.dy}px`);
+    // 強度
+    parts.push(`magnitude: ${vector.magnitude}px`);
+    // 角度
+    parts.push(`angle: ${vector.angle} degrees`);
+    return parts.join(". ") + ".";
+}
+/**
+ * FrameImageAnalysisOutputからテキスト表現を生成
+ */
+function frameAnalysisToText(analysis) {
+    const parts = [];
+    // メタデータ
+    parts.push(`frame analysis: ${analysis.metadata.totalFrames} total frames`);
+    parts.push(`analyzed ${analysis.metadata.analyzedPairs} pairs`);
+    parts.push(`average diff: ${analysis.statistics.averageDiffPercentage}%`);
+    // アニメーションゾーン
+    if (analysis.animationZones.length > 0) {
+        parts.push(`${analysis.animationZones.length} animation zones detected`);
+        for (const zone of analysis.animationZones) {
+            parts.push(animationZoneToText(zone));
+        }
+    }
+    // モーションベクトル
+    if (analysis.motionVectors.length > 0) {
+        parts.push(`${analysis.motionVectors.length} motion vectors detected`);
+        for (const vector of analysis.motionVectors) {
+            parts.push(motionVectorToText(vector));
+        }
+    }
+    // レイアウトシフト
+    if (analysis.layoutShifts.length > 0) {
+        parts.push(`${analysis.layoutShifts.length} layout shifts detected`);
+        for (const shift of analysis.layoutShifts) {
+            parts.push(layoutShiftToText(shift));
+        }
+    }
+    return parts.join(" ");
+}
+// Backward compatibility aliases
+exports.animationZoneToTextRepresentation = animationZoneToText;
+exports.layoutShiftToTextRepresentation = layoutShiftToText;
+exports.motionVectorToTextRepresentation = motionVectorToText;
+// =====================================================
+// ヘルパー関数
+// =====================================================
+/**
+ * L2正規化
+ */
+function normalizeL2(vector) {
+    const norm = Math.sqrt(vector.reduce((sum, val) => sum + val * val, 0));
+    if (norm === 0)
+        return vector;
+    return vector.map((val) => val / norm);
+}
+/**
+ * コサイン類似度を計算
+ */
+function calculateCosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error(`Vector dimensions do not match: ${a.length} vs ${b.length}`);
+    }
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        const aVal = a[i] ?? 0;
+        const bVal = b[i] ?? 0;
+        dotProduct += aVal * bVal;
+        normA += aVal * aVal;
+        normB += bVal * bVal;
+    }
+    normA = Math.sqrt(normA);
+    normB = Math.sqrt(normB);
+    if (normA === 0 || normB === 0) {
+        return 0;
+    }
+    return dotProduct / (normA * normB);
+}
+// =====================================================
+// FrameEmbeddingService クラス
+// =====================================================
+/**
+ * FrameEmbeddingService
+ * フレーム画像分析結果からEmbeddingを生成するサービス
+ */
+class FrameEmbeddingService {
+    embeddingService = null;
+    prismaClient = null;
+    modelName;
+    normalize;
+    constructor(options) {
+        this.modelName = options?.modelName ?? exports.DEFAULT_MODEL_NAME;
+        this.normalize = options?.normalize ?? true;
+        if (options?.embeddingService) {
+            this.embeddingService = options.embeddingService;
+        }
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[FrameEmbedding] Service initialized", {
+                modelName: this.modelName,
+                normalize: this.normalize,
+            });
+        }
+    }
+    /**
+     * EmbeddingServiceを取得
+     */
+    getEmbeddingService() {
+        if (this.embeddingService) {
+            return this.embeddingService;
+        }
+        if (embeddingServiceFactory) {
+            this.embeddingService = embeddingServiceFactory();
+            return this.embeddingService;
+        }
+        throw new Error("EmbeddingService not initialized");
+    }
+    /**
+     * PrismaClientを取得
+     */
+    getPrismaClient() {
+        if (this.prismaClient) {
+            return this.prismaClient;
+        }
+        if (prismaClientFactory) {
+            this.prismaClient = prismaClientFactory();
+            return this.prismaClient;
+        }
+        throw new Error("PrismaClient not initialized");
+    }
+    /**
+     * テキストからEmbeddingを生成
+     */
+    async generateEmbeddingFromText(text) {
+        const service = this.getEmbeddingService();
+        const embedding = await service.generateEmbedding(`passage: ${text}`, "passage");
+        // Embeddingベクトルの検証
+        const validationResult = (0, embedding_validation_service_1.validateEmbeddingVector)(embedding);
+        if (!validationResult.isValid) {
+            const error = validationResult.error;
+            const errorMessage = error?.index !== undefined
+                ? `${error.message} at index ${error.index}`
+                : (error?.message ?? "Unknown validation error");
+            throw new embedding_validation_service_1.EmbeddingValidationError(error?.code ?? "INVALID_VECTOR", errorMessage, error?.index);
+        }
+        // L2正規化
+        if (this.normalize) {
+            return normalizeL2(embedding);
+        }
+        return embedding;
+    }
+    // =====================================================
+    // 単一生成メソッド
+    // =====================================================
+    /**
+     * AnimationZoneからEmbeddingを生成
+     */
+    async generateFromAnimationZone(zone) {
+        if (!zone || typeof zone !== "object") {
+            throw new Error("Invalid input: zone must be a valid AnimationZone object");
+        }
+        const startTime = Date.now();
+        const textUsed = animationZoneToText(zone);
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[FrameEmbedding] Generating from animation zone", {
+                animationType: zone.animationType,
+                scrollRange: `${zone.scrollStart}-${zone.scrollEnd}`,
+            });
+        }
+        const embedding = await this.generateEmbeddingFromText(textUsed);
+        const processingTimeMs = Date.now() - startTime;
+        return {
+            embedding,
+            textUsed,
+            modelName: this.modelName,
+            processingTimeMs,
+        };
+    }
+    /**
+     * MotionVectorInfoからEmbeddingを生成
+     */
+    async generateFromMotionVector(vector) {
+        if (!vector || typeof vector !== "object") {
+            throw new Error("Invalid input: vector must be a valid MotionVectorInfo object");
+        }
+        const startTime = Date.now();
+        const textUsed = motionVectorToText(vector);
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[FrameEmbedding] Generating from motion vector", {
+                direction: vector.direction,
+                magnitude: vector.magnitude,
+            });
+        }
+        const embedding = await this.generateEmbeddingFromText(textUsed);
+        const processingTimeMs = Date.now() - startTime;
+        return {
+            embedding,
+            textUsed,
+            modelName: this.modelName,
+            processingTimeMs,
+        };
+    }
+    /**
+     * FrameImageAnalysisOutputからEmbeddingを生成
+     */
+    async generateFromFrameAnalysis(analysis) {
+        if (!analysis || typeof analysis !== "object") {
+            throw new Error("Invalid input: analysis must be a valid FrameImageAnalysisOutput object");
+        }
+        const startTime = Date.now();
+        const textUsed = frameAnalysisToText(analysis);
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[FrameEmbedding] Generating from frame analysis", {
+                totalFrames: analysis.metadata.totalFrames,
+                zones: analysis.animationZones.length,
+                vectors: analysis.motionVectors.length,
+            });
+        }
+        const embedding = await this.generateEmbeddingFromText(textUsed);
+        const processingTimeMs = Date.now() - startTime;
+        return {
+            embedding,
+            textUsed,
+            modelName: this.modelName,
+            processingTimeMs,
+        };
+    }
+    // =====================================================
+    // 配列生成メソッド
+    // =====================================================
+    /**
+     * AnimationZone配列からEmbedding配列を生成
+     */
+    async generateFromAnimationZones(zones) {
+        if (zones.length === 0) {
+            return [];
+        }
+        const texts = zones.map((zone) => animationZoneToText(zone));
+        try {
+            const service = this.getEmbeddingService();
+            const embeddings = await service.generateBatchEmbeddings(texts.map((t) => `passage: ${t}`), "passage");
+            return zones.map((_zone, i) => {
+                let embedding = embeddings[i] ?? [];
+                if (this.normalize && embedding.length > 0) {
+                    embedding = normalizeL2(embedding);
+                }
+                return {
+                    embedding,
+                    textUsed: texts[i] ?? "",
+                    modelName: this.modelName,
+                    processingTimeMs: 0,
+                };
+            });
+        }
+        catch (error) {
+            // バッチ処理が失敗した場合は個別に処理
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.warn("[FrameEmbedding] Batch failed, falling back to individual", {
+                    error: error instanceof Error ? error.message : "Unknown error",
+                });
+            }
+            const results = [];
+            for (const zone of zones) {
+                try {
+                    const result = await this.generateFromAnimationZone(zone);
+                    results.push(result);
+                }
+                catch {
+                    // Skip failed ones
+                }
+            }
+            return results;
+        }
+    }
+    /**
+     * MotionVectorInfo配列からEmbedding配列を生成
+     */
+    async generateFromMotionVectors(vectors) {
+        if (vectors.length === 0) {
+            return [];
+        }
+        const texts = vectors.map((v) => motionVectorToText(v));
+        try {
+            const service = this.getEmbeddingService();
+            const embeddings = await service.generateBatchEmbeddings(texts.map((t) => `passage: ${t}`), "passage");
+            return vectors.map((_vector, i) => {
+                let embedding = embeddings[i] ?? [];
+                if (this.normalize && embedding.length > 0) {
+                    embedding = normalizeL2(embedding);
+                }
+                return {
+                    embedding,
+                    textUsed: texts[i] ?? "",
+                    modelName: this.modelName,
+                    processingTimeMs: 0,
+                };
+            });
+        }
+        catch (error) {
+            // バッチ処理が失敗した場合は個別に処理
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.warn("[FrameEmbedding] Batch failed, falling back to individual", {
+                    error: error instanceof Error ? error.message : "Unknown error",
+                });
+            }
+            const results = [];
+            for (const vector of vectors) {
+                try {
+                    const result = await this.generateFromMotionVector(vector);
+                    results.push(result);
+                }
+                catch {
+                    // Skip failed ones
+                }
+            }
+            return results;
+        }
+    }
+    // =====================================================
+    // 統合生成メソッド
+    // =====================================================
+    /**
+     * FrameImageAnalysisOutputから統合Embedding結果を生成
+     */
+    async generateFromAnalysis(analysis) {
+        const startTime = Date.now();
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[FrameEmbedding] Generating from analysis (integrated)", {
+                zones: analysis.animationZones.length,
+                vectors: analysis.motionVectors.length,
+            });
+        }
+        // AnimationZonesのEmbedding生成
+        const zoneEmbeddings = await this.generateFromAnimationZones(analysis.animationZones);
+        // MotionVectorsのEmbedding生成
+        const vectorEmbeddings = await this.generateFromMotionVectors(analysis.motionVectors);
+        // サマリーEmbedding生成
+        const summaryEmbedding = await this.generateFromFrameAnalysis(analysis);
+        const processingTimeMs = Date.now() - startTime;
+        return {
+            zoneEmbeddings,
+            vectorEmbeddings,
+            summaryEmbedding,
+            metadata: {
+                totalFrames: analysis.metadata.totalFrames,
+                analyzedPairs: analysis.metadata.analyzedPairs,
+                framesDir: analysis.metadata.framesDir,
+                analysisTime: analysis.metadata.analysisTime,
+            },
+            processingTimeMs,
+        };
+    }
+    // =====================================================
+    // バッチ処理メソッド
+    // =====================================================
+    /**
+     * AnimationZone配列からバッチでEmbeddingを生成（進捗コールバック対応）
+     */
+    async generateBatchFromAnimationZones(zones, options) {
+        if (zones.length === 0) {
+            return [];
+        }
+        const continueOnError = options?.continueOnError ?? false;
+        const results = [];
+        try {
+            const service = this.getEmbeddingService();
+            const texts = zones.map((zone) => animationZoneToText(zone));
+            const embeddings = await service.generateBatchEmbeddings(texts.map((t) => `passage: ${t}`), "passage");
+            for (let i = 0; i < zones.length; i++) {
+                let embedding = embeddings[i] ?? [];
+                if (this.normalize && embedding.length > 0) {
+                    embedding = normalizeL2(embedding);
+                }
+                results.push({
+                    embedding,
+                    textUsed: texts[i] ?? "",
+                    modelName: this.modelName,
+                    processingTimeMs: 0,
+                });
+                if (options?.onProgress) {
+                    options.onProgress(i + 1, zones.length);
+                }
+            }
+        }
+        catch (error) {
+            // バッチ処理が失敗した場合は個別に処理
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.warn("[FrameEmbedding] Batch failed, falling back to individual", {
+                    error: error instanceof Error ? error.message : "Unknown error",
+                });
+            }
+            for (let i = 0; i < zones.length; i++) {
+                const zone = zones[i];
+                if (!zone)
+                    continue;
+                try {
+                    const result = await this.generateFromAnimationZone(zone);
+                    results.push(result);
+                }
+                catch (indError) {
+                    if (!continueOnError) {
+                        throw indError;
+                    }
+                    // continueOnError=trueの場合はスキップ
+                }
+                if (options?.onProgress) {
+                    options.onProgress(i + 1, zones.length);
+                }
+            }
+        }
+        return results;
+    }
+    // =====================================================
+    // 類似度計算
+    // =====================================================
+    /**
+     * 2つのEmbedding間の類似度を計算
+     */
+    calculateSimilarity(embedding1, embedding2) {
+        return calculateCosineSimilarity(embedding1, embedding2);
+    }
+    // =====================================================
+    // キャッシュ管理
+    // =====================================================
+    /**
+     * キャッシュ統計を取得
+     */
+    getCacheStats() {
+        try {
+            const service = this.getEmbeddingService();
+            return service.getCacheStats();
+        }
+        catch {
+            return { hits: 0, misses: 0, size: 0, evictions: 0 };
+        }
+    }
+    /**
+     * キャッシュをクリア
+     */
+    clearCache() {
+        try {
+            const service = this.getEmbeddingService();
+            service.clearCache();
+        }
+        catch {
+            // サービスが初期化されていない場合は何もしない
+        }
+    }
+    // =====================================================
+    // DB保存メソッド
+    // =====================================================
+    /**
+     * AnimationZoneをMotionPatternとして保存
+     */
+    async saveAnimationZone(zone, webPageId, sourceUrl) {
+        const prisma = this.getPrismaClient();
+        const textRepresentation = animationZoneToText(zone);
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[FrameEmbedding] Saving animation zone", {
+                animationType: zone.animationType,
+                scrollRange: `${zone.scrollStart}-${zone.scrollEnd}`,
+            });
+        }
+        // MotionPatternを作成
+        const patternData = {
+            name: `${zone.animationType}_${zone.scrollStart}-${zone.scrollEnd}`,
+            type: `scroll_animation_${zone.animationType}`,
+            category: this.mapAnimationTypeToCategory(zone.animationType),
+            triggerType: "scroll",
+            triggerConfig: { scrollStart: zone.scrollStart, scrollEnd: zone.scrollEnd },
+            animation: {
+                duration: zone.duration,
+                avgChange: parseFloat(zone.avgDiff),
+                peakChange: parseFloat(zone.peakDiff),
+            },
+            properties: [
+                { property: "opacity", from: "0", to: "1" },
+                { property: "transform", from: "none", to: "none" },
+            ],
+            implementation: {},
+            accessibility: {},
+            performance: {},
+            usageScope: "inspiration_only",
+            tags: ["frame-analysis", zone.animationType],
+            metadata: {
+                frameStart: zone.frameStart,
+                frameEnd: zone.frameEnd,
+                analysisSource: "frame-image-analysis",
+            },
+        };
+        if (webPageId !== undefined) {
+            patternData.webPageId = webPageId;
+        }
+        if (sourceUrl !== undefined) {
+            patternData.sourceUrl = sourceUrl;
+        }
+        const createdPattern = await prisma.motionPattern.create({
+            data: patternData,
+        });
+        // Embeddingを生成して保存
+        const embeddingId = await this.saveEmbeddingToDb(createdPattern.id, textRepresentation);
+        return { patternId: createdPattern.id, embeddingId };
+    }
+    /**
+     * LayoutShiftをMotionPatternとして保存
+     */
+    async saveLayoutShift(layoutShift, webPageId, sourceUrl) {
+        const prisma = this.getPrismaClient();
+        const textRepresentation = layoutShiftToText(layoutShift);
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[FrameEmbedding] Saving layout shift", {
+                frameRange: layoutShift.frameRange,
+                impactFraction: layoutShift.impactFraction,
+            });
+        }
+        // MotionPatternを作成
+        const patternData = {
+            name: `layout_shift_${layoutShift.impactFraction}`,
+            category: "layout_shift",
+            triggerType: "scroll",
+            triggerConfig: {},
+            animation: {
+                impactFraction: parseFloat(layoutShift.impactFraction),
+            },
+            properties: [{ property: "position", from: "initial", to: "shifted" }],
+            implementation: {},
+            accessibility: {
+                warnings: ["potential-cls-issue"],
+            },
+            performance: {
+                clsImpact: parseFloat(layoutShift.impactFraction),
+            },
+            usageScope: "inspiration_only",
+            tags: ["frame-analysis", "layout-shift", "cls"],
+            metadata: {
+                frameRange: layoutShift.frameRange,
+                scrollRange: layoutShift.scrollRange,
+                boundingBox: layoutShift.boundingBox,
+                analysisSource: "frame-image-analysis",
+            },
+        };
+        if (webPageId !== undefined) {
+            patternData.webPageId = webPageId;
+        }
+        if (sourceUrl !== undefined) {
+            patternData.sourceUrl = sourceUrl;
+        }
+        const createdPattern = await prisma.motionPattern.create({
+            data: patternData,
+        });
+        // Embeddingを生成して保存
+        const embeddingId = await this.saveEmbeddingToDb(createdPattern.id, textRepresentation);
+        return { patternId: createdPattern.id, embeddingId };
+    }
+    /**
+     * MotionVectorをMotionPatternとして保存
+     */
+    async saveMotionVector(vector, webPageId, sourceUrl) {
+        const prisma = this.getPrismaClient();
+        const textRepresentation = motionVectorToText(vector);
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[FrameEmbedding] Saving motion vector", {
+                direction: vector.direction,
+                magnitude: vector.magnitude,
+            });
+        }
+        // MotionPatternを作成
+        const patternData = {
+            name: `motion_${vector.direction}_${vector.magnitude}`,
+            category: "motion_vector",
+            triggerType: "scroll",
+            triggerConfig: {},
+            animation: {
+                dx: vector.dx,
+                dy: vector.dy,
+                magnitude: parseFloat(vector.magnitude),
+                angle: parseFloat(vector.angle),
+            },
+            properties: [
+                {
+                    property: "transform",
+                    from: "translate(0,0)",
+                    to: `translate(${vector.dx}px,${vector.dy}px)`,
+                },
+            ],
+            implementation: {},
+            accessibility: {},
+            performance: {},
+            usageScope: "inspiration_only",
+            tags: ["frame-analysis", "motion-vector", vector.direction],
+            metadata: {
+                frameRange: vector.frameRange,
+                direction: vector.direction,
+                analysisSource: "frame-image-analysis",
+            },
+        };
+        if (webPageId !== undefined) {
+            patternData.webPageId = webPageId;
+        }
+        if (sourceUrl !== undefined) {
+            patternData.sourceUrl = sourceUrl;
+        }
+        const createdPattern = await prisma.motionPattern.create({
+            data: patternData,
+        });
+        // Embeddingを生成して保存
+        const embeddingId = await this.saveEmbeddingToDb(createdPattern.id, textRepresentation);
+        return { patternId: createdPattern.id, embeddingId };
+    }
+    /**
+     * Embeddingを生成してDBに保存
+     */
+    async saveEmbeddingToDb(patternId, textRepresentation) {
+        const prisma = this.getPrismaClient();
+        // Embeddingを生成
+        let embedding;
+        try {
+            embedding = await this.generateEmbeddingFromText(textRepresentation);
+        }
+        catch (error) {
+            // EmbeddingValidationError は再スロー
+            if (error instanceof embedding_validation_service_1.EmbeddingValidationError) {
+                throw error;
+            }
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.warn("[FrameEmbedding] Embedding generation failed", {
+                    error: error instanceof Error ? error.message : "Unknown error",
+                    patternId,
+                });
+            }
+            // Embeddingなしで保存（後でリトライ可能）
+            embedding = [];
+        }
+        // MotionEmbeddingを作成
+        const createdEmbedding = await prisma.motionEmbedding.create({
+            data: {
+                motionPatternId: patternId,
+                textRepresentation,
+                modelVersion: this.modelName,
+            },
+        });
+        // Embeddingベクトルを更新（pgvector形式）
+        if (embedding.length > 0) {
+            const vectorString = `[${embedding.join(",")}]`;
+            await prisma.$executeRawUnsafe(`UPDATE motion_embeddings SET embedding = $1::vector WHERE id = $2::uuid`, vectorString, createdEmbedding.id);
+        }
+        return createdEmbedding.id;
+    }
+    /**
+     * AnimationTypeをDBカテゴリにマッピング
+     */
+    mapAnimationTypeToCategory(animationType) {
+        switch (animationType) {
+            case "micro-interaction":
+                return "micro_interaction";
+            case "fade/slide transition":
+                return "transition";
+            case "scroll-linked animation":
+                return "scroll_animation";
+            case "long-form reveal":
+                return "reveal_animation";
+            default:
+                return "unknown";
+        }
+    }
+    /**
+     * フレーム画像分析結果をDBに保存
+     */
+    async saveFrameAnalysis(input) {
+        const { analysisResult, webPageId, sourceUrl } = input;
+        const patternIds = [];
+        const embeddingIds = [];
+        const errors = [];
+        let animationZonesSaved = 0;
+        let layoutShiftsSaved = 0;
+        let motionVectorsSaved = 0;
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[FrameEmbedding] Starting frame analysis save", {
+                animationZones: analysisResult.animationZones.length,
+                layoutShifts: analysisResult.layoutShifts.length,
+                motionVectors: analysisResult.motionVectors.length,
+                webPageId,
+            });
+        }
+        // AnimationZonesを保存
+        for (let i = 0; i < analysisResult.animationZones.length; i++) {
+            const zone = analysisResult.animationZones[i];
+            if (!zone)
+                continue;
+            try {
+                const result = await this.saveAnimationZone(zone, webPageId, sourceUrl);
+                patternIds.push(result.patternId);
+                embeddingIds.push(result.embeddingId);
+                animationZonesSaved++;
+            }
+            catch (error) {
+                errors.push({
+                    type: "animationZone",
+                    index: i,
+                    error: error instanceof Error ? error : new Error("Unknown error"),
+                });
+                if ((0, logger_1.isDevelopment)()) {
+                    logger_1.logger.warn("[FrameEmbedding] Failed to save animation zone", {
+                        index: i,
+                        error: error instanceof Error ? error.message : "Unknown error",
+                    });
+                }
+            }
+        }
+        // LayoutShiftsを保存
+        for (let i = 0; i < analysisResult.layoutShifts.length; i++) {
+            const layoutShift = analysisResult.layoutShifts[i];
+            if (!layoutShift)
+                continue;
+            try {
+                const result = await this.saveLayoutShift(layoutShift, webPageId, sourceUrl);
+                patternIds.push(result.patternId);
+                embeddingIds.push(result.embeddingId);
+                layoutShiftsSaved++;
+            }
+            catch (error) {
+                errors.push({
+                    type: "layoutShift",
+                    index: i,
+                    error: error instanceof Error ? error : new Error("Unknown error"),
+                });
+                if ((0, logger_1.isDevelopment)()) {
+                    logger_1.logger.warn("[FrameEmbedding] Failed to save layout shift", {
+                        index: i,
+                        error: error instanceof Error ? error.message : "Unknown error",
+                    });
+                }
+            }
+        }
+        // MotionVectorsを保存
+        for (let i = 0; i < analysisResult.motionVectors.length; i++) {
+            const vector = analysisResult.motionVectors[i];
+            if (!vector)
+                continue;
+            try {
+                const result = await this.saveMotionVector(vector, webPageId, sourceUrl);
+                patternIds.push(result.patternId);
+                embeddingIds.push(result.embeddingId);
+                motionVectorsSaved++;
+            }
+            catch (error) {
+                errors.push({
+                    type: "motionVector",
+                    index: i,
+                    error: error instanceof Error ? error : new Error("Unknown error"),
+                });
+                if ((0, logger_1.isDevelopment)()) {
+                    logger_1.logger.warn("[FrameEmbedding] Failed to save motion vector", {
+                        index: i,
+                        error: error instanceof Error ? error.message : "Unknown error",
+                    });
+                }
+            }
+        }
+        const savedCount = patternIds.length;
+        const totalItems = analysisResult.animationZones.length +
+            analysisResult.layoutShifts.length +
+            analysisResult.motionVectors.length;
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[FrameEmbedding] Frame analysis save completed", {
+                savedCount,
+                totalItems,
+                errorCount: errors.length,
+                byCategory: {
+                    animationZones: animationZonesSaved,
+                    layoutShifts: layoutShiftsSaved,
+                    motionVectors: motionVectorsSaved,
+                },
+            });
+        }
+        const result = {
+            saved: savedCount > 0,
+            savedCount,
+            patternIds,
+            savedPatternIds: patternIds, // エイリアス（テスト互換性用）
+            embeddingIds,
+            byCategory: {
+                animationZones: animationZonesSaved,
+                layoutShifts: layoutShiftsSaved,
+                motionVectors: motionVectorsSaved,
+            },
+        };
+        // エラーがある場合は理由を設定
+        if (!result.saved && errors.length > 0) {
+            const firstError = errors[0];
+            result.reason = `Save failed: ${firstError?.error.message || "Unknown error"} [total=${totalItems}, errors=${errors.length}]`;
+        }
+        else if (!result.saved && totalItems === 0) {
+            result.reason = "No items to save";
+        }
+        return result;
+    }
+    /**
+     * 利用可能かどうかをチェック
+     */
+    isAvailable() {
+        try {
+            this.getPrismaClient();
+            return true;
+        }
+        catch (error) {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.warn("[FrameEmbedding] isAvailable check failed", {
+                    error: error instanceof Error ? error.message : "Unknown error",
+                    hasPrismaClientFactory: prismaClientFactory !== null,
+                    hasEmbeddingServiceFactory: embeddingServiceFactory !== null,
+                });
+            }
+            return false;
+        }
+    }
+}
+exports.FrameEmbeddingService = FrameEmbeddingService;
+// =====================================================
+// DB保存関数（非クラスメソッド）
+// =====================================================
+/**
+ * MotionEmbeddingをDBに保存
+ *
+ * @param motionPatternId - MotionPattern ID
+ * @param embedding - Embeddingベクトル
+ * @param modelVersion - モデルバージョン（テキスト表現としても使用）
+ * @returns 作成されたMotionEmbedding ID
+ */
+async function saveMotionEmbedding(motionPatternId, embedding, modelVersion) {
+    if (!prismaClientFactory) {
+        throw new Error("PrismaClient not initialized");
+    }
+    const prisma = prismaClientFactory();
+    // MotionEmbeddingを作成
+    const createdEmbedding = await prisma.motionEmbedding.create({
+        data: {
+            motionPatternId,
+            textRepresentation: modelVersion, // テキスト表現としても使用
+            modelVersion,
+        },
+    });
+    // Embeddingベクトルを更新（pgvector形式）
+    if (embedding.length > 0) {
+        const vectorString = `[${embedding.join(",")}]`;
+        await prisma.$executeRawUnsafe(`UPDATE motion_embeddings SET embedding = $1::vector WHERE id = $2::uuid`, vectorString, createdEmbedding.id);
+    }
+    return createdEmbedding.id;
+}
+/**
+ * フレーム分析結果をEmbeddingと共にDBに保存
+ *
+ * @param webPageId - WebPage ID
+ * @param analysis - フレーム画像分析結果
+ * @param embeddingResult - Embedding結果（オプション、事前生成済みの場合）
+ * @returns 保存結果
+ */
+async function saveFrameAnalysisWithEmbeddings(webPageId, analysis, embeddingResult) {
+    // 新しいインスタンスを作成してDI設定を反映
+    // （テスト時にモックファクトリが使用されるようにする）
+    const service = new FrameEmbeddingService();
+    // embeddingResultは現在未使用（将来の最適化用）
+    // 事前に生成されたEmbeddingを再利用する場合に使用可能
+    void embeddingResult;
+    return service.saveFrameAnalysis({
+        analysisResult: analysis,
+        webPageId,
+    });
+}
+// =====================================================
+// シングルトンインスタンス
+// =====================================================
+let frameEmbeddingServiceInstance = null;
+/**
+ * FrameEmbeddingServiceインスタンスを取得
+ */
+function getFrameEmbeddingService() {
+    if (!frameEmbeddingServiceInstance) {
+        frameEmbeddingServiceInstance = new FrameEmbeddingService();
+    }
+    return frameEmbeddingServiceInstance;
+}
+/**
+ * FrameEmbeddingServiceインスタンスをリセット
+ */
+function resetFrameEmbeddingService() {
+    frameEmbeddingServiceInstance = null;
+}
+exports.default = FrameEmbeddingService;
+//# sourceMappingURL=frame-embedding.service.js.map