feat: add headers to plugin context type (#232)

Signed-off-by: Dylan Kilkenny <dylankilkenny95@gmail.com>

Author: dylankilkenny

custom-models/plugin-api.ts

@@ -184,12 +184,19 @@ export interface PluginKVStore {
   ): Promise<T | null>;
 }
 
+/**
+ * HTTP headers from the incoming request.
+ * Each header name maps to an array of values (since HTTP headers can have multiple values).
+ */
+export type PluginHeaders = Record<string, string[]>;
+
 /**
  * Plugin context with KV always available for modern plugins.
  */
 export interface PluginContext {
   api: PluginAPI;
   kv: PluginKVStore;
+  headers: PluginHeaders;
   params: any;
 }
 

src/models/plugin-api.ts

@@ -184,13 +184,19 @@ export interface PluginKVStore {
   ): Promise<T | null>;
 }
 
+/**
+ * HTTP headers from the incoming request.
+ * Each header name maps to an array of values (since HTTP headers can have multiple values).
+ */
+export type PluginHeaders = Record<string, string[]>;
+
 /**
  * Plugin context with KV always available for modern plugins.
  */
 export interface PluginContext {
   api: PluginAPI;
   kv: PluginKVStore;
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  headers: PluginHeaders;
   params: any;
 }