@absolutejs/sync 1.11.0 → 1.12.0

package/dist/engine/index.js

@@ -1136,7 +1136,7 @@ var wrap = (source) => `
 		const userFn = (${source});
 		if (typeof userFn !== 'function') {
 			throw new Error(
-				'sandboxedHandler must evaluate to (args, ctx, actions) => result; got ' +
+				'sandboxedHandler must evaluate to (args, ctx, actions, unsafeHost) => result; got ' +
 					typeof userFn
 			);
 		}
@@ -1148,12 +1148,24 @@ var wrap = (source) => `
 			now: () => __dispatch(__callId, 'now'),
 			fetch: (url, init) => __dispatch(__callId, 'fetch', url, init)
 		};
-		return userFn(args, ctx, actions);
+		// Escape hatch \u2014 host fns the mutation explicitly opted in to.
+		// The Proxy means every property access is a host call; the
+		// engine throws if the property name isn't declared in the
+		// mutation's sandbox.unsafeHost map.
+		const unsafeHost = new Proxy({}, {
+			get: (_target, fnName) => {
+				if (typeof fnName !== 'string') return undefined;
+				return (...callArgs) =>
+					__dispatch(__callId, 'unsafeHost', fnName, callArgs);
+			}
+		});
+		return userFn(args, ctx, actions, unsafeHost);
 	}
 `;
 var compile = async (source, config, bridgeFetch) => {
   const { Reference, createIsolatedRunner, resolveIsolatePolicy } = await loadIsolatedJsc();
   const callMap = new Map;
+  const unsafeHost = config.unsafeHost;
   const dispatch = new Reference((callId, op, ...rest) => {
     const a = callMap.get(callId);
     if (a === undefined) {
@@ -1172,6 +1184,14 @@ var compile = async (source, config, bridgeFetch) => {
         return a.now();
       case "fetch":
         return runBridgeFetch(bridgeFetch, rest[0], rest[1]);
+      case "unsafeHost": {
+        const fnName = rest[0];
+        const callArgs = rest[1] ?? [];
+        if (unsafeHost === undefined || typeof unsafeHost[fnName] !== "function") {
+          throw new Error(`sandboxedHandler called unsafeHost.${fnName}() but it was not declared in the mutation's sandbox.unsafeHost config. Declare it (and only the host fns you intend to expose) to opt in to the escape hatch.`);
+        }
+        return unsafeHost[fnName](...callArgs);
+      }
       default:
         throw new Error(`unknown sandbox action op: ${String(op)}`);
     }
@@ -3140,5 +3160,5 @@ export {
   CdcConsumerSlowError
 };
 
-//# debugId=C14BF50A13D2477E64756E2164756E21
+//# debugId=5C3B639DC6FB356064756E2164756E21
 //# sourceMappingURL=index.js.map