@kya-os/agentshield-nextjs 0.1.7

package/dist/index.js

@@ -0,0 +1,198 @@
+'use strict';
+
+var server = require('next/server');
+var agentshield = require('@kya-os/agentshield');
+var react = require('react');
+
+// src/middleware.ts
+function createAgentShieldMiddleware(config = {}) {
+  const detector = new agentshield.AgentDetector(config);
+  if (config.events) {
+    Object.entries(config.events).forEach(([event, handler]) => {
+      detector.on(event, handler);
+    });
+  }
+  const {
+    onAgentDetected = "log",
+    onDetection,
+    skipPaths = [],
+    blockedResponse = {
+      status: 403,
+      message: "Access denied: Automated agent detected",
+      headers: { "Content-Type": "application/json" }
+    },
+    redirectUrl = "/blocked",
+    rewriteUrl = "/blocked"
+  } = config;
+  return async (request) => {
+    try {
+      const shouldSkip = skipPaths.some((pattern) => {
+        if (typeof pattern === "string") {
+          return request.nextUrl.pathname.startsWith(pattern);
+        }
+        return pattern.test(request.nextUrl.pathname);
+      });
+      if (shouldSkip) {
+        request.agentShield = { skipped: true };
+        return server.NextResponse.next();
+      }
+      const context = {
+        userAgent: request.headers.get("user-agent") ?? void 0,
+        ipAddress: request.ip ?? request.headers.get("x-forwarded-for") ?? void 0,
+        headers: Object.fromEntries(request.headers.entries()),
+        url: request.url,
+        method: request.method,
+        timestamp: /* @__PURE__ */ new Date()
+      };
+      const result = await detector.analyze(context);
+      if (result.isAgent && result.confidence >= (config.confidenceThreshold ?? 0.7)) {
+        if (onDetection) {
+          const customResponse = await onDetection(request, result);
+          if (customResponse) {
+            return customResponse;
+          }
+        }
+        switch (onAgentDetected) {
+          case "block": {
+            const response2 = server.NextResponse.json(
+              {
+                error: blockedResponse.message,
+                detected: true,
+                confidence: result.confidence,
+                timestamp: result.timestamp
+              },
+              { status: blockedResponse.status }
+            );
+            if (blockedResponse.headers) {
+              Object.entries(blockedResponse.headers).forEach(
+                ([key, value]) => {
+                  response2.headers.set(key, value);
+                }
+              );
+            }
+            detector.emit("agent.blocked", result, context);
+            return response2;
+          }
+          case "redirect":
+            return server.NextResponse.redirect(new URL(redirectUrl, request.url));
+          case "rewrite":
+            return server.NextResponse.rewrite(new URL(rewriteUrl, request.url));
+          case "log":
+            console.warn("AgentShield: Agent detected", {
+              ipAddress: context.ipAddress,
+              userAgent: context.userAgent,
+              confidence: result.confidence,
+              reasons: result.reasons,
+              pathname: request.nextUrl.pathname
+            });
+            break;
+          case "allow":
+          default:
+            if (result.isAgent && result.confidence >= (config.confidenceThreshold ?? 0.7)) {
+              detector.emit("agent.allowed", result, context);
+            }
+            break;
+        }
+      }
+      request.agentShield = {
+        result,
+        skipped: false
+      };
+      const response = server.NextResponse.next();
+      response.headers.set("x-agentshield-detected", result.isAgent.toString());
+      response.headers.set(
+        "x-agentshield-confidence",
+        result.confidence.toString()
+      );
+      return response;
+    } catch (error) {
+      console.error("AgentShield middleware error:", error);
+      return server.NextResponse.next();
+    }
+  };
+}
+function agentShield(config = {}) {
+  return createAgentShieldMiddleware(config);
+}
+function useAgentDetection(config = {}) {
+  const [detector] = react.useState(() => new agentshield.AgentDetector(config));
+  const [isDetecting, setIsDetecting] = react.useState(false);
+  const [lastResult, setLastResult] = react.useState(null);
+  const detect = react.useCallback(async () => {
+    setIsDetecting(true);
+    try {
+      const context = {
+        userAgent: navigator.userAgent,
+        headers: {},
+        // Client-side headers are limited
+        timestamp: /* @__PURE__ */ new Date()
+      };
+      const result = await detector.analyze(context);
+      setLastResult(result);
+      return result;
+    } finally {
+      setIsDetecting(false);
+    }
+  }, [detector]);
+  return {
+    detect,
+    isDetecting,
+    lastResult,
+    detector
+  };
+}
+function useDetectionMonitor(onDetection) {
+  const [detectionHistory, setDetectionHistory] = react.useState(
+    []
+  );
+  const addDetection = react.useCallback(
+    (result, request) => {
+      setDetectionHistory((prev) => [...prev, result].slice(-100));
+      if (onDetection && request) {
+        onDetection({
+          result,
+          request,
+          userAgent: request.headers?.get?.("user-agent"),
+          ip: request.ip
+        });
+      }
+    },
+    [onDetection]
+  );
+  const clearHistory = react.useCallback(() => {
+    setDetectionHistory([]);
+  }, []);
+  const getStats = react.useCallback(() => {
+    const total = detectionHistory.length;
+    const detected = detectionHistory.filter((r) => r.isAgent).length;
+    const avgConfidence = total > 0 ? detectionHistory.reduce((sum, r) => sum + r.confidence, 0) / total : 0;
+    return {
+      total,
+      detected,
+      avgConfidence,
+      detectionRate: total > 0 ? detected / total : 0
+    };
+  }, [detectionHistory]);
+  return {
+    detectionHistory,
+    addDetection,
+    clearHistory,
+    getStats
+  };
+}
+
+// src/index.ts
+var VERSION = "0.1.0";
+/**
+ * @fileoverview AgentShield Next.js Integration
+ * @version 0.1.0
+ * @license MIT OR Apache-2.0
+ */
+
+exports.VERSION = VERSION;
+exports.agentShield = agentShield;
+exports.createAgentShieldMiddleware = createAgentShieldMiddleware;
+exports.useAgentDetection = useAgentDetection;
+exports.useDetectionMonitor = useDetectionMonitor;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/middleware.ts","../src/hooks.ts","../src/index.ts"],"names":["AgentDetector","NextResponse","response","useState","useCallback"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Next.js middleware for AgentShield\n */\n\nimport { NextRequest, NextResponse } from 'next/server';\nimport { AgentDetector } from '@kya-os/agentshield';\nimport type { NextJSMiddlewareConfig } from './types';\n\n/**\n * Create AgentShield middleware for Next.js\n */\nexport function createAgentShieldMiddleware(\n  config: Partial<NextJSMiddlewareConfig> = {}\n) {\n  const detector = new AgentDetector(config);\n  \n  // Wire up event handlers if provided\n  if (config.events) {\n    Object.entries(config.events).forEach(([event, handler]) => {\n      detector.on(event as any, handler as any);\n    });\n  }\n\n  const {\n    onAgentDetected = 'log',\n    onDetection,\n    skipPaths = [],\n    blockedResponse = {\n      status: 403,\n      message: 'Access denied: Automated agent detected',\n      headers: { 'Content-Type': 'application/json' },\n    },\n    redirectUrl = '/blocked',\n    rewriteUrl = '/blocked',\n  } = config;\n\n  return async (request: NextRequest): Promise<NextResponse> => {\n    try {\n      // Check if path should be skipped\n      const shouldSkip = skipPaths.some(pattern => {\n        if (typeof pattern === 'string') {\n          return request.nextUrl.pathname.startsWith(pattern);\n        }\n        return pattern.test(request.nextUrl.pathname);\n      });\n\n      if (shouldSkip) {\n        // Mark as skipped in request\n        (request as any).agentShield = { skipped: true };\n        return NextResponse.next();\n      }\n\n      // Prepare request context\n      const context = {\n        userAgent: request.headers.get('user-agent') ?? undefined,\n        ipAddress: request.ip ?? request.headers.get('x-forwarded-for') ?? undefined,\n        headers: Object.fromEntries(request.headers.entries()),\n        url: request.url,\n        method: request.method,\n        timestamp: new Date(),\n      };\n\n      // Analyze request\n      const result = await detector.analyze(context);\n\n      // Handle detection result\n      if (\n        result.isAgent &&\n        result.confidence >= (config.confidenceThreshold ?? 0.7)\n      ) {\n        // Call custom detection handler if provided\n        if (onDetection) {\n          const customResponse = await onDetection(request, result);\n          if (customResponse) {\n            return customResponse;\n          }\n        }\n\n        // Handle based on configuration\n        switch (onAgentDetected) {\n          case 'block': {\n            const response = NextResponse.json(\n              {\n                error: blockedResponse.message,\n                detected: true,\n                confidence: result.confidence,\n                timestamp: result.timestamp,\n              },\n              { status: blockedResponse.status }\n            );\n\n            if (blockedResponse.headers) {\n              Object.entries(blockedResponse.headers).forEach(\n                ([key, value]) => {\n                  response.headers.set(key, value);\n                }\n              );\n            }\n            \n            // Emit blocked event\n            detector.emit('agent.blocked', result, context);\n\n            return response;\n          }\n\n          case 'redirect':\n            return NextResponse.redirect(new URL(redirectUrl, request.url));\n\n          case 'rewrite':\n            return NextResponse.rewrite(new URL(rewriteUrl, request.url));\n\n          case 'log':\n            console.warn('AgentShield: Agent detected', {\n              ipAddress: context.ipAddress,\n              userAgent: context.userAgent,\n              confidence: result.confidence,\n              reasons: result.reasons,\n              pathname: request.nextUrl.pathname,\n            });\n            break;\n\n          case 'allow':\n          default:\n            // Emit allowed event for high-confidence agents\n            if (result.isAgent && result.confidence >= (config.confidenceThreshold ?? 0.7)) {\n              detector.emit('agent.allowed', result, context);\n            }\n            // Continue processing\n            break;\n        }\n      }\n\n      // Add detection result to request for API routes\n      (request as any).agentShield = {\n        result,\n        skipped: false,\n      };\n\n      // Add detection result to response headers for debugging\n      const response = NextResponse.next();\n      response.headers.set('x-agentshield-detected', result.isAgent.toString());\n      response.headers.set(\n        'x-agentshield-confidence',\n        result.confidence.toString()\n      );\n\n      return response;\n    } catch (error) {\n      console.error('AgentShield middleware error:', error);\n      return NextResponse.next(); // Continue on error\n    }\n  };\n}\n\n/**\n * Convenience function for basic setup\n */\nexport function agentShield(config: Partial<NextJSMiddlewareConfig> = {}) {\n  return createAgentShieldMiddleware(config);\n}\n","/**\n * React hooks for AgentShield in Next.js applications\n */\n\nimport { useState, useCallback } from 'react';\nimport { AgentDetector } from '@kya-os/agentshield';\nimport type { DetectionResult, AgentShieldConfig } from '@kya-os/agentshield';\nimport type { DetectionContext } from './types';\n\n/**\n * Hook for client-side agent detection\n */\nexport function useAgentDetection(config: Partial<AgentShieldConfig> = {}) {\n  const [detector] = useState(() => new AgentDetector(config));\n  const [isDetecting, setIsDetecting] = useState(false);\n  const [lastResult, setLastResult] = useState<DetectionResult | null>(null);\n\n  const detect = useCallback(async () => {\n    setIsDetecting(true);\n    try {\n      const context = {\n        userAgent: navigator.userAgent,\n        headers: {}, // Client-side headers are limited\n        timestamp: new Date(),\n      };\n\n      const result = await detector.analyze(context);\n      setLastResult(result);\n      return result;\n    } finally {\n      setIsDetecting(false);\n    }\n  }, [detector]);\n\n  return {\n    detect,\n    isDetecting,\n    lastResult,\n    detector,\n  };\n}\n\n/**\n * Hook for monitoring detection results\n */\nexport function useDetectionMonitor(\n  onDetection?: (context: DetectionContext) => void\n) {\n  const [detectionHistory, setDetectionHistory] = useState<DetectionResult[]>(\n    []\n  );\n\n  const addDetection = useCallback(\n    (result: DetectionResult, request?: any) => {\n      setDetectionHistory(prev => [...prev, result].slice(-100)); // Keep last 100\n\n      if (onDetection && request) {\n        onDetection({\n          result,\n          request,\n          userAgent: request.headers?.get?.('user-agent'),\n          ip: request.ip,\n        });\n      }\n    },\n    [onDetection]\n  );\n\n  const clearHistory = useCallback(() => {\n    setDetectionHistory([]);\n  }, []);\n\n  const getStats = useCallback(() => {\n    const total = detectionHistory.length;\n    const detected = detectionHistory.filter(r => r.isAgent).length;\n    const avgConfidence =\n      total > 0\n        ? detectionHistory.reduce((sum, r) => sum + r.confidence, 0) / total\n        : 0;\n\n    return {\n      total,\n      detected,\n      avgConfidence,\n      detectionRate: total > 0 ? detected / total : 0,\n    };\n  }, [detectionHistory]);\n\n  return {\n    detectionHistory,\n    addDetection,\n    clearHistory,\n    getStats,\n  };\n}\n","/**\n * @fileoverview AgentShield Next.js Integration\n * @version 0.1.0\n * @license MIT OR Apache-2.0\n */\n\nexport * from './middleware';\nexport * from './types';\nexport * from './hooks';\n\n/**\n * Library version\n */\nexport const VERSION = '0.1.0';\n"]}

