@visactor/vseed 0.4.2 → 0.4.4

package/dist/esm/pipeline/utils/sandbox/execute.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 增强的安全代码执行器
+ * @description 专为 AI 生成代码设计的安全沙箱
+ * @module enhancedSecureCodeExecutor
+ */
+import type { CodeExecutionOptions, CodeExecutionResult } from '../../../types/sandbox';
+/**
+ * 初始化 Worker 池
+ * @description 预热 Worker 实例，提升首次执行性能
+ *
+ * **⚠️ 注意：这是一个可选的性能优化方法**
+ *
+ * - **懒加载模式**：如果不调用此方法，Worker 池会在首次使用时自动初始化
+ * - **推荐场景**：应用启动时预热，避免首次筛选时的冷启动延迟
+ * - **配置选项**：
+ *   - `poolSize`: Worker 池大小（默认 2）
+ *
+ * @param options - 初始化选项
+ * @param options.poolSize - Worker 池大小，默认为 2
+ *
+ * @example
+ * ```typescript
+ * // ✅ 推荐：应用启动时预热（可选）
+ * import { initializeWorkerPool } from '@visactor/vseed'
+ *
+ * // 在 main.ts 或入口文件中
+ * await initializeWorkerPool({ poolSize: 2 })
+ *
+ * // ✅ 也可以：不做任何事，让 Worker 池自动初始化
+ * // 首次调用 dynamicFilter 时会自动创建
+ * ```
+ */
+export declare function initializeWorkerPool(options?: {
+    utilityLibUrl?: string;
+    utilityLibSource?: string;
+    poolSize?: number;
+}): Promise<void>;
+/**
+ * 销毁 Worker 池
+ * @description 终止所有 Worker 实例并清理全局状态
+ *
+ * **⚠️ 注意：大多数情况下不需要手动调用此方法**
+ *
+ * - **一般使用**：浏览器会在页面卸载时自动清理 Worker 资源
+ * - **建议场景**：
+ *   - 单元测试的清理阶段（`afterAll` 钩子）
+ *   - 开发环境热重载时清理旧实例
+ *   - 动态卸载整个图表库模块（极少见）
+ *
+ * @example
+ * ```typescript
+ * // ✅ 推荐：测试环境
+ * afterAll(() => {
+ *   terminateWorkerPool()
+ * })
+ *
+ * // ❌ 不推荐：组件卸载时（Worker 池是全局的，其他组件可能还在使用）
+ * onUnmounted(() => {
+ *   terminateWorkerPool() // 不要这样做！
+ * })
+ * ```
+ */
+export declare function terminateWorkerPool(): void;
+/**
+ * 增强的安全验证
+ * @description 针对 AI 生成代码的特定模式检查
+ */
+export declare function validateCodeSafety(code: string): void;
+/**
+ * 代码执行函数
+ * @description 使用 Worker 池和增强安全检查
+ */
+export declare function executeFilterCode(options: CodeExecutionOptions): Promise<CodeExecutionResult>;