@reftrixmcp/mcp-server 0.1.7

package/dist/utils/url-validator.js

@@ -0,0 +1,533 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BLOCKED_IPV6_PATTERNS = exports.BLOCKED_IP_RANGES = exports.BLOCKED_HOSTS = void 0;
+exports.isBlockedIPv6Range = isBlockedIPv6Range;
+exports.isBlockedHost = isBlockedHost;
+exports.isBlockedIpRange = isBlockedIpRange;
+exports.normalizeUrlForValidation = normalizeUrlForValidation;
+exports.validateExternalUrl = validateExternalUrl;
+/**
+ * URL検証ユーティリティ
+ * SSRF (Server-Side Request Forgery) 対策のためのURL検証機能
+ *
+ * セキュリティ要件:
+ * - プライベートIP、localhost、メタデータサービスへのアクセスをブロック
+ * - http/https プロトコルのみ許可
+ *
+ * @see SEC監査指摘対応
+ */
+const logger_1 = require("./logger");
+// =============================================
+// 定数定義
+// =============================================
+/**
+ * ブロックするホスト名一覧
+ * localhost、メタデータサービスなど
+ */
+exports.BLOCKED_HOSTS = [
+    // ローカルホスト
+    "localhost",
+    "127.0.0.1",
+    "0.0.0.0",
+    // IPv6 localhost
+    "::1",
+    "[::1]",
+    // AWS EC2 メタデータサービス
+    "169.254.169.254",
+    // GCP メタデータサービス
+    "metadata.google.internal",
+    // Azure メタデータサービス
+    "169.254.169.254",
+    // Link-local addresses
+    "169.254.0.0",
+    // Kubernetes
+    "kubernetes.default.svc",
+];
+/**
+ * ブロックするIPレンジ（正規表現）
+ * プライベートIP、ループバック、リンクローカルなど
+ */
+exports.BLOCKED_IP_RANGES = [
+    // 10.0.0.0/8 (クラスAプライベート)
+    /^10\./,
+    // 172.16.0.0/12 (クラスBプライベート)
+    /^172\.(1[6-9]|2[0-9]|3[0-1])\./,
+    // 192.168.0.0/16 (クラスCプライベート)
+    /^192\.168\./,
+    // 127.0.0.0/8 (ループバック)
+    /^127\./,
+    // 0.0.0.0/8
+    /^0\./,
+    // 169.254.0.0/16 (リンクローカル)
+    /^169\.254\./,
+];
+/**
+ * ブロックするIPv6パターン
+ * プライベート、ループバック、リンクローカル、トンネリングなど
+ */
+exports.BLOCKED_IPV6_PATTERNS = {
+    // ループバック ::1 (0:0:0:0:0:0:0:1 または ::1)
+    LOOPBACK: /^(0{0,4}:){7}0{0,3}1$|^::1$/i,
+    // リンクローカル fe80::/10 (fe80 - febf)
+    LINK_LOCAL: /^fe[89ab][0-9a-f]:/i,
+    // ユニークローカル fc00::/7 (fc00::/8 + fd00::/8)
+    UNIQUE_LOCAL: /^f[cd][0-9a-f]{2}:/i,
+    // 未指定アドレス :: (0:0:0:0:0:0:0:0)
+    UNSPECIFIED: /^(0{0,4}:){7}0{0,4}$|^::0?$|^0::0?$/i,
+    // マルチキャスト ff00::/8
+    MULTICAST: /^ff[0-9a-f]{2}:/i,
+    // Teredo 2001:0::/32
+    TEREDO: /^2001:0{1,4}:/i,
+    // 6to4 2002::/16
+    SIX_TO_FOUR: /^2002:/i,
+};
+/**
+ * 許可されるプロトコル
+ */
+const ALLOWED_PROTOCOLS = ["http:", "https:"];
+// =============================================
+// ヘルパー関数
+// =============================================
+/**
+ * 文字列がIPv4アドレス形式かどうかを判定
+ */
+function isIPv4Address(host) {
+    // IPv4形式: x.x.x.x (各オクテットは0-255)
+    const ipv4Regex = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/;
+    const match = host.match(ipv4Regex);
+    if (!match)
+        return false;
+    // 各オクテットが0-255の範囲内かチェック
+    for (let i = 1; i <= 4; i++) {
+        const octetStr = match[i];
+        if (!octetStr)
+            return false;
+        const octet = parseInt(octetStr, 10);
+        if (octet < 0 || octet > 255)
+            return false;
+    }
+    return true;
+}
+/**
+ * 文字列がIPv6アドレス形式かどうかを判定
+ * 角括弧付き（[::1]）も対応
+ */
+function isIPv6Address(host) {
+    // 角括弧を除去
+    const cleaned = host.replace(/^\[|\]$/g, "");
+    // IPv6形式の判定
+    // - コロンを含む必要がある
+    if (!cleaned.includes(":"))
+        return false;
+    // IPv4マップドIPv6 (::ffff:x.x.x.x) または IPv4互換IPv6 (::x.x.x.x)
+    if (cleaned.includes(".")) {
+        // ::ffff:192.168.1.1 形式
+        const ipv4MappedRegex = /^(::ffff:|::)(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/i;
+        if (ipv4MappedRegex.test(cleaned)) {
+            return true;
+        }
+        // IPv4部分が含まれるその他の形式も許容
+    }
+    // 標準的なIPv6形式
+    // 完全形式: 2001:0db8:0000:0000:0000:0000:0000:0001
+    // 圧縮形式: 2001:db8::1, ::1, fe80::1, ::
+    // 16進数形式のIPv4マップド: ::ffff:7f00:1
+    // 基本的な構造チェック
+    // セグメントは最大8つ（::を使用する場合は少なくなる）
+    const segments = cleaned.split(":");
+    // :: が含まれているか
+    const hasDoubleColon = cleaned.includes("::");
+    // :: は1回のみ許可
+    const doubleColonCount = (cleaned.match(/::/g) || []).length;
+    if (doubleColonCount > 1)
+        return false;
+    // セグメント数のチェック
+    if (hasDoubleColon) {
+        // :: を使用する場合、残りのセグメントは8未満
+        const nonEmptySegments = segments.filter((s) => s !== "").length;
+        if (nonEmptySegments > 7)
+            return false;
+    }
+    else {
+        // :: を使用しない場合、セグメントは正確に8つ
+        if (segments.length !== 8)
+            return false;
+    }
+    // 各セグメントが有効な16進数（0-4桁）か、空文字（::の一部）かチェック
+    for (const segment of segments) {
+        // 空のセグメントは :: の一部として許容
+        if (segment === "")
+            continue;
+        // IPv4部分のチェック（最後のセグメントの場合）
+        if (segment.includes(".")) {
+            const ipv4Regex = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/;
+            if (!ipv4Regex.test(segment))
+                return false;
+            continue;
+        }
+        // 16進数セグメント（1-4桁）
+        if (!/^[0-9a-f]{1,4}$/i.test(segment))
+            return false;
+    }
+    return true;
+}
+/**
+ * IPv6アドレスを完全形式に展開
+ * 例: ::1 -> 0000:0000:0000:0000:0000:0000:0000:0001
+ */
+function expandIPv6(ipv6) {
+    // IPv4マップド/互換形式は特別処理
+    if (ipv6.includes(".")) {
+        return ipv6; // そのまま返す
+    }
+    let parts = ipv6.split(":");
+    // :: の展開
+    const doubleColonIndex = ipv6.indexOf("::");
+    if (doubleColonIndex !== -1) {
+        const before = ipv6.slice(0, doubleColonIndex).split(":").filter(Boolean);
+        const after = ipv6
+            .slice(doubleColonIndex + 2)
+            .split(":")
+            .filter(Boolean);
+        const zerosNeeded = 8 - before.length - after.length;
+        const zeros = Array(Math.max(0, zerosNeeded)).fill("0000");
+        parts = [...before, ...zeros, ...after];
+    }
+    // 各パートを4桁にパディング
+    return parts.map((p) => p.padStart(4, "0")).join(":");
+}
+/**
+ * IPv6アドレスがブロックされるレンジに含まれているかチェック
+ *
+ * @param ipv6 - チェックするIPv6アドレス（角括弧なし）
+ * @returns ブロックされている場合 true
+ */
+function isBlockedIPv6Range(ipv6) {
+    const cleaned = ipv6.toLowerCase().replace(/^\[|\]$/g, "");
+    // IPv6形式でない場合はfalse
+    if (!isIPv6Address(cleaned)) {
+        return false;
+    }
+    // IPv6アドレスを展開（圧縮形式を完全形式に）
+    const expanded = expandIPv6(cleaned);
+    // 各パターンをチェック
+    for (const pattern of Object.values(exports.BLOCKED_IPV6_PATTERNS)) {
+        if (pattern.test(expanded) || pattern.test(cleaned)) {
+            return true;
+        }
+    }
+    // IPv4マップドIPv6 (::ffff:x.x.x.x) のチェック
+    const ipv4MappedMatch = cleaned.match(/^::ffff:(\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})$/i);
+    if (ipv4MappedMatch && ipv4MappedMatch[1]) {
+        // 埋め込まれたIPv4がブロック対象かチェック
+        if (isBlockedHost(ipv4MappedMatch[1]) || isBlockedIPv4Range(ipv4MappedMatch[1])) {
+            return true;
+        }
+    }
+    // IPv4互換IPv6 (::x.x.x.x) のチェック
+    const ipv4CompatMatch = cleaned.match(/^::(\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})$/);
+    if (ipv4CompatMatch && ipv4CompatMatch[1]) {
+        if (isBlockedHost(ipv4CompatMatch[1]) || isBlockedIPv4Range(ipv4CompatMatch[1])) {
+            return true;
+        }
+    }
+    // 16進数形式のIPv4マップドIPv6 (::ffff:7f00:1) のチェック
+    const hexMappedMatch = cleaned.match(/^::ffff:([0-9a-f]{1,4}):([0-9a-f]{1,4})$/i);
+    if (hexMappedMatch && hexMappedMatch[1] && hexMappedMatch[2]) {
+        const high = parseInt(hexMappedMatch[1], 16);
+        const low = parseInt(hexMappedMatch[2], 16);
+        const ipv4 = `${(high >> 8) & 0xff}.${high & 0xff}.${(low >> 8) & 0xff}.${low & 0xff}`;
+        if (isBlockedHost(ipv4) || isBlockedIPv4Range(ipv4)) {
+            return true;
+        }
+    }
+    // IPv4互換IPv6の16進数形式 (::c0a8:101 = ::192.168.1.1) のチェック
+    // URL APIがIPv4互換IPv6を16進数形式に変換する場合に対応
+    const hexCompatMatch = cleaned.match(/^::([0-9a-f]{1,4}):([0-9a-f]{1,4})$/i);
+    if (hexCompatMatch && hexCompatMatch[1] && hexCompatMatch[2]) {
+        const high = parseInt(hexCompatMatch[1], 16);
+        const low = parseInt(hexCompatMatch[2], 16);
+        const ipv4 = `${(high >> 8) & 0xff}.${high & 0xff}.${(low >> 8) & 0xff}.${low & 0xff}`;
+        if (isBlockedHost(ipv4) || isBlockedIPv4Range(ipv4)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * IPv4アドレスがブロックされるレンジに含まれているかチェック（内部関数）
+ *
+ * @param ip - チェックするIPv4アドレス
+ * @returns ブロックされている場合 true
+ */
+function isBlockedIPv4Range(ip) {
+    // IPアドレス形式でない場合はfalse
+    if (!isIPv4Address(ip)) {
+        return false;
+    }
+    // 各レンジをチェック
+    for (const range of exports.BLOCKED_IP_RANGES) {
+        if (range.test(ip)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * ホスト名がブロックリストに含まれているかチェック
+ *
+ * @param host - チェックするホスト名
+ * @returns ブロックされている場合 true
+ */
+function isBlockedHost(host) {
+    const normalizedHost = host.toLowerCase().replace(/^\[|\]$/g, "");
+    // 直接一致チェック
+    if (exports.BLOCKED_HOSTS.includes(normalizedHost)) {
+        return true;
+    }
+    // メタデータサービスの部分一致チェック
+    if (normalizedHost.includes("metadata.google.internal")) {
+        return true;
+    }
+    return false;
+}
+/**
+ * IPアドレスがブロックされるレンジに含まれているかチェック
+ * IPv4とIPv6の両方に対応
+ *
+ * @param ip - チェックするIPアドレス
+ * @returns ブロックされている場合 true
+ */
+function isBlockedIpRange(ip) {
+    // IPv6チェックを先に行う
+    if (isIPv6Address(ip)) {
+        return isBlockedIPv6Range(ip);
+    }
+    // IPv4形式でない場合はfalse
+    if (!isIPv4Address(ip)) {
+        return false;
+    }
+    // IPv4レンジチェック
+    return isBlockedIPv4Range(ip);
+}
+/**
+ * URLを検証用に正規化
+ *
+ * @param url - 正規化するURL
+ * @returns 正規化されたURL文字列
+ */
+function normalizeUrlForValidation(url) {
+    const trimmed = url.trim();
+    try {
+        const urlObj = new URL(trimmed);
+        // 1. ホスト名を小文字に正規化
+        urlObj.hostname = urlObj.hostname.toLowerCase();
+        // 2. デフォルトポートを除去 (443 for https, 80 for http)
+        if ((urlObj.protocol === "https:" && urlObj.port === "443") ||
+            (urlObj.protocol === "http:" && urlObj.port === "80")) {
+            urlObj.port = "";
+        }
+        // 3. フラグメント（#hash）を除去
+        urlObj.hash = "";
+        // 4. パス正規化: 連続スラッシュを単一スラッシュに
+        urlObj.pathname = urlObj.pathname.replace(/\/+/g, "/");
+        // 5. クエリパラメータをアルファベット順にソート
+        let sortedQuery = "";
+        if (urlObj.search) {
+            const params = urlObj.searchParams;
+            const entries = Array.from(params.entries());
+            // パラメータ名でソート、同じ名前の場合は値でソート
+            entries.sort((a, b) => {
+                const keyCompare = a[0].localeCompare(b[0]);
+                if (keyCompare !== 0)
+                    return keyCompare;
+                return a[1].localeCompare(b[1]);
+            });
+            const sortedParams = new URLSearchParams();
+            for (const [key, value] of entries) {
+                sortedParams.append(key, value);
+            }
+            sortedQuery = sortedParams.toString();
+        }
+        // 6. パスを正規化（ルートパス "/" のみの場合は空に）
+        let normalizedPath = urlObj.pathname;
+        if (normalizedPath === "/") {
+            normalizedPath = "";
+        }
+        // 末尾スラッシュを除去（パスがある場合のみ）
+        if (normalizedPath.length > 1) {
+            normalizedPath = normalizedPath.replace(/\/+$/, "");
+        }
+        // 7. 結果を手動で構築（URL objectのhrefを使わない）
+        let result = `${urlObj.protocol}//${urlObj.hostname}`;
+        // ポートを追加（非デフォルトポートのみ）
+        if (urlObj.port) {
+            result += `:${urlObj.port}`;
+        }
+        // パスを追加
+        result += normalizedPath;
+        // クエリを追加
+        if (sortedQuery) {
+            result += `?${sortedQuery}`;
+        }
+        return result;
+    }
+    catch {
+        // URL解析に失敗した場合はそのまま返す
+        return trimmed.toLowerCase();
+    }
+}
+// =============================================
+// メイン検証関数
+// =============================================
+/**
+ * 外部URLの安全性を検証
+ *
+ * SSRF対策として以下をチェック:
+ * - プロトコル (http/https のみ許可)
+ * - ブロックされたホスト (localhost, メタデータサービスなど)
+ * - プライベートIPレンジ (10.x, 172.16-31.x, 192.168.x など)
+ *
+ * @param url - 検証するURL
+ * @returns 検証結果
+ *
+ * @example
+ * ```typescript
+ * const result = validateExternalUrl('https://example.com');
+ * if (result.valid) {
+ *   console.log('URL is safe:', result.normalizedUrl);
+ * } else {
+ *   console.error('URL blocked:', result.error);
+ * }
+ * ```
+ */
+function validateExternalUrl(url) {
+    // 空チェック
+    if (!url || url.trim() === "") {
+        return {
+            valid: false,
+            error: "URL is empty: URL cannot be empty or whitespace only",
+        };
+    }
+    const trimmedUrl = url.trim();
+    // プロトコルチェック（プロトコルなしの場合）
+    if (!trimmedUrl.includes("://")) {
+        return {
+            valid: false,
+            error: "Invalid protocol: URL must start with http:// or https://",
+        };
+    }
+    // URL解析
+    let urlObj;
+    try {
+        urlObj = new URL(trimmedUrl);
+    }
+    catch {
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.debug("[url-validator] Failed to parse URL", { url: trimmedUrl });
+        }
+        return {
+            valid: false,
+            error: "Invalid URL format: unable to parse URL",
+        };
+    }
+    // プロトコル検証
+    if (!ALLOWED_PROTOCOLS.includes(urlObj.protocol)) {
+        return {
+            valid: false,
+            error: `Invalid protocol: only http and https are allowed, got ${urlObj.protocol}`,
+        };
+    }
+    // ホスト名取得（ポート除去）
+    const hostname = urlObj.hostname.toLowerCase();
+    // 空のホスト名チェック
+    if (!hostname || hostname === "" || hostname === "." || hostname === "..") {
+        return {
+            valid: false,
+            error: "Invalid URL format: hostname is empty or invalid",
+        };
+    }
+    // ホスト名の基本的な妥当性チェック（ドットのみは無効）
+    if (/^\.+$/.test(hostname)) {
+        return {
+            valid: false,
+            error: "Invalid URL format: hostname contains only dots",
+        };
+    }
+    // ブロックホストチェック
+    if (isBlockedHost(hostname)) {
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.warn("[url-validator] Blocked host detected", { hostname });
+        }
+        return {
+            valid: false,
+            error: `URL is blocked: ${hostname} is not allowed`,
+        };
+    }
+    // IPレンジチェック（IPv4アドレス形式の場合）
+    if (isIPv4Address(hostname)) {
+        if (isBlockedIpRange(hostname)) {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.warn("[url-validator] Blocked IP range detected", { hostname });
+            }
+            return {
+                valid: false,
+                error: `URL is blocked: private IP range ${hostname} is not allowed`,
+            };
+        }
+    }
+    // IPv6レンジチェック
+    // URL APIはIPv6ホスト名に角括弧を保持する（例: "[fe80::1]"）
+    // isIPv6Address/isBlockedIPv6Rangeは角括弧付きでも正しく処理する
+    if (isIPv6Address(hostname)) {
+        if (isBlockedIPv6Range(hostname)) {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.warn("[url-validator] Blocked IPv6 range detected", { hostname });
+            }
+            return {
+                valid: false,
+                error: `URL is blocked: IPv6 address ${hostname} is not allowed`,
+            };
+        }
+    }
+    // URLエンコードされた危険なパターンのチェック
+    const decodedUrl = decodeURIComponent(trimmedUrl).toLowerCase();
+    if (decodedUrl.includes("localhost") ||
+        decodedUrl.includes("127.0.0.1") ||
+        decodedUrl.includes("169.254.169.254")) {
+        // 実際のホスト名とデコード後で異なる場合は疑わしい
+        if (!hostname.includes("localhost") && !hostname.includes("127.0.0.1")) {
+            return {
+                valid: false,
+                error: "URL is blocked: suspicious URL encoding detected",
+            };
+        }
+    }
+    // 正規化されたURLを返す
+    const normalizedUrl = normalizeUrlForValidation(trimmedUrl);
+    if ((0, logger_1.isDevelopment)()) {
+        logger_1.logger.debug("[url-validator] URL validated successfully", {
+            original: trimmedUrl,
+            normalized: normalizedUrl,
+        });
+    }
+    return {
+        valid: true,
+        normalizedUrl,
+    };
+}
+// =============================================
+// Zodスキーマ（オプション）
+// =============================================
+// =============================================
+// 開発環境ログ
+// =============================================
+if ((0, logger_1.isDevelopment)()) {
+    logger_1.logger.debug("[url-validator] Module loaded", {
+        blockedHostsCount: exports.BLOCKED_HOSTS.length,
+        blockedIpRangesCount: exports.BLOCKED_IP_RANGES.length,
+    });
+}
+//# sourceMappingURL=url-validator.js.map

package/dist/utils/url-validator.js.map

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

package/dist/workers/batch-quality-worker.d.ts

@@ -0,0 +1,87 @@
+/**
+ * BatchQualityWorker - BullMQ Worker for Batch Quality Evaluation
+ *
+ * Phase4: Handles batch quality evaluation jobs asynchronously.
+ * Processes multiple pages in batches with configurable batch size.
+ *
+ * Configuration:
+ * - concurrency: 3 (balance between throughput and resource usage)
+ * - lockDuration: 600000ms (aligned with MCP 600s limit)
+ * - attempts: 2 (allow one retry for transient failures)
+ *
+ * @module workers/batch-quality-worker
+ */
+import { Worker, type Job } from "bullmq";
+import { type RedisConfig } from "../config/redis";
+import { type BatchQualityJobData, type BatchQualityJobResult } from "../queues/batch-quality-queue";
+import type { QualityEvaluateData } from "../tools/quality/schemas";
+/**
+ * Worker configuration options
+ */
+export interface BatchQualityWorkerOptions {
+    /** Redis configuration overrides */
+    redisConfig?: Partial<RedisConfig>;
+    /** Worker concurrency (default: 3) */
+    concurrency?: number;
+    /** Lock duration in ms (default: 600000) */
+    lockDuration?: number;
+    /** Enable verbose logging (default: isDevelopment()) */
+    verbose?: boolean;
+}
+/**
+ * Worker instance with lifecycle methods
+ */
+export interface BatchQualityWorkerInstance {
+    /** BullMQ Worker instance */
+    worker: Worker<BatchQualityJobData, BatchQualityJobResult>;
+    /** Gracefully close the worker */
+    close: () => Promise<void>;
+    /** Pause the worker (stop accepting new jobs, current job continues) */
+    pause: () => Promise<void>;
+    /** Check if worker is running */
+    isRunning: () => boolean;
+}
+/**
+ * Service interface for evaluating pages
+ * Injected via setQualityEvaluatorService
+ */
+export interface IQualityEvaluatorService {
+    evaluatePage: (html: string, options?: EvaluatePageOptions) => Promise<QualityEvaluateData>;
+    getPageById?: (pageId: string) => Promise<string | null>;
+}
+/**
+ * Options for page evaluation
+ */
+export interface EvaluatePageOptions {
+    strict?: boolean;
+    weights?: {
+        originality?: number;
+        craftsmanship?: number;
+        contextuality?: number;
+    };
+}
+/**
+ * Set the quality evaluator service (dependency injection)
+ * Must be called before worker starts processing jobs.
+ */
+export declare function setQualityEvaluatorService(service: IQualityEvaluatorService): void;
+/**
+ * Reset the quality evaluator service (for testing)
+ */
+export declare function resetQualityEvaluatorService(): void;
+/**
+ * Process a batch quality evaluation job
+ *
+ * @param job - BullMQ Job instance
+ * @returns Job result
+ */
+declare function processBatchQualityJob(job: Job<BatchQualityJobData, BatchQualityJobResult>): Promise<BatchQualityJobResult>;
+/**
+ * Create a BatchQualityWorker instance
+ *
+ * @param options - Worker configuration options
+ * @returns Worker instance with lifecycle methods
+ */
+export declare function createBatchQualityWorker(options?: BatchQualityWorkerOptions): BatchQualityWorkerInstance;
+export { processBatchQualityJob };
+//# sourceMappingURL=batch-quality-worker.d.ts.map

package/dist/workers/batch-quality-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-quality-worker.d.ts","sourceRoot":"","sources":["../../src/workers/batch-quality-worker.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,EAAE,KAAK,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAG3B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAMpE;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,oCAAoC;IACpC,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACnC,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC,mBAAmB,EAAE,qBAAqB,CAAC,CAAC;IAC3D,kCAAkC;IAClC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,wEAAwE;IACxE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,iCAAiC;IACjC,SAAS,EAAE,MAAM,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5F,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC1D;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAkBD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAElF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD;AAMD;;;;;GAKG;AACH,iBAAe,sBAAsB,CACnC,GAAG,EAAE,GAAG,CAAC,mBAAmB,EAAE,qBAAqB,CAAC,GACnD,OAAO,CAAC,qBAAqB,CAAC,CAiLhC;AAMD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAA8B,GACtC,0BAA0B,CAgG5B;AAMD,OAAO,EAAE,sBAAsB,EAAE,CAAC"}