feat: add MessageSender of chrome runtime to request context

src/chrome/kernel.ts

@@ -1,3 +1,4 @@
+import type { Request } from '../core';
 import { Kernel } from '../core/kernel';
 
 /**
@@ -19,7 +20,14 @@ export class ChromeKernel<
 		chrome.runtime.onConnect.addListener((port) => {
 			const channelId = port.name as ChannelId;
 			port.onMessage.addListener((message, port) => {
-				this.execute(channelId, message, (payload) => {
+				let payload: Request<EventType>;
+				if (typeof message === 'object') {
+					payload = { ...message, context: port.sender };
+				} else {
+					payload = message;
+				}
+
+				this.execute(channelId, payload, (payload) => {
 					port.postMessage(payload);
 				});
 			});

src/core/types.ts

@@ -1,6 +1,7 @@
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export type Middleware<EventType = any, RequestPayload = any> = (
-	request: Request<EventType, RequestPayload>,
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+export type Middleware<EventType = any, RequestPayload = any, Context = any> = (
+	request: Request<EventType, RequestPayload, Context>,
 	respond: (response: RawResponse) => void,
 	next?: (request: Request<EventType, RequestPayload>) => void,
 ) => Promise<void> | void;
@@ -9,13 +10,21 @@ export type RawRequest<Type = string, Payload = Record<string, unknown>> = {
 	type: Type;
 } & Payload;
 
-export type Request<Type = string, Payload = Record<string, unknown>> = {
+export type Request<
+	Type = string,
+	Payload = Record<string, unknown>,
+	Context = any,
+> = {
 	id: string;
 	/**
 	 * timeout is always passed in the request,
 	 * any timeout-aware middleware can use this one to prevent unexpected retrying/looping
 	 */
 	timeout: number;
+	/**
+	 * Source Context request, e.g. MessageSender for chrome runtime
+	 */
+	context?: Context;
 } & RawRequest<Type, Payload>;
 
 export type RawResponse<Payload = Record<string, unknown>> = {