package/dist/index.mjs

@@ -0,0 +1,192 @@
+import { NextResponse } from 'next/server';
+import { AgentDetector } from '@kya-os/agentshield';
+import { useState, useCallback } from 'react';
+
+// src/middleware.ts
+function createAgentShieldMiddleware(config = {}) {
+  const detector = new AgentDetector(config);
+  if (config.events) {
+    Object.entries(config.events).forEach(([event, handler]) => {
+      detector.on(event, handler);
+    });
+  }
+  const {
+    onAgentDetected = "log",
+    onDetection,
+    skipPaths = [],
+    blockedResponse = {
+      status: 403,
+      message: "Access denied: Automated agent detected",
+      headers: { "Content-Type": "application/json" }
+    },
+    redirectUrl = "/blocked",
+    rewriteUrl = "/blocked"
+  } = config;
+  return async (request) => {
+    try {
+      const shouldSkip = skipPaths.some((pattern) => {
+        if (typeof pattern === "string") {
+          return request.nextUrl.pathname.startsWith(pattern);
+        }
+        return pattern.test(request.nextUrl.pathname);
+      });
+      if (shouldSkip) {
+        request.agentShield = { skipped: true };
+        return NextResponse.next();
+      }
+      const context = {
+        userAgent: request.headers.get("user-agent") ?? void 0,
+        ipAddress: request.ip ?? request.headers.get("x-forwarded-for") ?? void 0,
+        headers: Object.fromEntries(request.headers.entries()),
+        url: request.url,
+        method: request.method,
+        timestamp: /* @__PURE__ */ new Date()
+      };
+      const result = await detector.analyze(context);
+      if (result.isAgent && result.confidence >= (config.confidenceThreshold ?? 0.7)) {
+        if (onDetection) {
+          const customResponse = await onDetection(request, result);
+          if (customResponse) {
+            return customResponse;
+          }
+        }
+        switch (onAgentDetected) {
+          case "block": {
+            const response2 = NextResponse.json(
+              {
+                error: blockedResponse.message,
+                detected: true,
+                confidence: result.confidence,
+                timestamp: result.timestamp
+              },
+              { status: blockedResponse.status }
+            );
+            if (blockedResponse.headers) {
+              Object.entries(blockedResponse.headers).forEach(
+                ([key, value]) => {
+                  response2.headers.set(key, value);
+                }
+              );
+            }
+            detector.emit("agent.blocked", result, context);
+            return response2;
+          }
+          case "redirect":
+            return NextResponse.redirect(new URL(redirectUrl, request.url));
+          case "rewrite":
+            return NextResponse.rewrite(new URL(rewriteUrl, request.url));
+          case "log":
+            console.warn("AgentShield: Agent detected", {
+              ipAddress: context.ipAddress,
+              userAgent: context.userAgent,
+              confidence: result.confidence,
+              reasons: result.reasons,
+              pathname: request.nextUrl.pathname
+            });
+            break;
+          case "allow":
+          default:
+            if (result.isAgent && result.confidence >= (config.confidenceThreshold ?? 0.7)) {
+              detector.emit("agent.allowed", result, context);
+            }
+            break;
+        }
+      }
+      request.agentShield = {
+        result,
+        skipped: false
+      };
+      const response = NextResponse.next();
+      response.headers.set("x-agentshield-detected", result.isAgent.toString());
+      response.headers.set(
+        "x-agentshield-confidence",
+        result.confidence.toString()
+      );
+      return response;
+    } catch (error) {
+      console.error("AgentShield middleware error:", error);
+      return NextResponse.next();
+    }
+  };
+}
+function agentShield(config = {}) {
+  return createAgentShieldMiddleware(config);
+}
+function useAgentDetection(config = {}) {
+  const [detector] = useState(() => new AgentDetector(config));
+  const [isDetecting, setIsDetecting] = useState(false);
+  const [lastResult, setLastResult] = useState(null);
+  const detect = useCallback(async () => {
+    setIsDetecting(true);
+    try {
+      const context = {
+        userAgent: navigator.userAgent,
+        headers: {},
+        // Client-side headers are limited
+        timestamp: /* @__PURE__ */ new Date()
+      };
+      const result = await detector.analyze(context);
+      setLastResult(result);
+      return result;
+    } finally {
+      setIsDetecting(false);
+    }
+  }, [detector]);
+  return {
+    detect,
+    isDetecting,
+    lastResult,
+    detector
+  };
+}
+function useDetectionMonitor(onDetection) {
+  const [detectionHistory, setDetectionHistory] = useState(
+    []
+  );
+  const addDetection = useCallback(
+    (result, request) => {
+      setDetectionHistory((prev) => [...prev, result].slice(-100));
+      if (onDetection && request) {
+        onDetection({
+          result,
+          request,
+          userAgent: request.headers?.get?.("user-agent"),
+          ip: request.ip
+        });
+      }
+    },
+    [onDetection]
+  );
+  const clearHistory = useCallback(() => {
+    setDetectionHistory([]);
+  }, []);
+  const getStats = useCallback(() => {
+    const total = detectionHistory.length;
+    const detected = detectionHistory.filter((r) => r.isAgent).length;
+    const avgConfidence = total > 0 ? detectionHistory.reduce((sum, r) => sum + r.confidence, 0) / total : 0;
+    return {
+      total,
+      detected,
+      avgConfidence,
+      detectionRate: total > 0 ? detected / total : 0
+    };
+  }, [detectionHistory]);
+  return {
+    detectionHistory,
+    addDetection,
+    clearHistory,
+    getStats
+  };
+}
+
+// src/index.ts
+var VERSION = "0.1.0";
+/**
+ * @fileoverview AgentShield Next.js Integration
+ * @version 0.1.0
+ * @license MIT OR Apache-2.0
+ */
+
+export { VERSION, agentShield, createAgentShieldMiddleware, useAgentDetection, useDetectionMonitor };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/middleware.ts","../src/hooks.ts","../src/index.ts"],"names":["response","AgentDetector"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Next.js middleware for AgentShield\n */\n\nimport { NextRequest, NextResponse } from 'next/server';\nimport { AgentDetector } from '@kya-os/agentshield';\nimport type { NextJSMiddlewareConfig } from './types';\n\n/**\n * Create AgentShield middleware for Next.js\n */\nexport function createAgentShieldMiddleware(\n  config: Partial<NextJSMiddlewareConfig> = {}\n) {\n  const detector = new AgentDetector(config);\n  \n  // Wire up event handlers if provided\n  if (config.events) {\n    Object.entries(config.events).forEach(([event, handler]) => {\n      detector.on(event as any, handler as any);\n    });\n  }\n\n  const {\n    onAgentDetected = 'log',\n    onDetection,\n    skipPaths = [],\n    blockedResponse = {\n      status: 403,\n      message: 'Access denied: Automated agent detected',\n      headers: { 'Content-Type': 'application/json' },\n    },\n    redirectUrl = '/blocked',\n    rewriteUrl = '/blocked',\n  } = config;\n\n  return async (request: NextRequest): Promise<NextResponse> => {\n    try {\n      // Check if path should be skipped\n      const shouldSkip = skipPaths.some(pattern => {\n        if (typeof pattern === 'string') {\n          return request.nextUrl.pathname.startsWith(pattern);\n        }\n        return pattern.test(request.nextUrl.pathname);\n      });\n\n      if (shouldSkip) {\n        // Mark as skipped in request\n        (request as any).agentShield = { skipped: true };\n        return NextResponse.next();\n      }\n\n      // Prepare request context\n      const context = {\n        userAgent: request.headers.get('user-agent') ?? undefined,\n        ipAddress: request.ip ?? request.headers.get('x-forwarded-for') ?? undefined,\n        headers: Object.fromEntries(request.headers.entries()),\n        url: request.url,\n        method: request.method,\n        timestamp: new Date(),\n      };\n\n      // Analyze request\n      const result = await detector.analyze(context);\n\n      // Handle detection result\n      if (\n        result.isAgent &&\n        result.confidence >= (config.confidenceThreshold ?? 0.7)\n      ) {\n        // Call custom detection handler if provided\n        if (onDetection) {\n          const customResponse = await onDetection(request, result);\n          if (customResponse) {\n            return customResponse;\n          }\n        }\n\n        // Handle based on configuration\n        switch (onAgentDetected) {\n          case 'block': {\n            const response = NextResponse.json(\n              {\n                error: blockedResponse.message,\n                detected: true,\n                confidence: result.confidence,\n                timestamp: result.timestamp,\n              },\n              { status: blockedResponse.status }\n            );\n\n            if (blockedResponse.headers) {\n              Object.entries(blockedResponse.headers).forEach(\n                ([key, value]) => {\n                  response.headers.set(key, value);\n                }\n              );\n            }\n            \n            // Emit blocked event\n            detector.emit('agent.blocked', result, context);\n\n            return response;\n          }\n\n          case 'redirect':\n            return NextResponse.redirect(new URL(redirectUrl, request.url));\n\n          case 'rewrite':\n            return NextResponse.rewrite(new URL(rewriteUrl, request.url));\n\n          case 'log':\n            console.warn('AgentShield: Agent detected', {\n              ipAddress: context.ipAddress,\n              userAgent: context.userAgent,\n              confidence: result.confidence,\n              reasons: result.reasons,\n              pathname: request.nextUrl.pathname,\n            });\n            break;\n\n          case 'allow':\n          default:\n            // Emit allowed event for high-confidence agents\n            if (result.isAgent && result.confidence >= (config.confidenceThreshold ?? 0.7)) {\n              detector.emit('agent.allowed', result, context);\n            }\n            // Continue processing\n            break;\n        }\n      }\n\n      // Add detection result to request for API routes\n      (request as any).agentShield = {\n        result,\n        skipped: false,\n      };\n\n      // Add detection result to response headers for debugging\n      const response = NextResponse.next();\n      response.headers.set('x-agentshield-detected', result.isAgent.toString());\n      response.headers.set(\n        'x-agentshield-confidence',\n        result.confidence.toString()\n      );\n\n      return response;\n    } catch (error) {\n      console.error('AgentShield middleware error:', error);\n      return NextResponse.next(); // Continue on error\n    }\n  };\n}\n\n/**\n * Convenience function for basic setup\n */\nexport function agentShield(config: Partial<NextJSMiddlewareConfig> = {}) {\n  return createAgentShieldMiddleware(config);\n}\n","/**\n * React hooks for AgentShield in Next.js applications\n */\n\nimport { useState, useCallback } from 'react';\nimport { AgentDetector } from '@kya-os/agentshield';\nimport type { DetectionResult, AgentShieldConfig } from '@kya-os/agentshield';\nimport type { DetectionContext } from './types';\n\n/**\n * Hook for client-side agent detection\n */\nexport function useAgentDetection(config: Partial<AgentShieldConfig> = {}) {\n  const [detector] = useState(() => new AgentDetector(config));\n  const [isDetecting, setIsDetecting] = useState(false);\n  const [lastResult, setLastResult] = useState<DetectionResult | null>(null);\n\n  const detect = useCallback(async () => {\n    setIsDetecting(true);\n    try {\n      const context = {\n        userAgent: navigator.userAgent,\n        headers: {}, // Client-side headers are limited\n        timestamp: new Date(),\n      };\n\n      const result = await detector.analyze(context);\n      setLastResult(result);\n      return result;\n    } finally {\n      setIsDetecting(false);\n    }\n  }, [detector]);\n\n  return {\n    detect,\n    isDetecting,\n    lastResult,\n    detector,\n  };\n}\n\n/**\n * Hook for monitoring detection results\n */\nexport function useDetectionMonitor(\n  onDetection?: (context: DetectionContext) => void\n) {\n  const [detectionHistory, setDetectionHistory] = useState<DetectionResult[]>(\n    []\n  );\n\n  const addDetection = useCallback(\n    (result: DetectionResult, request?: any) => {\n      setDetectionHistory(prev => [...prev, result].slice(-100)); // Keep last 100\n\n      if (onDetection && request) {\n        onDetection({\n          result,\n          request,\n          userAgent: request.headers?.get?.('user-agent'),\n          ip: request.ip,\n        });\n      }\n    },\n    [onDetection]\n  );\n\n  const clearHistory = useCallback(() => {\n    setDetectionHistory([]);\n  }, []);\n\n  const getStats = useCallback(() => {\n    const total = detectionHistory.length;\n    const detected = detectionHistory.filter(r => r.isAgent).length;\n    const avgConfidence =\n      total > 0\n        ? detectionHistory.reduce((sum, r) => sum + r.confidence, 0) / total\n        : 0;\n\n    return {\n      total,\n      detected,\n      avgConfidence,\n      detectionRate: total > 0 ? detected / total : 0,\n    };\n  }, [detectionHistory]);\n\n  return {\n    detectionHistory,\n    addDetection,\n    clearHistory,\n    getStats,\n  };\n}\n","/**\n * @fileoverview AgentShield Next.js Integration\n * @version 0.1.0\n * @license MIT OR Apache-2.0\n */\n\nexport * from './middleware';\nexport * from './types';\nexport * from './hooks';\n\n/**\n * Library version\n */\nexport const VERSION = '0.1.0';\n"]}

