next-plugin-agent-tail 0.0.1

package/dist/handler.d.mts

@@ -0,0 +1,24 @@
+//#region src/handler.d.ts
+/**
+ * Next.js App Router API route handler.
+ *
+ * Usage in app/api/__browser-logs/route.ts:
+ *   export { POST } from "next-plugin-browser-logs/handler"
+ */
+declare function POST(request: Request): Promise<Response>;
+/**
+ * Pages Router API route handler.
+ *
+ * Usage in pages/api/__browser-logs.ts:
+ *   export default pages_handler
+ */
+declare function pages_handler(req: {
+  method?: string;
+  body?: any;
+}, res: {
+  status: (code: number) => {
+    end: () => void;
+  };
+}): void;
+//#endregion
+export { POST, pages_handler };

package/dist/handler.mjs

@@ -0,0 +1,46 @@
+import { format_log_line } from "agent-tail-core";
+import fs from "node:fs";
+
+//#region src/handler.ts
+/**
+* Next.js App Router API route handler.
+*
+* Usage in app/api/__browser-logs/route.ts:
+*   export { POST } from "next-plugin-browser-logs/handler"
+*/
+async function POST(request) {
+	const log_path = process.env.__BROWSER_LOGS_PATH;
+	if (!log_path) return new Response("Browser logs not configured", { status: 500 });
+	try {
+		const lines = (await request.json()).map(format_log_line).join("");
+		fs.appendFileSync(log_path, lines);
+		return new Response(null, { status: 204 });
+	} catch {
+		return new Response(null, { status: 204 });
+	}
+}
+/**
+* Pages Router API route handler.
+*
+* Usage in pages/api/__browser-logs.ts:
+*   export default pages_handler
+*/
+function pages_handler(req, res) {
+	if (req.method !== "POST") {
+		res.status(405).end();
+		return;
+	}
+	const log_path = process.env.__BROWSER_LOGS_PATH;
+	if (!log_path) {
+		res.status(500).end();
+		return;
+	}
+	try {
+		const lines = (typeof req.body === "string" ? JSON.parse(req.body) : req.body).map(format_log_line).join("");
+		fs.appendFileSync(log_path, lines);
+	} catch {}
+	res.status(204).end();
+}
+
+//#endregion
+export { POST, pages_handler };

package/dist/index.d.mts

@@ -0,0 +1,13 @@
+import { POST, pages_handler } from "./handler.mjs";
+import { BrowserLogsScript } from "./script.mjs";
+import { BrowserLogsOptions, BrowserLogsOptions as BrowserLogsOptions$1, DEFAULT_OPTIONS, LogEntry, ResolvedOptions } from "agent-tail-core";
+
+//#region src/with-browser-logs.d.ts
+interface NextConfig {
+  env?: Record<string, string>;
+  webpack?: (config: any, context: any) => any;
+  [key: string]: any;
+}
+declare function with_browser_logs(next_config?: NextConfig, user_options?: BrowserLogsOptions$1): NextConfig;
+//#endregion
+export { type BrowserLogsOptions, BrowserLogsScript, DEFAULT_OPTIONS, type LogEntry, POST, type ResolvedOptions, pages_handler, with_browser_logs };

package/dist/index.mjs

@@ -0,0 +1,26 @@
+import { BrowserLogsScript } from "./script.mjs";
+import { POST, pages_handler } from "./handler.mjs";
+import { DEFAULT_OPTIONS, LogManager, resolve_options } from "agent-tail-core";
+
+//#region src/with-browser-logs.ts
+function with_browser_logs(next_config = {}, user_options) {
+	const options = resolve_options(user_options);
+	const log_manager = new LogManager(options);
+	const project_root = process.cwd();
+	const log_path = log_manager.initialize(project_root);
+	return {
+		...next_config,
+		env: {
+			...next_config.env,
+			__BROWSER_LOGS_ENDPOINT: options.endpoint,
+			__BROWSER_LOGS_PATH: log_path
+		},
+		webpack(config, context) {
+			if (typeof next_config.webpack === "function") config = next_config.webpack(config, context);
+			return config;
+		}
+	};
+}
+
+//#endregion
+export { BrowserLogsScript, DEFAULT_OPTIONS, POST, pages_handler, with_browser_logs };

package/dist/script.d.mts

@@ -0,0 +1,29 @@
+import { BrowserLogsOptions } from "agent-tail-core";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/script.d.ts
+interface BrowserLogsScriptProps {
+  options?: BrowserLogsOptions;
+}
+/**
+ * React component that injects the browser log capture script.
+ *
+ * Usage in app/layout.tsx:
+ *   import { BrowserLogsScript } from "next-plugin-browser-logs/script"
+ *
+ *   export default function RootLayout({ children }) {
+ *     return (
+ *       <html>
+ *         <head>
+ *           {process.env.NODE_ENV === "development" && <BrowserLogsScript />}
+ *         </head>
+ *         <body>{children}</body>
+ *       </html>
+ *     )
+ *   }
+ */
+declare function BrowserLogsScript({
+  options: user_options
+}?: BrowserLogsScriptProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { BrowserLogsScript };

package/dist/script.mjs

@@ -0,0 +1,31 @@
+import { generate_client_script, resolve_options } from "agent-tail-core";
+import "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/script.tsx
+/**
+* React component that injects the browser log capture script.
+*
+* Usage in app/layout.tsx:
+*   import { BrowserLogsScript } from "next-plugin-browser-logs/script"
+*
+*   export default function RootLayout({ children }) {
+*     return (
+*       <html>
+*         <head>
+*           {process.env.NODE_ENV === "development" && <BrowserLogsScript />}
+*         </head>
+*         <body>{children}</body>
+*       </html>
+*     )
+*   }
+*/
+function BrowserLogsScript({ options: user_options } = {}) {
+	return /* @__PURE__ */ jsx("script", {
+		dangerouslySetInnerHTML: { __html: generate_client_script(resolve_options(user_options)) },
+		suppressHydrationWarning: true
+	});
+}
+
+//#endregion
+export { BrowserLogsScript };

package/package.json

@@ -0,0 +1,47 @@
+{
+    "name": "next-plugin-agent-tail",
+    "type": "module",
+    "version": "0.0.1",
+    "description": "Next.js plugin for agent-tail — pipes browser console logs to files on disk during development.",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/gillkyle/agent-tail",
+        "directory": "packages/next-plugin"
+    },
+    "author": "Kyle Gill",
+    "keywords": ["next", "nextjs", "browser-logs", "console", "logging"],
+    "exports": {
+        ".": {
+            "import": "./dist/index.mjs",
+            "types": "./dist/index.d.mts"
+        },
+        "./handler": {
+            "import": "./dist/handler.mjs",
+            "types": "./dist/handler.d.mts"
+        },
+        "./script": {
+            "import": "./dist/script.mjs",
+            "types": "./dist/script.d.mts"
+        }
+    },
+    "main": "./dist/index.mjs",
+    "types": "./dist/index.d.mts",
+    "files": ["dist"],
+    "scripts": {
+        "build": "tsdown",
+        "typecheck": "tsc --noEmit"
+    },
+    "dependencies": {
+        "agent-tail-core": "workspace:*"
+    },
+    "peerDependencies": {
+        "next": ">=13.0.0"
+    },
+    "devDependencies": {
+        "next": "^15.0.0",
+        "tsdown": "^0.18.1",
+        "react": "^19.0.0",
+        "@types/react": "^19.0.0"
+    }
+}