@reftrixmcp/mcp-server 0.1.8 → 0.2.0

package/dist/services/cache.js

@@ -1,233 +0,0 @@
-"use strict";
-// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
-// SPDX-License-Identifier: AGPL-3.0-only
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.embeddingCache = exports.searchCache = exports.EmbeddingCache = exports.SearchCache = exports.LRUCache = void 0;
-/**
- * Cache Service
- * LRU (Least Recently Used) キャッシュ実装
- *
- * 目的:
- * - 検索結果のキャッシュ（TTL 5分）
- * - Embeddingベクトルのキャッシュ（TTL 30分）
- * - キャッシュヒット率の追跡
- * - メモリ効率を考慮した実装
- */
-const crypto_1 = require("crypto");
-const logger_1 = require("../utils/logger");
-const logger = new logger_1.Logger("Cache");
-/**
- * LRUキャッシュクラス
- * 最も長くアクセスされていないエントリから削除する
- */
-class LRUCache {
-    cache = new Map();
-    maxSize;
-    defaultTTL;
-    hits = 0;
-    misses = 0;
-    constructor(options) {
-        this.maxSize = options.maxSize;
-        this.defaultTTL = options.ttlMs;
-        logger.debug("LRUCache initialized", {
-            maxSize: this.maxSize,
-            defaultTTL: this.defaultTTL,
-        });
-    }
-    /**
-     * キャッシュから値を取得
-     * @param key キャッシュキー
-     * @returns 値が存在すれば値、なければundefined
-     */
-    get(key) {
-        const entry = this.cache.get(key);
-        if (!entry) {
-            this.misses++;
-            logger.debug("Miss", { key });
-            return undefined;
-        }
-        // TTLチェック
-        if (this.isExpired(entry)) {
-            this.cache.delete(key);
-            this.misses++;
-            logger.debug("Expired", { key });
-            return undefined;
-        }
-        // アクセス時間を更新（LRU）
-        entry.lastAccessed = Date.now();
-        this.cache.delete(key);
-        this.cache.set(key, entry);
-        this.hits++;
-        logger.debug("Hit", { key });
-        return entry.value;
-    }
-    /**
-     * キャッシュに値を設定
-     * @param key キャッシュキー
-     * @param value 保存する値
-     * @param ttlMs オプションのTTL（ミリ秒）
-     */
-    set(key, value, ttlMs) {
-        // 最大サイズに達している場合、LRUエントリを削除
-        if (this.cache.size >= this.maxSize && !this.cache.has(key)) {
-            this.evictLRU();
-        }
-        const now = Date.now();
-        const entry = {
-            value,
-            expiresAt: now + (ttlMs ?? this.defaultTTL),
-            lastAccessed: now,
-        };
-        // 既存のキーがあれば削除して末尾に追加（順序更新）
-        this.cache.delete(key);
-        this.cache.set(key, entry);
-        logger.debug("Set", {
-            key,
-            ttl: ttlMs ?? this.defaultTTL,
-            size: this.cache.size,
-        });
-    }
-    /**
-     * キーが存在するかチェック（期限切れは無視）
-     * @param key キャッシュキー
-     * @returns 存在すればtrue
-     */
-    has(key) {
-        const entry = this.cache.get(key);
-        if (!entry)
-            return false;
-        // 期限切れの場合は削除してfalseを返す
-        if (this.isExpired(entry)) {
-            this.cache.delete(key);
-            return false;
-        }
-        return true;
-    }
-    /**
-     * キャッシュからエントリを削除
-     * @param key キャッシュキー
-     * @returns 削除成功ならtrue
-     */
-    delete(key) {
-        const deleted = this.cache.delete(key);
-        if (deleted) {
-            logger.debug("Delete", { key });
-        }
-        return deleted;
-    }
-    /**
-     * キャッシュをクリア
-     */
-    clear() {
-        this.cache.clear();
-        this.hits = 0;
-        this.misses = 0;
-        logger.debug("Cleared");
-    }
-    /**
-     * 現在のキャッシュサイズを取得
-     * @returns キャッシュサイズ
-     */
-    size() {
-        return this.cache.size;
-    }
-    /**
-     * ヒット率を取得
-     * @returns ヒット率（0-1）
-     */
-    getHitRate() {
-        const total = this.hits + this.misses;
-        return total > 0 ? this.hits / total : 0;
-    }
-    /**
-     * キャッシュ統計を取得
-     * @returns キャッシュ統計情報
-     */
-    getStats() {
-        return {
-            hits: this.hits,
-            misses: this.misses,
-            hitRate: this.getHitRate(),
-            size: this.cache.size,
-            maxSize: this.maxSize,
-        };
-    }
-    /**
-     * LRUエントリを削除（最も長くアクセスされていないエントリ）
-     */
-    evictLRU() {
-        // Mapは挿入順序を保持するため、最初のエントリが最も古い
-        const firstKey = this.cache.keys().next().value;
-        if (firstKey !== undefined) {
-            this.cache.delete(firstKey);
-            logger.debug("Evicted LRU", { key: firstKey });
-        }
-    }
-    /**
-     * エントリが期限切れかチェック
-     * @param entry キャッシュエントリ
-     * @returns 期限切れならtrue
-     */
-    isExpired(entry) {
-        return Date.now() > entry.expiresAt;
-    }
-}
-exports.LRUCache = LRUCache;
-/**
- * 検索結果キャッシュクラス
- * クエリとフィルターからキーを生成
- */
-const searchLogger = new logger_1.Logger("SearchCache");
-class SearchCache extends LRUCache {
-    constructor(options) {
-        super(options);
-        searchLogger.debug("Initialized");
-    }
-    /**
-     * クエリからキャッシュキーを生成
-     * @param query 検索クエリ
-     * @param filters オプションのフィルター
-     * @returns ハッシュ化されたキー
-     */
-    generateKey(query, filters) {
-        const input = JSON.stringify({ query, filters: filters ?? {} });
-        const hash = (0, crypto_1.createHash)("sha256").update(input).digest("hex");
-        return `search:${hash.substring(0, 16)}`;
-    }
-}
-exports.SearchCache = SearchCache;
-/**
- * Embeddingキャッシュクラス
- * テキストからキーを生成してベクトルをキャッシュ
- */
-const embeddingLogger = new logger_1.Logger("EmbeddingCache");
-class EmbeddingCache extends LRUCache {
-    constructor(options) {
-        super(options);
-        embeddingLogger.debug("Initialized");
-    }
-    /**
-     * テキストからキャッシュキーを生成
-     * @param text テキスト
-     * @returns ハッシュ化されたキー
-     */
-    generateKey(text) {
-        const hash = (0, crypto_1.createHash)("sha256").update(text).digest("hex");
-        return `embedding:${hash.substring(0, 16)}`;
-    }
-}
-exports.EmbeddingCache = EmbeddingCache;
-/**
- * シングルトンインスタンス
- */
-// 検索結果キャッシュ: 最大1000件、TTL 5分
-exports.searchCache = new SearchCache({
-    maxSize: 1000,
-    ttlMs: 5 * 60 * 1000,
-});
-// Embeddingキャッシュ: 最大5000件、TTL 30分
-exports.embeddingCache = new EmbeddingCache({
-    maxSize: 5000,
-    ttlMs: 30 * 60 * 1000,
-});
-//# sourceMappingURL=cache.js.map

