@reftrixmcp/mcp-server 0.1.7

package/dist/services/section-screenshot.service.js

@@ -0,0 +1,363 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SectionScreenshotService = exports.SectionScreenshotServiceError = void 0;
+/**
+ * SectionScreenshotService
+ *
+ * フルページスクリーンショットからセクションを切り出すサービス
+ *
+ * 機能:
+ * - Sharpを使用したセクション画像の切り出し
+ * - Base64またはBufferの入力に対応
+ * - 複数セクションの並列切り出し対応
+ * - 境界外アクセスのエラーハンドリング
+ *
+ * @module @reftrixmcp/mcp-server/services/section-screenshot.service
+ */
+const sharp_1 = __importDefault(require("sharp"));
+const logger_1 = require("../utils/logger");
+// ============================================================================
+// エラークラス
+// ============================================================================
+/**
+ * セクションスクリーンショットサービスエラー
+ */
+class SectionScreenshotServiceError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = "SectionScreenshotServiceError";
+        this.code = code;
+        this.details = details;
+    }
+}
+exports.SectionScreenshotServiceError = SectionScreenshotServiceError;
+// ============================================================================
+// デフォルト設定
+// ============================================================================
+const DEFAULT_OPTIONS = {
+    format: "png",
+    quality: 90,
+    maxConcurrency: 5,
+};
+// ============================================================================
+// SectionScreenshotService クラス
+// ============================================================================
+/**
+ * フルページスクリーンショットからセクションを切り出すサービス
+ *
+ * @example
+ * ```typescript
+ * const service = new SectionScreenshotService();
+ *
+ * // 単一セクション切り出し
+ * const result = await service.extractSection(
+ *   fullPageBase64,
+ *   { startY: 0, endY: 800, height: 800 },
+ *   'hero-section'
+ * );
+ *
+ * // 複数セクション並列切り出し
+ * const results = await service.extractMultipleSections(
+ *   fullPageBase64,
+ *   [
+ *     { id: 'hero', bounds: { startY: 0, endY: 800, height: 800 } },
+ *     { id: 'features', bounds: { startY: 800, endY: 1600, height: 800 } },
+ *   ]
+ * );
+ * ```
+ */
+class SectionScreenshotService {
+    logger;
+    options;
+    /**
+     * コンストラクタ
+     * @param options - サービスオプション
+     */
+    constructor(options = {}) {
+        this.logger = (0, logger_1.createLogger)("SectionScreenshot");
+        this.options = {
+            format: options.format ?? DEFAULT_OPTIONS.format,
+            quality: options.quality ?? DEFAULT_OPTIONS.quality,
+            maxConcurrency: options.maxConcurrency ?? DEFAULT_OPTIONS.maxConcurrency,
+        };
+        this.logger.debug("Service initialized", {
+            format: this.options.format,
+            quality: this.options.quality,
+            maxConcurrency: this.options.maxConcurrency,
+        });
+    }
+    // ==========================================================================
+    // パブリックメソッド
+    // ==========================================================================
+    /**
+     * 単一セクションを切り出す
+     *
+     * @param fullPageBase64 - フルページスクリーンショットのBase64文字列
+     * @param bounds - セクションの境界情報
+     * @param sectionId - セクション識別子
+     * @param options - 切り出しオプション（オプション）
+     * @returns セクション切り出し結果
+     * @throws SectionScreenshotServiceError
+     */
+    async extractSection(fullPageBase64, bounds, sectionId, options) {
+        this.logger.debug("extractSection called", {
+            sectionId,
+            bounds,
+        });
+        // 入力バリデーション
+        this.validateInput(fullPageBase64, sectionId);
+        this.validateBounds(bounds, sectionId);
+        // Base64をBufferに変換
+        const imageBuffer = this.base64ToBuffer(fullPageBase64);
+        // 画像メタデータを取得
+        const metadata = await this.getImageMetadata(imageBuffer, sectionId);
+        // 境界チェック
+        this.validateBoundsAgainstImage(bounds, metadata.height, sectionId);
+        // セクションを切り出し
+        const result = await this.extractFromBuffer(imageBuffer, bounds, sectionId, metadata.width, options);
+        this.logger.debug("extractSection completed", {
+            sectionId,
+            width: result.width,
+            height: result.height,
+            bufferSize: result.imageBuffer.length,
+        });
+        return result;
+    }
+    /**
+     * 複数セクションを並列で切り出す
+     *
+     * @param fullPageBase64 - フルページスクリーンショットのBase64文字列
+     * @param sections - セクション情報の配列
+     * @param options - 切り出しオプション（オプション）
+     * @returns 成功結果とエラー情報を含む結果オブジェクト
+     */
+    async extractMultipleSections(fullPageBase64, sections, options) {
+        this.logger.debug("extractMultipleSections called", {
+            sectionCount: sections.length,
+        });
+        if (sections.length === 0) {
+            return { successes: [], errors: [] };
+        }
+        // 入力バリデーション
+        this.validateInput(fullPageBase64, "batch");
+        // Base64をBufferに変換（一度だけ）
+        const imageBuffer = this.base64ToBuffer(fullPageBase64);
+        // 画像メタデータを取得（一度だけ）
+        const metadata = await this.getImageMetadata(imageBuffer, "batch");
+        // 並列処理の実行
+        const results = await this.processInBatches(sections, imageBuffer, metadata, options);
+        this.logger.debug("extractMultipleSections completed", {
+            successCount: results.successes.length,
+            errorCount: results.errors.length,
+        });
+        return results;
+    }
+    // ==========================================================================
+    // プライベートメソッド - バリデーション
+    // ==========================================================================
+    /**
+     * 入力のバリデーション
+     */
+    validateInput(fullPageBase64, sectionId) {
+        if (!fullPageBase64 || typeof fullPageBase64 !== "string") {
+            throw new SectionScreenshotServiceError("INVALID_INPUT", "fullPageBase64 must be a non-empty string", { sectionId });
+        }
+        // Base64の基本形式チェック
+        // data:image/... プレフィックスがある場合は除去
+        const base64Data = fullPageBase64.includes(",") ? fullPageBase64.split(",")[1] : fullPageBase64;
+        if (!base64Data || base64Data.length === 0) {
+            throw new SectionScreenshotServiceError("INVALID_INPUT", "Invalid Base64 data: empty after removing prefix", { sectionId });
+        }
+    }
+    /**
+     * 境界情報のバリデーション
+     */
+    validateBounds(bounds, sectionId) {
+        if (bounds.startY < 0) {
+            throw new SectionScreenshotServiceError("INVALID_BOUNDS", `startY must be >= 0, got ${bounds.startY}`, { sectionId, bounds });
+        }
+        if (bounds.endY <= bounds.startY) {
+            throw new SectionScreenshotServiceError("INVALID_BOUNDS", `endY (${bounds.endY}) must be greater than startY (${bounds.startY})`, { sectionId, bounds });
+        }
+        if (bounds.height <= 0) {
+            throw new SectionScreenshotServiceError("INVALID_BOUNDS", `height must be > 0, got ${bounds.height}`, { sectionId, bounds });
+        }
+        // height と startY/endY の整合性チェック
+        const calculatedHeight = bounds.endY - bounds.startY;
+        if (Math.abs(calculatedHeight - bounds.height) > 1) {
+            // 1ピクセルの許容誤差
+            this.logger.warn("Height mismatch detected, using calculated height", {
+                sectionId,
+                providedHeight: bounds.height,
+                calculatedHeight,
+            });
+        }
+    }
+    /**
+     * 境界が画像サイズ内に収まっているか確認
+     */
+    validateBoundsAgainstImage(bounds, imageHeight, sectionId) {
+        if (bounds.startY >= imageHeight) {
+            throw new SectionScreenshotServiceError("OUT_OF_BOUNDS", `startY (${bounds.startY}) is outside image height (${imageHeight})`, { sectionId, bounds, imageHeight });
+        }
+        if (bounds.endY > imageHeight) {
+            throw new SectionScreenshotServiceError("OUT_OF_BOUNDS", `endY (${bounds.endY}) exceeds image height (${imageHeight})`, { sectionId, bounds, imageHeight });
+        }
+    }
+    // ==========================================================================
+    // プライベートメソッド - 画像処理
+    // ==========================================================================
+    /**
+     * Base64をBufferに変換
+     */
+    base64ToBuffer(base64String) {
+        // data:image/... プレフィックスがある場合は除去
+        const base64Data = base64String.includes(",") ? base64String.split(",")[1] : base64String;
+        try {
+            return Buffer.from(base64Data, "base64");
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unknown error";
+            throw new SectionScreenshotServiceError("INVALID_INPUT", `Failed to decode Base64: ${message}`, { originalError: message });
+        }
+    }
+    /**
+     * 画像メタデータを取得
+     */
+    async getImageMetadata(buffer, sectionId) {
+        try {
+            const metadata = await (0, sharp_1.default)(buffer).metadata();
+            if (!metadata.width || !metadata.height) {
+                throw new SectionScreenshotServiceError("IMAGE_PROCESSING_ERROR", "Could not determine image dimensions", { sectionId });
+            }
+            return {
+                width: metadata.width,
+                height: metadata.height,
+            };
+        }
+        catch (error) {
+            if (error instanceof SectionScreenshotServiceError) {
+                throw error;
+            }
+            const message = error instanceof Error ? error.message : "Unknown error";
+            throw new SectionScreenshotServiceError("IMAGE_PROCESSING_ERROR", `Failed to read image metadata: ${message}`, { sectionId, originalError: message });
+        }
+    }
+    /**
+     * Bufferからセクションを切り出し
+     */
+    async extractFromBuffer(buffer, bounds, sectionId, imageWidth, options) {
+        const format = options?.format ?? this.options.format;
+        const quality = options?.quality ?? this.options.quality;
+        // 実際の切り出し高さを計算（endY - startY を使用）
+        const extractHeight = bounds.endY - bounds.startY;
+        try {
+            // Sharpで切り出し
+            let sharpInstance = (0, sharp_1.default)(buffer).extract({
+                left: 0,
+                top: bounds.startY,
+                width: imageWidth,
+                height: extractHeight,
+            });
+            // フォーマット変換
+            switch (format) {
+                case "jpeg":
+                    sharpInstance = sharpInstance.jpeg({ quality });
+                    break;
+                case "webp":
+                    sharpInstance = sharpInstance.webp({ quality });
+                    break;
+                case "png":
+                default:
+                    sharpInstance = sharpInstance.png();
+                    break;
+            }
+            const outputBuffer = await sharpInstance.toBuffer();
+            const base64Output = outputBuffer.toString("base64");
+            // data URIプレフィックスを付与
+            const mimeType = format === "jpeg" ? "image/jpeg" : format === "webp" ? "image/webp" : "image/png";
+            const base64WithPrefix = `data:${mimeType};base64,${base64Output}`;
+            return {
+                sectionId,
+                imageBuffer: outputBuffer,
+                base64: base64WithPrefix,
+                bounds,
+                width: imageWidth,
+                height: extractHeight,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unknown error";
+            throw new SectionScreenshotServiceError("EXTRACTION_FAILED", `Failed to extract section: ${message}`, { sectionId, bounds, originalError: message });
+        }
+    }
+    /**
+     * バッチ処理で複数セクションを並列処理
+     */
+    async processInBatches(sections, imageBuffer, metadata, options) {
+        const successes = [];
+        const errors = [];
+        const maxConcurrency = options?.maxConcurrency ?? this.options.maxConcurrency;
+        // バッチに分割して処理
+        for (let i = 0; i < sections.length; i += maxConcurrency) {
+            const batch = sections.slice(i, i + maxConcurrency);
+            const batchPromises = batch.map(async (section) => {
+                try {
+                    // 境界バリデーション
+                    this.validateBounds(section.bounds, section.id);
+                    this.validateBoundsAgainstImage(section.bounds, metadata.height, section.id);
+                    // 切り出し
+                    const result = await this.extractFromBuffer(imageBuffer, section.bounds, section.id, metadata.width, options);
+                    return { success: true, result };
+                }
+                catch (error) {
+                    const errorInfo = this.createErrorInfo(section.id, error);
+                    return { success: false, error: errorInfo };
+                }
+            });
+            const batchResults = await Promise.all(batchPromises);
+            for (const result of batchResults) {
+                if (result.success) {
+                    successes.push(result.result);
+                }
+                else {
+                    errors.push(result.error);
+                }
+            }
+        }
+        return { successes, errors };
+    }
+    /**
+     * エラー情報を作成
+     */
+    createErrorInfo(sectionId, error) {
+        if (error instanceof SectionScreenshotServiceError) {
+            return {
+                sectionId,
+                errorCode: error.code,
+                errorMessage: error.message,
+                details: error.details,
+            };
+        }
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return {
+            sectionId,
+            errorCode: "EXTRACTION_FAILED",
+            errorMessage: message,
+            details: { originalError: message },
+        };
+    }
+}
+exports.SectionScreenshotService = SectionScreenshotService;
+// ============================================================================
+// エクスポート
+// ============================================================================
+exports.default = SectionScreenshotService;
+//# sourceMappingURL=section-screenshot.service.js.map

package/dist/services/section-screenshot.service.js.map

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

package/dist/services/service-client.d.ts

@@ -0,0 +1,181 @@
+/**
+ * API Base URL (環境変数から取得、デフォルトはポート24000)
+ */
+export declare const API_BASE_URL: string;
+/**
+ * ServiceClientエラーコード
+ */
+export declare enum ServiceClientErrorCode {
+    /** リクエストタイムアウト */
+    TIMEOUT_ERROR = "TIMEOUT_ERROR",
+    /** 最大リトライ回数超過 */
+    MAX_RETRIES_EXCEEDED = "MAX_RETRIES_EXCEEDED",
+    /** ネットワークエラー */
+    NETWORK_ERROR = "NETWORK_ERROR",
+    /** サーバーエラー (5xx) */
+    SERVER_ERROR = "SERVER_ERROR",
+    /** クライアントエラー (4xx) */
+    CLIENT_ERROR = "CLIENT_ERROR",
+    /** 認証エラー (401) */
+    UNAUTHORIZED = "UNAUTHORIZED"
+}
+/**
+ * ServiceClientエラークラス
+ */
+export declare class ServiceClientError extends Error {
+    readonly code: ServiceClientErrorCode;
+    readonly statusCode: number | undefined;
+    readonly retryCount: number | undefined;
+    readonly originalCause: Error | undefined;
+    constructor(code: ServiceClientErrorCode, message: string, options?: {
+        statusCode?: number | undefined;
+        retryCount?: number | undefined;
+        cause?: Error | undefined;
+    });
+}
+/**
+ * ServiceClientオプション
+ */
+export interface ServiceClientOptions {
+    /** タイムアウト時間（ミリ秒）。デフォルト: 30000ms (30秒) */
+    timeout?: number;
+    /** 最大リトライ回数。デフォルト: 3回 */
+    maxRetries?: number;
+    /** 初回リトライ遅延（ミリ秒）。デフォルト: 100ms */
+    retryDelay?: number;
+}
+/**
+ * プロジェクトのブランド設定情報の型定義
+ */
+export interface ProjectBrandSettingInfo {
+    id: string;
+    brandId: string | null;
+    paletteId: string | null;
+}
+/**
+ * プロジェクト詳細の型定義（Web API レスポンス形式）
+ * [Phase 1] ProjectPageInfo, pages フィールド削除
+ */
+export interface ProjectResponse {
+    id: string;
+    name: string;
+    slug: string;
+    description: string | null;
+    status: string;
+    createdAt: string;
+    updatedAt: string;
+    brandSetting: ProjectBrandSettingInfo | null;
+}
+/**
+ * プロジェクト一覧取得パラメータの型定義
+ */
+export interface ProjectListParams {
+    status?: "draft" | "in_progress" | "review" | "completed" | "archived" | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+    sortBy?: "createdAt" | "updatedAt" | "name" | undefined;
+    sortOrder?: "asc" | "desc" | undefined;
+}
+/**
+ * プロジェクト一覧レスポンスの型定義
+ */
+export interface ProjectListResponse {
+    projects: ProjectResponse[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/**
+ * カラートークンの型定義
+ */
+export interface ColorToken {
+    id: string;
+    name: string;
+    hex: string;
+    oklchL: number;
+    oklchC: number;
+    oklchH: number;
+    role: "primary" | "secondary" | "accent" | "neutral" | "semantic";
+    semanticMeaning: string | null;
+    sortOrder: number;
+}
+/**
+ * パレット詳細レスポンスの型定義
+ */
+export interface PaletteResponse {
+    id: string;
+    name: string;
+    slug: string;
+    description: string | null;
+    mode: "light" | "dark";
+    isDefault: boolean;
+    tokens: ColorToken[];
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Reftrix Service Client
+ * バックエンドAPIとの通信を担当（WebDesign専用）
+ *
+ * 耐障害性機能:
+ * - タイムアウト: デフォルト30秒（操作別に設定可能）
+ * - リトライ: 最大3回、指数バックオフ（100ms, 200ms, 400ms）
+ */
+export declare class ServiceClient {
+    private readonly baseUrl;
+    private readonly options;
+    constructor(baseUrl?: string, options?: ServiceClientOptions);
+    /**
+     * 現在のオプション設定を取得
+     */
+    getOptions(): Required<ServiceClientOptions>;
+    /**
+     * タイムアウト付きfetchを実行
+     * @param url - リクエストURL
+     * @param init - fetchオプション
+     * @param timeout - タイムアウト時間（ミリ秒）
+     * @returns fetchレスポンス
+     */
+    private fetchWithTimeout;
+    /**
+     * リトライ付きfetchを実行
+     * @param url - リクエストURL
+     * @param init - fetchオプション
+     * @param operationName - 操作名（ログ用）
+     * @returns fetchレスポンス
+     */
+    private fetchWithRetry;
+    /**
+     * プロジェクト取得API呼び出し
+     *
+     * Web API: GET /api/studio/projects/:id
+     * レスポンス: { data: { id, name, slug, description, status, createdAt, updatedAt, pages, brandSetting } }
+     *
+     * Note: Studio APIは /api/studio/ パスを使用（/api/v1/ ではない）
+     */
+    getProject(id: string): Promise<ProjectResponse | null>;
+    /**
+     * プロジェクト一覧取得API呼び出し
+     *
+     * Web API: GET /api/studio/projects
+     * クエリパラメータ: status, limit, offset, sortBy, sortOrder
+     * レスポンス: { data: { projects: [...], total, limit, offset } }
+     *
+     * Note: Studio APIは /api/studio/ パスを使用（/api/v1/ ではない）
+     */
+    listProjects(params?: ProjectListParams): Promise<ProjectListResponse>;
+    /**
+     * パレット取得API呼び出し
+     *
+     * Web API: GET /api/studio/palettes/:id
+     * レスポンス: { data: { id, name, slug, description, mode, isDefault, tokens, createdAt, updatedAt } }
+     *
+     * Note: Studio APIは /api/studio/ パスを使用（/api/v1/ ではない）
+     */
+    getPalette(id: string): Promise<PaletteResponse | null>;
+}
+/**
+ * デフォルトのServiceClientインスタンス
+ */
+export declare const serviceClient: ServiceClient;
+//# sourceMappingURL=service-client.d.ts.map

package/dist/services/service-client.d.ts.map

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