@milaboratories/pl-middle-layer 1.48.11 → 1.48.13

package/dist/js_render/index.cjs

@@ -1,167 +1,148 @@
-'use strict';
-
-var computable = require('@milaboratories/computable');
-var quickjsEmscripten = require('quickjs-emscripten');
-var context = require('./context.cjs');
-var index = require('../debug/index.cjs');
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_index = require('../debug/index.cjs');
+const require_context = require('./context.cjs');
+let _milaboratories_computable = require("@milaboratories/computable");
+let quickjs_emscripten = require("quickjs-emscripten");
 
+//#region src/js_render/index.ts
 function logOutputStatus(handle, renderedResult, stable, recalculationCounter, unstableMarker) {
-    if (index.getDebugFlags().logOutputStatus && (index.getDebugFlags().logOutputStatus === "any" || !stable)) {
-        if (stable)
-            console.log(`Stable output ${handle} calculated ${renderedResult !== undefined ? "defined" : "undefined"}; (#${recalculationCounter})`);
-        else
-            console.log(`Unstable output ${handle}; marker = ${unstableMarker}; ${renderedResult !== undefined ? "defined" : "undefined"} (#${recalculationCounter})`);
-    }
+	if (require_index.getDebugFlags().logOutputStatus && (require_index.getDebugFlags().logOutputStatus === "any" || !stable)) if (stable) console.log(`Stable output ${handle} calculated ${renderedResult !== void 0 ? "defined" : "undefined"}; (#${recalculationCounter})`);
+	else console.log(`Unstable output ${handle}; marker = ${unstableMarker}; ${renderedResult !== void 0 ? "defined" : "undefined"} (#${recalculationCounter})`);
 }
 /**
- * Creates a Computable that executes a render function (`fh`) from a block's code in a QuickJS virtual machine.
- * This function handles both synchronous and asynchronous execution patterns of the sandboxed JS code.
- *
- * The overall data flow is as follows:
- * 1. A QuickJS VM is initialized.
- * 2. A `JsExecutionContext` is created to bridge the host (TypeScript) and guest (QuickJS) environments. It injects a
- *    context object (`cfgRenderCtx`) into the VM, providing helper methods for the sandboxed code to interact with the
- *    platform (e.g., to request data).
- * 3. The block's Javascript bundle is evaluated in the VM.
- * 4. The specified render function (`fh.handle`) is executed.
- *
- * Two execution paths are possible depending on the behavior of the render function:
- *
- * ### Synchronous Path
- * If the render function computes its result without requesting any external data requiring asynchronous calculations,
- * it executes synchronously.
- * - The `computablesToResolve` map in `JsExecutionContext` remains empty.
- * - The function returns an object with an `ir` field holding the result (`{ ir: importedResult }`).
- *   Since `postprocessValue` is not specified, `ir` is treated as the final resolved value of the Computable.
- * - The QuickJS VM is disposed of immediately as it's no longer needed.
- *
- * ### Asynchronous Path (with `postprocessValue`)
- * If the render function needs external data requiring asynchronous calculations (e.g., fetching a file), it calls
- * one of the injected helper methods. These methods don't return data directly. Instead, they:
- *  a. Create a new `Computable` for the data request (e.g., to fetch a blob).
- *  b. Register this new `Computable` in the `computablesToResolve` map.
- *  c. Return a handle (string) to the sandboxed code.
- *
- * In this case:
- * - The initial execution of the render function returns a scaffold of the final result, which depends on the pending
- *   computables.
- * - The `computablesToResolve` map is passed as the `ir` (initial result) to `Computable.makeRaw`.
- * - The `postprocessValue` function is provided to handle the results once the computables are resolved.
- * - The QuickJS VM is kept alive (`keepVmAlive = true`) because its state is needed in `postprocessValue`.
- * - Once the `computable` framework resolves all dependencies, it calls `postprocessValue` with the resolved data.
- * - `postprocessValue` feeds the resolved data back into the VM, allowing the sandboxed code to compute the final
- *   result.
- * - The VM is eventually disposed of when the host Computable is destroyed.
- *
- * @param env The middle layer environment.
- * @param ctx The block context.
- * @param fh The config render lambda to execute.
- * @param codeWithInfo The block's code and feature flags.
- * @param configKey A key for the configuration, used for cache busting.
- * @param ops Options for the computable.
- * @returns A `Computable` that will resolve to the result of the lambda execution.
- */
+* Creates a Computable that executes a render function (`fh`) from a block's code in a QuickJS virtual machine.
+* This function handles both synchronous and asynchronous execution patterns of the sandboxed JS code.
+*
+* The overall data flow is as follows:
+* 1. A QuickJS VM is initialized.
+* 2. A `JsExecutionContext` is created to bridge the host (TypeScript) and guest (QuickJS) environments. It injects a
+*    context object (`cfgRenderCtx`) into the VM, providing helper methods for the sandboxed code to interact with the
+*    platform (e.g., to request data).
+* 3. The block's Javascript bundle is evaluated in the VM.
+* 4. The specified render function (`fh.handle`) is executed.
+*
+* Two execution paths are possible depending on the behavior of the render function:
+*
+* ### Synchronous Path
+* If the render function computes its result without requesting any external data requiring asynchronous calculations,
+* it executes synchronously.
+* - The `computablesToResolve` map in `JsExecutionContext` remains empty.
+* - The function returns an object with an `ir` field holding the result (`{ ir: importedResult }`).
+*   Since `postprocessValue` is not specified, `ir` is treated as the final resolved value of the Computable.
+* - The QuickJS VM is disposed of immediately as it's no longer needed.
+*
+* ### Asynchronous Path (with `postprocessValue`)
+* If the render function needs external data requiring asynchronous calculations (e.g., fetching a file), it calls
+* one of the injected helper methods. These methods don't return data directly. Instead, they:
+*  a. Create a new `Computable` for the data request (e.g., to fetch a blob).
+*  b. Register this new `Computable` in the `computablesToResolve` map.
+*  c. Return a handle (string) to the sandboxed code.
+*
+* In this case:
+* - The initial execution of the render function returns a scaffold of the final result, which depends on the pending
+*   computables.
+* - The `computablesToResolve` map is passed as the `ir` (initial result) to `Computable.makeRaw`.
+* - The `postprocessValue` function is provided to handle the results once the computables are resolved.
+* - The QuickJS VM is kept alive (`keepVmAlive = true`) because its state is needed in `postprocessValue`.
+* - Once the `computable` framework resolves all dependencies, it calls `postprocessValue` with the resolved data.
+* - `postprocessValue` feeds the resolved data back into the VM, allowing the sandboxed code to compute the final
+*   result.
+* - The VM is eventually disposed of when the host Computable is destroyed.
+*
+* @param env The middle layer environment.
+* @param ctx The block context.
+* @param fh The config render lambda to execute.
+* @param codeWithInfo The block's code and feature flags.
+* @param configKey A key for the configuration, used for cache busting.
+* @param ops Options for the computable.
+* @returns A `Computable` that will resolve to the result of the lambda execution.
+*/
 function computableFromRF(env, ctx, fh, codeWithInfo, configKey, ops = {}) {
-    // adding configKey to reload all outputs on block-pack update
-    const key = `${ctx.blockId}#lambda#${configKey}#${fh.handle}`;
-    ops = { ...ops, key };
-    if (ops.mode === undefined && fh.retentive === true)
-        ops.mode = "StableOnlyRetentive";
-    return computable.Computable.makeRaw((cCtx) => {
-        const { code, featureFlags } = codeWithInfo;
-        if (index.getDebugFlags().logOutputRecalculations)
-            console.log(`Block lambda recalculation : ${key} (${cCtx.changeSourceMarker}; ${cCtx.bodyInvocations} invocations)`);
-        const scope = new quickjsEmscripten.Scope();
-        let keepVmAlive = false;
-        cCtx.addOnDestroy(() => {
-            // If keepVmAlive is false, the scope will be disposed by the finally block,
-            // no need to dispose it here.
-            if (keepVmAlive)
-                scope.dispose();
-        });
-        try {
-            const runtime = scope.manage(env.quickJs.newRuntime());
-            runtime.setMemoryLimit(1024 * 1024 * 8);
-            runtime.setMaxStackSize(1024 * 320);
-            let deadlineSettings;
-            runtime.setInterruptHandler(() => {
-                if (deadlineSettings === undefined)
-                    return false;
-                if (Date.now() > deadlineSettings.deadline)
-                    return true;
-                return false;
-            });
-            const vm = scope.manage(runtime.newContext());
-            const rCtx = new context.JsExecutionContext(scope, vm, (s) => {
-                deadlineSettings = s;
-            }, featureFlags, { computableCtx: cCtx, blockCtx: ctx, mlEnv: env });
-            rCtx.evaluateBundle(code.content);
-            const result = rCtx.runCallback(fh.handle);
-            rCtx.resetComputableCtx();
-            const toBeResolved = rCtx.computableHelper.computablesToResolve;
-            if (Object.keys(toBeResolved).length === 0) {
-                const importedResult = rCtx.importObjectUniversal(result);
-                logOutputStatus(fh.handle, importedResult, cCtx.unstableMarker === undefined, -1, cCtx.unstableMarker);
-                return { ir: importedResult };
-            }
-            let recalculationCounter = 0;
-            if (index.getDebugFlags().logOutputStatus)
-                console.log(`Output ${fh.handle} scaffold calculated (not all computables resolved yet).`);
-            keepVmAlive = true;
-            return {
-                ir: toBeResolved,
-                postprocessValue: (resolved, { unstableMarker, stable }) => {
-                    // resolving futures
-                    for (const [handle, value] of Object.entries(resolved))
-                        rCtx.runCallback(handle, value);
-                    // rendering result
-                    const renderedResult = rCtx.importObjectUniversal(result);
-                    // logging
-                    recalculationCounter++;
-                    logOutputStatus(fh.handle, renderedResult, stable, recalculationCounter, unstableMarker);
-                    return renderedResult;
-                },
-            };
-        }
-        catch (e) {
-            keepVmAlive = false;
-            throw e;
-        }
-        finally {
-            if (!keepVmAlive)
-                scope.dispose();
-        }
-    }, ops);
+	const key = `${ctx.blockId}#lambda#${configKey}#${fh.handle}`;
+	ops = {
+		...ops,
+		key
+	};
+	if (ops.mode === void 0 && fh.retentive === true) ops.mode = "StableOnlyRetentive";
+	return _milaboratories_computable.Computable.makeRaw((cCtx) => {
+		const { code, featureFlags } = codeWithInfo;
+		if (require_index.getDebugFlags().logOutputRecalculations) console.log(`Block lambda recalculation : ${key} (${cCtx.changeSourceMarker}; ${cCtx.bodyInvocations} invocations)`);
+		const scope = new quickjs_emscripten.Scope();
+		let keepVmAlive = false;
+		cCtx.addOnDestroy(() => {
+			if (keepVmAlive) scope.dispose();
+		});
+		try {
+			const runtime = scope.manage(env.quickJs.newRuntime());
+			runtime.setMemoryLimit(1024 * 1024 * 8);
+			runtime.setMaxStackSize(1024 * 320);
+			let deadlineSettings;
+			runtime.setInterruptHandler(() => {
+				if (deadlineSettings === void 0) return false;
+				if (Date.now() > deadlineSettings.deadline) return true;
+				return false;
+			});
+			const rCtx = new require_context.JsExecutionContext(scope, scope.manage(runtime.newContext()), (s) => {
+				deadlineSettings = s;
+			}, featureFlags, {
+				computableCtx: cCtx,
+				blockCtx: ctx,
+				mlEnv: env
+			});
+			rCtx.evaluateBundle(code.content);
+			const result = rCtx.runCallback(fh.handle);
+			rCtx.resetComputableCtx();
+			const toBeResolved = rCtx.computableHelper.computablesToResolve;
+			if (Object.keys(toBeResolved).length === 0) {
+				const importedResult = rCtx.importObjectUniversal(result);
+				logOutputStatus(fh.handle, importedResult, cCtx.unstableMarker === void 0, -1, cCtx.unstableMarker);
+				return { ir: importedResult };
+			}
+			let recalculationCounter = 0;
+			if (require_index.getDebugFlags().logOutputStatus) console.log(`Output ${fh.handle} scaffold calculated (not all computables resolved yet).`);
+			keepVmAlive = true;
+			return {
+				ir: toBeResolved,
+				postprocessValue: (resolved, { unstableMarker, stable }) => {
+					for (const [handle, value] of Object.entries(resolved)) rCtx.runCallback(handle, value);
+					const renderedResult = rCtx.importObjectUniversal(result);
+					recalculationCounter++;
+					logOutputStatus(fh.handle, renderedResult, stable, recalculationCounter, unstableMarker);
+					return renderedResult;
+				}
+			};
+		} catch (e) {
+			keepVmAlive = false;
+			throw e;
+		} finally {
+			if (!keepVmAlive) scope.dispose();
+		}
+	}, ops);
 }
 function executeSingleLambda(quickJs, fh, codeWithInfo, ...args) {
-    const { code, featureFlags } = codeWithInfo;
-    const scope = new quickjsEmscripten.Scope();
-    try {
-        const runtime = scope.manage(quickJs.newRuntime());
-        runtime.setMemoryLimit(1024 * 1024 * 8);
-        runtime.setMaxStackSize(1024 * 320);
-        let deadlineSettings;
-        runtime.setInterruptHandler(() => {
-            if (deadlineSettings === undefined)
-                return false;
-            if (Date.now() > deadlineSettings.deadline)
-                return true;
-            return false;
-        });
-        const vm = scope.manage(runtime.newContext());
-        const rCtx = new context.JsExecutionContext(scope, vm, (s) => {
-            deadlineSettings = s;
-        }, featureFlags);
-        // Initializing the model
-        rCtx.evaluateBundle(code.content);
-        // Running the lambda with arguments (e.g., state for args(), args for enrichmentTargets())
-        return rCtx.importObjectUniversal(rCtx.runCallback(fh.handle, ...args));
-    }
-    finally {
-        scope.dispose();
-    }
+	const { code, featureFlags } = codeWithInfo;
+	const scope = new quickjs_emscripten.Scope();
+	try {
+		const runtime = scope.manage(quickJs.newRuntime());
+		runtime.setMemoryLimit(1024 * 1024 * 8);
+		runtime.setMaxStackSize(1024 * 320);
+		let deadlineSettings;
+		runtime.setInterruptHandler(() => {
+			if (deadlineSettings === void 0) return false;
+			if (Date.now() > deadlineSettings.deadline) return true;
+			return false;
+		});
+		const rCtx = new require_context.JsExecutionContext(scope, scope.manage(runtime.newContext()), (s) => {
+			deadlineSettings = s;
+		}, featureFlags);
+		rCtx.evaluateBundle(code.content);
+		return rCtx.importObjectUniversal(rCtx.runCallback(fh.handle, ...args));
+	} finally {
+		scope.dispose();
+	}
 }
 
