Add FunctionHandle_future type (#59898)

GitOrigin-RevId: 9488afac6deaa65d36ed3541903d839fc7491602

Author: reeceyang

src/server/components/index.ts

@@ -49,6 +49,17 @@ export type FunctionHandle<
   ReturnType = any,
 > = string & FunctionReference<Type, "internal", Args, ReturnType>;
 
+/**
+ * A {@link FunctionHandle} with the type semantics of {@link FunctionReference_future}.
+ *
+ * @public
+ */
+export type FunctionHandle_future<
+  Type extends FunctionType,
+  Args extends DefaultFunctionArgs = any,
+  ReturnType = any,
+> = string & FunctionReference_future<Type, "internal", Args, ReturnType>;
+
 /**
  * Create a serializable reference to a Convex function.
  * Passing a this reference to another component allows that component to call this

src/server/index.ts

@@ -209,6 +209,7 @@ export type {
   ComponentDefinition,
   AnyComponents,
   FunctionHandle,
+  FunctionHandle_future,
 } from "./components/index.js";
 
 /**