Fix graceful shutdown test hanging

The test was passing but the process never exited because a 30-second
fallback timer in shutdown() was never cancelled when shutdownResolve()
was called early.

Fixed by:
- Saving the timeout ID when creating the fallback timer
- Clearing the timeout when shutdownResolve() is called

This ensures the JS event loop can complete after shutdown finishes.

Author: nev-offload

Cargo.lock

@@ -38,3 +38,9 @@ hex = "0.4"
 
 # File watching
 notify = { version = "6.1", default-features = false, features = ["macos_fsevent"] }
+
+# HTTP server
+hyper = { version = "1.0", features = ["server", "http1"] }
+hyper-util = { version = "0.1", features = ["tokio", "server", "server-auto"] }
+http-body-util = "0.1"
+bytes = "1.0"

Cargo.toml

@@ -654,3 +654,15 @@ export type {
 } from "./watcher/index.ts";
 
 export { watchFile, watchDirectory } from "./watcher/index.ts";
+
+// ============================================================================
+// HTTP Server - Deno-style serve() API
+// ============================================================================
+
+export type {
+  RequestHandler,
+  ServeOptions,
+  Server,
+} from "./server/index.ts";
+
+export { serve } from "./server/index.ts";

funee-lib/index.ts

@@ -0,0 +1,13 @@
+/**
+ * HTTP Server Module
+ * 
+ * Provides serve() function for creating HTTP servers.
+ */
+
+export type {
+  RequestHandler,
+  ServeOptions,
+  Server,
+} from "./serve.ts";
+
+export { serve } from "./serve.ts";

funee-lib/server/index.ts

@@ -0,0 +1,81 @@
+/**
+ * HTTP Server - serve() function types
+ * 
+ * The actual implementation is in the runtime bootstrap (run_js.rs).
+ * This file exports types for TypeScript users.
+ * 
+ * @example
+ * ```typescript
+ * import { serve } from "funee";
+ * 
+ * // Simple server
+ * const server = serve({ port: 3000 }, (req) => {
+ *   return new Response("Hello, World!");
+ * });
+ * 
+ * // Shutdown when done
+ * await server.shutdown();
+ * ```
+ */
+
+/**
+ * Request handler function
+ */
+export type RequestHandler = (request: Request) => Response | Promise<Response>;
+
+/**
+ * Options for serve()
+ */
+export type ServeOptions = {
+  /** Port to listen on. Use 0 for random available port. */
+  port: number;
+  /** Hostname to bind to. Default: "127.0.0.1" */
+  hostname?: string;
+  /** Called when server starts listening */
+  onListen?: (info: { port: number; hostname: string }) => void;
+  /** Called when handler throws an error */
+  onError?: (error: Error) => Response | Promise<Response>;
+};
+
+/**
+ * Server handle returned by serve()
+ */
+export type Server = {
+  /** Port the server is listening on */
+  readonly port: number;
+  /** Hostname the server is bound to */
+  readonly hostname: string;
+  /** Gracefully shutdown the server */
+  shutdown: () => Promise<void>;
+};
+
+// Declare the global serve function (provided by runtime bootstrap)
+declare global {
+  function serve(
+    options: ServeOptions,
+    handler: RequestHandler,
+  ): Server;
+}
+
+/**
+ * Create an HTTP server
+ * 
+ * @param options - Server options including port and callbacks
+ * @param handler - Request handler function
+ * @returns Server handle with shutdown method
+ * 
+ * @example
+ * ```typescript
+ * const server = serve({ port: 3000 }, (req) => {
+ *   const url = new URL(req.url);
+ *   if (url.pathname === "/api") {
+ *     return Response.json({ hello: "world" });
+ *   }
+ *   return new Response("Not Found", { status: 404 });
+ * });
+ * ```
+ */
+export const serve: (
+  options: ServeOptions,
+  handler: RequestHandler,
+) => Server = globalThis.serve;