@reftrixmcp/mcp-server 0.1.7

package/dist/services/database-dumper.service.js

@@ -0,0 +1,550 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseDumperService = exports.TimeoutError = exports.ConnectionError = exports.RestoreError = exports.DumpError = exports.PgDumpNotFoundError = exports.DatabaseUrlParseError = void 0;
+exports.parseDatabaseUrl = parseDatabaseUrl;
+/**
+ * DatabaseDumper サービス
+ *
+ * PostgreSQL pg_dump / psql を使用したデータベースダンプ・リストアサービス。
+ *
+ * セキュリティ要件:
+ * - パスワードはコマンドライン引数に含めず、PGPASSWORD環境変数を使用
+ * - 一時ファイル使用時は0600パーミッション
+ * - SQLインジェクション対策
+ * - additionalArgsはホワイトリストで検証
+ *
+ * PostgreSQL 16対応
+ */
+const child_process_1 = require("child_process");
+const logger_1 = require("../utils/logger");
+const logger = new logger_1.Logger("DatabaseDumper");
+// =============================================================================
+// カスタムエラー
+// =============================================================================
+/**
+ * DATABASE_URL パースエラー
+ */
+class DatabaseUrlParseError extends Error {
+    url;
+    constructor(message, url) {
+        super(message);
+        this.url = url;
+        this.name = "DatabaseUrlParseError";
+    }
+}
+exports.DatabaseUrlParseError = DatabaseUrlParseError;
+/**
+ * pg_dump が見つからないエラー
+ */
+class PgDumpNotFoundError extends Error {
+    constructor(message = "pg_dump command not found. Please install PostgreSQL client tools.") {
+        super(message);
+        this.name = "PgDumpNotFoundError";
+    }
+}
+exports.PgDumpNotFoundError = PgDumpNotFoundError;
+/**
+ * ダンプエラー
+ */
+class DumpError extends Error {
+    stderr;
+    exitCode;
+    constructor(message, stderr, exitCode) {
+        super(message);
+        this.stderr = stderr;
+        this.exitCode = exitCode;
+        this.name = "DumpError";
+    }
+}
+exports.DumpError = DumpError;
+/**
+ * リストアエラー
+ */
+class RestoreError extends Error {
+    stderr;
+    exitCode;
+    constructor(message, stderr, exitCode) {
+        super(message);
+        this.stderr = stderr;
+        this.exitCode = exitCode;
+        this.name = "RestoreError";
+    }
+}
+exports.RestoreError = RestoreError;
+/**
+ * 接続エラー
+ */
+class ConnectionError extends Error {
+    stderr;
+    constructor(message, stderr) {
+        super(message);
+        this.stderr = stderr;
+        this.name = "ConnectionError";
+    }
+}
+exports.ConnectionError = ConnectionError;
+/**
+ * タイムアウトエラー
+ */
+class TimeoutError extends Error {
+    timeoutMs;
+    constructor(message, timeoutMs) {
+        super(message);
+        this.timeoutMs = timeoutMs;
+        this.name = "TimeoutError";
+    }
+}
+exports.TimeoutError = TimeoutError;
+// =============================================================================
+// ユーティリティ関数
+// =============================================================================
+/**
+ * DATABASE_URL をパースして接続情報を抽出
+ *
+ * @param url DATABASE_URL (postgresql:// または postgres://)
+ * @returns データベース接続情報
+ * @throws DatabaseUrlParseError
+ */
+function parseDatabaseUrl(url) {
+    if (!url || typeof url !== "string") {
+        throw new DatabaseUrlParseError("DATABASE_URL is required");
+    }
+    // postgresql:// または postgres:// で始まる必要がある
+    if (!url.startsWith("postgresql://") && !url.startsWith("postgres://")) {
+        throw new DatabaseUrlParseError("DATABASE_URL must start with postgresql:// or postgres://", url);
+    }
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new DatabaseUrlParseError("Invalid DATABASE_URL format", url);
+    }
+    // ユーザー名は必須
+    if (!parsed.username) {
+        throw new DatabaseUrlParseError("DATABASE_URL must include username", url);
+    }
+    // データベース名を抽出（先頭の / を除去）
+    const database = parsed.pathname.slice(1);
+    if (!database) {
+        throw new DatabaseUrlParseError("DATABASE_URL must include database name", url);
+    }
+    // パスワードをデコード（URLエンコードされている場合）
+    const password = decodeURIComponent(parsed.password || "");
+    // SSLモードを抽出
+    const sslmode = parsed.searchParams.get("sslmode");
+    const result = {
+        host: parsed.hostname,
+        port: parsed.port ? parseInt(parsed.port, 10) : 5432,
+        database,
+        user: parsed.username,
+        password,
+    };
+    if (sslmode) {
+        result.sslmode = sslmode;
+    }
+    return result;
+}
+/**
+ * 接続エラーかどうか判定
+ */
+function isConnectionError(stderr) {
+    const connectionErrorPatterns = [
+        /connection.*refused/i,
+        /could not connect/i,
+        /connection to server.*failed/i,
+        /no route to host/i,
+        /host.*not found/i,
+        /authentication failed/i,
+        /password authentication failed/i,
+    ];
+    return connectionErrorPatterns.some((pattern) => pattern.test(stderr));
+}
+// =============================================================================
+// DatabaseDumperService クラス
+// =============================================================================
+/**
+ * データベースダンパーサービス
+ *
+ * pg_dump / psql コマンドを使用してPostgreSQLデータベースの
+ * ダンプとリストアを行います。
+ *
+ * @example
+ * ```typescript
+ * const service = new DatabaseDumperService();
+ *
+ * // 可用性チェック
+ * const available = await service.isAvailable();
+ * if (!available.pgDump) {
+ *   throw new Error('pg_dump not installed');
+ * }
+ *
+ * // ダンプ
+ * const sql = await service.dump(process.env.DATABASE_URL!);
+ *
+ * // リストア
+ * await service.restore(process.env.DATABASE_URL!, sql);
+ * ```
+ */
+class DatabaseDumperService {
+    /** デフォルトタイムアウト: 5分 */
+    static DEFAULT_TIMEOUT_MS = 5 * 60 * 1000;
+    /**
+     * 許可する追加引数のホワイトリスト
+     * セキュリティ対策: 任意の引数を許可するとコマンドインジェクションの可能性
+     */
+    static ALLOWED_ADDITIONAL_ARGS = new Set([
+        // 出力制御
+        "--no-owner",
+        "--no-acl",
+        "--no-comments",
+        "--no-publications",
+        "--no-security-labels",
+        "--no-subscriptions",
+        "--no-tablespaces",
+        "--no-privileges",
+        // データ形式
+        "--inserts",
+        "--column-inserts",
+        "--rows-per-insert",
+        // クリーンアップ
+        "--clean",
+        "--if-exists",
+        "--create",
+        // 圧縮
+        "--compress",
+        // その他安全なオプション
+        "--no-synchronized-snapshots",
+        "--no-unlogged-table-data",
+        "--quote-all-identifiers",
+        "--serializable-deferrable",
+        "--snapshot",
+        "--strict-names",
+        "--use-set-session-authorization",
+        "--verbose",
+    ]);
+    /**
+     * データベースをダンプしてSQL文字列を返す
+     *
+     * @param databaseUrl DATABASE_URL
+     * @param options ダンプオプション
+     * @returns ダンプされたSQL
+     * @throws DatabaseUrlParseError, PgDumpNotFoundError, ConnectionError, TimeoutError, DumpError
+     */
+    async dump(databaseUrl, options = {}) {
+        const connInfo = parseDatabaseUrl(databaseUrl);
+        const timeoutMs = options.timeoutMs ?? DatabaseDumperService.DEFAULT_TIMEOUT_MS;
+        // pg_dump コマンド引数を構築
+        const args = this.buildDumpArgs(connInfo, options);
+        logger.debug("Executing pg_dump", { host: connInfo.host, database: connInfo.database });
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            const stderrChunks = [];
+            // 環境変数にパスワードを設定（コマンドライン引数には含めない）
+            const env = {
+                ...process.env,
+                PGPASSWORD: connInfo.password,
+            };
+            // SSLモード設定
+            if (connInfo.sslmode) {
+                env.PGSSLMODE = connInfo.sslmode;
+            }
+            const spawnOptions = {
+                env,
+                stdio: ["ignore", "pipe", "pipe"],
+            };
+            let child;
+            try {
+                child = (0, child_process_1.spawn)("pg_dump", args, spawnOptions);
+            }
+            catch {
+                reject(new PgDumpNotFoundError());
+                return;
+            }
+            // タイムアウト設定
+            const timeoutId = setTimeout(() => {
+                if (!child.killed) {
+                    child.kill("SIGTERM");
+                    reject(new TimeoutError(`pg_dump timed out after ${timeoutMs}ms`, timeoutMs));
+                }
+            }, timeoutMs);
+            // stdout 収集
+            child.stdout?.on("data", (data) => {
+                chunks.push(data);
+            });
+            // stderr 収集
+            child.stderr?.on("data", (data) => {
+                stderrChunks.push(data);
+            });
+            // エラーハンドリング
+            child.on("error", (err) => {
+                clearTimeout(timeoutId);
+                if (err.code === "ENOENT" || err.message.includes("ENOENT")) {
+                    reject(new PgDumpNotFoundError());
+                }
+                else {
+                    reject(new DumpError(`pg_dump failed: ${err.message}`));
+                }
+            });
+            // 終了ハンドリング
+            child.on("close", (code) => {
+                clearTimeout(timeoutId);
+                const stderr = Buffer.concat(stderrChunks).toString();
+                if (code === 0) {
+                    const stdout = Buffer.concat(chunks).toString();
+                    logger.debug("pg_dump completed", { bytes: stdout.length });
+                    resolve(stdout);
+                }
+                else {
+                    // エラー分類
+                    if (isConnectionError(stderr)) {
+                        reject(new ConnectionError(`Failed to connect to database: ${stderr}`, stderr));
+                    }
+                    else {
+                        reject(new DumpError(`pg_dump exited with code ${code}`, stderr, code ?? undefined));
+                    }
+                }
+            });
+        });
+    }
+    /**
+     * SQLをデータベースにリストア
+     *
+     * @param databaseUrl DATABASE_URL
+     * @param sqlContent リストアするSQL
+     * @param options リストアオプション
+     * @throws DatabaseUrlParseError, RestoreError, ConnectionError, TimeoutError
+     */
+    async restore(databaseUrl, sqlContent, options = {}) {
+        const connInfo = parseDatabaseUrl(databaseUrl);
+        const timeoutMs = options.timeoutMs ?? DatabaseDumperService.DEFAULT_TIMEOUT_MS;
+        // psql コマンド引数を構築
+        const args = this.buildRestoreArgs(connInfo);
+        logger.debug("Executing psql restore", { host: connInfo.host, database: connInfo.database });
+        return new Promise((resolve, reject) => {
+            const stderrChunks = [];
+            // 環境変数にパスワードを設定
+            const env = {
+                ...process.env,
+                PGPASSWORD: connInfo.password,
+            };
+            if (connInfo.sslmode) {
+                env.PGSSLMODE = connInfo.sslmode;
+            }
+            const spawnOptions = {
+                env,
+                stdio: ["pipe", "pipe", "pipe"],
+            };
+            let child;
+            try {
+                child = (0, child_process_1.spawn)("psql", args, spawnOptions);
+            }
+            catch {
+                reject(new RestoreError("psql command not found. Please install PostgreSQL client tools."));
+                return;
+            }
+            // タイムアウト設定
+            const timeoutId = setTimeout(() => {
+                if (!child.killed) {
+                    child.kill("SIGTERM");
+                    reject(new TimeoutError(`psql restore timed out after ${timeoutMs}ms`, timeoutMs));
+                }
+            }, timeoutMs);
+            // stderr 収集
+            child.stderr?.on("data", (data) => {
+                stderrChunks.push(data);
+            });
+            // エラーハンドリング
+            child.on("error", (err) => {
+                clearTimeout(timeoutId);
+                if (err.code === "ENOENT" || err.message.includes("ENOENT")) {
+                    reject(new RestoreError("psql command not found. Please install PostgreSQL client tools."));
+                }
+                else {
+                    reject(new RestoreError(`psql failed: ${err.message}`));
+                }
+            });
+            // 終了ハンドリング
+            child.on("close", (code) => {
+                clearTimeout(timeoutId);
+                const stderr = Buffer.concat(stderrChunks).toString();
+                if (code === 0) {
+                    logger.debug("psql restore completed");
+                    resolve();
+                }
+                else {
+                    // エラー分類
+                    if (isConnectionError(stderr)) {
+                        reject(new ConnectionError(`Failed to connect to database: ${stderr}`, stderr));
+                    }
+                    else {
+                        reject(new RestoreError(`psql exited with code ${code}`, stderr, code ?? undefined));
+                    }
+                }
+            });
+            // SQLをstdinに書き込む
+            const wrappedSql = this.wrapSqlForRestore(sqlContent, options);
+            child.stdin?.write(wrappedSql);
+            child.stdin?.end();
+        });
+    }
+    /**
+     * pg_dump / psql の可用性をチェック
+     *
+     * @returns 可用性チェック結果
+     */
+    async isAvailable() {
+        const result = {
+            pgDump: false,
+            psql: false,
+        };
+        // SEC-H3: execSyncのバージョンチェック
+        // ハードコードされたコマンド文字列のみ（ユーザー入力なし、インジェクション不可）
+        // pg_dump チェック
+        try {
+            const pgDumpOutput = (0, child_process_1.execSync)("pg_dump --version", { encoding: "utf8" });
+            result.pgDump = true;
+            result.pgDumpVersion = this.extractVersion(pgDumpOutput);
+        }
+        catch {
+            result.pgDump = false;
+        }
+        // psql チェック
+        try {
+            const psqlOutput = (0, child_process_1.execSync)("psql --version", { encoding: "utf8" });
+            result.psql = true;
+            result.psqlVersion = this.extractVersion(psqlOutput);
+        }
+        catch {
+            result.psql = false;
+        }
+        return result;
+    }
+    // ===========================================================================
+    // プライベートメソッド
+    // ===========================================================================
+    /**
+     * pg_dump コマンド引数を構築
+     */
+    buildDumpArgs(connInfo, options) {
+        const args = [
+            `--host=${connInfo.host}`,
+            `--port=${connInfo.port}`,
+            `--username=${connInfo.user}`,
+            `--dbname=${connInfo.database}`,
+            "--format=plain",
+            "--no-password", // PGPASSWORD環境変数を使用
+        ];
+        // オプション処理
+        if (options.schemaOnly) {
+            args.push("--schema-only");
+        }
+        if (options.dataOnly) {
+            args.push("--data-only");
+        }
+        if (options.tables && options.tables.length > 0) {
+            for (const table of options.tables) {
+                // SQLインジェクション対策: テーブル名のバリデーション
+                if (this.isValidIdentifier(table)) {
+                    args.push(`--table=${table}`);
+                }
+                else {
+                    logger.warn("Invalid table name skipped", { table });
+                }
+            }
+        }
+        if (options.excludeTables && options.excludeTables.length > 0) {
+            for (const table of options.excludeTables) {
+                if (this.isValidIdentifier(table)) {
+                    args.push(`--exclude-table=${table}`);
+                }
+                else {
+                    logger.warn("Invalid exclude table name skipped", { table });
+                }
+            }
+        }
+        if (options.includeLargeObjects) {
+            args.push("--blobs");
+        }
+        if (options.additionalArgs) {
+            for (const arg of options.additionalArgs) {
+                // 引数の基本部分を抽出（--compress=9 → --compress）
+                const baseArg = arg.split("=")[0];
+                if (baseArg && DatabaseDumperService.ALLOWED_ADDITIONAL_ARGS.has(baseArg)) {
+                    args.push(arg);
+                }
+                else {
+                    // セキュリティログ: 許可されていない引数はスキップ
+                    logger.warn("Skipping disallowed additional arg for security", { arg });
+                }
+            }
+        }
+        return args;
+    }
+    /**
+     * psql コマンド引数を構築
+     */
+    buildRestoreArgs(connInfo) {
+        return [
+            `--host=${connInfo.host}`,
+            `--port=${connInfo.port}`,
+            `--username=${connInfo.user}`,
+            `--dbname=${connInfo.database}`,
+            "--no-password", // PGPASSWORD環境変数を使用
+            "--quiet",
+            "-v",
+            "ON_ERROR_STOP=1", // エラー時に停止
+        ];
+    }
+    /**
+     * リストア用にSQLをラップ
+     */
+    wrapSqlForRestore(sql, options) {
+        const parts = [];
+        // トランザクション開始
+        if (!options.noTransaction) {
+            parts.push("BEGIN;");
+        }
+        // 外部キー制約の一時無効化
+        if (options.disableForeignKeys) {
+            parts.push("SET session_replication_role = replica;");
+        }
+        // メインSQL
+        parts.push(sql);
+        // 外部キー制約の再有効化
+        if (options.disableForeignKeys) {
+            parts.push("SET session_replication_role = DEFAULT;");
+        }
+        // トランザクションコミット
+        if (!options.noTransaction) {
+            parts.push("COMMIT;");
+        }
+        return parts.join("\n");
+    }
+    /**
+     * バージョン文字列を抽出
+     */
+    extractVersion(output) {
+        // "pg_dump (PostgreSQL) 16.0" -> "16.0"
+        const match = output.match(/\d+\.\d+(?:\.\d+)?/);
+        return match ? match[0] : output.trim();
+    }
+    /**
+     * 識別子（テーブル名など）が有効かチェック
+     *
+     * SQLインジェクション対策
+     */
+    isValidIdentifier(name) {
+        // PostgreSQL識別子の規則: 英字、数字、アンダースコア、ドル記号
+        // スキーマ.テーブル形式も許可
+        return /^[a-zA-Z_][a-zA-Z0-9_$]*(\.[a-zA-Z_][a-zA-Z0-9_$]*)?$/.test(name);
+    }
+}
+exports.DatabaseDumperService = DatabaseDumperService;
+// =============================================================================
+// デフォルトエクスポート
+// =============================================================================
+exports.default = DatabaseDumperService;
+//# sourceMappingURL=database-dumper.service.js.map