package/dist/services/cache.js.map

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

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

@@ -1,122 +0,0 @@
-/**
- * チェックサムサービスインターフェース
- */
-export interface ChecksumService {
-    /** SHA-256ハッシュ生成 */
-    generateHash(data: string | Buffer): string;
-    /** ファイルのハッシュ生成（ストリーム処理対応） */
-    generateFileHash(filePath: string): Promise<string>;
-    /** チェックサム検証（タイミング攻撃耐性） */
-    verifyChecksum(data: string | Buffer, expectedHash: string): boolean;
-    /** ファイル整合性検証 */
-    verifyFileIntegrity(filePath: string, expectedHash: string): Promise<boolean>;
-}
-/**
- * 破損検出結果
- */
-export interface CorruptionDetectionResult {
-    isCorrupted: boolean;
-    details?: string;
-}
-/**
- * チェックサム検証エラー
- */
-export declare class ChecksumError extends Error {
-    readonly code: string;
-    constructor(message: string, code: string);
-}
-/**
- * SHA-256チェックサムサービス実装
- *
- * セキュリティ要件:
- * - Node.js crypto モジュール使用
- * - SHA-256アルゴリズム
- * - 小文字16進数出力
- * - 大容量ファイル対応（ストリーム処理）
- * - タイミング攻撃耐性（crypto.timingSafeEqual使用）
- */
-export declare class SHA256ChecksumService implements ChecksumService {
-    /**
-     * SHA-256ハッシュを生成
-     *
-     * @param data - ハッシュ化するデータ（文字列またはBuffer）
-     * @returns 64文字の小文字16進数ハッシュ文字列
-     */
-    generateHash(data: string | Buffer): string;
-    /**
-     * テスト互換用: generateSHA256エイリアス
-     */
-    generateSHA256(content: string | Buffer): string;
-    /**
-     * ファイルからSHA-256ハッシュを生成（ストリーム処理）
-     *
-     * 大容量ファイル（100MB+）にも対応するため、ストリーム処理を使用します。
-     *
-     * @param filePath - ハッシュ化するファイルのパス
-     * @returns 64文字の小文字16進数ハッシュ文字列
-     * @throws ChecksumError ファイルが存在しない、または読み取り権限がない場合
-     */
-    generateFileHash(filePath: string): Promise<string>;
-    /**
-     * チェックサムを検証（タイミング攻撃耐性）
-     *
-     * crypto.timingSafeEqual を使用してタイミング攻撃を防ぎます。
-     *
-     * @param data - 検証するデータ
-     * @param expectedHash - 期待されるハッシュ値
-     * @returns 一致する場合true
-     */
-    verifyChecksum(data: string | Buffer, expectedHash: string): boolean;
-    /**
-     * ファイル整合性を検証
-     *
-     * @param filePath - 検証するファイルのパス
-     * @param expectedHash - 期待されるハッシュ値
-     * @returns 整合性が保たれている場合true
-     * @throws ChecksumError ファイルアクセスエラーまたは無効なハッシュフォーマット
-     */
-    verifyFileIntegrity(filePath: string, expectedHash: string): Promise<boolean>;
-    /**
-     * チェックサムを比較（タイミング攻撃耐性、大文字小文字無視）
-     *
-     * @param checksum1 - 比較するチェックサム1
-     * @param checksum2 - 比較するチェックサム2
-     * @returns 一致する場合true
-     * @throws ChecksumError 無効なフォーマットの場合
-     */
-    compareChecksums(checksum1: string, checksum2: string): boolean;
-    /**
-     * 破損検出
-     *
-     * @param originalChecksum - 元のチェックサム
-     * @param currentChecksum - 現在のチェックサム
-     * @returns 破損検出結果
-     */
-    detectCorruption(originalChecksum: string, currentChecksum: string): CorruptionDetectionResult;
-    /**
-     * ハッシュフォーマットの検証
-     *
-     * @param hash - 検証するハッシュ文字列
-     * @returns 有効なSHA-256フォーマットの場合true
-     */
-    private isValidHashFormat;
-    /**
-     * タイミング攻撃耐性のある文字列比較
-     *
-     * crypto.timingSafeEqual を使用して、比較時間が入力に依存しないようにします。
-     *
-     * @param a - 比較する文字列1
-     * @param b - 比較する文字列2
-     * @returns 一致する場合true
-     */
-    private timingSafeCompare;
-}
-/**
- * デフォルトのチェックサムサービスインスタンス
- */
-export declare const checksumService: SHA256ChecksumService;
-/**
- * デフォルトエクスポート
- */
-export default SHA256ChecksumService;
-//# sourceMappingURL=checksum-service.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"checksum-service.d.ts","sourceRoot":"","sources":["../../src/services/checksum-service.ts"],"names":[],"mappings":"AAoBA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAE5C,6BAA6B;IAC7B,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpD,0BAA0B;IAC1B,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;IAErE,gBAAgB;IAChB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/E;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAGpB,IAAI,EAAE,MAAM;gBAD5B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM;CAK/B;AAQD;;;;;;;;;GASG;AACH,qBAAa,qBAAsB,YAAW,eAAe;IAC3D;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAe3C;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAIhD;;;;;;;;OAQG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA2CzD;;;;;;;;OAQG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO;IAWpE;;;;;;;OAOG;IACG,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBnF;;;;;;;OAOG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAc/D;;;;;;OAMG;IACH,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,yBAAyB;IAuB9F;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;CAY1B;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,uBAA8B,CAAC;AAE3D;;GAEG;AACH,eAAe,qBAAqB,CAAC"}