package/dist/middleware-OvcbG6s2.d.mts

@@ -0,0 +1,73 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { AgentShieldConfig, DetectionResult, AgentShieldEvents } from '@kya-os/agentshield';
+
+/**
+ * Next.js-specific type definitions
+ */
+
+/**
+ * Next.js middleware configuration
+ */
+interface NextJSMiddlewareConfig extends Partial<AgentShieldConfig> {
+    /**
+     * Action to take when an agent is detected
+     */
+    onAgentDetected?: 'block' | 'redirect' | 'rewrite' | 'allow' | 'log';
+    /**
+     * Custom handler for agent detection
+     * @deprecated Use 'events' instead. Will be removed in v1.0.0
+     */
+    onDetection?: (req: NextRequest, result: DetectionResult) => NextResponse | Promise<NextResponse> | void | Promise<void>;
+    /**
+     * Event handlers for detection events
+     */
+    events?: Partial<AgentShieldEvents>;
+    /**
+     * Path patterns to skip detection
+     */
+    skipPaths?: string[] | RegExp[];
+    /**
+     * Response when blocking agents
+     */
+    blockedResponse?: {
+        status: number;
+        message: string;
+        headers?: Record<string, string>;
+    };
+    /**
+     * Redirect URL when redirecting detected agents
+     */
+    redirectUrl?: string;
+    /**
+     * Rewrite URL when rewriting requests from detected agents
+     */
+    rewriteUrl?: string;
+    /**
+     * Confidence threshold for agent detection
+     */
+    confidenceThreshold?: number;
+}
+/**
+ * Detection context for hooks
+ */
+interface DetectionContext {
+    result: DetectionResult;
+    request: NextRequest;
+    userAgent?: string;
+    ip?: string;
+}
+
+/**
+ * Next.js middleware for AgentShield
+ */
+
+/**
+ * Create AgentShield middleware for Next.js
+ */
+declare function createAgentShieldMiddleware(config?: Partial<NextJSMiddlewareConfig>): (request: NextRequest) => Promise<NextResponse>;
+/**
+ * Convenience function for basic setup
+ */
+declare function agentShield(config?: Partial<NextJSMiddlewareConfig>): (request: NextRequest) => Promise<NextResponse>;
+
+export { type DetectionContext as D, type NextJSMiddlewareConfig as N, agentShield as a, createAgentShieldMiddleware as c };