package/dist/services/database-dumper.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-dumper.service.js","sourceRoot":"","sources":["../../src/services/database-dumper.service.ts"],"names":[],"mappings":";AAAA,6DAA6D;AAC7D,yCAAyC;;;AA2KzC,4CAkDC;AA3ND;;;;;;;;;;;;GAYG;AAEH,iDAAsF;AACtF,4CAAyC;AAEzC,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,gBAAgB,CAAC,CAAC;AA4D5C,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;GAEG;AACH,MAAa,qBAAsB,SAAQ,KAAK;IAG5B;IAFlB,YACE,OAAe,EACC,GAAY;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,QAAG,GAAH,GAAG,CAAS;QAG5B,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AARD,sDAQC;AAED;;GAEG;AACH,MAAa,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAO,GAAG,oEAAoE;QACxF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC;AAED;;GAEG;AACH,MAAa,SAAU,SAAQ,KAAK;IAGhB;IACA;IAHlB,YACE,OAAe,EACC,MAAe,EACf,QAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,WAAM,GAAN,MAAM,CAAS;QACf,aAAQ,GAAR,QAAQ,CAAS;QAGjC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AATD,8BASC;AAED;;GAEG;AACH,MAAa,YAAa,SAAQ,KAAK;IAGnB;IACA;IAHlB,YACE,OAAe,EACC,MAAe,EACf,QAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,WAAM,GAAN,MAAM,CAAS;QACf,aAAQ,GAAR,QAAQ,CAAS;QAGjC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AATD,oCASC;AAED;;GAEG;AACH,MAAa,eAAgB,SAAQ,KAAK;IAGtB;IAFlB,YACE,OAAe,EACC,MAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,WAAM,GAAN,MAAM,CAAS;QAG/B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AARD,0CAQC;AAED;;GAEG;AACH,MAAa,YAAa,SAAQ,KAAK;IAGnB;IAFlB,YACE,OAAe,EACC,SAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,cAAS,GAAT,SAAS,CAAQ;QAGjC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AARD,oCAQC;AAED,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,GAAW;IAC1C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,qBAAqB,CAAC,0BAA0B,CAAC,CAAC;IAC9D,CAAC;IAED,0CAA0C;IAC1C,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,qBAAqB,CAC7B,2DAA2D,EAC3D,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,qBAAqB,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;IACtE,CAAC;IAED,WAAW;IACX,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,IAAI,qBAAqB,CAAC,oCAAoC,EAAE,GAAG,CAAC,CAAC;IAC7E,CAAC;IAED,wBAAwB;IACxB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,qBAAqB,CAAC,yCAAyC,EAAE,GAAG,CAAC,CAAC;IAClF,CAAC;IAED,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,kBAAkB,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAE3D,YAAY;IACZ,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAEnD,MAAM,MAAM,GAA2B;QACrC,IAAI,EAAE,MAAM,CAAC,QAAQ;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;QACpD,QAAQ;QACR,IAAI,EAAE,MAAM,CAAC,QAAQ;QACrB,QAAQ;KACT,CAAC;IAEF,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,MAAc;IACvC,MAAM,uBAAuB,GAAG;QAC9B,sBAAsB;QACtB,oBAAoB;QACpB,+BAA+B;QAC/B,mBAAmB;QACnB,kBAAkB;QAClB,wBAAwB;QACxB,iCAAiC;KAClC,CAAC;IAEF,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAa,qBAAqB;IAChC,sBAAsB;IACd,MAAM,CAAU,kBAAkB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;IAE3D;;;OAGG;IACK,MAAM,CAAU,uBAAuB,GAAG,IAAI,GAAG,CAAC;QACxD,OAAO;QACP,YAAY;QACZ,UAAU;QACV,eAAe;QACf,mBAAmB;QACnB,sBAAsB;QACtB,oBAAoB;QACpB,kBAAkB;QAClB,iBAAiB;QACjB,QAAQ;QACR,WAAW;QACX,kBAAkB;QAClB,mBAAmB;QACnB,UAAU;QACV,SAAS;QACT,aAAa;QACb,UAAU;QACV,KAAK;QACL,YAAY;QACZ,cAAc;QACd,6BAA6B;QAC7B,0BAA0B;QAC1B,yBAAyB;QACzB,2BAA2B;QAC3B,YAAY;QACZ,gBAAgB;QAChB,iCAAiC;QACjC,WAAW;KACZ,CAAC,CAAC;IAEH;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CAAC,WAAmB,EAAE,UAAuB,EAAE;QACvD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,qBAAqB,CAAC,kBAAkB,CAAC;QAEhF,oBAAoB;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAEnD,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QAExF,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC7C,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,MAAM,YAAY,GAAa,EAAE,CAAC;YAElC,iCAAiC;YACjC,MAAM,GAAG,GAAuB;gBAC9B,GAAG,OAAO,CAAC,GAAG;gBACd,UAAU,EAAE,QAAQ,CAAC,QAAQ;aAC9B,CAAC;YAEF,WAAW;YACX,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrB,GAAG,CAAC,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC;YACnC,CAAC;YAED,MAAM,YAAY,GAAiB;gBACjC,GAAG;gBACH,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;aAClC,CAAC;YAEF,IAAI,KAAmB,CAAC;YACxB,IAAI,CAAC;gBACH,KAAK,GAAG,IAAA,qBAAK,EAAC,SAAS,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;YAC/C,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC;gBAClC,OAAO;YACT,CAAC;YAED,WAAW;YACX,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBAChC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;oBAClB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBACtB,MAAM,CAAC,IAAI,YAAY,CAAC,2BAA2B,SAAS,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;gBAChF,CAAC;YACH,CAAC,EAAE,SAAS,CAAC,CAAC;YAEd,YAAY;YACZ,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACxC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC,CAAC,CAAC;YAEH,YAAY;YACZ,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACxC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC,CAAC,CAAC;YAEH,YAAY;YACZ,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAA8B,EAAE,EAAE;gBACnD,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC5D,MAAM,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC;gBACpC,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,SAAS,CAAC,mBAAmB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAC1D,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,WAAW;YACX,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,YAAY,CAAC,SAAS,CAAC,CAAC;gBAExB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAEtD,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;oBAChD,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;oBAC5D,OAAO,CAAC,MAAM,CAAC,CAAC;gBAClB,CAAC;qBAAM,CAAC;oBACN,QAAQ;oBACR,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;wBAC9B,MAAM,CAAC,IAAI,eAAe,CAAC,kCAAkC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;oBAClF,CAAC;yBAAM,CAAC;wBACN,MAAM,CAAC,IAAI,SAAS,CAAC,4BAA4B,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC;oBACvF,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CACX,WAAmB,EACnB,UAAkB,EAClB,UAA0B,EAAE;QAE5B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,qBAAqB,CAAC,kBAAkB,CAAC;QAEhF,iBAAiB;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAE7C,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE7F,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,MAAM,YAAY,GAAa,EAAE,CAAC;YAElC,gBAAgB;YAChB,MAAM,GAAG,GAAuB;gBAC9B,GAAG,OAAO,CAAC,GAAG;gBACd,UAAU,EAAE,QAAQ,CAAC,QAAQ;aAC9B,CAAC;YAEF,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrB,GAAG,CAAC,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC;YACnC,CAAC;YAED,MAAM,YAAY,GAAiB;gBACjC,GAAG;gBACH,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aAChC,CAAC;YAEF,IAAI,KAAmB,CAAC;YACxB,IAAI,CAAC;gBACH,KAAK,GAAG,IAAA,qBAAK,EAAC,MAAM,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,IAAI,YAAY,CAAC,iEAAiE,CAAC,CAAC,CAAC;gBAC5F,OAAO;YACT,CAAC;YAED,WAAW;YACX,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBAChC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;oBAClB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBACtB,MAAM,CAAC,IAAI,YAAY,CAAC,gCAAgC,SAAS,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;gBACrF,CAAC;YACH,CAAC,EAAE,SAAS,CAAC,CAAC;YAEd,YAAY;YACZ,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACxC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC,CAAC,CAAC;YAEH,YAAY;YACZ,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAA8B,EAAE,EAAE;gBACnD,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC5D,MAAM,CACJ,IAAI,YAAY,CAAC,iEAAiE,CAAC,CACpF,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,YAAY,CAAC,gBAAgB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAC1D,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,WAAW;YACX,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,YAAY,CAAC,SAAS,CAAC,CAAC;gBAExB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAEtD,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;oBACvC,OAAO,EAAE,CAAC;gBACZ,CAAC;qBAAM,CAAC;oBACN,QAAQ;oBACR,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;wBAC9B,MAAM,CAAC,IAAI,eAAe,CAAC,kCAAkC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;oBAClF,CAAC;yBAAM,CAAC;wBACN,MAAM,CAAC,IAAI,YAAY,CAAC,yBAAyB,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC;oBACvF,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,iBAAiB;YACjB,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAC/D,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;YAC/B,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,MAAM,GAAuB;YACjC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,KAAK;SACZ,CAAC;QAEF,6BAA6B;QAC7B,0CAA0C;QAC1C,eAAe;QACf,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAA,wBAAQ,EAAC,mBAAmB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YACzE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;YACrB,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;QACxB,CAAC;QAED,YAAY;QACZ,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAA,wBAAQ,EAAC,gBAAgB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YACpE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;YACnB,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC;QACtB,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,8EAA8E;IAC9E,aAAa;IACb,8EAA8E;IAE9E;;OAEG;IACK,aAAa,CAAC,QAAgC,EAAE,OAAoB;QAC1E,MAAM,IAAI,GAAa;YACrB,UAAU,QAAQ,CAAC,IAAI,EAAE;YACzB,UAAU,QAAQ,CAAC,IAAI,EAAE;YACzB,cAAc,QAAQ,CAAC,IAAI,EAAE;YAC7B,YAAY,QAAQ,CAAC,QAAQ,EAAE;YAC/B,gBAAgB;YAChB,eAAe,EAAE,oBAAoB;SACtC,CAAC;QAEF,UAAU;QACV,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC7B,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC3B,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnC,+BAA+B;gBAC/B,IAAI,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;oBAClC,IAAI,CAAC,IAAI,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC;gBAChC,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9D,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;gBAC1C,IAAI,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;oBAClC,IAAI,CAAC,IAAI,CAAC,mBAAmB,KAAK,EAAE,CAAC,CAAC;gBACxC,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC/D,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvB,CAAC;QAED,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;YAC3B,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;gBACzC,wCAAwC;gBACxC,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAClC,IAAI,OAAO,IAAI,qBAAqB,CAAC,uBAAuB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC1E,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACjB,CAAC;qBAAM,CAAC;oBACN,4BAA4B;oBAC5B,MAAM,CAAC,IAAI,CAAC,iDAAiD,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;gBAC1E,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,QAAgC;QACvD,OAAO;YACL,UAAU,QAAQ,CAAC,IAAI,EAAE;YACzB,UAAU,QAAQ,CAAC,IAAI,EAAE;YACzB,cAAc,QAAQ,CAAC,IAAI,EAAE;YAC7B,YAAY,QAAQ,CAAC,QAAQ,EAAE;YAC/B,eAAe,EAAE,oBAAoB;YACrC,SAAS;YACT,IAAI;YACJ,iBAAiB,EAAE,UAAU;SAC9B,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,GAAW,EAAE,OAAuB;QAC5D,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,aAAa;QACb,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;QAED,eAAe;QACf,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACxD,CAAC;QAED,SAAS;QACT,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEhB,cAAc;QACd,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACxD,CAAC;QAED,eAAe;QACf,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,MAAc;QACnC,wCAAwC;QACxC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACjD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACK,iBAAiB,CAAC,IAAY;QACpC,uCAAuC;QACvC,iBAAiB;QACjB,OAAO,uDAAuD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5E,CAAC;;AA/YH,sDAgZC;AAED,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF,kBAAe,qBAAqB,CAAC"}

