fi-pool-server 0.1.0

package/dist/tools/execute.d.ts

@@ -0,0 +1,109 @@
+/**
+ * 执行类工具（Execute）
+ *
+ * 封装流水线执行操作，返回执行确认信息。
+ * 执行进度可通过 getSystemStatus 查看。
+ *
+ * @module tools/execute
+ */
+/**
+ * 对单只股票运行本地分析（数据获取 + 技术指标计算 + 客观报告）。
+ *
+ * @param code - 股票代码
+ * @returns { success: true, data: { date: string } }
+ */
+export declare function runLocalAnalysis(code: string): Promise<{
+    success: true;
+    data: {
+        date: string;
+    };
+    error?: undefined;
+} | {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+    };
+    data?: undefined;
+}>;
+/**
+ * 对单只股票运行完整流水线。
+ *
+ * @param code - 股票代码
+ * @returns { success: true, data: { date: string } }
+ */
+export declare function runFullPipeline(code: string): Promise<{
+    success: true;
+    data: {
+        date: string;
+    };
+    error?: undefined;
+} | {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+    };
+    data?: undefined;
+}>;
+/**
+ * 对指定股池中所有股票运行本地分析。
+ *
+ * @param poolId - 股池 ID
+ * @returns { success: true, data: { total: number } }
+ */
+export declare function runPoolAnalysis(poolId: number): Promise<{
+    success: true;
+    data: {
+        total: number;
+    };
+    error?: undefined;
+} | {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+    };
+    data?: undefined;
+}>;
+/**
+ * 对指定股池中所有股票运行完整流水线。
+ *
+ * @param poolId - 股池 ID
+ * @returns { success: true, data: { total: number } }
+ */
+export declare function runPoolFullPipeline(poolId: number): Promise<{
+    success: true;
+    data: {
+        total: number;
+    };
+    error?: undefined;
+} | {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+    };
+    data?: undefined;
+}>;
+/**
+ * 触发获取最新日行情数据。
+ *
+ * @param code - 可选股票代码，不指定则更新所有关注股票
+ * @returns { success: true, data: { updated: number } }
+ */
+export declare function refreshData(code?: string): Promise<{
+    success: true;
+    data: {
+        updated: number;
+    };
+    error?: undefined;
+} | {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+    };
+    data?: undefined;
+}>;
+//# sourceMappingURL=execute.d.ts.map

package/dist/tools/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/tools/execute.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM;;;;;;;;;;;;;GAQlD;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM;;;;;;;;;;;;;GAQjD;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM;;;;;;;;;;;;;GAiBnD;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM;;;;;;;;;;;;;GAiBvD;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM;;;;;;;;;;;;;GAQ9C"}

package/dist/tools/execute.js

@@ -0,0 +1,112 @@
+/**
+ * 执行类工具（Execute）
+ *
+ * 封装流水线执行操作，返回执行确认信息。
+ * 执行进度可通过 getSystemStatus 查看。
+ *
+ * @module tools/execute
+ */
+import * as pipelineService from '../services/pipeline.js';
+import * as dailyInfoService from '../services/daily-info.js';
+import * as poolService from '../services/pool.js';
+/**
+ * 对单只股票运行本地分析（数据获取 + 技术指标计算 + 客观报告）。
+ *
+ * @param code - 股票代码
+ * @returns { success: true, data: { date: string } }
+ */
+export async function runLocalAnalysis(code) {
+    try {
+        const result = await pipelineService.runLocalAnalysis(code);
+        return { success: true, data: { date: result.date } };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { success: false, error: { code: 'LLM_ERROR', message } };
+    }
+}
+/**
+ * 对单只股票运行完整流水线。
+ *
+ * @param code - 股票代码
+ * @returns { success: true, data: { date: string } }
+ */
+export async function runFullPipeline(code) {
+    try {
+        const result = await pipelineService.runFullPipeline(code);
+        return { success: true, data: { date: result.date } };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { success: false, error: { code: 'LLM_ERROR', message } };
+    }
+}
+/**
+ * 对指定股池中所有股票运行本地分析。
+ *
+ * @param poolId - 股池 ID
+ * @returns { success: true, data: { total: number } }
+ */
+export async function runPoolAnalysis(poolId) {
+    try {
+        const stocks = await poolService.getPoolStocks(poolId);
+        let completed = 0;
+        for (const s of stocks) {
+            try {
+                await pipelineService.runLocalAnalysis(s.code);
+                completed++;
+            }
+            catch (err) {
+                console.warn(`[runPoolAnalysis] ${s.code} 失败:`, err.message);
+            }
+        }
+        return { success: true, data: { total: completed } };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { success: false, error: { code: 'DB_ERROR', message } };
+    }
+}
+/**
+ * 对指定股池中所有股票运行完整流水线。
+ *
+ * @param poolId - 股池 ID
+ * @returns { success: true, data: { total: number } }
+ */
+export async function runPoolFullPipeline(poolId) {
+    try {
+        const stocks = await poolService.getPoolStocks(poolId);
+        let completed = 0;
+        for (const s of stocks) {
+            try {
+                await pipelineService.runFullPipeline(s.code);
+                completed++;
+            }
+            catch (err) {
+                console.warn(`[runPoolFullPipeline] ${s.code} 失败:`, err.message);
+            }
+        }
+        return { success: true, data: { total: completed } };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { success: false, error: { code: 'DB_ERROR', message } };
+    }
+}
+/**
+ * 触发获取最新日行情数据。
+ *
+ * @param code - 可选股票代码，不指定则更新所有关注股票
+ * @returns { success: true, data: { updated: number } }
+ */
+export async function refreshData(code) {
+    try {
+        const result = await dailyInfoService.refreshData(code);
+        return { success: true, data: { updated: result.updated } };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { success: false, error: { code: 'RATE_LIMIT', message } };
+    }
+}
+//# sourceMappingURL=execute.js.map