package/dist/middleware-OvcbG6s2.d.ts

@@ -0,0 +1,73 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { AgentShieldConfig, DetectionResult, AgentShieldEvents } from '@kya-os/agentshield';
+
+/**
+ * Next.js-specific type definitions
+ */
+
+/**
+ * Next.js middleware configuration
+ */
+interface NextJSMiddlewareConfig extends Partial<AgentShieldConfig> {
+    /**
+     * Action to take when an agent is detected
+     */
+    onAgentDetected?: 'block' | 'redirect' | 'rewrite' | 'allow' | 'log';
+    /**
+     * Custom handler for agent detection
+     * @deprecated Use 'events' instead. Will be removed in v1.0.0
+     */
+    onDetection?: (req: NextRequest, result: DetectionResult) => NextResponse | Promise<NextResponse> | void | Promise<void>;
+    /**
+     * Event handlers for detection events
+     */
+    events?: Partial<AgentShieldEvents>;
+    /**
+     * Path patterns to skip detection
+     */
+    skipPaths?: string[] | RegExp[];
+    /**
+     * Response when blocking agents
+     */
+    blockedResponse?: {
+        status: number;
+        message: string;
+        headers?: Record<string, string>;
+    };
+    /**
+     * Redirect URL when redirecting detected agents
+     */
+    redirectUrl?: string;
+    /**
+     * Rewrite URL when rewriting requests from detected agents
+     */
+    rewriteUrl?: string;
+    /**
+     * Confidence threshold for agent detection
+     */
+    confidenceThreshold?: number;
+}
+/**
+ * Detection context for hooks
+ */
+interface DetectionContext {
+    result: DetectionResult;
+    request: NextRequest;
+    userAgent?: string;
+    ip?: string;
+}
+
+/**
+ * Next.js middleware for AgentShield
+ */
+
+/**
+ * Create AgentShield middleware for Next.js
+ */
+declare function createAgentShieldMiddleware(config?: Partial<NextJSMiddlewareConfig>): (request: NextRequest) => Promise<NextResponse>;
+/**
+ * Convenience function for basic setup
+ */
+declare function agentShield(config?: Partial<NextJSMiddlewareConfig>): (request: NextRequest) => Promise<NextResponse>;
+
+export { type DetectionContext as D, type NextJSMiddlewareConfig as N, agentShield as a, createAgentShieldMiddleware as c };

package/dist/middleware.d.mts

@@ -0,0 +1,3 @@
+import 'next/server';
+export { a as agentShield, c as createAgentShieldMiddleware } from './middleware-OvcbG6s2.mjs';
+import '@kya-os/agentshield';

package/dist/middleware.d.ts

@@ -0,0 +1,3 @@
+import 'next/server';
+export { a as agentShield, c as createAgentShieldMiddleware } from './middleware-OvcbG6s2.js';
+import '@kya-os/agentshield';