shieldstack-ts 0.1.0

package/examples/demo/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "demo",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint"
+  },
+  "dependencies": {
+    "next": "16.2.2",
+    "react": "19.2.4",
+    "react-dom": "19.2.4",
+    "shieldstack-ts": "file:../../"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.2.2",
+    "typescript": "^5"
+  }
+}

package/examples/demo/public/file.svg

@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

package/examples/demo/public/globe.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

package/examples/demo/public/next.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

package/examples/demo/public/vercel.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

package/examples/demo/public/window.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>

package/examples/demo/src/app/api/chat/route.ts

@@ -0,0 +1,38 @@
+import { ShieldStack, withShield } from 'shieldstack-ts';
+
+const shield = new ShieldStack({
+  pii: { policy: 'redact', emails: true, creditCards: true, phoneNumbers: true },
+  injectionDetection: { threshold: 0.8 },
+  tokenLimiter: { maxTokens: 1000, windowMs: 60000 }
+});
+
+const mockLlmResponse = [
+  "Sure! Here is the data you requested from our internal system:",
+  " The customer email is admin@enterprise.com",
+  " and their phone number is 1-800-555-0199.",
+  " Make sure you don't leak the AWS key: AKIAIOSFODNN7EXAMPLE",
+  " which has full production access. Is there anything else you need?"
+];
+
+function createMockStream(): ReadableStream<Uint8Array> {
+  const encoder = new TextEncoder();
+  return new ReadableStream({
+    async start(controller) {
+      for (const chunk of mockLlmResponse) {
+        controller.enqueue(encoder.encode(chunk));
+        await new Promise(r => setTimeout(r, 200));
+      }
+      controller.close();
+    }
+  });
+}
+
+async function chatHandler(req: Request) {
+  const stream = createMockStream();
+  
+  return new Response(stream, {
+    headers: { 'Content-Type': 'text/plain; charset=utf-8' }
+  });
+}
+
+export const POST = withShield(shield, chatHandler);

package/examples/demo/src/app/globals.css