package/dist/services/embedding-backfill.service.d.ts

@@ -0,0 +1,53 @@
+export interface BackfillResult {
+    sectionBackfilled: number;
+    motionBackfilled: number;
+    backgroundBackfilled: number;
+    jsAnimationBackfilled: number;
+    responsiveBackfilled: number;
+    totalBackfilled: number;
+    errors: string[];
+    memorySkips: number;
+}
+export interface EmbeddingCoverage {
+    type: string;
+    total: number;
+    embedded: number;
+    missing: number;
+}
+export interface WebPageWithMissingEmbeddings {
+    webPageId: string;
+    url: string;
+    missingCount: number;
+}
+export interface BackfillOptions {
+    chunkSize?: number;
+    /**
+     * RSS threshold in bytes. Special values:
+     * - 0: Disable memory check entirely
+     * - undefined: Auto-detect (system total × DEFAULT_MEMORY_RATIO)
+     * - positive number: Use as-is
+     */
+    rssThreshold?: number;
+    /** Memory ratio (0.0-1.0) for auto-detect threshold. Default: 0.70 */
+    memoryRatio?: number;
+    onProgress?: (type: string, done: number, total: number) => void;
+    onMemoryPressure?: (type: string, rssGB: number, thresholdGB: number, action: "dispose" | "skip") => void;
+}
+/**
+ * Check embedding coverage for a specific WebPage (no backfill)
+ */
+export declare function checkWebPageEmbeddingCoverage(webPageId: string): Promise<EmbeddingCoverage[]>;
+/**
+ * Find all WebPages that have patterns with missing embeddings
+ */
+export declare function findWebPagesWithMissingEmbeddings(): Promise<WebPageWithMissingEmbeddings[]>;
+/**
+ * Backfill missing embeddings for a specific WebPage.
+ *
+ * Dynamic memory management:
+ * - Pipeline stays alive between chunks (fast GPU inference)
+ * - When RSS exceeds threshold: dispose → GC → wait → retry
+ * - If recovery fails: skip remaining items (next invocation will retry)
+ */
+export declare function backfillWebPageEmbeddings(webPageId: string, options?: BackfillOptions): Promise<BackfillResult>;
+//# sourceMappingURL=embedding-backfill.service.d.ts.map

package/dist/services/embedding-backfill.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-backfill.service.d.ts","sourceRoot":"","sources":["../../src/services/embedding-backfill.service.ts"],"names":[],"mappings":"AAiEA,MAAM,WAAW,cAAc;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,gBAAgB,CAAC,EAAE,CACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,GAAG,MAAM,KACvB,IAAI,CAAC;CACX;AAsUD;;GAEG;AACH,wBAAsB,6BAA6B,CACjD,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA2D9B;AAED;;GAEG;AACH,wBAAsB,iCAAiC,IAAI,OAAO,CAAC,4BAA4B,EAAE,CAAC,CAsCjG;AAED;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,CAAC,CA2GzB"}