Inspector initial support

Signed-off-by: Francis Bouvier <francis@lightpanda.io>

Author: francisbouvier

src/api.zig

@@ -83,6 +83,10 @@ pub const TryCatch = Engine.TryCatch;
 pub const VM = Engine.VM;
 pub const Env = Engine.Env;
 
+pub const Inspector = Engine.Inspector;
+pub const InspectorOnResponseFn = *const fn (ctx: *anyopaque, call_id: u32, msg: []const u8) void;
+pub const InspectorOnEventFn = *const fn (ctx: *anyopaque, msg: []const u8) void;
+
 pub const engineType = enum {
     v8,
 };

src/engines/v8/v8.zig

@@ -86,6 +86,7 @@ pub const Env = struct {
     isolate_params: v8.CreateParams,
     hscope: v8.HandleScope,
     globals: v8.FunctionTemplate,
+    inspector: ?Inspector = null,
 
     js_ctx: ?v8.Context = null,
 
@@ -152,6 +153,14 @@ pub const Env = struct {
         self.* = undefined;
     }
 
+    pub fn setInspector(self: *Env, inspector: Inspector) void {
+        self.inspector = inspector;
+    }
+
+    pub fn getInspector(self: Env) Inspector {
+        return self.inspector.?;
+    }
+
     pub fn setUserContext(self: *Env, userctx: public.UserContext) anyerror!void {
         self.nat_ctx.userctx = userctx;
     }
@@ -220,6 +229,7 @@ pub const Env = struct {
         // Native context
         self.nat_ctx.stop();
     }
+
     pub fn getGlobal(self: Env) anyerror!Object {
         if (self.js_ctx == null) {
             return error.EnvNotStarted;
@@ -504,3 +514,38 @@ pub fn jsExec(script: []const u8, name: ?[]const u8, isolate: v8.Isolate, js_ctx
     const value = scr.run(js_ctx) catch return error.JSExec;
     return .{ .value = value };
 }
+
+// Inspector
+
+pub const Inspector = struct {
+    inner: *v8.Inspector,
+    session: v8.InspectorSession,
+
+    pub fn init(
+        alloc: std.mem.Allocator,
+        env: Env,
+        ctx: *anyopaque,
+        onResp: public.InspectorOnResponseFn,
+        onEvent: public.InspectorOnEventFn,
+    ) !Inspector {
+        const inner = try alloc.create(v8.Inspector);
+        const channel = v8.InspectorChannel.init(ctx, onResp, onEvent, env.isolate);
+        const client = v8.InspectorClient.init();
+        v8.Inspector.init(inner, client, channel, env.isolate);
+        const session = inner.connect();
+        return .{ .inner = inner, .session = session };
+    }
+
+    pub fn deinit(self: Inspector, alloc: std.mem.Allocator) void {
+        self.inner.deinit();
+        alloc.destroy(self.inner);
+    }
+
+    pub fn contextCreated(self: Inspector, env: Env, name: []const u8, origin: []const u8, auxData: ?[]const u8) void {
+        self.inner.contextCreated(env.js_ctx.?, name, origin, auxData);
+    }
+
+    pub fn send(self: Inspector, msg: []const u8, env: Env) void {
+        return self.session.dispatchProtocolMessage(env.isolate, msg);
+    }
+};