+//#endregion
 exports.computableFromRF = computableFromRF;
 exports.executeSingleLambda = executeSingleLambda;
-//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/js_render/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../src/js_render/index.ts"],"sourcesContent":["import type { MiddleLayerEnvironment } from \"../middle_layer/middle_layer\";\nimport type { BlockCodeWithInfo, ConfigRenderLambda } from \"@platforma-sdk/model\";\nimport type { ComputableRenderingOps } from \"@milaboratories/computable\";\nimport { Computable } from \"@milaboratories/computable\";\nimport type { QuickJSWASMModule } from \"quickjs-emscripten\";\nimport { Scope } from \"quickjs-emscripten\";\nimport type { DeadlineSettings } from \"./context\";\nimport { JsExecutionContext } from \"./context\";\nimport type { BlockContextAny } from \"../middle_layer/block_ctx\";\nimport { getDebugFlags } from \"../debug\";\n\nfunction logOutputStatus(\n  handle: string,\n  renderedResult: unknown,\n  stable: boolean,\n  recalculationCounter: number,\n  unstableMarker?: string,\n) {\n  if (getDebugFlags().logOutputStatus && (getDebugFlags().logOutputStatus === \"any\" || !stable)) {\n    if (stable)\n      console.log(\n        `Stable output ${handle} calculated ${renderedResult !== undefined ? \"defined\" : \"undefined\"}; (#${recalculationCounter})`,\n      );\n    else\n      console.log(\n        `Unstable output ${handle}; marker = ${unstableMarker}; ${renderedResult !== undefined ? \"defined\" : \"undefined\"} (#${recalculationCounter})`,\n      );\n  }\n}\n\n/**\n * Creates a Computable that executes a render function (`fh`) from a block's code in a QuickJS virtual machine.\n * This function handles both synchronous and asynchronous execution patterns of the sandboxed JS code.\n *\n * The overall data flow is as follows:\n * 1. A QuickJS VM is initialized.\n * 2. A `JsExecutionContext` is created to bridge the host (TypeScript) and guest (QuickJS) environments. It injects a\n *    context object (`cfgRenderCtx`) into the VM, providing helper methods for the sandboxed code to interact with the\n *    platform (e.g., to request data).\n * 3. The block's Javascript bundle is evaluated in the VM.\n * 4. The specified render function (`fh.handle`) is executed.\n *\n * Two execution paths are possible depending on the behavior of the render function:\n *\n * ### Synchronous Path\n * If the render function computes its result without requesting any external data requiring asynchronous calculations,\n * it executes synchronously.\n * - The `computablesToResolve` map in `JsExecutionContext` remains empty.\n * - The function returns an object with an `ir` field holding the result (`{ ir: importedResult }`).\n *   Since `postprocessValue` is not specified, `ir` is treated as the final resolved value of the Computable.\n * - The QuickJS VM is disposed of immediately as it's no longer needed.\n *\n * ### Asynchronous Path (with `postprocessValue`)\n * If the render function needs external data requiring asynchronous calculations (e.g., fetching a file), it calls\n * one of the injected helper methods. These methods don't return data directly. Instead, they:\n *  a. Create a new `Computable` for the data request (e.g., to fetch a blob).\n *  b. Register this new `Computable` in the `computablesToResolve` map.\n *  c. Return a handle (string) to the sandboxed code.\n *\n * In this case:\n * - The initial execution of the render function returns a scaffold of the final result, which depends on the pending\n *   computables.\n * - The `computablesToResolve` map is passed as the `ir` (initial result) to `Computable.makeRaw`.\n * - The `postprocessValue` function is provided to handle the results once the computables are resolved.\n * - The QuickJS VM is kept alive (`keepVmAlive = true`) because its state is needed in `postprocessValue`.\n * - Once the `computable` framework resolves all dependencies, it calls `postprocessValue` with the resolved data.\n * - `postprocessValue` feeds the resolved data back into the VM, allowing the sandboxed code to compute the final\n *   result.\n * - The VM is eventually disposed of when the host Computable is destroyed.\n *\n * @param env The middle layer environment.\n * @param ctx The block context.\n * @param fh The config render lambda to execute.\n * @param codeWithInfo The block's code and feature flags.\n * @param configKey A key for the configuration, used for cache busting.\n * @param ops Options for the computable.\n * @returns A `Computable` that will resolve to the result of the lambda execution.\n */\nexport function computableFromRF(\n  env: MiddleLayerEnvironment,\n  ctx: BlockContextAny,\n  fh: ConfigRenderLambda,\n  codeWithInfo: BlockCodeWithInfo,\n  configKey: string,\n  ops: Partial<ComputableRenderingOps> = {},\n): Computable<unknown> {\n  // adding configKey to reload all outputs on block-pack update\n  const key = `${ctx.blockId}#lambda#${configKey}#${fh.handle}`;\n  ops = { ...ops, key };\n  if (ops.mode === undefined && fh.retentive === true) ops.mode = \"StableOnlyRetentive\";\n  return Computable.makeRaw((cCtx) => {\n    const { code, featureFlags } = codeWithInfo;\n\n    if (getDebugFlags().logOutputRecalculations)\n      console.log(\n        `Block lambda recalculation : ${key} (${cCtx.changeSourceMarker}; ${cCtx.bodyInvocations} invocations)`,\n      );\n\n    const scope = new Scope();\n    let keepVmAlive = false;\n    cCtx.addOnDestroy(() => {\n      // If keepVmAlive is false, the scope will be disposed by the finally block,\n      // no need to dispose it here.\n      if (keepVmAlive) scope.dispose();\n    });\n\n    try {\n      const runtime = scope.manage(env.quickJs.newRuntime());\n      runtime.setMemoryLimit(1024 * 1024 * 8);\n      runtime.setMaxStackSize(1024 * 320);\n\n      let deadlineSettings: DeadlineSettings | undefined;\n      runtime.setInterruptHandler(() => {\n        if (deadlineSettings === undefined) return false;\n        if (Date.now() > deadlineSettings.deadline) return true;\n        return false;\n      });\n      const vm = scope.manage(runtime.newContext());\n      const rCtx = new JsExecutionContext(\n        scope,\n        vm,\n        (s) => {\n          deadlineSettings = s;\n        },\n        featureFlags,\n        { computableCtx: cCtx, blockCtx: ctx, mlEnv: env },\n      );\n\n      rCtx.evaluateBundle(code.content);\n      const result = rCtx.runCallback(fh.handle);\n\n      rCtx.resetComputableCtx();\n\n      const toBeResolved = rCtx.computableHelper!.computablesToResolve;\n\n      if (Object.keys(toBeResolved).length === 0) {\n        const importedResult = rCtx.importObjectUniversal(result);\n        logOutputStatus(\n          fh.handle,\n          importedResult,\n          cCtx.unstableMarker === undefined,\n          -1,\n          cCtx.unstableMarker,\n        );\n        return { ir: importedResult };\n      }\n\n      let recalculationCounter = 0;\n      if (getDebugFlags().logOutputStatus)\n        console.log(`Output ${fh.handle} scaffold calculated (not all computables resolved yet).`);\n      keepVmAlive = true;\n\n      return {\n        ir: toBeResolved,\n        postprocessValue: (resolved: Record<string, unknown>, { unstableMarker, stable }) => {\n          // resolving futures\n          for (const [handle, value] of Object.entries(resolved)) rCtx.runCallback(handle, value);\n\n          // rendering result\n          const renderedResult = rCtx.importObjectUniversal(result);\n\n          // logging\n          recalculationCounter++;\n          logOutputStatus(fh.handle, renderedResult, stable, recalculationCounter, unstableMarker);\n\n          return renderedResult;\n        },\n      };\n    } catch (e) {\n      keepVmAlive = false;\n      throw e;\n    } finally {\n      if (!keepVmAlive) scope.dispose();\n    }\n  }, ops);\n}\n\nexport function executeSingleLambda(\n  quickJs: QuickJSWASMModule,\n  fh: ConfigRenderLambda,\n  codeWithInfo: BlockCodeWithInfo,\n  ...args: unknown[]\n): unknown {\n  const { code, featureFlags } = codeWithInfo;\n  const scope = new Scope();\n  try {\n    const runtime = scope.manage(quickJs.newRuntime());\n    runtime.setMemoryLimit(1024 * 1024 * 8);\n    runtime.setMaxStackSize(1024 * 320);\n\n    let deadlineSettings: DeadlineSettings | undefined;\n    runtime.setInterruptHandler(() => {\n      if (deadlineSettings === undefined) return false;\n      if (Date.now() > deadlineSettings.deadline) return true;\n      return false;\n    });\n    const vm = scope.manage(runtime.newContext());\n    const rCtx = new JsExecutionContext(\n      scope,\n      vm,\n      (s) => {\n        deadlineSettings = s;\n      },\n      featureFlags,\n    );\n\n    // Initializing the model\n    rCtx.evaluateBundle(code.content);\n\n    // Running the lambda with arguments (e.g., state for args(), args for enrichmentTargets())\n    return rCtx.importObjectUniversal(rCtx.runCallback(fh.handle, ...args));\n  } finally {\n    scope.dispose();\n  }\n}\n"],"names":["getDebugFlags","Computable","Scope","JsExecutionContext"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["getDebugFlags","Computable","Scope","JsExecutionContext"],"sources":["../../src/js_render/index.ts"],"sourcesContent":["import type { MiddleLayerEnvironment } from \"../middle_layer/middle_layer\";\nimport type { BlockCodeWithInfo, ConfigRenderLambda } from \"@platforma-sdk/model\";\nimport type { ComputableRenderingOps } from \"@milaboratories/computable\";\nimport { Computable } from \"@milaboratories/computable\";\nimport type { QuickJSWASMModule } from \"quickjs-emscripten\";\nimport { Scope } from \"quickjs-emscripten\";\nimport type { DeadlineSettings } from \"./context\";\nimport { JsExecutionContext } from \"./context\";\nimport type { BlockContextAny } from \"../middle_layer/block_ctx\";\nimport { getDebugFlags } from \"../debug\";\n\nfunction logOutputStatus(\n  handle: string,\n  renderedResult: unknown,\n  stable: boolean,\n  recalculationCounter: number,\n  unstableMarker?: string,\n) {\n  if (getDebugFlags().logOutputStatus && (getDebugFlags().logOutputStatus === \"any\" || !stable)) {\n    if (stable)\n      console.log(\n        `Stable output ${handle} calculated ${renderedResult !== undefined ? \"defined\" : \"undefined\"}; (#${recalculationCounter})`,\n      );\n    else\n      console.log(\n        `Unstable output ${handle}; marker = ${unstableMarker}; ${renderedResult !== undefined ? \"defined\" : \"undefined\"} (#${recalculationCounter})`,\n      );\n  }\n}\n\n/**\n * Creates a Computable that executes a render function (`fh`) from a block's code in a QuickJS virtual machine.\n * This function handles both synchronous and asynchronous execution patterns of the sandboxed JS code.\n *\n * The overall data flow is as follows:\n * 1. A QuickJS VM is initialized.\n * 2. A `JsExecutionContext` is created to bridge the host (TypeScript) and guest (QuickJS) environments. It injects a\n *    context object (`cfgRenderCtx`) into the VM, providing helper methods for the sandboxed code to interact with the\n *    platform (e.g., to request data).\n * 3. The block's Javascript bundle is evaluated in the VM.\n * 4. The specified render function (`fh.handle`) is executed.\n *\n * Two execution paths are possible depending on the behavior of the render function:\n *\n * ### Synchronous Path\n * If the render function computes its result without requesting any external data requiring asynchronous calculations,\n * it executes synchronously.\n * - The `computablesToResolve` map in `JsExecutionContext` remains empty.\n * - The function returns an object with an `ir` field holding the result (`{ ir: importedResult }`).\n *   Since `postprocessValue` is not specified, `ir` is treated as the final resolved value of the Computable.\n * - The QuickJS VM is disposed of immediately as it's no longer needed.\n *\n * ### Asynchronous Path (with `postprocessValue`)\n * If the render function needs external data requiring asynchronous calculations (e.g., fetching a file), it calls\n * one of the injected helper methods. These methods don't return data directly. Instead, they:\n *  a. Create a new `Computable` for the data request (e.g., to fetch a blob).\n *  b. Register this new `Computable` in the `computablesToResolve` map.\n *  c. Return a handle (string) to the sandboxed code.\n *\n * In this case:\n * - The initial execution of the render function returns a scaffold of the final result, which depends on the pending\n *   computables.\n * - The `computablesToResolve` map is passed as the `ir` (initial result) to `Computable.makeRaw`.\n * - The `postprocessValue` function is provided to handle the results once the computables are resolved.\n * - The QuickJS VM is kept alive (`keepVmAlive = true`) because its state is needed in `postprocessValue`.\n * - Once the `computable` framework resolves all dependencies, it calls `postprocessValue` with the resolved data.\n * - `postprocessValue` feeds the resolved data back into the VM, allowing the sandboxed code to compute the final\n *   result.\n * - The VM is eventually disposed of when the host Computable is destroyed.\n *\n * @param env The middle layer environment.\n * @param ctx The block context.\n * @param fh The config render lambda to execute.\n * @param codeWithInfo The block's code and feature flags.\n * @param configKey A key for the configuration, used for cache busting.\n * @param ops Options for the computable.\n * @returns A `Computable` that will resolve to the result of the lambda execution.\n */\nexport function computableFromRF(\n  env: MiddleLayerEnvironment,\n  ctx: BlockContextAny,\n  fh: ConfigRenderLambda,\n  codeWithInfo: BlockCodeWithInfo,\n  configKey: string,\n  ops: Partial<ComputableRenderingOps> = {},\n): Computable<unknown> {\n  // adding configKey to reload all outputs on block-pack update\n  const key = `${ctx.blockId}#lambda#${configKey}#${fh.handle}`;\n  ops = { ...ops, key };\n  if (ops.mode === undefined && fh.retentive === true) ops.mode = \"StableOnlyRetentive\";\n  return Computable.makeRaw((cCtx) => {\n    const { code, featureFlags } = codeWithInfo;\n\n    if (getDebugFlags().logOutputRecalculations)\n      console.log(\n        `Block lambda recalculation : ${key} (${cCtx.changeSourceMarker}; ${cCtx.bodyInvocations} invocations)`,\n      );\n\n    const scope = new Scope();\n    let keepVmAlive = false;\n    cCtx.addOnDestroy(() => {\n      // If keepVmAlive is false, the scope will be disposed by the finally block,\n      // no need to dispose it here.\n      if (keepVmAlive) scope.dispose();\n    });\n\n    try {\n      const runtime = scope.manage(env.quickJs.newRuntime());\n      runtime.setMemoryLimit(1024 * 1024 * 8);\n      runtime.setMaxStackSize(1024 * 320);\n\n      let deadlineSettings: DeadlineSettings | undefined;\n      runtime.setInterruptHandler(() => {\n        if (deadlineSettings === undefined) return false;\n        if (Date.now() > deadlineSettings.deadline) return true;\n        return false;\n      });\n      const vm = scope.manage(runtime.newContext());\n      const rCtx = new JsExecutionContext(\n        scope,\n        vm,\n        (s) => {\n          deadlineSettings = s;\n        },\n        featureFlags,\n        { computableCtx: cCtx, blockCtx: ctx, mlEnv: env },\n      );\n\n      rCtx.evaluateBundle(code.content);\n      const result = rCtx.runCallback(fh.handle);\n\n      rCtx.resetComputableCtx();\n\n      const toBeResolved = rCtx.computableHelper!.computablesToResolve;\n\n      if (Object.keys(toBeResolved).length === 0) {\n        const importedResult = rCtx.importObjectUniversal(result);\n        logOutputStatus(\n          fh.handle,\n          importedResult,\n          cCtx.unstableMarker === undefined,\n          -1,\n          cCtx.unstableMarker,\n        );\n        return { ir: importedResult };\n      }\n\n      let recalculationCounter = 0;\n      if (getDebugFlags().logOutputStatus)\n        console.log(`Output ${fh.handle} scaffold calculated (not all computables resolved yet).`);\n      keepVmAlive = true;\n\n      return {\n        ir: toBeResolved,\n        postprocessValue: (resolved: Record<string, unknown>, { unstableMarker, stable }) => {\n          // resolving futures\n          for (const [handle, value] of Object.entries(resolved)) rCtx.runCallback(handle, value);\n\n          // rendering result\n          const renderedResult = rCtx.importObjectUniversal(result);\n\n          // logging\n          recalculationCounter++;\n          logOutputStatus(fh.handle, renderedResult, stable, recalculationCounter, unstableMarker);\n\n          return renderedResult;\n        },\n      };\n    } catch (e) {\n      keepVmAlive = false;\n      throw e;\n    } finally {\n      if (!keepVmAlive) scope.dispose();\n    }\n  }, ops);\n}\n\nexport function executeSingleLambda(\n  quickJs: QuickJSWASMModule,\n  fh: ConfigRenderLambda,\n  codeWithInfo: BlockCodeWithInfo,\n  ...args: unknown[]\n): unknown {\n  const { code, featureFlags } = codeWithInfo;\n  const scope = new Scope();\n  try {\n    const runtime = scope.manage(quickJs.newRuntime());\n    runtime.setMemoryLimit(1024 * 1024 * 8);\n    runtime.setMaxStackSize(1024 * 320);\n\n    let deadlineSettings: DeadlineSettings | undefined;\n    runtime.setInterruptHandler(() => {\n      if (deadlineSettings === undefined) return false;\n      if (Date.now() > deadlineSettings.deadline) return true;\n      return false;\n    });\n    const vm = scope.manage(runtime.newContext());\n    const rCtx = new JsExecutionContext(\n      scope,\n      vm,\n      (s) => {\n        deadlineSettings = s;\n      },\n      featureFlags,\n    );\n\n    // Initializing the model\n    rCtx.evaluateBundle(code.content);\n\n    // Running the lambda with arguments (e.g., state for args(), args for enrichmentTargets())\n    return rCtx.importObjectUniversal(rCtx.runCallback(fh.handle, ...args));\n  } finally {\n    scope.dispose();\n  }\n}\n"],"mappings":"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"}