@invect/core 0.0.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"service-factory.js","names":[],"sources":["../../src/services/service-factory.ts"],"sourcesContent":["// Framework-agnostic Service Factory for Invect core\nimport { FlowsService } from './flows/flows.service';\nimport { FlowRunsService } from './flow-runs/flow-runs.service';\nimport { NodeExecutionService } from './node-executions/node-execution.service';\nimport { FlowOrchestrationService } from './flow-orchestration.service';\nimport { DatabaseService } from './database/database.service';\nimport { NodeDataService } from './node-data.service';\nimport { GraphService } from './graph.service';\nimport { BatchJobsService } from './batch-jobs/batch-jobs.service';\nimport { BaseAIClient } from './ai/base-client';\nimport { CredentialsService } from './credentials/credentials.service';\nimport { EncryptionService } from './credentials/encryption.service';\nimport { AgentToolExecutionService } from './agent-tool-executions/agent-tool-execution.service';\nimport { FlowAccessService } from './auth/flow-access.service';\nimport { FlowTriggersService } from './triggers/flow-triggers.service';\nimport { CronSchedulerService } from './triggers/cron-scheduler.service';\nimport { ChatStreamService } from './chat/chat-stream.service';\nimport { ExecutionEventBus, getExecutionEventBus } from './execution-event-bus';\nimport { DatabaseError } from 'src/types/common/errors.types';\nimport { Logger, InvectConfig } from 'src/types/schemas';\nimport { NodeExecutorRegistry } from 'src/nodes/executor-registry';\nimport { FlowVersionsService } from './flow-versions/flow-versions.service';\nimport { ReactFlowRendererService } from './react-flow-renderer.service';\nimport type { PluginHookRunner } from 'src/types/plugin.types';\n\n/**\n * Core Services container\n */\nexport interface CoreServices {\n  flowsService: FlowsService;\n  flowVersionsService: FlowVersionsService;\n  flowRunsService: FlowRunsService;\n  nodeExecutionsService: NodeExecutionService;\n  orchestrationService: FlowOrchestrationService;\n  databaseService: DatabaseService;\n  nodeDataService: NodeDataService;\n  graphService: GraphService;\n  batchJobsService: BatchJobsService;\n  baseAIClient: BaseAIClient;\n  reactFlowRendererService: ReactFlowRendererService;\n  credentialsService: CredentialsService;\n  agentToolExecutionService: AgentToolExecutionService;\n  flowAccessService: FlowAccessService | null;\n  triggersService: FlowTriggersService;\n  cronScheduler: CronSchedulerService;\n  chatStreamService: ChatStreamService;\n  executionEventBus: ExecutionEventBus;\n}\n\n/**\n * Service Factory for creating and managing core services\n */\nexport class ServiceFactory {\n  private services: CoreServices | null = null;\n  private initialized = false;\n  logger: Logger;\n\n  constructor(\n    private readonly config: InvectConfig,\n    private readonly nodeRegistry: NodeExecutorRegistry,\n    /** The Invect core instance (for passing to ChatStreamService → tools) */\n    private readonly invectRef?: unknown,\n    /** Action registry for chat system prompt context */\n    private readonly actionRegistryRef?: unknown,\n    /** Plugin hook runner for lifecycle hooks */\n    private readonly pluginHookRunner?: PluginHookRunner,\n    /** JS expression service for data mapper (sandbox) */\n    private readonly jsExpressionServiceRef?: import('./templating/js-expression.service').JsExpressionService,\n    /** Template service for resolving {{ }} expressions in node params */\n    private readonly templateServiceRef?: import('./templating/template.service').TemplateService,\n  ) {\n    this.logger = config.logger; // Fallback to console if no logger provided\n    if (!this.nodeRegistry) {\n      throw new Error('Node registry is not provided, cannot initialize services without it');\n    } else {\n      this.logger.debug('Node registry provided, will register default executors');\n    }\n  }\n\n  /**\n   * Initialize all services\n   */\n  async initialize(): Promise<void> {\n    if (this.initialized) {\n      this.logger.debug('Service factory already initialized');\n      return;\n    }\n\n    this.logger.info('Initializing service factory');\n\n    try {\n      // 1. Create database service first (no dependencies)\n      // Schema verification is opt-in via config.schemaVerification.\n      // It only checks that required tables/columns exist — does NOT run migrations.\n      const schemaVerification = this.config.schemaVerification;\n      const verificationOpts = schemaVerification\n        ? {\n            strict: typeof schemaVerification === 'object' ? schemaVerification.strict : false,\n            plugins: (this.config.plugins || []) as import('src/types/plugin.types').InvectPlugin[],\n          }\n        : undefined;\n      const databaseService = new DatabaseService(\n        this.config.baseDatabaseConfig,\n        this.logger,\n        verificationOpts,\n        (this.config.plugins || []) as import('src/types/plugin.types').InvectPlugin[],\n      );\n      await databaseService.initialize();\n\n      // 3. Create BatchJobsService (database only, no AI client)\n      const batchJobsService = new BatchJobsService(this.logger, databaseService);\n\n      // 4. Create BaseAIClient (adapters are registered dynamically from credentials)\n      const baseAIClient = new BaseAIClient(this.logger, batchJobsService);\n\n      // 5. Create other services\n      const flowVersionsService = new FlowVersionsService(this.logger, databaseService);\n      const flowsService = new FlowsService(this.logger, databaseService);\n      const nodeExecutionsService = new NodeExecutionService(this.logger, databaseService);\n      const flowRunsService = new FlowRunsService(this.logger, databaseService, flowsService);\n      const nodeDataService = new NodeDataService(\n        this.config,\n        this.logger,\n        databaseService,\n        baseAIClient,\n        this.templateServiceRef,\n      );\n      const graphService = new GraphService(this.logger, nodeExecutionsService);\n      const reactFlowRendererService = new ReactFlowRendererService(\n        this.logger,\n        flowsService,\n        flowVersionsService,\n        flowRunsService,\n        nodeExecutionsService,\n      );\n\n      // 5b. Create credentials service with encryption\n      const encryptionService = new EncryptionService({\n        masterKey: process.env.ENCRYPTION_KEY || 'default-dev-key-change-in-production',\n      });\n      const credentialsService = new CredentialsService(\n        databaseService.adapter,\n        encryptionService,\n        this.logger,\n      );\n\n      // 5c. Create agent tool execution service\n      const agentToolExecutionService = new AgentToolExecutionService(this.logger, databaseService);\n\n      // 5d. Create flow access service if enabled\n      let flowAccessService: FlowAccessService | null = null;\n      if (this.config.auth?.useFlowAccessTable) {\n        flowAccessService = new FlowAccessService({\n          adapter: databaseService.adapter,\n          logger: this.logger,\n        });\n        this.logger.info('Flow access table enabled - using Invect-managed flow permissions');\n      }\n\n      // 5e. Create triggers service (needs orchestration, wired after orchestration is created)\n      // Placeholder — we wire the real orchestrationService reference below.\n\n      // 6. Create orchestration service with proper dependencies\n      const orchestrationService = new FlowOrchestrationService(\n        this.logger,\n        flowRunsService,\n        nodeExecutionsService,\n        flowsService,\n        nodeDataService,\n        graphService,\n        this.nodeRegistry,\n        batchJobsService,\n        credentialsService, // Add credentials service\n        baseAIClient, // Add baseAIClient for agent prompt support\n        agentToolExecutionService, // Add agent tool execution service\n        // Execution config: heartbeat, flow timeout, stale-run detection\n        {\n          heartbeatIntervalMs: this.config.execution?.heartbeatIntervalMs ?? 30_000,\n          flowTimeoutMs: this.config.execution?.flowTimeoutMs ?? 600_000,\n          staleRunCheckIntervalMs: this.config.execution?.staleRunCheckIntervalMs ?? 60_000,\n        },\n        this.pluginHookRunner, // Plugin hooks for flow/node execution lifecycle\n        this.jsExpressionServiceRef, // JS expression engine for data mapper\n        this.templateServiceRef, // Template service for {{ }} expression resolution\n      );\n\n      // 6b. Create triggers service (depends on orchestration)\n      const triggersService = new FlowTriggersService(\n        this.logger,\n        databaseService,\n        flowsService,\n        flowVersionsService,\n        orchestrationService,\n      );\n\n      // 6c. Create cron scheduler (depends on triggers service)\n      const cronScheduler = new CronSchedulerService(this.logger, triggersService);\n\n      // 6d. Create chat stream service\n      const chatStreamService = new ChatStreamService(\n        this.logger,\n        this.config,\n        credentialsService,\n        flowsService,\n        flowVersionsService,\n        (this.actionRegistryRef as import('src/actions').ActionRegistry) ?? null,\n        this.invectRef,\n      );\n\n      // 6e. Wire execution event bus to services that write state\n      const executionEventBus = getExecutionEventBus();\n      flowRunsService.setEventBus(executionEventBus);\n      nodeExecutionsService.setEventBus(executionEventBus);\n\n      // Initialize services\n      await Promise.all([\n        batchJobsService.initialize(),\n        flowsService.initialize(),\n        flowRunsService.initialize(),\n        nodeExecutionsService.initialize(),\n        orchestrationService.initialize(),\n        nodeDataService.initialize(),\n        reactFlowRendererService.initialize(),\n        agentToolExecutionService.initialize(),\n        triggersService.initialize(),\n      ]);\n\n      // Store services\n      this.services = {\n        flowsService,\n        flowVersionsService,\n        flowRunsService,\n        nodeExecutionsService,\n        orchestrationService,\n        databaseService,\n        nodeDataService,\n        graphService,\n        batchJobsService,\n        baseAIClient,\n        reactFlowRendererService,\n        credentialsService,\n        agentToolExecutionService,\n        flowAccessService,\n        triggersService,\n        cronScheduler,\n        chatStreamService,\n        executionEventBus,\n      };\n\n      this.initialized = true;\n      this.logger.info('Service factory initialized successfully');\n    } catch (error) {\n      this.logger.error('Failed to initialize service factory', error);\n      throw new DatabaseError('Failed to initialize service factory', { error });\n    }\n  }\n\n  /**\n   * Get all services\n   */\n  getServices(): CoreServices {\n    if (!this.services) {\n      throw new Error('Service factory not initialized');\n    }\n    return this.services;\n  }\n\n  /**\n   * Get flow service\n   */\n  getFlowService(): FlowsService {\n    return this.getServices().flowsService;\n  }\n\n  /**\n   * Get execution service\n   */\n  getFlowRunsService(): FlowRunsService {\n    return this.getServices().flowRunsService;\n  }\n\n  /**\n   * Get execution trace service\n   */\n  getNodeExecutionsService(): NodeExecutionService {\n    return this.getServices().nodeExecutionsService;\n  }\n\n  /**\n   * Get orchestration service\n   */\n  getOrchestrationService(): FlowOrchestrationService {\n    return this.getServices().orchestrationService;\n  }\n\n  getFlowVersionsService() {\n    return this.getServices().flowVersionsService;\n  }\n\n  /**\n   * Get database service\n   */\n  getDatabaseService(): DatabaseService {\n    return this.getServices().databaseService;\n  }\n\n  /**\n   * Get node data service\n   */\n  getNodeDataService(): NodeDataService {\n    return this.getServices().nodeDataService;\n  }\n\n  /**\n   * Get graph service\n   */\n  getGraphService(): GraphService {\n    return this.getServices().graphService;\n  }\n\n  /**\n   * Get base AI client\n   */\n  getBaseAIClient(): BaseAIClient {\n    return this.getServices().baseAIClient;\n  }\n\n  /**\n   * Get React Flow renderer service\n   */\n  getReactFlowRendererService(): ReactFlowRendererService {\n    return this.getServices().reactFlowRendererService;\n  }\n\n  /**\n   * Get credentials service\n   */\n  getCredentialsService(): CredentialsService {\n    return this.getServices().credentialsService;\n  }\n\n  /**\n   * Get agent tool execution service\n   */\n  getAgentToolExecutionService(): AgentToolExecutionService {\n    return this.getServices().agentToolExecutionService;\n  }\n\n  /**\n   * Get flow access service (for Invect-managed flow permissions).\n   * Returns null if useFlowAccessTable is not enabled.\n   */\n  getFlowAccessService(): FlowAccessService | null {\n    return this.getServices().flowAccessService;\n  }\n\n  /**\n   * Get triggers service\n   */\n  getTriggersService(): FlowTriggersService {\n    return this.getServices().triggersService;\n  }\n\n  /**\n   * Get cron scheduler service\n   */\n  getCronScheduler(): CronSchedulerService {\n    return this.getServices().cronScheduler;\n  }\n\n  /**\n   * Get chat stream service\n   */\n  getChatStreamService(): ChatStreamService {\n    return this.getServices().chatStreamService;\n  }\n\n  /**\n   * Get execution event bus for SSE streaming\n   */\n  getExecutionEventBus(): ExecutionEventBus {\n    return this.getServices().executionEventBus;\n  }\n\n  /**\n   * Health check for all services\n   */\n  async healthCheck(): Promise<{\n    healthy: boolean;\n    services: Record<string, boolean>;\n    timestamp: string;\n  }> {\n    const serviceResults: Record<string, boolean> = {};\n    let allHealthy = true;\n\n    if (!this.services) {\n      return {\n        healthy: false,\n        services: { factory: false },\n        timestamp: new Date().toISOString(),\n      };\n    }\n\n    try {\n      // Test database connectivity\n      await this.services.databaseService.healthCheck();\n      serviceResults.database = true;\n    } catch (error) {\n      this.logger.error('Database health check failed', error);\n      serviceResults.database = false;\n      allHealthy = false;\n    }\n\n    // For other services, we'll just check if they're initialized\n    serviceResults.nodeData = !!this.services.nodeDataService;\n    serviceResults.flow = !!this.services.flowsService;\n    serviceResults.execution = !!this.services.flowRunsService;\n    serviceResults.executionTrace = !!this.services.nodeExecutionsService;\n    serviceResults.orchestration = !!this.services.orchestrationService;\n    serviceResults.graph = !!this.services.graphService;\n\n    return {\n      healthy: allHealthy,\n      services: serviceResults,\n      timestamp: new Date().toISOString(),\n    };\n  }\n\n  /**\n   * Close all services and cleanup\n   */\n  async close(): Promise<void> {\n    if (!this.services) {\n      this.logger.debug('Service factory not initialized, nothing to close');\n      return;\n    }\n\n    this.logger.info('Closing service factory');\n\n    try {\n      await Promise.all([\n        this.services.flowsService.close(),\n        this.services.flowRunsService.close(),\n        this.services.nodeExecutionsService.close(),\n        this.services.orchestrationService.close(),\n        this.services.databaseService.close(),\n        this.services.nodeDataService.close(),\n        // Note: GraphService doesn't have a close method as it's stateless\n      ]);\n\n      this.services = null;\n      this.initialized = false;\n      this.logger.info('Service factory closed successfully');\n    } catch (error) {\n      this.logger.error('Error closing service factory', error);\n      throw new DatabaseError('Error closing service factory', { error });\n    }\n  }\n\n  /**\n   * Check if the factory is initialized\n   */\n  isInitialized(): boolean {\n    return this.initialized;\n  }\n}\n"],"mappings":"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"}