@@ -0,0 +1,75 @@
+:root {
+  --bg-color: #f7f9fc;
+  --surface-color: #ffffff;
+  --text-active: #1f2937;
+  --text-muted: #6b7280;
+  --accent-color: #3b82f6; /* Trust blue */
+  --border-color: #e5e7eb;
+  --shadow-sm: 0 4px 6px -1px rgb(0 0 0 / 0.05), 0 2px 4px -2px rgb(0 0 0 / 0.05);
+  --shadow-lg: 0 20px 25px -5px rgb(0 0 0 / 0.05), 0 8px 10px -6px rgb(0 0 0 / 0.05);
+  --glass-bg: rgba(255, 255, 255, 0.85);
+  --glass-border: rgba(255, 255, 255, 0.4);
+}
+
+html, body {
+  width: 100vw;
+  height: 100vh;
+  margin: 0;
+  padding: 0;
+  font-family: var(--font-geist-sans), 'Inter', sans-serif;
+  background-color: var(--bg-color);
+  color: var(--text-active);
+  -webkit-font-smoothing: antialiased;
+  overflow: hidden;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+.premium-container {
+  display: flex;
+  height: 100vh;
+  align-items: center;
+  justify-content: center;
+  background: radial-gradient(circle at top, #ffffff, #f7f9fc);
+}
+
+.glass-panel {
+  background: var(--glass-bg);
+  backdrop-filter: blur(12px);
+  -webkit-backdrop-filter: blur(12px);
+  border: 1px solid var(--glass-border);
+  box-shadow: var(--shadow-lg);
+  border-radius: 24px;
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+  transition: transform 0.2s ease-out;
+}
+
+.button-premium {
+  background: linear-gradient(135deg, #3b82f6, #2563eb);
+  color: white;
+  border: none;
+  padding: 12px 24px;
+  border-radius: 12px;
+  font-weight: 500;
+  cursor: pointer;
+  box-shadow: 0 4px 14px 0 rgba(59, 130, 246, 0.39);
+  transition: all 0.2s ease;
+}
+
+.button-premium:hover {
+  transform: translateY(-1px);
+  box-shadow: 0 6px 20px rgba(59, 130, 246, 0.45);
+}
+
+.message-box {
+  animation: fadeIn 0.3s ease-out forwards;
+}
+
+@keyframes fadeIn {
+  from { opacity: 0; transform: translateY(10px); }
+  to { opacity: 1; transform: translateY(0); }
+}

package/examples/demo/src/app/layout.tsx

@@ -0,0 +1,30 @@
+import type { Metadata } from "next";
+import { Geist, Geist_Mono } from "next/font/google";
+import "./globals.css";
+
+const geistSans = Geist({
+  variable: "--font-geist-sans",
+  subsets: ["latin"],
+});
+
+const geistMono = Geist_Mono({
+  variable: "--font-geist-mono",
+  subsets: ["latin"],
+});
+
+export const metadata: Metadata = {
+  title: "ShieldStack Trust Terminal",
+  description: "LLM security middleware demo",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en" className={`${geistSans.variable} ${geistMono.variable}`}>
+      <body>{children}</body>
+    </html>
+  );
+}

package/examples/demo/src/app/page.module.css

@@ -0,0 +1,142 @@
+.page {
+  --background: #fafafa;
+  --foreground: #fff;
+
+  --text-primary: #000;
+  --text-secondary: #666;
+
+  --button-primary-hover: #383838;
+  --button-secondary-hover: #f2f2f2;
+  --button-secondary-border: #ebebeb;
+
+  display: flex;
+  flex: 1;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  font-family: var(--font-geist-sans);
+  background-color: var(--background);
+}
+
+.main {
+  display: flex;
+  flex: 1;
+  width: 100%;
+  max-width: 800px;
+  flex-direction: column;
+  align-items: flex-start;
+  justify-content: space-between;
+  background-color: var(--foreground);
+  padding: 120px 60px;
+}
+
+.intro {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  text-align: left;
+  gap: 24px;
+}
+
+.intro h1 {
+  max-width: 320px;
+  font-size: 40px;
+  font-weight: 600;
+  line-height: 48px;
+  letter-spacing: -2.4px;
+  text-wrap: balance;
+  color: var(--text-primary);
+}
+
+.intro p {
+  max-width: 440px;
+  font-size: 18px;
+  line-height: 32px;
+  text-wrap: balance;
+  color: var(--text-secondary);
+}
+
+.intro a {
+  font-weight: 500;
+  color: var(--text-primary);
+}
+
+.ctas {
+  display: flex;
+  flex-direction: row;
+  width: 100%;
+  max-width: 440px;
+  gap: 16px;
+  font-size: 14px;
+}
+
+.ctas a {
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  height: 40px;
+  padding: 0 16px;
+  border-radius: 128px;
+  border: 1px solid transparent;
+  transition: 0.2s;
+  cursor: pointer;
+  width: fit-content;
+  font-weight: 500;
+}
+
+a.primary {
+  background: var(--text-primary);
+  color: var(--background);
+  gap: 8px;
+}
+
+a.secondary {
+  border-color: var(--button-secondary-border);
+}
+
+/* Enable hover only on non-touch devices */
+@media (hover: hover) and (pointer: fine) {
+  a.primary:hover {
+    background: var(--button-primary-hover);
+    border-color: transparent;
+  }
+
+  a.secondary:hover {
+    background: var(--button-secondary-hover);
+    border-color: transparent;
+  }
+}
+
+@media (max-width: 600px) {
+  .main {
+    padding: 48px 24px;
+  }
+
+  .intro {
+    gap: 16px;
+  }
+
+  .intro h1 {
+    font-size: 32px;
+    line-height: 40px;
+    letter-spacing: -1.92px;
+  }
+}
+
+@media (prefers-color-scheme: dark) {
+  .logo {
+    filter: invert();
+  }
+
+  .page {
+    --background: #000;
+    --foreground: #000;
+
+    --text-primary: #ededed;
+    --text-secondary: #999;
+
+    --button-primary-hover: #ccc;
+    --button-secondary-hover: #1a1a1a;
+    --button-secondary-border: #1a1a1a;
+  }
+}

package/examples/demo/src/app/page.tsx

@@ -0,0 +1,162 @@
+'use client';
+
+import { useState, useRef, useEffect } from 'react';
+
+export default function Home() {
+  const [messages, setMessages] = useState<{role: 'user' | 'assistant', content: string}[]>([]);
+  const [input, setInput] = useState('');
+  const [isLoading, setIsLoading] = useState(false);
+  const [errorStatus, setErrorStatus] = useState<string | null>(null);
+  const messagesEndRef = useRef<HTMLDivElement>(null);
+
+  const scrollToBottom = () => {
+    messagesEndRef.current?.scrollIntoView({ behavior: 'smooth' });
+  };
+
+  useEffect(() => {
+    scrollToBottom();
+  }, [messages]);
+
+  const handleSubmit = async (e: React.FormEvent) => {
+    e.preventDefault();
+    if (!input.trim() || isLoading) return;
+
+    const userMessage = input;
+    setInput('');
+    setMessages(prev => [...prev, { role: 'user', content: userMessage }]);
+    setErrorStatus(null);
+    setIsLoading(true);
+
+    try {
+      const response = await fetch('/api/chat', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ message: userMessage })
+      });
+
+      if (!response.ok) {
+        let errJson = { error: 'Unknown Error' };
+        try { errJson = await response.json(); } catch(e) {}
+        setErrorStatus(`Shield Blocked: ${errJson.error}`);
+        setIsLoading(false);
+        return;
+      }
+
+      setMessages(prev => [...prev, { role: 'assistant', content: '' }]);
+      
+      const reader = response.body?.getReader();
+      const decoder = new TextDecoder();
+      
+      if (reader) {
+        let done = false;
+        while (!done) {
+          const { value, done: doneReading } = await reader.read();
+          done = doneReading;
+          if (value) {
+            const chunkValue = decoder.decode(value, { stream: true });
+            setMessages(prev => {
+              const newMsgs = [...prev];
+              const lastIndex = newMsgs.length - 1;
+              newMsgs[lastIndex] = { 
+                ...newMsgs[lastIndex], 
+                content: newMsgs[lastIndex].content + chunkValue 
+              };
+              return newMsgs;
+            });
+          }
+        }
+      }
+    } catch (err) {
+      setErrorStatus('Connection failed. Please ensure the backend is running.');
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  return (
+    <main className="premium-container">
+      <div className="glass-panel" style={{ width: '100%', maxWidth: '800px', height: '80vh' }}>
+        
+        <header style={{ padding: '24px', borderBottom: '1px solid var(--border-color)', display: 'flex', alignItems: 'center', justifyContent: 'space-between' }}>
+          <div style={{ display: 'flex', alignItems: 'center', gap: '12px' }}>
+            <div style={{ width: '32px', height: '32px', borderRadius: '8px', background: 'var(--accent-color)', display: 'flex', alignItems: 'center', justifyContent: 'center', color: 'white', fontWeight: 'bold' }}>S</div>
+            <div>
+              <h1 style={{ fontSize: '1.25rem', fontWeight: 600, margin: 0, color: 'var(--text-active)' }}>ShieldStack Trust Terminal</h1>
+              <p style={{ fontSize: '0.875rem', color: 'var(--text-muted)', margin: 0 }}>Secure Edge Execution</p>
+            </div>
+          </div>
+          <div style={{ fontSize: '0.75rem', padding: '4px 8px', borderRadius: '12px', background: 'rgba(59, 130, 246, 0.1)', color: 'var(--accent-color)', fontWeight: 600 }}>Active Shield</div>
+        </header>
+
+        <div style={{ flex: 1, overflowY: 'auto', padding: '24px', display: 'flex', flexDirection: 'column', gap: '16px' }}>
+          {messages.length === 0 && (
+            <div style={{ margin: 'auto', textAlign: 'center', color: 'var(--text-muted)' }}>
+              <p>Type a prompt to test the protection.</p>
+              <p style={{ fontSize: '0.875rem', marginTop: '8px' }}>E.g. Try sending fake PII, or typing "Ignore previous instructions"</p>
+            </div>
+          )}
+          
+          {messages.map((msg, i) => (
+            <div key={i} className="message-box" style={{ 
+              alignSelf: msg.role === 'user' ? 'flex-end' : 'flex-start',
+              background: msg.role === 'user' ? 'var(--accent-color)' : '#ffffff',
+              color: msg.role === 'user' ? 'white' : 'var(--text-active)',
+              padding: '12px 16px',
+              borderRadius: '12px',
+              maxWidth: '80%',
+              boxShadow: 'var(--shadow-sm)',
+              border: msg.role === 'user' ? 'none' : '1px solid var(--border-color)'
+            }}>
+              {msg.content}
+            </div>
+          ))}
+
+          {errorStatus && (
+            <div className="message-box" style={{ 
+              alignSelf: 'center',
+              background: '#fee2e2',
+              color: '#991b1b',
+              padding: '12px 16px',
+              borderRadius: '8px',
+              fontSize: '0.875rem',
+              fontWeight: 500,
+              maxWidth: '90%',
+              border: '1px solid #fecaca'
+            }}>
+              ⚠️ {errorStatus}
+            </div>
+          )}
+          <div ref={messagesEndRef} />
+        </div>
+
+        {/* Input Area */}
+        <div style={{ padding: '24px', borderTop: '1px solid var(--border-color)', background: '#ffffff' }}>
+          <form onSubmit={handleSubmit} style={{ display: 'flex', gap: '12px' }}>
+            <input 
+              type="text" 
+              value={input}
+              onChange={e => setInput(e.target.value)}
+              placeholder="Test the shield..."
+              disabled={isLoading}
+              style={{ 
+                flex: 1, 
+                padding: '12px 16px', 
+                borderRadius: '12px', 
+                border: '1px solid var(--border-color)', 
+                outline: 'none',
+                background: '#f9fafb',
+                fontFamily: 'inherit',
+                fontSize: '1rem',
+                color: 'var(--text-active)'
+              }}
+            />
+            <button type="submit" className="button-premium" disabled={isLoading || !input.trim()}>
+              {isLoading ? 'Scanning...' : 'Send'}
+            </button>
+          </form>
+        </div>
+
+      </div>
+    </main>
+  );
+}

package/examples/demo/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "shieldstack-ts",
+  "version": "0.1.0",
+  "description": "High-performance TypeScript-native LLM security & observability middleware",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/ --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "typecheck": "tsc --noEmit"
+  },
+  "author": "Ali Shuja <alishujawork@gmail.com>",
+  "license": "MIT",
+  "keywords": ["llm", "security", "middleware", "pii", "privacy", "openai", "typescript", "edge"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ShujaSN/shieldstack-ts"
+  },
+  "dependencies": {
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.12.7",
+    "@typescript-eslint/eslint-plugin": "^7.6.0",
+    "@typescript-eslint/parser": "^7.6.0",
+    "eslint": "^8.57.0",
+    "prettier": "^3.2.5",
+    "tsup": "^8.1.0",
+    "typescript": "^5.4.5",
+    "vitest": "^1.5.0"
+  }
+}

