@reftrixmcp/mcp-server 0.1.7

package/dist/services/encryption-service.js

@@ -0,0 +1,343 @@
+"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.BackupEncryptionService = exports.EncryptionService = exports.EncryptionError = void 0;
+/**
+ * バックアップ暗号化サービス（SEC H-02対応）
+ *
+ * AES-256-GCM認証付き暗号化を使用したバックアップデータの保護機能を提供します。
+ *
+ * セキュリティ要件:
+ * - AES-256-GCMアルゴリズム（認証付き暗号化）
+ * - 256ビット（32バイト）鍵
+ * - 12バイトIV（GCM推奨サイズ）
+ * - 16バイト認証タグ（GCM標準）
+ * - PBKDF2鍵導出（100,000イテレーション、SHA-512）
+ * - IVの再利用禁止（毎回ランダム生成）
+ * - タイミング攻撃耐性
+ */
+const crypto = __importStar(require("crypto"));
+const logger_1 = require("../utils/logger");
+const encryptionLogger = new logger_1.Logger("EncryptionService");
+const backupEncryptionLogger = new logger_1.Logger("BackupEncryptionService");
+/**
+ * 暗号化エラー
+ */
+class EncryptionError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = "EncryptionError";
+    }
+}
+exports.EncryptionError = EncryptionError;
+/**
+ * 定数
+ */
+const ALGORITHM = "aes-256-gcm";
+const KEY_LENGTH = 32; // 256ビット
+const IV_LENGTH = 12; // 96ビット（GCM推奨）
+const AUTH_TAG_LENGTH = 16; // 128ビット
+const SALT_LENGTH = 16; // 128ビット
+const PBKDF2_ITERATIONS = 100000;
+const PBKDF2_DIGEST = "sha512";
+/** バックアップファイルマジックナンバー */
+const MAGIC_NUMBER = Buffer.from("VBAK", "utf-8");
+/** バックアップファイルバージョン */
+const FILE_VERSION = "1.0.0";
+/** バージョンバイト数（メジャー.マイナー） */
+const VERSION_BYTES = 2;
+/** アルゴリズムバイト */
+const ALGORITHM_BYTE = 1; // 1 = AES-256-GCM
+/**
+ * バックアップ暗号化サービス実装
+ *
+ * Node.js crypto モジュールを使用したAES-256-GCM暗号化を提供します。
+ */
+class EncryptionService {
+    /**
+     * データをAES-256-GCMで暗号化
+     *
+     * @param data - 暗号化するデータ（文字列またはBuffer）
+     * @param key - 256ビット（32バイト）暗号化鍵
+     * @returns 暗号化結果（暗号文、IV、認証タグ）
+     * @throws EncryptionError 無効な鍵長の場合
+     */
+    encrypt(data, key) {
+        // 鍵長検証
+        if (key.length !== KEY_LENGTH) {
+            throw new EncryptionError(`Invalid key length: expected ${KEY_LENGTH} bytes, got ${key.length} bytes`, "INVALID_KEY_LENGTH");
+        }
+        // データをBufferに変換
+        const plaintext = typeof data === "string" ? Buffer.from(data, "utf-8") : data;
+        // IVを毎回ランダム生成（再利用禁止）
+        const iv = crypto.randomBytes(IV_LENGTH);
+        encryptionLogger.debug(`Encrypting ${plaintext.length} bytes with AES-256-GCM`);
+        // 暗号化
+        const cipher = crypto.createCipheriv(ALGORITHM, key, iv);
+        const encrypted = Buffer.concat([cipher.update(plaintext), cipher.final()]);
+        const authTag = cipher.getAuthTag();
+        return {
+            ciphertext: encrypted,
+            iv,
+            authTag,
+        };
+    }
+    /**
+     * AES-256-GCMで暗号化されたデータを復号化
+     *
+     * @param encryptedData - 暗号化データ（暗号文、IV、認証タグ）
+     * @param key - 256ビット（32バイト）復号化鍵
+     * @returns 復号化されたデータ
+     * @throws EncryptionError 復号化失敗（認証エラー、改ざん検出）
+     */
+    decrypt(encryptedData, key) {
+        // 鍵長検証
+        if (key.length !== KEY_LENGTH) {
+            throw new EncryptionError(`Invalid key length: expected ${KEY_LENGTH} bytes, got ${key.length} bytes`, "INVALID_KEY_LENGTH");
+        }
+        const { ciphertext, iv, authTag } = encryptedData;
+        encryptionLogger.debug(`Decrypting ${ciphertext.length} bytes with AES-256-GCM`);
+        try {
+            const decipher = crypto.createDecipheriv(ALGORITHM, key, iv);
+            decipher.setAuthTag(authTag);
+            const decrypted = Buffer.concat([decipher.update(ciphertext), decipher.final()]);
+            return decrypted;
+        }
+        catch (error) {
+            encryptionLogger.error("Decryption failed", error);
+            throw new EncryptionError("Decryption failed: authentication error or data tampered", "DECRYPTION_FAILED");
+        }
+    }
+    /**
+     * 256ビット（32バイト）のランダム暗号化鍵を生成
+     *
+     * @returns 安全に生成された暗号化鍵
+     */
+    generateKey() {
+        encryptionLogger.debug("Generating 256-bit random key");
+        return crypto.randomBytes(KEY_LENGTH);
+    }
+    /**
+     * パスワードからPBKDF2を使用して鍵を導出
+     *
+     * @param password - ユーザーパスワード
+     * @param salt - ランダムソルト（16バイト推奨）
+     * @returns 導出された256ビット鍵
+     */
+    deriveKey(password, salt) {
+        encryptionLogger.debug(`Deriving key with PBKDF2 (${PBKDF2_ITERATIONS} iterations, ${PBKDF2_DIGEST})`);
+        return crypto.pbkdf2Sync(password, salt, PBKDF2_ITERATIONS, KEY_LENGTH, PBKDF2_DIGEST);
+    }
+    /**
+     * ランダムソルトを生成
+     *
+     * @returns 16バイトのランダムソルト
+     */
+    generateSalt() {
+        return crypto.randomBytes(SALT_LENGTH);
+    }
+}
+exports.EncryptionService = EncryptionService;
+/**
+ * バックアップ暗号化サービス（拡張版）
+ *
+ * バックアップファイル形式の作成・復元機能を含むサービスです。
+ * テストとの互換性のため、レガシーインターフェースもサポートします。
+ */
+class BackupEncryptionService extends EncryptionService {
+    /**
+     * 暗号化（レガシーインターフェース互換）
+     *
+     * @param data - 暗号化するデータ
+     * @param key - 暗号化鍵
+     * @returns レガシー形式の暗号化結果
+     */
+    encryptLegacy(data, key) {
+        const result = this.encrypt(data, key);
+        return {
+            encryptedData: result.ciphertext,
+            iv: result.iv,
+            authTag: result.authTag,
+        };
+    }
+    /**
+     * 復号化（レガシーインターフェース互換）
+     *
+     * @param encryptedData - 暗号文
+     * @param key - 復号化鍵
+     * @param iv - 初期化ベクトル
+     * @param authTag - 認証タグ
+     * @returns 復号化されたデータ
+     */
+    decryptLegacy(encryptedData, key, iv, authTag) {
+        return this.decrypt({
+            ciphertext: encryptedData,
+            iv,
+            authTag,
+        }, key);
+    }
+    /**
+     * パスワードから鍵を導出（レガシーインターフェース互換）
+     *
+     * @param password - パスワード
+     * @param salt - ソルト
+     * @returns 導出された鍵
+     */
+    deriveKeyFromPassword(password, salt) {
+        return this.deriveKey(password, salt);
+    }
+    /**
+     * 暗号化バックアップファイルを作成
+     *
+     * ファイル形式:
+     * [4 bytes: magic number 'VBAK']
+     * [2 bytes: version (major.minor)]
+     * [1 byte: algorithm (1 = AES-256-GCM)]
+     * [16 bytes: salt]
+     * [12 bytes: IV]
+     * [16 bytes: auth tag]
+     * [remaining: encrypted data]
+     *
+     * @param data - バックアップデータ
+     * @param password - 暗号化パスワード
+     * @returns バックアップファイル作成結果
+     */
+    createBackupFile(data, password) {
+        backupEncryptionLogger.debug(`Creating backup file (${data.length} bytes)`);
+        // ソルト生成
+        const salt = this.generateSalt();
+        // パスワードから鍵を導出
+        const key = this.deriveKey(password, salt);
+        // データを暗号化
+        const encrypted = this.encrypt(data, key);
+        // ヘッダー構築
+        const versionBuffer = Buffer.alloc(VERSION_BYTES);
+        const [major, minor] = FILE_VERSION.split(".").map(Number);
+        versionBuffer.writeUInt8(major ?? 1, 0);
+        versionBuffer.writeUInt8(minor ?? 0, 1);
+        const algorithmBuffer = Buffer.alloc(1);
+        algorithmBuffer.writeUInt8(ALGORITHM_BYTE, 0);
+        // ファイル全体を結合
+        const backupFile = Buffer.concat([
+            MAGIC_NUMBER, // 4 bytes
+            versionBuffer, // 2 bytes
+            algorithmBuffer, // 1 byte
+            salt, // 16 bytes
+            encrypted.iv, // 12 bytes
+            encrypted.authTag, // 16 bytes
+            encrypted.ciphertext, // remaining
+        ]);
+        const timestamp = new Date().toISOString();
+        backupEncryptionLogger.debug(`Backup file created: ${backupFile.length} bytes`);
+        return {
+            encrypted: backupFile,
+            metadata: {
+                algorithm: ALGORITHM,
+                version: FILE_VERSION,
+                timestamp,
+            },
+        };
+    }
+    /**
+     * 暗号化バックアップファイルを復元
+     *
+     * @param encryptedBackup - 暗号化されたバックアップファイル
+     * @param password - 復号化パスワード
+     * @returns 復元されたデータ
+     * @throws EncryptionError 無効なファイル形式、パスワード誤り、改ざん検出
+     */
+    restoreBackupFile(encryptedBackup, password) {
+        backupEncryptionLogger.debug(`Restoring backup file (${encryptedBackup.length} bytes)`);
+        // 最小サイズチェック（ヘッダー + 最小暗号文）
+        const headerSize = 4 + VERSION_BYTES + 1 + SALT_LENGTH + IV_LENGTH + AUTH_TAG_LENGTH;
+        if (encryptedBackup.length < headerSize) {
+            throw new EncryptionError("Invalid backup file: too small", "INVALID_BACKUP_FORMAT");
+        }
+        // マジックナンバー検証
+        const magic = encryptedBackup.subarray(0, 4);
+        if (!magic.equals(MAGIC_NUMBER)) {
+            throw new EncryptionError("Invalid backup file: wrong magic number", "INVALID_MAGIC_NUMBER");
+        }
+        // ヘッダー解析
+        let offset = 4;
+        // バージョン（2バイト）- 現在は検証のみ
+        // const majorVersion = encryptedBackup.readUInt8(offset);
+        // const minorVersion = encryptedBackup.readUInt8(offset + 1);
+        offset += VERSION_BYTES;
+        // アルゴリズム（1バイト）- 現在は検証のみ
+        const algorithmByte = encryptedBackup.readUInt8(offset);
+        if (algorithmByte !== ALGORITHM_BYTE) {
+            throw new EncryptionError("Unsupported encryption algorithm", "UNSUPPORTED_ALGORITHM");
+        }
+        offset += 1;
+        // ソルト（16バイト）
+        const salt = encryptedBackup.subarray(offset, offset + SALT_LENGTH);
+        offset += SALT_LENGTH;
+        // IV（12バイト）
+        const iv = encryptedBackup.subarray(offset, offset + IV_LENGTH);
+        offset += IV_LENGTH;
+        // 認証タグ（16バイト）
+        const authTag = encryptedBackup.subarray(offset, offset + AUTH_TAG_LENGTH);
+        offset += AUTH_TAG_LENGTH;
+        // 暗号文（残り）
+        const ciphertext = encryptedBackup.subarray(offset);
+        // パスワードから鍵を導出
+        const key = this.deriveKey(password, salt);
+        // 復号化
+        try {
+            return this.decrypt({
+                ciphertext,
+                iv,
+                authTag,
+            }, key);
+        }
+        catch (error) {
+            if (error instanceof EncryptionError) {
+                throw error;
+            }
+            throw new EncryptionError("Failed to restore backup: wrong password or corrupted data", "RESTORE_FAILED");
+        }
+    }
+}
+exports.BackupEncryptionService = BackupEncryptionService;
+/**
+ * デフォルトエクスポート
+ */
+exports.default = BackupEncryptionService;
+//# sourceMappingURL=encryption-service.js.map

