Inspector: add public interfaces

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

Author: francisbouvier

src/engines/v8/v8.zig

@@ -157,8 +157,8 @@ pub const Env = struct {
         self.inspector = inspector;
     }
 
-    pub fn getInspector(self: Env) Inspector {
-        return self.inspector.?;
+    pub inline fn getInspector(self: Env) ?Inspector {
+        return self.inspector;
     }
 
     pub fn setUserContext(self: *Env, userctx: public.UserContext) anyerror!void {
@@ -527,7 +527,7 @@ pub const Inspector = struct {
         ctx: *anyopaque,
         onResp: public.InspectorOnResponseFn,
         onEvent: public.InspectorOnEventFn,
-    ) !Inspector {
+    ) anyerror!Inspector {
         const inner = try alloc.create(v8.Inspector);
         const channel = v8.InspectorChannel.init(ctx, onResp, onEvent, env.isolate);
         const client = v8.InspectorClient.init();
@@ -545,7 +545,7 @@ pub const Inspector = struct {
         self.inner.contextCreated(env.js_ctx.?, name, origin, auxData);
     }
 
-    pub fn send(self: Inspector, msg: []const u8, env: Env) void {
+    pub fn send(self: Inspector, env: Env, msg: []const u8) void {
         return self.session.dispatchProtocolMessage(env.isolate, msg);
     }
 };

src/interfaces.zig

@@ -46,6 +46,7 @@ pub fn VM(comptime T: type) void {
 
 pub fn Env(
     comptime T: type,
+    comptime Inspector_T: type,
     comptime JSValue_T: type,
     comptime Object_T: type,
 ) void {
@@ -64,6 +65,9 @@ pub fn Env(
 
     assertDecl(T, "bindGlobal", fn (self: *T, ob: anytype) anyerror!void);
 
+    assertDecl(T, "setInspector", fn (self: *T, inspector: Inspector_T) void);
+    assertDecl(T, "getInspector", fn (self: T) callconv(.Inline) ?Inspector_T);
+
     assertDecl(T, "setUserContext", fn (
         self: *T,
         userctx: public.UserContext,
@@ -192,6 +196,33 @@ pub fn CallbackResult(comptime T: type) void {
     // TODO: how to get the result?
 }
 
+pub fn Inspector(comptime T: type, comptime Env_T: type) void {
+
+    // init()
+    assertDecl(T, "init", fn (
+        alloc: std.mem.Allocator,
+        env: Env_T,
+        ctx: *anyopaque,
+        onResp: public.InspectorOnResponseFn,
+        onEvent: public.InspectorOnEventFn,
+    ) anyerror!T);
+
+    // deinit()
+    assertDecl(T, "deinit", fn (self: T, alloc: std.mem.Allocator) void);
+
+    // contextCreated()
+    assertDecl(T, "contextCreated", fn (
+        self: T,
+        env: Env_T,
+        name: []const u8,
+        origin: []const u8,
+        auxData: ?[]const u8,
+    ) void);
+
+    // send()
+    assertDecl(T, "send", fn (self: T, env: Env_T, msg: []const u8) void);
+}
+
 // Utils
 // -----
 

src/private_api.zig

@@ -34,10 +34,13 @@ fn checkInterfaces(engine: anytype) void {
     interfaces.VM(engine.VM);
     interfaces.Env(
         engine.Env,
+        engine.Inspector,
         engine.JSValue,
         engine.Object,
     );
 
+    interfaces.Inspector(engine.Inspector, engine.Env);
+
     // private api
 }