package/src/adapters/express.ts

@@ -0,0 +1,28 @@
+import { ShieldStack } from '../core/ShieldStack';
+
+export function expressShield(shield: ShieldStack) {
+  return async (req: any, res: any, next: any) => {
+    try {
+      const identifier = req.ip || 'anonymous';
+      
+      if (req.body) {
+        const payloadStr = typeof req.body === 'string' ? req.body : JSON.stringify(req.body);
+        const safePayload = await shield.evaluateRequest(payloadStr, identifier);
+        
+        if (typeof req.body === 'string') {
+          req.body = safePayload;
+        } else {
+          try {
+            req.body = JSON.parse(safePayload);
+          } catch(e) {
+            req.body = safePayload;
+          }
+        }
+      }
+      next();
+    } catch (error: any) {
+      shield.logger.error('express_shield_blocked', error.message);
+      res.status(403).json({ error: error.message });
+    }
+  };
+}

package/src/adapters/hono.ts

@@ -0,0 +1,22 @@
+import { ShieldStack } from '../core/ShieldStack';
+
+export function honoShield(shield: ShieldStack) {
+  return async (c: any, next: any) => {
+    try {
+      const req: Request = c.req.raw;
+      const identifier = c.req.header('cf-connecting-ip') || 'anonymous';
+      const text = await c.req.raw.clone().text();
+      if (text) await shield.evaluateRequest(text, identifier);
+      
+      await next();
+
+      if (c.res && c.res.body instanceof ReadableStream) {
+        const streamSanitizer = shield.createStreamSanitizer();
+        c.res = new Response(c.res.body.pipeThrough(streamSanitizer), c.res);
+      }
+    } catch (error: any) {
+      shield.logger.error('hono_shield_blocked', error.message);
+      return c.json({ error: error.message }, 403);
+    }
+  };
+}

package/src/adapters/index.ts

@@ -0,0 +1,4 @@
+// Framework specific adapters (Hono, Next.js, Express)
+export * from './hono';
+export * from './next';
+export * from './express';

package/src/adapters/next.ts

@@ -0,0 +1,26 @@
+import { ShieldStack } from '../core/ShieldStack';
+
+export function withShield(shield: ShieldStack, handler: (req: Request, ...args: any[]) => Promise<Response>) {
+  return async (req: Request, ...args: any[]) => {
+    try {
+      const identifier = req.headers.get('x-forwarded-for') || 'anonymous';
+      
+      if (req.clone().body) {
+         const text = await req.clone().text();
+         if (text) await shield.evaluateRequest(text, identifier);
+      }
+
+      const response = await handler(req, ...args);
+
+      if (response.body) {
+        const streamSanitizer = shield.createStreamSanitizer();
+        return new Response(response.body.pipeThrough(streamSanitizer), response);
+      }
+
+      return response;
+    } catch (error: any) {
+      shield.logger.error('next_shield_blocked', error.message);
+      return new Response(JSON.stringify({ error: error.message }), { status: 403, headers: { 'Content-Type': 'application/json' }});
+    }
+  };
+}