package/dist/tools/execute.js.map

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

package/dist/tools/manager.d.ts

@@ -0,0 +1,150 @@
+/**
+ * 管理类工具（Manager）
+ *
+ * 封装股池 CRUD 操作，对外暴露标准 API 格式：
+ *   { success: true, data: T } | { success: false, error: { code: string, message: string } }
+ *
+ * 错误码约定：
+ * - INVALID_PARAM：参数校验失败（空名称、负 ID、信号值范围错误等）
+ * - DB_ERROR：数据库操作异常（唯一约束冲突、外键关联等）
+ *
+ * @module tools/manager
+ */
+/**
+ * 创建新的股票池。
+ *
+ * 创建后如果提供了 stockCodes，会立即将对应股票加入新股池。
+ *
+ * @param name - 股池名称（必填，不能为空字符串）
+ * @param desc - 可选描述
+ * @param stockCodes - 可选的初始股票代码列表
+ * @returns 成功包含 { id }，失败带错误码 INVALID_PARAM 或 DB_ERROR
+ *
+ * @example
+ * const r = await createPool('白马股池', '优质蓝筹', ['600519']);
+ * if (r.success) console.log('created id:', r.data.id);
+ */
+export declare function createPool(name: string, desc?: string, stockCodes?: string[]): Promise<{
+    success: true;
+    data: {
+        id: number;
+    };
+} | {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+    };
+}>;
+/**
+ * 删除指定股池及其关联的 pool_stock 记录。
+ *
+ * @param id - 股池 ID（必须是正整数）
+ * @returns 成功无 data，失败带错误码 INVALID_PARAM 或 DB_ERROR
+ *
+ * @example
+ * const r = await deletePool(1);
+ */
+export declare function deletePool(id: number): Promise<{
+    success: true;
+    data?: undefined;
+} | {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+    };
+}>;
+/**
+ * 修改股池名称或描述。
+ *
+ * 仅提供需要更新的字段即可，未提供的字段保持不变。
+ *
+ * @param id - 股池 ID（必须是正整数）
+ * @param name - 可选新名称（不能为空字符串）
+ * @param desc - 可选新描述
+ * @returns 成功无 data，失败带错误码 INVALID_PARAM 或 DB_ERROR
+ *
+ * @example
+ * const r = await updatePool(1, { name: '新名称', desc: '新描述' });
+ */
+export declare function updatePool(id: number, name?: string, desc?: string): Promise<{
+    success: true;
+    data?: undefined;
+} | {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+    };
+}>;
+/**
+ * 向指定股池批量添加股票代码。
+ *
+ * 已存在于该股池的股票会自动跳过，不会重复添加。
+ *
+ * @param poolId - 股池 ID（必须是正整数）
+ * @param stockCodes - 要添加的股票代码数组（不能为空）
+ * @returns 成功包含 { added, skipped }，失败带错误码
+ *
+ * @example
+ * const r = await addStocks(1, ['600519', '000001']);
+ * if (r.success) console.log(`添加 ${r.data.added}，跳过 ${r.data.skipped}`);
+ */
+export declare function addStocks(poolId: number, stockCodes: string[]): Promise<{
+    success: true;
+    data: {
+        added: number;
+        skipped: number;
+    };
+} | {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+    };
+}>;
+/**
+ * 从指定股池中移除一批股票代码。
+ *
+ * @param poolId - 股池 ID（必须是正整数）
+ * @param stockCodes - 要移除的股票代码数组（不能为空）
+ * @returns 成功包含 { removed }，失败带错误码
+ *
+ * @example
+ * const r = await removeStocks(1, ['600519']);
+ * if (r.success) console.log(`移除了 ${r.data.removed} 只`);
+ */
+export declare function removeStocks(poolId: number, stockCodes: string[]): Promise<{
+    success: true;
+    data: {
+        removed: number;
+    };
+} | {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+    };
+}>;
+/**
+ * 设置股池综合信号值。
+ *
+ * @param poolId - 股池 ID（必须是正整数）
+ * @param signal - 信号值：-1 看空, 0 中性, 1 看多
+ * @returns 成功无 data，失败带错误码
+ *
+ * @example
+ * const r = await setPoolSignal(1, 1); // 看多
+ */
+export declare function setPoolSignal(poolId: number, signal: number): Promise<{
+    success: true;
+    data?: undefined;
+} | {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+    };
+}>;
+//# sourceMappingURL=manager.d.ts.map