package/dist/services/encryption-service.js.map

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

package/dist/services/external-css-fetcher.d.ts

@@ -0,0 +1,185 @@
+/**
+ * CSS URL抽出結果
+ */
+export interface ExtractedCssUrl {
+    /** 抽出されたURL（絶対URL） */
+    url: string;
+    /** 元のhref値（相対URLの場合もある） */
+    originalHref: string;
+    /** link要素のmedia属性 */
+    media?: string;
+    /** link要素のtype属性（省略時はtext/css） */
+    type?: string;
+    /** @importからの抽出かどうか */
+    fromImport?: boolean;
+}
+/**
+ * CSS取得オプション
+ */
+export interface FetchCssOptions {
+    /** タイムアウト（ミリ秒）デフォルト: 5000 */
+    timeout?: number;
+    /** 最大CSSサイズ（バイト）デフォルト: 5MB */
+    maxSize?: number;
+    /** User-Agentヘッダー */
+    userAgent?: string;
+}
+/**
+ * 複数CSS取得オプション
+ */
+export interface FetchAllCssOptions extends FetchCssOptions {
+    /** 最大並列取得数 デフォルト: 5 */
+    maxConcurrent?: number;
+    /** エラーでも継続するか デフォルト: true */
+    continueOnError?: boolean;
+}
+/**
+ * 単一CSS取得結果
+ */
+export interface FetchCssResult {
+    /** 取得URL */
+    url: string;
+    /** CSSコンテンツ（成功時） */
+    content: string | null;
+    /** エラーメッセージ（失敗時） */
+    error?: string;
+}
+/**
+ * 内部用：詳細なCSS取得結果
+ */
+interface FetchCssDetailedResult {
+    /** 取得成功フラグ */
+    success: boolean;
+    /** CSSコンテンツ（成功時） */
+    content?: string;
+    /** エラーメッセージ（失敗時） */
+    error?: string;
+    /** HTTPステータスコード（取得試行時） */
+    statusCode?: number;
+    /** 最終的なURL（リダイレクト後） */
+    finalUrl?: string;
+    /** コンテンツサイズ（バイト） */
+    contentSize?: number;
+}
+/**
+ * 複数CSS取得結果
+ */
+interface FetchAllCssDetailedResult {
+    /** 結合されたCSSコンテンツ */
+    combinedCss: string;
+    /** 各URLの取得結果 */
+    results: Array<{
+        url: string;
+        success: boolean;
+        error?: string;
+        contentSize?: number;
+        content?: string;
+    }>;
+    /** 成功した取得数 */
+    successCount: number;
+    /** 失敗した取得数 */
+    failedCount: number;
+    /** 合計コンテンツサイズ（バイト） */
+    totalSize: number;
+}
+/**
+ * URLがSSRFの観点から安全かチェック
+ *
+ * @param url - チェック対象のURL
+ * @returns 安全な場合true、危険な場合false
+ */
+export declare function isSafeUrl(url: string): boolean;
+/**
+ * 相対URLを絶対URLに変換
+ *
+ * 対応する入力形式:
+ * - 絶対URL: https://example.com/styles.css
+ * - プロトコル相対URL: //cdn.example.com/styles.css
+ * - ルート相対パス: /styles/main.css
+ * - 相対パス: ./components/button.css, ../shared/reset.css
+ * - ファイル名のみ: styles.css
+ *
+ * 特殊URLスキーム（そのまま返却）:
+ * - data: URL: data:text/css;base64,...
+ * - blob: URL: blob:https://...
+ * - javascript: スキーム（セキュリティ上ブロック）
+ *
+ * @param href - 変換対象のURL（相対または絶対）
+ * @param baseUrl - ベースURL
+ * @returns 絶対URL、または特殊スキームの場合はそのまま
+ */
+export declare function resolveUrl(href: string, baseUrl: string): string;
+/**
+ * HTMLから<link rel="stylesheet">のURLを抽出
+ *
+ * @param html - HTML文字列
+ * @param baseUrl - ベースURL（相対URL解決用）
+ * @returns 抽出されたCSS URL配列
+ */
+export declare function extractCssUrls(html: string, baseUrl: string): ExtractedCssUrl[];
+/**
+ * CSSコンテンツ内の@import URLを抽出
+ *
+ * @param css - CSSコンテンツ
+ * @param baseUrl - ベースURL（相対URL解決用）
+ * @returns 抽出されたCSS URL配列
+ */
+export declare function extractImportUrls(css: string, baseUrl: string): ExtractedCssUrl[];
+/**
+ * 単一URLからCSSを取得
+ *
+ * @param url - CSS取得先URL
+ * @param options - 取得オプション
+ * @returns CSS取得結果（成功時はコンテンツ文字列、失敗時はnull）
+ */
+export declare function fetchCss(url: string, options?: FetchCssOptions): Promise<string | null>;
+/**
+ * 複数URLからCSSを取得（API向けシンプル版）
+ *
+ * @param urls - CSS取得先URL配列
+ * @param options - 取得オプション
+ * @returns CSS取得結果配列
+ */
+export declare function fetchAllCss(urls: string[], options?: FetchAllCssOptions): Promise<FetchCssResult[]>;
+/**
+ * ExternalCssFetcher クラス
+ *
+ * 外部CSSファイルの取得と処理を行うユーティリティクラス
+ *
+ * @example
+ * ```typescript
+ * const fetcher = new ExternalCssFetcher();
+ * const urls = fetcher.extractCssUrls(html, baseUrl);
+ * const result = await fetcher.fetchAllCss(urls.map(u => u.url));
+ * ```
+ */
+export declare class ExternalCssFetcher {
+    private options;
+    constructor(options?: FetchAllCssOptions);
+    /**
+     * HTMLから<link rel="stylesheet">のURLを抽出
+     */
+    extractCssUrls(html: string, baseUrl: string): ExtractedCssUrl[];
+    /**
+     * CSSコンテンツ内の@import URLを抽出
+     */
+    extractImportUrls(css: string, baseUrl: string): ExtractedCssUrl[];
+    /**
+     * 単一URLからCSSを取得
+     */
+    fetchCss(url: string, options?: FetchCssOptions): Promise<FetchCssDetailedResult>;
+    /**
+     * 複数URLからCSSを取得して結合
+     */
+    fetchAllCss(urls: string[], options?: FetchAllCssOptions): Promise<FetchAllCssDetailedResult>;
+    /**
+     * URLがSSRFの観点から安全かチェック
+     */
+    isSafeUrl(url: string): boolean;
+    /**
+     * 相対URLを絶対URLに変換
+     */
+    resolveUrl(href: string, baseUrl: string): string;
+}
+export {};
+//# sourceMappingURL=external-css-fetcher.d.ts.map

package/dist/services/external-css-fetcher.d.ts.map

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