package/dist/services/checksum-service.js

@@ -1,270 +0,0 @@
-"use strict";
-// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
-// SPDX-License-Identifier: AGPL-3.0-only
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.checksumService = exports.SHA256ChecksumService = exports.ChecksumError = void 0;
-/**
- * SHA-256チェックサムサービス（SEC H-01対応）
- *
- * コンテンツの整合性検証機能を提供します。
- * - SHA-256ハッシュ生成
- * - ファイル整合性検証
- * - タイミング攻撃耐性のあるチェックサム比較
- * - 破損検出
- */
-const crypto = __importStar(require("crypto"));
-const fs = __importStar(require("fs/promises"));
-const fs_1 = require("fs");
-const logger_1 = require("../utils/logger");
-const logger = new logger_1.Logger("ChecksumService");
-/**
- * チェックサム検証エラー
- */
-class ChecksumError extends Error {
-    code;
-    constructor(message, code) {
-        super(message);
-        this.code = code;
-        this.name = "ChecksumError";
-    }
-}
-exports.ChecksumError = ChecksumError;
-/**
- * SHA-256ハッシュフォーマットの正規表現
- * 64文字の16進数文字列（小文字）
- */
-const SHA256_HASH_REGEX = /^[a-f0-9]{64}$/i;
-/**
- * SHA-256チェックサムサービス実装
- *
- * セキュリティ要件:
- * - Node.js crypto モジュール使用
- * - SHA-256アルゴリズム
- * - 小文字16進数出力
- * - 大容量ファイル対応（ストリーム処理）
- * - タイミング攻撃耐性（crypto.timingSafeEqual使用）
- */
-class SHA256ChecksumService {
-    /**
-     * SHA-256ハッシュを生成
-     *
-     * @param data - ハッシュ化するデータ（文字列またはBuffer）
-     * @returns 64文字の小文字16進数ハッシュ文字列
-     */
-    generateHash(data) {
-        const dataLength = typeof data === "string" ? data.length : data.length;
-        logger.debug(`Generating SHA-256 hash for ${dataLength} bytes`);
-        const hash = crypto.createHash("sha256");
-        if (typeof data === "string") {
-            hash.update(data, "utf-8");
-        }
-        else {
-            hash.update(data);
-        }
-        return hash.digest("hex");
-    }
-    /**
-     * テスト互換用: generateSHA256エイリアス
-     */
-    generateSHA256(content) {
-        return this.generateHash(content);
-    }
-    /**
-     * ファイルからSHA-256ハッシュを生成（ストリーム処理）
-     *
-     * 大容量ファイル（100MB+）にも対応するため、ストリーム処理を使用します。
-     *
-     * @param filePath - ハッシュ化するファイルのパス
-     * @returns 64文字の小文字16進数ハッシュ文字列
-     * @throws ChecksumError ファイルが存在しない、または読み取り権限がない場合
-     */
-    async generateFileHash(filePath) {
-        logger.debug(`Generating file hash for: ${filePath}`);
-        // ファイル存在確認
-        try {
-            await fs.access(filePath, fs.constants.R_OK);
-        }
-        catch (error) {
-            const err = error;
-            if (err.code === "ENOENT") {
-                throw new ChecksumError(`File not found: ${filePath}`, "FILE_NOT_FOUND");
-            }
-            if (err.code === "EACCES") {
-                throw new ChecksumError(`Permission denied: ${filePath}`, "PERMISSION_DENIED");
-            }
-            throw new ChecksumError(`Failed to access file: ${filePath}`, "FILE_ACCESS_ERROR");
-        }
-        return new Promise((resolve, reject) => {
-            const hash = crypto.createHash("sha256");
-            const stream = (0, fs_1.createReadStream)(filePath);
-            stream.on("data", (chunk) => {
-                // string | Buffer 両方に対応（型安全性確保）
-                if (typeof chunk === "string") {
-                    hash.update(chunk, "utf-8");
-                }
-                else {
-                    hash.update(chunk);
-                }
-            });
-            stream.on("end", () => {
-                const digest = hash.digest("hex");
-                logger.debug(`File hash generated: ${digest.substring(0, 16)}...`);
-                resolve(digest);
-            });
-            stream.on("error", (err) => {
-                logger.error("File hash error", err);
-                reject(new ChecksumError(`Failed to read file: ${filePath}`, "FILE_READ_ERROR"));
-            });
-        });
-    }
-    /**
-     * チェックサムを検証（タイミング攻撃耐性）
-     *
-     * crypto.timingSafeEqual を使用してタイミング攻撃を防ぎます。
-     *
-     * @param data - 検証するデータ
-     * @param expectedHash - 期待されるハッシュ値
-     * @returns 一致する場合true
-     */
-    verifyChecksum(data, expectedHash) {
-        // 入力検証: ハッシュフォーマットチェック
-        if (!this.isValidHashFormat(expectedHash)) {
-            logger.debug("Invalid hash format provided");
-            return false;
-        }
-        const actualHash = this.generateHash(data);
-        return this.timingSafeCompare(actualHash, expectedHash.toLowerCase());
-    }
-    /**
-     * ファイル整合性を検証
-     *
-     * @param filePath - 検証するファイルのパス
-     * @param expectedHash - 期待されるハッシュ値
-     * @returns 整合性が保たれている場合true
-     * @throws ChecksumError ファイルアクセスエラーまたは無効なハッシュフォーマット
-     */
-    async verifyFileIntegrity(filePath, expectedHash) {
-        logger.debug(`Verifying file integrity: ${filePath}`);
-        // 入力検証: ハッシュフォーマットチェック
-        if (!this.isValidHashFormat(expectedHash)) {
-            throw new ChecksumError("Invalid checksum format", "INVALID_FORMAT");
-        }
-        const actualHash = await this.generateFileHash(filePath);
-        const isValid = this.timingSafeCompare(actualHash, expectedHash.toLowerCase());
-        logger.debug(`File integrity: ${isValid ? "valid" : "invalid"}`);
-        return isValid;
-    }
-    /**
-     * チェックサムを比較（タイミング攻撃耐性、大文字小文字無視）
-     *
-     * @param checksum1 - 比較するチェックサム1
-     * @param checksum2 - 比較するチェックサム2
-     * @returns 一致する場合true
-     * @throws ChecksumError 無効なフォーマットの場合
-     */
-    compareChecksums(checksum1, checksum2) {
-        // 空文字列の特別処理
-        if (checksum1 === "" && checksum2 === "") {
-            return true;
-        }
-        // 入力検証
-        if (!this.isValidHashFormat(checksum1) || !this.isValidHashFormat(checksum2)) {
-            throw new ChecksumError("Invalid checksum format", "INVALID_FORMAT");
-        }
-        return this.timingSafeCompare(checksum1.toLowerCase(), checksum2.toLowerCase());
-    }
-    /**
-     * 破損検出
-     *
-     * @param originalChecksum - 元のチェックサム
-     * @param currentChecksum - 現在のチェックサム
-     * @returns 破損検出結果
-     */
-    detectCorruption(originalChecksum, currentChecksum) {
-        // 入力検証
-        if (!this.isValidHashFormat(originalChecksum) || !this.isValidHashFormat(currentChecksum)) {
-            throw new ChecksumError("Invalid checksum format", "INVALID_FORMAT");
-        }
-        const isMatch = this.timingSafeCompare(originalChecksum.toLowerCase(), currentChecksum.toLowerCase());
-        if (isMatch) {
-            return {
-                isCorrupted: false,
-            };
-        }
-        return {
-            isCorrupted: true,
-            details: `Checksum mismatch detected - original: ${originalChecksum.substring(0, 16)}..., current: ${currentChecksum.substring(0, 16)}...`,
-        };
-    }
-    /**
-     * ハッシュフォーマットの検証
-     *
-     * @param hash - 検証するハッシュ文字列
-     * @returns 有効なSHA-256フォーマットの場合true
-     */
-    isValidHashFormat(hash) {
-        return SHA256_HASH_REGEX.test(hash);
-    }
-    /**
-     * タイミング攻撃耐性のある文字列比較
-     *
-     * crypto.timingSafeEqual を使用して、比較時間が入力に依存しないようにします。
-     *
-     * @param a - 比較する文字列1
-     * @param b - 比較する文字列2
-     * @returns 一致する場合true
-     */
-    timingSafeCompare(a, b) {
-        // 長さが異なる場合は即座にfalseを返す（これはtimingSafeEqualの要件）
-        // ただし、ハッシュ比較では常に同じ長さ（64文字）になるはず
-        if (a.length !== b.length) {
-            return false;
-        }
-        const bufA = Buffer.from(a, "utf-8");
-        const bufB = Buffer.from(b, "utf-8");
-        return crypto.timingSafeEqual(bufA, bufB);
-    }
-}
-exports.SHA256ChecksumService = SHA256ChecksumService;
-/**
- * デフォルトのチェックサムサービスインスタンス
- */
-exports.checksumService = new SHA256ChecksumService();
-/**
- * デフォルトエクスポート
- */
-exports.default = SHA256ChecksumService;
-//# sourceMappingURL=checksum-service.js.map

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

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