package/dist/tools/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/tools/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH;;;;;;;;;;;;;GAaG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CACN;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACvC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAC/D,CAqBA;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,EAAE,EAAE,MAAM,GACT,OAAO,CACN;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,GACnC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAC/D,CAWA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,CAC9B,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CACN;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,GACnC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAC/D,CA+BA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CACN;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC3D;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAC/D,CAeA;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CACN;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC5C;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAC/D,CAeA;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CACN;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,GACnC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAC/D,CAeA"}

package/dist/tools/manager.js

@@ -0,0 +1,200 @@
+/**
+ * 管理类工具（Manager）
+ *
+ * 封装股池 CRUD 操作，对外暴露标准 API 格式：
+ *   { success: true, data: T } | { success: false, error: { code: string, message: string } }
+ *
+ * 错误码约定：
+ * - INVALID_PARAM：参数校验失败（空名称、负 ID、信号值范围错误等）
+ * - DB_ERROR：数据库操作异常（唯一约束冲突、外键关联等）
+ *
+ * @module tools/manager
+ */
+import * as poolService from '../services/pool.js';
+import { getDatabase } from '../db/index.js';
+import { pool } from '../db/schema.js';
+import { eq } from 'drizzle-orm';
+/**
+ * 创建新的股票池。
+ *
+ * 创建后如果提供了 stockCodes，会立即将对应股票加入新股池。
+ *
+ * @param name - 股池名称（必填，不能为空字符串）
+ * @param desc - 可选描述
+ * @param stockCodes - 可选的初始股票代码列表
+ * @returns 成功包含 { id }，失败带错误码 INVALID_PARAM 或 DB_ERROR
+ *
+ * @example
+ * const r = await createPool('白马股池', '优质蓝筹', ['600519']);
+ * if (r.success) console.log('created id:', r.data.id);
+ */
+export async function createPool(name, desc, stockCodes) {
+    try {
+        if (!name || name.trim().length === 0) {
+            return { success: false, error: { code: 'INVALID_PARAM', message: '股池名称不能为空' } };
+        }
+        // 预检名称唯一性
+        const existing = getDatabase().select().from(pool).where(eq(pool.name, name.trim())).get();
+        if (existing) {
+            return { success: false, error: { code: 'INVALID_PARAM', message: `股池名称"${name}"已存在` } };
+        }
+        const result = await poolService.createPool(name.trim(), desc?.trim());
+        if (stockCodes && stockCodes.length > 0) {
+            await poolService.addStocks(result.id, stockCodes);
+        }
+        return { success: true, data: { id: result.id } };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { success: false, error: { code: 'DB_ERROR', message } };
+    }
+}
+/**
+ * 删除指定股池及其关联的 pool_stock 记录。
+ *
+ * @param id - 股池 ID（必须是正整数）
+ * @returns 成功无 data，失败带错误码 INVALID_PARAM 或 DB_ERROR
+ *
+ * @example
+ * const r = await deletePool(1);
+ */
+export async function deletePool(id) {
+    try {
+        if (!Number.isInteger(id) || id <= 0) {
+            return { success: false, error: { code: 'INVALID_PARAM', message: '股池 ID 必须是正整数' } };
+        }
+        await poolService.deletePool(id);
+        return { success: true };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { success: false, error: { code: 'DB_ERROR', message } };
+    }
+}
+/**
+ * 修改股池名称或描述。
+ *
+ * 仅提供需要更新的字段即可，未提供的字段保持不变。
+ *
+ * @param id - 股池 ID（必须是正整数）
+ * @param name - 可选新名称（不能为空字符串）
+ * @param desc - 可选新描述
+ * @returns 成功无 data，失败带错误码 INVALID_PARAM 或 DB_ERROR
+ *
+ * @example
+ * const r = await updatePool(1, { name: '新名称', desc: '新描述' });
+ */
+export async function updatePool(id, name, desc) {
+    try {
+        if (!Number.isInteger(id) || id <= 0) {
+            return { success: false, error: { code: 'INVALID_PARAM', message: '股池 ID 必须是正整数' } };
+        }
+        if (name !== undefined && name.trim().length === 0) {
+            return { success: false, error: { code: 'INVALID_PARAM', message: '股池名称不能为空' } };
+        }
+        // 预检名称唯一性（如需改名）
+        if (name !== undefined) {
+            const existing = getDatabase().select().from(pool).where(eq(pool.name, name.trim())).get();
+            if (existing && existing.id !== id) {
+                return { success: false, error: { code: 'INVALID_PARAM', message: `股池名称"${name}"已存在` } };
+            }
+        }
+        const updateData = {};
+        if (name !== undefined)
+            updateData.name = name.trim();
+        if (desc !== undefined)
+            updateData.desc = desc.trim();
+        if (Object.keys(updateData).length === 0) {
+            return { success: false, error: { code: 'INVALID_PARAM', message: '未提供任何需要更新的字段' } };
+        }
+        await poolService.updatePool(id, updateData);
+        return { success: true };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { success: false, error: { code: 'DB_ERROR', message } };
+    }
+}
+/**
+ * 向指定股池批量添加股票代码。
+ *
+ * 已存在于该股池的股票会自动跳过，不会重复添加。
+ *
+ * @param poolId - 股池 ID（必须是正整数）
+ * @param stockCodes - 要添加的股票代码数组（不能为空）
+ * @returns 成功包含 { added, skipped }，失败带错误码
+ *
+ * @example
+ * const r = await addStocks(1, ['600519', '000001']);
+ * if (r.success) console.log(`添加 ${r.data.added}，跳过 ${r.data.skipped}`);
+ */
+export async function addStocks(poolId, stockCodes) {
+    try {
+        if (!Number.isInteger(poolId) || poolId <= 0) {
+            return { success: false, error: { code: 'INVALID_PARAM', message: '股池 ID 必须是正整数' } };
+        }
+        if (!stockCodes || stockCodes.length === 0) {
+            return { success: false, error: { code: 'INVALID_PARAM', message: '股票代码列表不能为空' } };
+        }
+        const result = await poolService.addStocks(poolId, stockCodes);
+        return { success: true, data: result };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { success: false, error: { code: 'DB_ERROR', message } };
+    }
+}
+/**
+ * 从指定股池中移除一批股票代码。
+ *
+ * @param poolId - 股池 ID（必须是正整数）
+ * @param stockCodes - 要移除的股票代码数组（不能为空）
+ * @returns 成功包含 { removed }，失败带错误码
+ *
+ * @example
+ * const r = await removeStocks(1, ['600519']);
+ * if (r.success) console.log(`移除了 ${r.data.removed} 只`);
+ */
+export async function removeStocks(poolId, stockCodes) {
+    try {
+        if (!Number.isInteger(poolId) || poolId <= 0) {
+            return { success: false, error: { code: 'INVALID_PARAM', message: '股池 ID 必须是正整数' } };
+        }
+        if (!stockCodes || stockCodes.length === 0) {
+            return { success: false, error: { code: 'INVALID_PARAM', message: '股票代码列表不能为空' } };
+        }
+        const result = await poolService.removeStocks(poolId, stockCodes);
+        return { success: true, data: result };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { success: false, error: { code: 'DB_ERROR', message } };
+    }
+}
+/**
+ * 设置股池综合信号值。
+ *
+ * @param poolId - 股池 ID（必须是正整数）
+ * @param signal - 信号值：-1 看空, 0 中性, 1 看多
+ * @returns 成功无 data，失败带错误码
+ *
+ * @example
+ * const r = await setPoolSignal(1, 1); // 看多
+ */
+export async function setPoolSignal(poolId, signal) {
+    try {
+        if (!Number.isInteger(poolId) || poolId <= 0) {
+            return { success: false, error: { code: 'INVALID_PARAM', message: '股池 ID 必须是正整数' } };
+        }
+        if (![-1, 0, 1].includes(signal)) {
+            return { success: false, error: { code: 'INVALID_PARAM', message: '信号值必须为 -1（看空）、0（中性）或 1（看多）' } };
+        }
+        await poolService.setPoolSignal(poolId, signal);
+        return { success: true };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { success: false, error: { code: 'DB_ERROR', message } };
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/tools/manager.js.map

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