package/dist/services/templating/index.cjs

@@ -0,0 +1,2 @@
+require("./template.service.cjs");
+require("./js-expression.service.cjs");

package/dist/services/templating/index.d.ts

@@ -0,0 +1,2 @@
+import { JsExpressionError, JsExpressionService, JsExpressionServiceConfig, createJsExpressionService, disposeJsExpressionService, getJsExpressionService } from "./js-expression.service.js";
+import { TemplateRenderResult, TemplateService, TemplateValidationResult, createTemplateService, getTemplateService } from "./template.service.js";

package/dist/services/templating/index.js

@@ -0,0 +1,3 @@
+import "./template.service.js";
+import "./js-expression.service.js";
+export {};

package/dist/services/templating/js-expression.service.cjs

@@ -0,0 +1,148 @@
+require("../../_virtual/_rolldown/runtime.cjs");
+let quickjs_emscripten = require("quickjs-emscripten");
+//#region src/services/templating/js-expression.service.ts
+/**
+* JS Expression Service
+*
+* Provides sandboxed JavaScript evaluation for data mapper expressions.
+* Uses QuickJS (via quickjs-emscripten) for safe, isolated execution.
+*
+* User code is wrapped in a function body — use `return` to produce a value.
+* For single-expression one-liners (no `return` keyword), `return` is auto-prepended.
+*
+* Context keys from upstream nodes are injected as local variables.
+* `$input` is always available as the full context object (escape hatch for name collisions).
+*/
+const DEFAULT_MEMORY_LIMIT = 16 * 1024 * 1024;
+const DEFAULT_MAX_STACK_SIZE = 1024 * 1024;
+var JsExpressionService = class {
+	module = null;
+	runtime = null;
+	logger;
+	config;
+	constructor(config = {}, logger) {
+		this.logger = logger;
+		this.config = {
+			memoryLimitBytes: config.memoryLimitBytes ?? DEFAULT_MEMORY_LIMIT,
+			maxStackSizeBytes: config.maxStackSizeBytes ?? DEFAULT_MAX_STACK_SIZE
+		};
+	}
+	/**
+	* Initialize the QuickJS WASM module and runtime.
+	* Must be called before evaluate(). Safe to call multiple times.
+	*/
+	async initialize() {
+		if (this.runtime) return;
+		this.module = await (0, quickjs_emscripten.newQuickJSWASMModule)();
+		this.runtime = this.module.newRuntime();
+		this.runtime.setMemoryLimit(this.config.memoryLimitBytes);
+		this.runtime.setMaxStackSize(this.config.maxStackSizeBytes);
+		this.logger?.debug("JsExpressionService initialized", {
+			memoryLimit: this.config.memoryLimitBytes,
+			maxStackSize: this.config.maxStackSizeBytes
+		});
+	}
+	/**
+	* Evaluate JS code against a context object.
+	*
+	* User code is wrapped in a function body. Use `return` to produce a value.
+	* For one-liners without `return`, the service auto-prepends it.
+	*
+	* Context keys are available as local variables. `$input` is the full context.
+	*
+	* @example
+	* // Auto-return (one-liner):
+	* evaluate("users.filter(u => u.active)", { users: [...] })
+	*
+	* // Explicit return (multi-statement):
+	* evaluate(`
+	*   const active = users.filter(u => u.active);
+	*   return active.map(u => ({ ...u, rank: 1 }));
+	* `, { users: [...] })
+	*/
+	evaluate(expression, context) {
+		if (!this.runtime) throw new Error("JsExpressionService not initialized. Call initialize() first.");
+		const vm = this.runtime.newContext();
+		try {
+			const contextJson = JSON.stringify(context);
+			const contextKeys = Object.keys(context);
+			const userBody = needsAutoReturn(expression) ? `return (${expression})` : expression;
+			const destructure = contextKeys.length > 0 ? `const {${contextKeys.join(",")}} = $input;` : "";
+			const wrapped = `(function(){const $input = JSON.parse(${JSON.stringify(contextJson)});${destructure}${userBody}})()`;
+			const result = vm.evalCode(wrapped);
+			if (result.error) {
+				const errorObj = vm.dump(result.error);
+				result.error.dispose();
+				throw new JsExpressionError(typeof errorObj === "object" && errorObj !== null && "message" in errorObj ? errorObj.message : String(errorObj), expression);
+			}
+			const value = vm.dump(result.value);
+			result.value.dispose();
+			return value;
+		} finally {
+			vm.dispose();
+		}
+	}
+	/**
+	* Dispose the QuickJS runtime. Call on Invect shutdown.
+	*/
+	dispose() {
+		if (this.runtime) {
+			this.runtime.dispose();
+			this.runtime = null;
+		}
+		this.module = null;
+		this.logger?.debug("JsExpressionService disposed");
+	}
+};
+/**
+* Determine if user code needs auto-return wrapping.
+*
+* Auto-return is applied when the code does NOT contain a `return` keyword
+* (as a word boundary match, to avoid false positives in strings like "returns").
+*
+* This means one-liners like `users.filter(u => u.active)` work without typing `return`,
+* while multi-statement code requires explicit `return`.
+*/
+function needsAutoReturn(code) {
+	const stripped = code.replace(/\/\/.*$/gm, "").replace(/\/\*[\s\S]*?\*\//g, "").replace(/'(?:[^'\\]|\\.)*'/g, "").replace(/"(?:[^"\\]|\\.)*"/g, "").replace(/`(?:[^`\\]|\\.)*`/g, "");
+	return !/\breturn\b/.test(stripped);
+}
+/**
+* Custom error class for mapper expression errors.
+* Includes the original expression for debugging.
+*/
+var JsExpressionError = class extends Error {
+	constructor(message, expression) {
+		super(`Mapper expression error: ${message}`);
+		this.expression = expression;
+		this.name = "JsExpressionError";
+	}
+};
+let defaultInstance = null;
+async function getJsExpressionService(logger) {
+	if (!defaultInstance) {
+		defaultInstance = new JsExpressionService({}, logger);
+		await defaultInstance.initialize();
+	}
+	return defaultInstance;
+}
+function createJsExpressionService(config, logger) {
+	return new JsExpressionService(config, logger);
+}
+/**
+* Dispose the global singleton (call during shutdown).
+*/
+function disposeJsExpressionService() {
+	if (defaultInstance) {
+		defaultInstance.dispose();
+		defaultInstance = null;
+	}
+}
+//#endregion
+exports.JsExpressionError = JsExpressionError;
+exports.JsExpressionService = JsExpressionService;
+exports.createJsExpressionService = createJsExpressionService;
+exports.disposeJsExpressionService = disposeJsExpressionService;
+exports.getJsExpressionService = getJsExpressionService;
+
+//# sourceMappingURL=js-expression.service.cjs.map

package/dist/services/templating/js-expression.service.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-expression.service.cjs","names":[],"sources":["../../../src/services/templating/js-expression.service.ts"],"sourcesContent":["/**\n * JS Expression Service\n *\n * Provides sandboxed JavaScript evaluation for data mapper expressions.\n * Uses QuickJS (via quickjs-emscripten) for safe, isolated execution.\n *\n * User code is wrapped in a function body — use `return` to produce a value.\n * For single-expression one-liners (no `return` keyword), `return` is auto-prepended.\n *\n * Context keys from upstream nodes are injected as local variables.\n * `$input` is always available as the full context object (escape hatch for name collisions).\n */\nimport { newQuickJSWASMModule } from 'quickjs-emscripten';\nimport type { QuickJSWASMModule, QuickJSRuntime } from 'quickjs-emscripten';\nimport type { Logger } from 'src/types/schemas';\n\nexport interface JsExpressionServiceConfig {\n  /** Memory limit for the QuickJS runtime in bytes. Default: 16MB */\n  memoryLimitBytes?: number;\n  /** Max stack size in bytes. Default: 1MB */\n  maxStackSizeBytes?: number;\n}\n\nconst DEFAULT_MEMORY_LIMIT = 16 * 1024 * 1024; // 16 MB\nconst DEFAULT_MAX_STACK_SIZE = 1024 * 1024; // 1 MB\n\nexport class JsExpressionService {\n  private module: QuickJSWASMModule | null = null;\n  private runtime: QuickJSRuntime | null = null;\n  private logger?: Logger;\n  private config: Required<JsExpressionServiceConfig>;\n\n  constructor(config: JsExpressionServiceConfig = {}, logger?: Logger) {\n    this.logger = logger;\n    this.config = {\n      memoryLimitBytes: config.memoryLimitBytes ?? DEFAULT_MEMORY_LIMIT,\n      maxStackSizeBytes: config.maxStackSizeBytes ?? DEFAULT_MAX_STACK_SIZE,\n    };\n  }\n\n  /**\n   * Initialize the QuickJS WASM module and runtime.\n   * Must be called before evaluate(). Safe to call multiple times.\n   */\n  async initialize(): Promise<void> {\n    if (this.runtime) {\n      return;\n    }\n\n    this.module = await newQuickJSWASMModule();\n    this.runtime = this.module.newRuntime();\n    this.runtime.setMemoryLimit(this.config.memoryLimitBytes);\n    this.runtime.setMaxStackSize(this.config.maxStackSizeBytes);\n\n    this.logger?.debug('JsExpressionService initialized', {\n      memoryLimit: this.config.memoryLimitBytes,\n      maxStackSize: this.config.maxStackSizeBytes,\n    });\n  }\n\n  /**\n   * Evaluate JS code against a context object.\n   *\n   * User code is wrapped in a function body. Use `return` to produce a value.\n   * For one-liners without `return`, the service auto-prepends it.\n   *\n   * Context keys are available as local variables. `$input` is the full context.\n   *\n   * @example\n   * // Auto-return (one-liner):\n   * evaluate(\"users.filter(u => u.active)\", { users: [...] })\n   *\n   * // Explicit return (multi-statement):\n   * evaluate(`\n   *   const active = users.filter(u => u.active);\n   *   return active.map(u => ({ ...u, rank: 1 }));\n   * `, { users: [...] })\n   */\n  evaluate(expression: string, context: Record<string, unknown>): unknown {\n    if (!this.runtime) {\n      throw new Error('JsExpressionService not initialized. Call initialize() first.');\n    }\n\n    const vm = this.runtime.newContext();\n    try {\n      // Inject context as a JSON-serialized global, then destructure into locals.\n      // This avoids per-key handle creation and is faster for large contexts.\n      const contextJson = JSON.stringify(context);\n      const contextKeys = Object.keys(context);\n\n      // Build the wrapped code:\n      // 1. Parse the serialized context into $input\n      // 2. Destructure context keys into local variables\n      // 3. Execute user code in a function body (with auto-return for one-liners)\n      const userBody = needsAutoReturn(expression) ? `return (${expression})` : expression;\n      const destructure =\n        contextKeys.length > 0 ? `const {${contextKeys.join(',')}} = $input;` : '';\n      const wrapped = `(function(){const $input = JSON.parse(${JSON.stringify(contextJson)});${destructure}${userBody}})()`;\n\n      const result = vm.evalCode(wrapped);\n      if (result.error) {\n        const errorObj = vm.dump(result.error);\n        result.error.dispose();\n        const message =\n          typeof errorObj === 'object' && errorObj !== null && 'message' in errorObj\n            ? (errorObj as { message: string }).message\n            : String(errorObj);\n        throw new JsExpressionError(message, expression);\n      }\n\n      const value = vm.dump(result.value);\n      result.value.dispose();\n      return value;\n    } finally {\n      vm.dispose();\n    }\n  }\n\n  /**\n   * Dispose the QuickJS runtime. Call on Invect shutdown.\n   */\n  dispose(): void {\n    if (this.runtime) {\n      this.runtime.dispose();\n      this.runtime = null;\n    }\n    this.module = null;\n    this.logger?.debug('JsExpressionService disposed');\n  }\n}\n\n/**\n * Determine if user code needs auto-return wrapping.\n *\n * Auto-return is applied when the code does NOT contain a `return` keyword\n * (as a word boundary match, to avoid false positives in strings like \"returns\").\n *\n * This means one-liners like `users.filter(u => u.active)` work without typing `return`,\n * while multi-statement code requires explicit `return`.\n */\nfunction needsAutoReturn(code: string): boolean {\n  // Strip string literals and comments to avoid false positives,\n  // then check for `return` as a keyword boundary\n  const stripped = code\n    .replace(/\\/\\/.*$/gm, '') // line comments\n    .replace(/\\/\\*[\\s\\S]*?\\*\\//g, '') // block comments\n    .replace(/'(?:[^'\\\\]|\\\\.)*'/g, '') // single-quoted strings\n    .replace(/\"(?:[^\"\\\\]|\\\\.)*\"/g, '') // double-quoted strings\n    .replace(/`(?:[^`\\\\]|\\\\.)*`/g, ''); // template literals\n\n  return !/\\breturn\\b/.test(stripped);\n}\n\n/**\n * Custom error class for mapper expression errors.\n * Includes the original expression for debugging.\n */\nexport class JsExpressionError extends Error {\n  constructor(\n    message: string,\n    public readonly expression: string,\n  ) {\n    super(`Mapper expression error: ${message}`);\n    this.name = 'JsExpressionError';\n  }\n}\n\n// ── Singleton helpers ──────────────────────────────────────────────────────────\n\nlet defaultInstance: JsExpressionService | null = null;\n\nexport async function getJsExpressionService(logger?: Logger): Promise<JsExpressionService> {\n  if (!defaultInstance) {\n    defaultInstance = new JsExpressionService({}, logger);\n    await defaultInstance.initialize();\n  }\n  return defaultInstance;\n}\n\nexport function createJsExpressionService(\n  config?: JsExpressionServiceConfig,\n  logger?: Logger,\n): JsExpressionService {\n  return new JsExpressionService(config, logger);\n}\n\n/**\n * Dispose the global singleton (call during shutdown).\n */\nexport function disposeJsExpressionService(): void {\n  if (defaultInstance) {\n    defaultInstance.dispose();\n    defaultInstance = null;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAuBA,MAAM,uBAAuB,KAAK,OAAO;AACzC,MAAM,yBAAyB,OAAO;AAEtC,IAAa,sBAAb,MAAiC;CAC/B,SAA2C;CAC3C,UAAyC;CACzC;CACA;CAEA,YAAY,SAAoC,EAAE,EAAE,QAAiB;AACnE,OAAK,SAAS;AACd,OAAK,SAAS;GACZ,kBAAkB,OAAO,oBAAoB;GAC7C,mBAAmB,OAAO,qBAAqB;GAChD;;;;;;CAOH,MAAM,aAA4B;AAChC,MAAI,KAAK,QACP;AAGF,OAAK,SAAS,OAAA,GAAA,mBAAA,uBAA4B;AAC1C,OAAK,UAAU,KAAK,OAAO,YAAY;AACvC,OAAK,QAAQ,eAAe,KAAK,OAAO,iBAAiB;AACzD,OAAK,QAAQ,gBAAgB,KAAK,OAAO,kBAAkB;AAE3D,OAAK,QAAQ,MAAM,mCAAmC;GACpD,aAAa,KAAK,OAAO;GACzB,cAAc,KAAK,OAAO;GAC3B,CAAC;;;;;;;;;;;;;;;;;;;;CAqBJ,SAAS,YAAoB,SAA2C;AACtE,MAAI,CAAC,KAAK,QACR,OAAM,IAAI,MAAM,gEAAgE;EAGlF,MAAM,KAAK,KAAK,QAAQ,YAAY;AACpC,MAAI;GAGF,MAAM,cAAc,KAAK,UAAU,QAAQ;GAC3C,MAAM,cAAc,OAAO,KAAK,QAAQ;GAMxC,MAAM,WAAW,gBAAgB,WAAW,GAAG,WAAW,WAAW,KAAK;GAC1E,MAAM,cACJ,YAAY,SAAS,IAAI,UAAU,YAAY,KAAK,IAAI,CAAC,eAAe;GAC1E,MAAM,UAAU,yCAAyC,KAAK,UAAU,YAAY,CAAC,IAAI,cAAc,SAAS;GAEhH,MAAM,SAAS,GAAG,SAAS,QAAQ;AACnC,OAAI,OAAO,OAAO;IAChB,MAAM,WAAW,GAAG,KAAK,OAAO,MAAM;AACtC,WAAO,MAAM,SAAS;AAKtB,UAAM,IAAI,kBAHR,OAAO,aAAa,YAAY,aAAa,QAAQ,aAAa,WAC7D,SAAiC,UAClC,OAAO,SAAS,EACe,WAAW;;GAGlD,MAAM,QAAQ,GAAG,KAAK,OAAO,MAAM;AACnC,UAAO,MAAM,SAAS;AACtB,UAAO;YACC;AACR,MAAG,SAAS;;;;;;CAOhB,UAAgB;AACd,MAAI,KAAK,SAAS;AAChB,QAAK,QAAQ,SAAS;AACtB,QAAK,UAAU;;AAEjB,OAAK,SAAS;AACd,OAAK,QAAQ,MAAM,+BAA+B;;;;;;;;;;;;AAatD,SAAS,gBAAgB,MAAuB;CAG9C,MAAM,WAAW,KACd,QAAQ,aAAa,GAAG,CACxB,QAAQ,qBAAqB,GAAG,CAChC,QAAQ,sBAAsB,GAAG,CACjC,QAAQ,sBAAsB,GAAG,CACjC,QAAQ,sBAAsB,GAAG;AAEpC,QAAO,CAAC,aAAa,KAAK,SAAS;;;;;;AAOrC,IAAa,oBAAb,cAAuC,MAAM;CAC3C,YACE,SACA,YACA;AACA,QAAM,4BAA4B,UAAU;AAF5B,OAAA,aAAA;AAGhB,OAAK,OAAO;;;AAMhB,IAAI,kBAA8C;AAElD,eAAsB,uBAAuB,QAA+C;AAC1F,KAAI,CAAC,iBAAiB;AACpB,oBAAkB,IAAI,oBAAoB,EAAE,EAAE,OAAO;AACrD,QAAM,gBAAgB,YAAY;;AAEpC,QAAO;;AAGT,SAAgB,0BACd,QACA,QACqB;AACrB,QAAO,IAAI,oBAAoB,QAAQ,OAAO;;;;;AAMhD,SAAgB,6BAAmC;AACjD,KAAI,iBAAiB;AACnB,kBAAgB,SAAS;AACzB,oBAAkB"}

package/dist/services/templating/js-expression.service.d.cts

@@ -0,0 +1,61 @@
+import { Logger } from "../../types/schemas-fresh/invect-config.cjs";
+
+//#region src/services/templating/js-expression.service.d.ts
+interface JsExpressionServiceConfig {
+  /** Memory limit for the QuickJS runtime in bytes. Default: 16MB */
+  memoryLimitBytes?: number;
+  /** Max stack size in bytes. Default: 1MB */
+  maxStackSizeBytes?: number;
+}
+declare class JsExpressionService {
+  private module;
+  private runtime;
+  private logger?;
+  private config;
+  constructor(config?: JsExpressionServiceConfig, logger?: Logger);
+  /**
+   * Initialize the QuickJS WASM module and runtime.
+   * Must be called before evaluate(). Safe to call multiple times.
+   */
+  initialize(): Promise<void>;
+  /**
+   * Evaluate JS code against a context object.
+   *
+   * User code is wrapped in a function body. Use `return` to produce a value.
+   * For one-liners without `return`, the service auto-prepends it.
+   *
+   * Context keys are available as local variables. `$input` is the full context.
+   *
+   * @example
+   * // Auto-return (one-liner):
+   * evaluate("users.filter(u => u.active)", { users: [...] })
+   *
+   * // Explicit return (multi-statement):
+   * evaluate(`
+   *   const active = users.filter(u => u.active);
+   *   return active.map(u => ({ ...u, rank: 1 }));
+   * `, { users: [...] })
+   */
+  evaluate(expression: string, context: Record<string, unknown>): unknown;
+  /**
+   * Dispose the QuickJS runtime. Call on Invect shutdown.
+   */
+  dispose(): void;
+}
+/**
+ * Custom error class for mapper expression errors.
+ * Includes the original expression for debugging.
+ */
+declare class JsExpressionError extends Error {
+  readonly expression: string;
+  constructor(message: string, expression: string);
+}
+declare function getJsExpressionService(logger?: Logger): Promise<JsExpressionService>;
+declare function createJsExpressionService(config?: JsExpressionServiceConfig, logger?: Logger): JsExpressionService;
+/**
+ * Dispose the global singleton (call during shutdown).
+ */
+declare function disposeJsExpressionService(): void;
+//#endregion
+export { JsExpressionError, JsExpressionService, JsExpressionServiceConfig, createJsExpressionService, disposeJsExpressionService, getJsExpressionService };
+//# sourceMappingURL=js-expression.service.d.cts.map

package/dist/services/templating/js-expression.service.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-expression.service.d.cts","names":[],"sources":["../../../src/services/templating/js-expression.service.ts"],"mappings":";;;UAgBiB,yBAAA;;EAEf,gBAAA;EAFwC;EAIxC,iBAAA;AAAA;AAAA,cAMW,mBAAA;EAAA,QACH,MAAA;EAAA,QACA,OAAA;EAAA,QACA,MAAA;EAAA,QACA,MAAA;cAEI,MAAA,GAAQ,yBAAA,EAAgC,MAAA,GAAS,MAAA;EAYzC;;;;EAAd,UAAA,CAAA,GAAc,OAAA;EAhBZ;;;;;;;;;;;;;;;;;AAiIV;EA/EE,QAAA,CAAS,UAAA,UAAoB,OAAA,EAAS,MAAA;;;;EA2CtC,OAAA,CAAA;AAAA;;;;;cAoCW,iBAAA,SAA0B,KAAA;EAAA,SAGnB,UAAA;cADhB,OAAA,UACgB,UAAA;AAAA;AAAA,iBAWE,sBAAA,CAAuB,MAAA,GAAS,MAAA,GAAS,OAAA,CAAQ,mBAAA;AAAA,iBAQvD,yBAAA,CACd,MAAA,GAAS,yBAAA,EACT,MAAA,GAAS,MAAA,GACR,mBAAA;;;;iBAOa,0BAAA,CAAA"}

package/dist/services/templating/js-expression.service.d.ts

@@ -0,0 +1,60 @@
+import { Logger } from "../../types/schemas-fresh/invect-config.js";
+//#region src/services/templating/js-expression.service.d.ts
+interface JsExpressionServiceConfig {
+  /** Memory limit for the QuickJS runtime in bytes. Default: 16MB */
+  memoryLimitBytes?: number;
+  /** Max stack size in bytes. Default: 1MB */
+  maxStackSizeBytes?: number;
+}
+declare class JsExpressionService {
+  private module;
+  private runtime;
+  private logger?;
+  private config;
+  constructor(config?: JsExpressionServiceConfig, logger?: Logger);
+  /**
+   * Initialize the QuickJS WASM module and runtime.
+   * Must be called before evaluate(). Safe to call multiple times.
+   */
+  initialize(): Promise<void>;
+  /**
+   * Evaluate JS code against a context object.
+   *
+   * User code is wrapped in a function body. Use `return` to produce a value.
+   * For one-liners without `return`, the service auto-prepends it.
+   *
+   * Context keys are available as local variables. `$input` is the full context.
+   *
+   * @example
+   * // Auto-return (one-liner):
+   * evaluate("users.filter(u => u.active)", { users: [...] })
+   *
+   * // Explicit return (multi-statement):
+   * evaluate(`
+   *   const active = users.filter(u => u.active);
+   *   return active.map(u => ({ ...u, rank: 1 }));
+   * `, { users: [...] })
+   */
+  evaluate(expression: string, context: Record<string, unknown>): unknown;
+  /**
+   * Dispose the QuickJS runtime. Call on Invect shutdown.
+   */
+  dispose(): void;
+}
+/**
+ * Custom error class for mapper expression errors.
+ * Includes the original expression for debugging.
+ */
+declare class JsExpressionError extends Error {
+  readonly expression: string;
+  constructor(message: string, expression: string);
+}
+declare function getJsExpressionService(logger?: Logger): Promise<JsExpressionService>;
+declare function createJsExpressionService(config?: JsExpressionServiceConfig, logger?: Logger): JsExpressionService;
+/**
+ * Dispose the global singleton (call during shutdown).
+ */
+declare function disposeJsExpressionService(): void;
+//#endregion
+export { JsExpressionError, JsExpressionService, JsExpressionServiceConfig, createJsExpressionService, disposeJsExpressionService, getJsExpressionService };
+//# sourceMappingURL=js-expression.service.d.ts.map

package/dist/services/templating/js-expression.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-expression.service.d.ts","names":[],"sources":["../../../src/services/templating/js-expression.service.ts"],"mappings":";;UAgBiB,yBAAA;;EAEf,gBAAA;EAFe;EAIf,iBAAA;AAAA;AAAA,cAMW,mBAAA;EAAA,QACH,MAAA;EAAA,QACA,OAAA;EAAA,QACA,MAAA;EAAA,QACA,MAAA;cAEI,MAAA,GAAQ,yBAAA,EAAgC,MAAA,GAAS,MAAA;EAAA;;;;EAYvD,UAAA,CAAA,GAAc,OAAA;EAjBZ;;;;;;;;;;;;;;;;;;EAmDR,QAAA,CAAS,UAAA,UAAoB,OAAA,EAAS,MAAA;EA+ET;;;EApC7B,OAAA,CAAA;AAAA;;;;;cAoCW,iBAAA,SAA0B,KAAA;EAAA,SAGnB,UAAA;cADhB,OAAA,UACgB,UAAA;AAAA;AAAA,iBAWE,sBAAA,CAAuB,MAAA,GAAS,MAAA,GAAS,OAAA,CAAQ,mBAAA;AAAA,iBAQvD,yBAAA,CACd,MAAA,GAAS,yBAAA,EACT,MAAA,GAAS,MAAA,GACR,mBAAA;;;;iBAOa,0BAAA,CAAA"}

package/dist/services/templating/js-expression.service.js

@@ -0,0 +1,143 @@
+import { newQuickJSWASMModule } from "quickjs-emscripten";
+//#region src/services/templating/js-expression.service.ts
+/**
+* JS Expression Service
+*
+* Provides sandboxed JavaScript evaluation for data mapper expressions.
+* Uses QuickJS (via quickjs-emscripten) for safe, isolated execution.
+*
+* User code is wrapped in a function body — use `return` to produce a value.
+* For single-expression one-liners (no `return` keyword), `return` is auto-prepended.
+*
+* Context keys from upstream nodes are injected as local variables.
+* `$input` is always available as the full context object (escape hatch for name collisions).
+*/
+const DEFAULT_MEMORY_LIMIT = 16 * 1024 * 1024;
+const DEFAULT_MAX_STACK_SIZE = 1024 * 1024;
+var JsExpressionService = class {
+	module = null;
+	runtime = null;
+	logger;
+	config;
+	constructor(config = {}, logger) {
+		this.logger = logger;
+		this.config = {
+			memoryLimitBytes: config.memoryLimitBytes ?? DEFAULT_MEMORY_LIMIT,
+			maxStackSizeBytes: config.maxStackSizeBytes ?? DEFAULT_MAX_STACK_SIZE
+		};
+	}
+	/**
+	* Initialize the QuickJS WASM module and runtime.
+	* Must be called before evaluate(). Safe to call multiple times.
+	*/
+	async initialize() {
+		if (this.runtime) return;
+		this.module = await newQuickJSWASMModule();
+		this.runtime = this.module.newRuntime();
+		this.runtime.setMemoryLimit(this.config.memoryLimitBytes);
+		this.runtime.setMaxStackSize(this.config.maxStackSizeBytes);
+		this.logger?.debug("JsExpressionService initialized", {
+			memoryLimit: this.config.memoryLimitBytes,
+			maxStackSize: this.config.maxStackSizeBytes
+		});
+	}
+	/**
+	* Evaluate JS code against a context object.
+	*
+	* User code is wrapped in a function body. Use `return` to produce a value.
+	* For one-liners without `return`, the service auto-prepends it.
+	*
+	* Context keys are available as local variables. `$input` is the full context.
+	*
+	* @example
+	* // Auto-return (one-liner):
+	* evaluate("users.filter(u => u.active)", { users: [...] })
+	*
+	* // Explicit return (multi-statement):
+	* evaluate(`
+	*   const active = users.filter(u => u.active);
+	*   return active.map(u => ({ ...u, rank: 1 }));
+	* `, { users: [...] })
+	*/
+	evaluate(expression, context) {
+		if (!this.runtime) throw new Error("JsExpressionService not initialized. Call initialize() first.");
+		const vm = this.runtime.newContext();
+		try {
+			const contextJson = JSON.stringify(context);
+			const contextKeys = Object.keys(context);
+			const userBody = needsAutoReturn(expression) ? `return (${expression})` : expression;
+			const destructure = contextKeys.length > 0 ? `const {${contextKeys.join(",")}} = $input;` : "";
+			const wrapped = `(function(){const $input = JSON.parse(${JSON.stringify(contextJson)});${destructure}${userBody}})()`;
+			const result = vm.evalCode(wrapped);
+			if (result.error) {
+				const errorObj = vm.dump(result.error);
+				result.error.dispose();
+				throw new JsExpressionError(typeof errorObj === "object" && errorObj !== null && "message" in errorObj ? errorObj.message : String(errorObj), expression);
+			}
+			const value = vm.dump(result.value);
+			result.value.dispose();
+			return value;
+		} finally {
+			vm.dispose();
+		}
+	}
+	/**
+	* Dispose the QuickJS runtime. Call on Invect shutdown.
+	*/
+	dispose() {
+		if (this.runtime) {
+			this.runtime.dispose();
+			this.runtime = null;
+		}
+		this.module = null;
+		this.logger?.debug("JsExpressionService disposed");
+	}
+};
+/**
+* Determine if user code needs auto-return wrapping.
+*
+* Auto-return is applied when the code does NOT contain a `return` keyword
+* (as a word boundary match, to avoid false positives in strings like "returns").
+*
+* This means one-liners like `users.filter(u => u.active)` work without typing `return`,
+* while multi-statement code requires explicit `return`.
+*/
+function needsAutoReturn(code) {
+	const stripped = code.replace(/\/\/.*$/gm, "").replace(/\/\*[\s\S]*?\*\//g, "").replace(/'(?:[^'\\]|\\.)*'/g, "").replace(/"(?:[^"\\]|\\.)*"/g, "").replace(/`(?:[^`\\]|\\.)*`/g, "");
+	return !/\breturn\b/.test(stripped);
+}
+/**
+* Custom error class for mapper expression errors.
+* Includes the original expression for debugging.
+*/
+var JsExpressionError = class extends Error {
+	constructor(message, expression) {
+		super(`Mapper expression error: ${message}`);
+		this.expression = expression;
+		this.name = "JsExpressionError";
+	}
+};
+let defaultInstance = null;
+async function getJsExpressionService(logger) {
+	if (!defaultInstance) {
+		defaultInstance = new JsExpressionService({}, logger);
+		await defaultInstance.initialize();
+	}
+	return defaultInstance;
+}
+function createJsExpressionService(config, logger) {
+	return new JsExpressionService(config, logger);
+}
+/**
+* Dispose the global singleton (call during shutdown).
+*/
+function disposeJsExpressionService() {
+	if (defaultInstance) {
+		defaultInstance.dispose();
+		defaultInstance = null;
+	}
+}
+//#endregion
+export { JsExpressionError, JsExpressionService, createJsExpressionService, disposeJsExpressionService, getJsExpressionService };
+
+//# sourceMappingURL=js-expression.service.js.map

package/dist/services/templating/js-expression.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-expression.service.js","names":[],"sources":["../../../src/services/templating/js-expression.service.ts"],"sourcesContent":["/**\n * JS Expression Service\n *\n * Provides sandboxed JavaScript evaluation for data mapper expressions.\n * Uses QuickJS (via quickjs-emscripten) for safe, isolated execution.\n *\n * User code is wrapped in a function body — use `return` to produce a value.\n * For single-expression one-liners (no `return` keyword), `return` is auto-prepended.\n *\n * Context keys from upstream nodes are injected as local variables.\n * `$input` is always available as the full context object (escape hatch for name collisions).\n */\nimport { newQuickJSWASMModule } from 'quickjs-emscripten';\nimport type { QuickJSWASMModule, QuickJSRuntime } from 'quickjs-emscripten';\nimport type { Logger } from 'src/types/schemas';\n\nexport interface JsExpressionServiceConfig {\n  /** Memory limit for the QuickJS runtime in bytes. Default: 16MB */\n  memoryLimitBytes?: number;\n  /** Max stack size in bytes. Default: 1MB */\n  maxStackSizeBytes?: number;\n}\n\nconst DEFAULT_MEMORY_LIMIT = 16 * 1024 * 1024; // 16 MB\nconst DEFAULT_MAX_STACK_SIZE = 1024 * 1024; // 1 MB\n\nexport class JsExpressionService {\n  private module: QuickJSWASMModule | null = null;\n  private runtime: QuickJSRuntime | null = null;\n  private logger?: Logger;\n  private config: Required<JsExpressionServiceConfig>;\n\n  constructor(config: JsExpressionServiceConfig = {}, logger?: Logger) {\n    this.logger = logger;\n    this.config = {\n      memoryLimitBytes: config.memoryLimitBytes ?? DEFAULT_MEMORY_LIMIT,\n      maxStackSizeBytes: config.maxStackSizeBytes ?? DEFAULT_MAX_STACK_SIZE,\n    };\n  }\n\n  /**\n   * Initialize the QuickJS WASM module and runtime.\n   * Must be called before evaluate(). Safe to call multiple times.\n   */\n  async initialize(): Promise<void> {\n    if (this.runtime) {\n      return;\n    }\n\n    this.module = await newQuickJSWASMModule();\n    this.runtime = this.module.newRuntime();\n    this.runtime.setMemoryLimit(this.config.memoryLimitBytes);\n    this.runtime.setMaxStackSize(this.config.maxStackSizeBytes);\n\n    this.logger?.debug('JsExpressionService initialized', {\n      memoryLimit: this.config.memoryLimitBytes,\n      maxStackSize: this.config.maxStackSizeBytes,\n    });\n  }\n\n  /**\n   * Evaluate JS code against a context object.\n   *\n   * User code is wrapped in a function body. Use `return` to produce a value.\n   * For one-liners without `return`, the service auto-prepends it.\n   *\n   * Context keys are available as local variables. `$input` is the full context.\n   *\n   * @example\n   * // Auto-return (one-liner):\n   * evaluate(\"users.filter(u => u.active)\", { users: [...] })\n   *\n   * // Explicit return (multi-statement):\n   * evaluate(`\n   *   const active = users.filter(u => u.active);\n   *   return active.map(u => ({ ...u, rank: 1 }));\n   * `, { users: [...] })\n   */\n  evaluate(expression: string, context: Record<string, unknown>): unknown {\n    if (!this.runtime) {\n      throw new Error('JsExpressionService not initialized. Call initialize() first.');\n    }\n\n    const vm = this.runtime.newContext();\n    try {\n      // Inject context as a JSON-serialized global, then destructure into locals.\n      // This avoids per-key handle creation and is faster for large contexts.\n      const contextJson = JSON.stringify(context);\n      const contextKeys = Object.keys(context);\n\n      // Build the wrapped code:\n      // 1. Parse the serialized context into $input\n      // 2. Destructure context keys into local variables\n      // 3. Execute user code in a function body (with auto-return for one-liners)\n      const userBody = needsAutoReturn(expression) ? `return (${expression})` : expression;\n      const destructure =\n        contextKeys.length > 0 ? `const {${contextKeys.join(',')}} = $input;` : '';\n      const wrapped = `(function(){const $input = JSON.parse(${JSON.stringify(contextJson)});${destructure}${userBody}})()`;\n\n      const result = vm.evalCode(wrapped);\n      if (result.error) {\n        const errorObj = vm.dump(result.error);\n        result.error.dispose();\n        const message =\n          typeof errorObj === 'object' && errorObj !== null && 'message' in errorObj\n            ? (errorObj as { message: string }).message\n            : String(errorObj);\n        throw new JsExpressionError(message, expression);\n      }\n\n      const value = vm.dump(result.value);\n      result.value.dispose();\n      return value;\n    } finally {\n      vm.dispose();\n    }\n  }\n\n  /**\n   * Dispose the QuickJS runtime. Call on Invect shutdown.\n   */\n  dispose(): void {\n    if (this.runtime) {\n      this.runtime.dispose();\n      this.runtime = null;\n    }\n    this.module = null;\n    this.logger?.debug('JsExpressionService disposed');\n  }\n}\n\n/**\n * Determine if user code needs auto-return wrapping.\n *\n * Auto-return is applied when the code does NOT contain a `return` keyword\n * (as a word boundary match, to avoid false positives in strings like \"returns\").\n *\n * This means one-liners like `users.filter(u => u.active)` work without typing `return`,\n * while multi-statement code requires explicit `return`.\n */\nfunction needsAutoReturn(code: string): boolean {\n  // Strip string literals and comments to avoid false positives,\n  // then check for `return` as a keyword boundary\n  const stripped = code\n    .replace(/\\/\\/.*$/gm, '') // line comments\n    .replace(/\\/\\*[\\s\\S]*?\\*\\//g, '') // block comments\n    .replace(/'(?:[^'\\\\]|\\\\.)*'/g, '') // single-quoted strings\n    .replace(/\"(?:[^\"\\\\]|\\\\.)*\"/g, '') // double-quoted strings\n    .replace(/`(?:[^`\\\\]|\\\\.)*`/g, ''); // template literals\n\n  return !/\\breturn\\b/.test(stripped);\n}\n\n/**\n * Custom error class for mapper expression errors.\n * Includes the original expression for debugging.\n */\nexport class JsExpressionError extends Error {\n  constructor(\n    message: string,\n    public readonly expression: string,\n  ) {\n    super(`Mapper expression error: ${message}`);\n    this.name = 'JsExpressionError';\n  }\n}\n\n// ── Singleton helpers ──────────────────────────────────────────────────────────\n\nlet defaultInstance: JsExpressionService | null = null;\n\nexport async function getJsExpressionService(logger?: Logger): Promise<JsExpressionService> {\n  if (!defaultInstance) {\n    defaultInstance = new JsExpressionService({}, logger);\n    await defaultInstance.initialize();\n  }\n  return defaultInstance;\n}\n\nexport function createJsExpressionService(\n  config?: JsExpressionServiceConfig,\n  logger?: Logger,\n): JsExpressionService {\n  return new JsExpressionService(config, logger);\n}\n\n/**\n * Dispose the global singleton (call during shutdown).\n */\nexport function disposeJsExpressionService(): void {\n  if (defaultInstance) {\n    defaultInstance.dispose();\n    defaultInstance = null;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAuBA,MAAM,uBAAuB,KAAK,OAAO;AACzC,MAAM,yBAAyB,OAAO;AAEtC,IAAa,sBAAb,MAAiC;CAC/B,SAA2C;CAC3C,UAAyC;CACzC;CACA;CAEA,YAAY,SAAoC,EAAE,EAAE,QAAiB;AACnE,OAAK,SAAS;AACd,OAAK,SAAS;GACZ,kBAAkB,OAAO,oBAAoB;GAC7C,mBAAmB,OAAO,qBAAqB;GAChD;;;;;;CAOH,MAAM,aAA4B;AAChC,MAAI,KAAK,QACP;AAGF,OAAK,SAAS,MAAM,sBAAsB;AAC1C,OAAK,UAAU,KAAK,OAAO,YAAY;AACvC,OAAK,QAAQ,eAAe,KAAK,OAAO,iBAAiB;AACzD,OAAK,QAAQ,gBAAgB,KAAK,OAAO,kBAAkB;AAE3D,OAAK,QAAQ,MAAM,mCAAmC;GACpD,aAAa,KAAK,OAAO;GACzB,cAAc,KAAK,OAAO;GAC3B,CAAC;;;;;;;;;;;;;;;;;;;;CAqBJ,SAAS,YAAoB,SAA2C;AACtE,MAAI,CAAC,KAAK,QACR,OAAM,IAAI,MAAM,gEAAgE;EAGlF,MAAM,KAAK,KAAK,QAAQ,YAAY;AACpC,MAAI;GAGF,MAAM,cAAc,KAAK,UAAU,QAAQ;GAC3C,MAAM,cAAc,OAAO,KAAK,QAAQ;GAMxC,MAAM,WAAW,gBAAgB,WAAW,GAAG,WAAW,WAAW,KAAK;GAC1E,MAAM,cACJ,YAAY,SAAS,IAAI,UAAU,YAAY,KAAK,IAAI,CAAC,eAAe;GAC1E,MAAM,UAAU,yCAAyC,KAAK,UAAU,YAAY,CAAC,IAAI,cAAc,SAAS;GAEhH,MAAM,SAAS,GAAG,SAAS,QAAQ;AACnC,OAAI,OAAO,OAAO;IAChB,MAAM,WAAW,GAAG,KAAK,OAAO,MAAM;AACtC,WAAO,MAAM,SAAS;AAKtB,UAAM,IAAI,kBAHR,OAAO,aAAa,YAAY,aAAa,QAAQ,aAAa,WAC7D,SAAiC,UAClC,OAAO,SAAS,EACe,WAAW;;GAGlD,MAAM,QAAQ,GAAG,KAAK,OAAO,MAAM;AACnC,UAAO,MAAM,SAAS;AACtB,UAAO;YACC;AACR,MAAG,SAAS;;;;;;CAOhB,UAAgB;AACd,MAAI,KAAK,SAAS;AAChB,QAAK,QAAQ,SAAS;AACtB,QAAK,UAAU;;AAEjB,OAAK,SAAS;AACd,OAAK,QAAQ,MAAM,+BAA+B;;;;;;;;;;;;AAatD,SAAS,gBAAgB,MAAuB;CAG9C,MAAM,WAAW,KACd,QAAQ,aAAa,GAAG,CACxB,QAAQ,qBAAqB,GAAG,CAChC,QAAQ,sBAAsB,GAAG,CACjC,QAAQ,sBAAsB,GAAG,CACjC,QAAQ,sBAAsB,GAAG;AAEpC,QAAO,CAAC,aAAa,KAAK,SAAS;;;;;;AAOrC,IAAa,oBAAb,cAAuC,MAAM;CAC3C,YACE,SACA,YACA;AACA,QAAM,4BAA4B,UAAU;AAF5B,OAAA,aAAA;AAGhB,OAAK,OAAO;;;AAMhB,IAAI,kBAA8C;AAElD,eAAsB,uBAAuB,QAA+C;AAC1F,KAAI,CAAC,iBAAiB;AACpB,oBAAkB,IAAI,oBAAoB,EAAE,EAAE,OAAO;AACrD,QAAM,gBAAgB,YAAY;;AAEpC,QAAO;;AAGT,SAAgB,0BACd,QACA,QACqB;AACrB,QAAO,IAAI,oBAAoB,QAAQ,OAAO;;;;;AAMhD,SAAgB,6BAAmC;AACjD,KAAI,iBAAiB;AACnB,kBAAgB,SAAS;AACzB,oBAAkB"}