expo-http-server 0.1.3 → 0.1.4

package/README.md

@@ -43,7 +43,13 @@ export default function App() {
   const obj = { app: "expo-http-server", desc: "You can load JSON!" };
 
   useEffect(() => {
-    server.setup(9666);
+    server.setup(9666, (event: server.StatusEvent) => {
+      if (event.status === "ERROR") {
+        // there was an error...
+      } else {
+        // server was STARTED, PAUSED, RESUMED or STOPPED
+      }
+    });
     server.route("/", "GET", async (request) => {
       console.log("Request", "/", "GET", JSON.stringify(request));
       setLastCalled(Date.now());
@@ -88,7 +94,12 @@ export default function App() {
 
 ```
 
-Note that on iOS when the app is backgrounded the server will inevitably get paused. A background task will be started automatically, however you will likely only get 30 seconds of listening time in the background.
+## Running in the background
+**iOS**: When the app is backgrounded the server will inevitably get paused. There is no getting around this. expo-http-server will start a  [background task](https://developer.apple.com/documentation/uikit/uiapplication/1623031-beginbackgroundtask) that should provide a bit more background time, but this will only be ~25 seconds, which could be lowered by Apple in the future. expo-http-server will automatically pause the server when the time runs out, and resume it when the app is resumed.
+
+**Android**: The server can be ran continuously in the background using a foreground service, e.g. a persistent notification. [Notifee](https://notifee.app/react-native/docs/android/foreground-service#building-a-long-lived-task) can be used to do this. Take a look at the example project for how to set this up.
+
+## Testing
 
 Send a request to the server in a browser `browser` or `curl`:
 

package/android/src/main/java/expo/modules/httpserver/ExpoHttpServerModule.kt

@@ -17,7 +17,7 @@ class ExpoHttpServerModule : Module() {
                            val contentType: String,
                            val body: String)
 
-  private lateinit var server: Server
+  private var server: Server? = null;
   private val responses = HashMap<String, SimpleHttpResponse>()
 
   private val requestHandler: RequestHandler = { request: Request, response: Response ->
@@ -49,7 +49,7 @@ class ExpoHttpServerModule : Module() {
 
     Name("ExpoHttpServer")
 
-    Events("onRequest")
+    Events("onStatusUpdate", "onRequest")
 
     Function("setup") { port: Int ->
       server = AndroidServer.Builder{
@@ -60,11 +60,22 @@ class ExpoHttpServerModule : Module() {
     }
 
     Function("route") { path: String, method: String ->
-      server = server.request(HttpMethod.getMethod(method), path, requestHandler);
+      server = server?.request(HttpMethod.getMethod(method), path, requestHandler);
     }
 
     Function("start") {
-      server.start()
+      if (server == null) {
+        sendEvent("onStatusUpdate", bundleOf(
+          "status" to "ERROR",
+          "message" to "Server not setup / port not configured"
+        ))
+      } else {
+        server?.start()
+        sendEvent("onStatusUpdate", bundleOf(
+          "status" to "STARTED",
+          "message" to "Server started"
+        ))
+      }
     }
 
     Function("respond") { uuid: String,
@@ -75,7 +86,11 @@ class ExpoHttpServerModule : Module() {
     }
 
     Function("stop") {
-      server.close()
+      server?.close()
+      sendEvent("onStatusUpdate", bundleOf(
+        "status" to "STOPPED",
+        "message" to "Server stopped"
+      ))
     }
   }
 }

package/build/index.d.ts

@@ -1,4 +1,12 @@
 export type HttpMethod = "GET" | "POST" | "PUT" | "DELETE";
+/**
+ * PAUSED AND RESUMED are iOS only
+ */
+export type Status = "STARTED" | "PAUSED" | "RESUMED" | "STOPPED" | "ERROR";
+export interface StatusEvent {
+    status: Status;
+    message: string;
+}
 export interface RequestEvent {
     uuid: string;
     method: string;
@@ -20,6 +28,6 @@ export interface Callback {
 }
 export declare const start: () => void;
 export declare const route: (path: string, method: HttpMethod, callback: (request: RequestEvent) => Promise<Response>) => void;
-export declare const setup: (port: number) => any;
+export declare const setup: (port: number, onStatusUpdate?: ((event: StatusEvent) => void) | undefined) => void;
 export declare const stop: () => any;
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CACxD;AAED,eAAO,MAAM,KAAK,YAyBjB,CAAC;AAEF,eAAO,MAAM,KAAK,SACV,MAAM,UACJ,UAAU,sBACE,YAAY,KAAK,QAAQ,QAAQ,CAAC,SAQvD,CAAC;AAEF,eAAO,MAAM,KAAK,SAAU,MAAM,QAAqC,CAAC;AACxE,eAAO,MAAM,IAAI,WAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAC3D;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE5E,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CACxD;AAED,eAAO,MAAM,KAAK,YAyBjB,CAAC;AAEF,eAAO,MAAM,KAAK,SACV,MAAM,UACJ,UAAU,sBACE,YAAY,KAAK,QAAQ,QAAQ,CAAC,SAQvD,CAAC;AAEF,eAAO,MAAM,KAAK,SACV,MAAM,4BACa,WAAW,KAAK,IAAI,sBAQ9C,CAAC;AAEF,eAAO,MAAM,IAAI,WAAoC,CAAC"}

package/build/index.js

@@ -3,7 +3,6 @@ import ExpoHttpServerModule from "./ExpoHttpServerModule";
 const emitter = new EventEmitter(ExpoHttpServerModule);
 const requestCallbacks = [];
 export const start = () => {
-    ExpoHttpServerModule.start();
     emitter.addListener("onRequest", async (event) => {
         const callbacks = requestCallbacks.filter((c) => event.path === c.path && event.method === c.method);
         if (!callbacks.length) {
@@ -15,6 +14,7 @@ export const start = () => {
             ExpoHttpServerModule.respond(event.uuid, response.statusCode || 200, response.contentType || "application/json", response.body || "{}");
         }
     });
+    ExpoHttpServerModule.start();
 };
 export const route = (path, method, callback) => {
     requestCallbacks.push({
@@ -24,6 +24,13 @@ export const route = (path, method, callback) => {
     });
     ExpoHttpServerModule.route(path, method);
 };
-export const setup = (port) => ExpoHttpServerModule.setup(port);
+export const setup = (port, onStatusUpdate) => {
+    if (onStatusUpdate) {
+        emitter.addListener("onStatusUpdate", async (event) => {
+            onStatusUpdate(event);
+        });
+    }
+    ExpoHttpServerModule.setup(port);
+};
 export const stop = () => ExpoHttpServerModule.stop();
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,oBAAoB,MAAM,wBAAwB,CAAC;AAE1D,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,oBAAoB,CAAC,CAAC;AACvD,MAAM,gBAAgB,GAAe,EAAE,CAAC;AA0BxC,MAAM,CAAC,MAAM,KAAK,GAAG,GAAG,EAAE;IACxB,oBAAoB,CAAC,KAAK,EAAE,CAAC;IAC7B,OAAO,CAAC,WAAW,CAAe,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAC7D,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CACvC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,CAC1D,CAAC;QACF,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YACtB,oBAAoB,CAAC,OAAO,CAC1B,KAAK,CAAC,IAAI,EACV,GAAG,EACH,aAAa,EACb,aAAa,CACd,CAAC;YACF,OAAO;QACT,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACzC,oBAAoB,CAAC,OAAO,CAC1B,KAAK,CAAC,IAAI,EACV,QAAQ,CAAC,UAAU,IAAI,GAAG,EAC1B,QAAQ,CAAC,WAAW,IAAI,kBAAkB,EAC1C,QAAQ,CAAC,IAAI,IAAI,IAAI,CACtB,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG,CACnB,IAAY,EACZ,MAAkB,EAClB,QAAsD,EACtD,EAAE;IACF,gBAAgB,CAAC,IAAI,CAAC;QACpB,MAAM;QACN,IAAI;QACJ,QAAQ;KACT,CAAC,CAAC;IACH,oBAAoB,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACxE,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC","sourcesContent":["import { EventEmitter } from \"expo-modules-core\";\n\nimport ExpoHttpServerModule from \"./ExpoHttpServerModule\";\n\nconst emitter = new EventEmitter(ExpoHttpServerModule);\nconst requestCallbacks: Callback[] = [];\n\nexport type HttpMethod = \"GET\" | \"POST\" | \"PUT\" | \"DELETE\";\n\nexport interface RequestEvent {\n  uuid: string;\n  method: string;\n  path: string;\n  body: string;\n  headersJson: string;\n  paramsJson: string;\n  cookiesJson: string;\n}\n\nexport interface Response {\n  statusCode?: number;\n  contentType?: string;\n  body?: string;\n}\n\nexport interface Callback {\n  method: string;\n  path: string;\n  callback: (request: RequestEvent) => Promise<Response>;\n}\n\nexport const start = () => {\n  ExpoHttpServerModule.start();\n  emitter.addListener<RequestEvent>(\"onRequest\", async (event) => {\n    const callbacks = requestCallbacks.filter(\n      (c) => event.path === c.path && event.method === c.method,\n    );\n    if (!callbacks.length) {\n      ExpoHttpServerModule.respond(\n        event.uuid,\n        200,\n        \"No callback\",\n        \"No callback\",\n      );\n      return;\n    }\n    for (const c of callbacks) {\n      const response = await c.callback(event);\n      ExpoHttpServerModule.respond(\n        event.uuid,\n        response.statusCode || 200,\n        response.contentType || \"application/json\",\n        response.body || \"{}\",\n      );\n    }\n  });\n};\n\nexport const route = (\n  path: string,\n  method: HttpMethod,\n  callback: (request: RequestEvent) => Promise<Response>,\n) => {\n  requestCallbacks.push({\n    method,\n    path,\n    callback,\n  });\n  ExpoHttpServerModule.route(path, method);\n};\n\nexport const setup = (port: number) => ExpoHttpServerModule.setup(port);\nexport const stop = () => ExpoHttpServerModule.stop();\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,oBAAoB,MAAM,wBAAwB,CAAC;AAE1D,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,oBAAoB,CAAC,CAAC;AACvD,MAAM,gBAAgB,GAAe,EAAE,CAAC;AAmCxC,MAAM,CAAC,MAAM,KAAK,GAAG,GAAG,EAAE;IACxB,OAAO,CAAC,WAAW,CAAe,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAC7D,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CACvC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,CAC1D,CAAC;QACF,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YACtB,oBAAoB,CAAC,OAAO,CAC1B,KAAK,CAAC,IAAI,EACV,GAAG,EACH,aAAa,EACb,aAAa,CACd,CAAC;YACF,OAAO;QACT,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACzC,oBAAoB,CAAC,OAAO,CAC1B,KAAK,CAAC,IAAI,EACV,QAAQ,CAAC,UAAU,IAAI,GAAG,EAC1B,QAAQ,CAAC,WAAW,IAAI,kBAAkB,EAC1C,QAAQ,CAAC,IAAI,IAAI,IAAI,CACtB,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IACH,oBAAoB,CAAC,KAAK,EAAE,CAAC;AAC/B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG,CACnB,IAAY,EACZ,MAAkB,EAClB,QAAsD,EACtD,EAAE;IACF,gBAAgB,CAAC,IAAI,CAAC;QACpB,MAAM;QACN,IAAI;QACJ,QAAQ;KACT,CAAC,CAAC;IACH,oBAAoB,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG,CACnB,IAAY,EACZ,cAA6C,EAC7C,EAAE;IACF,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,CAAC,WAAW,CAAc,gBAAgB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACjE,cAAc,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;IACD,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC","sourcesContent":["import { EventEmitter } from \"expo-modules-core\";\n\nimport ExpoHttpServerModule from \"./ExpoHttpServerModule\";\n\nconst emitter = new EventEmitter(ExpoHttpServerModule);\nconst requestCallbacks: Callback[] = [];\n\nexport type HttpMethod = \"GET\" | \"POST\" | \"PUT\" | \"DELETE\";\n/**\n * PAUSED AND RESUMED are iOS only\n */\nexport type Status = \"STARTED\" | \"PAUSED\" | \"RESUMED\" | \"STOPPED\" | \"ERROR\";\n\nexport interface StatusEvent {\n  status: Status;\n  message: string;\n}\n\nexport interface RequestEvent {\n  uuid: string;\n  method: string;\n  path: string;\n  body: string;\n  headersJson: string;\n  paramsJson: string;\n  cookiesJson: string;\n}\n\nexport interface Response {\n  statusCode?: number;\n  contentType?: string;\n  body?: string;\n}\n\nexport interface Callback {\n  method: string;\n  path: string;\n  callback: (request: RequestEvent) => Promise<Response>;\n}\n\nexport const start = () => {\n  emitter.addListener<RequestEvent>(\"onRequest\", async (event) => {\n    const callbacks = requestCallbacks.filter(\n      (c) => event.path === c.path && event.method === c.method,\n    );\n    if (!callbacks.length) {\n      ExpoHttpServerModule.respond(\n        event.uuid,\n        200,\n        \"No callback\",\n        \"No callback\",\n      );\n      return;\n    }\n    for (const c of callbacks) {\n      const response = await c.callback(event);\n      ExpoHttpServerModule.respond(\n        event.uuid,\n        response.statusCode || 200,\n        response.contentType || \"application/json\",\n        response.body || \"{}\",\n      );\n    }\n  });\n  ExpoHttpServerModule.start();\n};\n\nexport const route = (\n  path: string,\n  method: HttpMethod,\n  callback: (request: RequestEvent) => Promise<Response>,\n) => {\n  requestCallbacks.push({\n    method,\n    path,\n    callback,\n  });\n  ExpoHttpServerModule.route(path, method);\n};\n\nexport const setup = (\n  port: number,\n  onStatusUpdate?: (event: StatusEvent) => void,\n) => {\n  if (onStatusUpdate) {\n    emitter.addListener<StatusEvent>(\"onStatusUpdate\", async (event) => {\n      onStatusUpdate(event);\n    });\n  }\n  ExpoHttpServerModule.setup(port);\n};\n\nexport const stop = () => ExpoHttpServerModule.stop();\n"]}

package/ios/ExpoHttpServerModule.swift

@@ -4,13 +4,14 @@ import Criollo
 public class ExpoHttpServerModule: Module {
     private let server = CRHTTPServer()
     private var port: Int?
+    private var stopped = false
     private var responses = [String: CRResponse]()
     private var bgTaskIdentifier = UIBackgroundTaskIdentifier.invalid
     
     public func definition() -> ModuleDefinition {
         Name("ExpoHttpServer")
 
-        Events("onRequest")
+        Events("onStatusUpdate", "onRequest")
         
         Function("setup", setupHandler)
         Function("start", startHandler)
@@ -20,24 +21,17 @@ public class ExpoHttpServerModule: Module {
     }
     
     private func setupHandler(port: Int) {
-        NotificationCenter.default.addObserver(forName: UIApplication.willEnterForegroundNotification, object: nil, queue: .main) { [unowned self] notification in
-            if (self.server.isListening) {
-                self.endBackgroundTask()
-                self.beginBackgroundTask()
-            }
-        }
         self.port = port;
     }
 
     private func startHandler() {
-        if (server.isListening) { return }
-        beginBackgroundTask()
-        var error: NSError?
-        if let port = port {
-            server.startListening(&error, portNumber: UInt(port))
-        } else {
-            server.startListening(&error)
+        NotificationCenter.default.addObserver(forName: UIApplication.willEnterForegroundNotification, object: nil, queue: .main) { [unowned self] notification in
+            if (!self.stopped) {
+                self.startServer(status: "RESUMED", message: "Server resumed")
+            }
         }
+        stopped = false;
+        startServer(status: "STARTED", message: "Server started")
     }
     
     private func routeHandler(path: String, method: String) {
@@ -74,16 +68,52 @@ public class ExpoHttpServerModule: Module {
     }
     
     private func stopHandler() {
+        stopped = true;
+        stopServer(status: "STOPPED", message: "Server stopped")
+    }
+        
+    private func startServer(status: String, message: String) {
+        stopServer()
+        if let port = port {
+            var error: NSError?
+            server.startListening(&error, portNumber: UInt(port))
+            if (error != nil) {
+                sendEvent("onStatusUpdate", [
+                    "status": "ERROR",
+                    "message": error?.localizedDescription ?? "Unknown error starting server"
+                ])
+            } else {
+                beginBackgroundTask()
+                sendEvent("onStatusUpdate", [
+                    "status": status,
+                    "message": message
+                ])
+            }
+        } else {
+            sendEvent("onStatusUpdate", [
+                "status": "ERROR",
+                "message": "Can't start server with port configured"
+            ])
+        }
+    }
+    
+    private func stopServer(status: String? = nil, message: String? = nil) {
         if (server.isListening) {
             server.stopListening()
-            endBackgroundTask()
+        }
+        endBackgroundTask()
+        if let status = status, let message = message {
+            sendEvent("onStatusUpdate", [
+                "status": status,
+                "message": message
+            ])
         }
     }
     
     private func beginBackgroundTask() {
         if (bgTaskIdentifier == UIBackgroundTaskIdentifier.invalid) {
             self.bgTaskIdentifier = UIApplication.shared.beginBackgroundTask(withName: "BgTask", expirationHandler: {
-                self.endBackgroundTask()
+                self.stopServer(status: "PAUSED", message: "Server paused")
             })
         }
     }
@@ -133,4 +163,4 @@ extension CRHTTPMethod {
         }
         return httpMethod
     }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "expo-http-server",
-	"version": "0.1.3",
+	"version": "0.1.4",
 	"description": "A simple HTTP server expo module (iOS/Android)",
 	"main": "build/index.js",
 	"types": "build/index.d.ts",

package/src/index.ts

@@ -6,6 +6,15 @@ const emitter = new EventEmitter(ExpoHttpServerModule);
 const requestCallbacks: Callback[] = [];
 
 export type HttpMethod = "GET" | "POST" | "PUT" | "DELETE";
+/**
+ * PAUSED AND RESUMED are iOS only
+ */
+export type Status = "STARTED" | "PAUSED" | "RESUMED" | "STOPPED" | "ERROR";
+
+export interface StatusEvent {
+  status: Status;
+  message: string;
+}
 
 export interface RequestEvent {
   uuid: string;
@@ -30,7 +39,6 @@ export interface Callback {
 }
 
 export const start = () => {
-  ExpoHttpServerModule.start();
   emitter.addListener<RequestEvent>("onRequest", async (event) => {
     const callbacks = requestCallbacks.filter(
       (c) => event.path === c.path && event.method === c.method,
@@ -54,6 +62,7 @@ export const start = () => {
       );
     }
   });
+  ExpoHttpServerModule.start();
 };
 
 export const route = (
@@ -69,5 +78,16 @@ export const route = (
   ExpoHttpServerModule.route(path, method);
 };
 
-export const setup = (port: number) => ExpoHttpServerModule.setup(port);
+export const setup = (
+  port: number,
+  onStatusUpdate?: (event: StatusEvent) => void,
+) => {
+  if (onStatusUpdate) {
+    emitter.addListener<StatusEvent>("onStatusUpdate", async (event) => {
+      onStatusUpdate(event);
+    });
+  }
+  ExpoHttpServerModule.setup(port);
+};
+
 export const stop = () => ExpoHttpServerModule.stop();