npm - @winstonfassett/webdev-nextjs - Versions diffs - 0.1.0-alpha.0 - Mend

@winstonfassett/webdev-nextjs 0.1.0-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

package/CHANGELOG.md ADDED Viewed

@@ -0,0 +1,12 @@
+# Changelog
+## 0.1.0 (unreleased)
+First stable release after the `0.1.0-alpha.0` line.
+- Wired by `npx webdev init` (wraps `next.config.{js,ts,mjs}` with `withWebdev()` and, for Next.js Turbopack, injects `<WebDevMcpInit />` into `app/layout.tsx`).
+- Bundler detection: `--webpack` / `--turbopack` flags, then Next.js major version (>=16 → turbopack, <16 → webpack).
+## 0.1.0-alpha.0
+Initial alpha. Next.js adapter for webdev — `withWebdev` HOF, webpack entry injection, instrumentation hooks.

package/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2026 Winston Fassett
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md ADDED Viewed

@@ -0,0 +1,68 @@
+# @winstonfassett/webdev-nextjs
+Next.js adapter for [webdev](https://github.com/WinstonFassett/webdev) — live browser observability for AI agents during development.
+## Install
+```bash
+npm install -D @winstonfassett/webdev-nextjs @winstonfassett/webdev-gateway
+```
+## Webpack mode (Next.js 14+)
+Fully automatic — client instrumentation is injected via webpack entry.
+```js
+// next.config.js
+import { withWebdev } from '@winstonfassett/webdev-nextjs'
+export default withWebdev({
+  // your Next.js config
+})
+```
+Gateway auto-starts. No separate terminal needed.
+MCP endpoint: `http://localhost:3333/__mcp/sse`
+## Turbopack mode (Next.js 15+)
+Turbopack doesn't support webpack entry injection, so add the client component to your layout:
+```js
+// next.config.js
+import { withWebdev } from '@winstonfassett/webdev-nextjs'
+export default withWebdev({
+  turbopack: {},
+})
+```
+```tsx
+// app/layout.tsx
+import { WebDevMcpInit } from '@winstonfassett/webdev-nextjs/init'
+export default function RootLayout({ children }) {
+  return (
+    <html>
+      <body>
+        <WebDevMcpInit />
+        {children}
+      </body>
+    </html>
+  )
+}
+```
+## Options
+```js
+withWebdev(nextConfig, {
+  gatewayUrl: 'http://localhost:3333',  // Gateway URL (default)
+  enabled: process.env.NODE_ENV === 'development',  // Default
+})
+```
+## License
+MIT

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,14 @@
+interface NextConfig {
+    webpack?: (config: any, options: any) => any;
+    rewrites?: () => Promise<any> | any;
+    [key: string]: any;
+}
+export interface WebdevOptions {
+    gatewayUrl?: string;
+    enabled?: boolean;
+    network?: boolean;
+    key?: string;
+}
+export declare function withWebdev(nextConfig?: NextConfig, options?: WebdevOptions): NextConfig;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,UAAU,UAAU;IAClB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,KAAK,GAAG,CAAA;IAC5C,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAA;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AA4BD,wBAAgB,UAAU,CACxB,UAAU,GAAE,UAAe,EAC3B,OAAO,GAAE,aAAkB,GAC1B,UAAU,CAmIZ"}

package/dist/index.js ADDED Viewed

@@ -0,0 +1,131 @@
+// Next.js adapter for webdev
+// Wraps next.config to inject gateway registration, console capture, build events, and rewrites
+import { ensureGateway, registerWithRetry, patchConsole, connectDevEvents, makeServerId, } from '@winstonfassett/webdev-gateway/helpers';
+let _devEvents = null;
+function sendBuildEvent(payload) {
+    _devEvents?.send(payload);
+}
+/** Webpack plugin that sends build events to the gateway */
+class WebdevBuildPlugin {
+    apply(compiler) {
+        compiler.hooks.compile.tap('WebdevBuild', () => {
+            sendBuildEvent({ type: 'build:start' });
+        });
+        compiler.hooks.done.tap('WebdevBuild', (stats) => {
+            if (stats.hasErrors()) {
+                const errors = stats.toJson({ errors: true }).errors;
+                const msg = errors?.[0]?.message ?? 'Build error';
+                sendBuildEvent({ type: 'build:error', error: msg });
+            }
+            else {
+                const modules = Object.keys(stats.toJson({ assets: false, modules: true }).modules ?? {}).slice(0, 20);
+                sendBuildEvent({ type: 'build:update', modules, duration: stats.endTime - stats.startTime });
+            }
+        });
+    }
+}
+export function withWebdev(nextConfig = {}, options = {}) {
+    const { gatewayUrl = 'http://localhost:3333', enabled = process.env.NODE_ENV === 'development', network = false, } = options;
+    if (!enabled) {
+        return nextConfig;
+    }
+    // Stable server ID: computed from directory + type, inherited by forked workers via env
+    if (!process.env.__WEBDEV_SERVER__) {
+        process.env.__WEBDEV_SERVER__ = makeServerId(process.cwd(), 'nextjs', options.key);
+    }
+    const serverId = process.env.__WEBDEV_SERVER__;
+    // Guard: Next.js forks workers that re-run this code. Only register once.
+    if (!process.env.__WEBDEV_REGISTERED__) {
+        process.env.__WEBDEV_REGISTERED__ = '1';
+        const registrationPayload = {
+            serverId,
+            type: 'nextjs',
+            port: parseInt(process.env.PORT || '3000', 10),
+            pid: process.pid,
+            directory: process.cwd(),
+            key: options.key,
+        };
+        ensureGateway(gatewayUrl).then(async () => {
+            await patchConsole(gatewayUrl, serverId);
+            _devEvents = await connectDevEvents(gatewayUrl, serverId, {
+                registrationPayload,
+            });
+            registerWithRetry(gatewayUrl, registrationPayload);
+        });
+    }
+    return {
+        ...nextConfig,
+        // Expose env vars to browser — works with both webpack and Turbopack
+        env: {
+            ...nextConfig.env,
+            NEXT_PUBLIC_WEBDEV_GATEWAY: gatewayUrl,
+            NEXT_PUBLIC_WEBDEV_SERVER: serverId,
+        },
+        webpack(config, webpackOptions) {
+            const { dev, isServer } = webpackOptions;
+            // Exclude gateway log directory from webpack watching
+            if (dev) {
+                const existing = config.watchOptions?.ignored;
+                let ignored;
+                if (existing instanceof RegExp) {
+                    ignored = new RegExp(existing.source + '|[/\\\\]\\.webdev[/\\\\]');
+                }
+                else {
+                    ignored = /[/\\]\.webdev[/\\]/;
+                }
+                config.watchOptions = { ...config.watchOptions, ignored };
+                config.plugins = config.plugins || [];
+                config.plugins.push(new WebdevBuildPlugin());
+            }
+            // Inject client instrumentation in dev client bundles (webpack mode only)
+            if (dev && !isServer) {
+                const originalEntry = config.entry;
+                config.entry = async () => {
+                    const entries = await originalEntry();
+                    Object.keys(entries).forEach((key) => {
+                        const entry = entries[key];
+                        if (Array.isArray(entry) && !entry.includes('@winstonfassett/webdev-nextjs/instrument')) {
+                            entries[key] = ['@winstonfassett/webdev-nextjs/instrument', ...entry];
+                        }
+                    });
+                    return entries;
+                };
+                config.plugins = config.plugins || [];
+                const webpack = config.plugins[0]?.constructor;
+                if (webpack && webpack.DefinePlugin) {
+                    config.plugins.push(new webpack.DefinePlugin({
+                        'process.env.__WEBDEV_GATEWAY__': JSON.stringify(gatewayUrl),
+                        'process.env.__WEBDEV_NETWORK__': JSON.stringify(network),
+                        'process.env.__WEBDEV_SERVER__': JSON.stringify(serverId),
+                    }));
+                }
+            }
+            if (typeof nextConfig.webpack === 'function') {
+                return nextConfig.webpack(config, webpackOptions);
+            }
+            return config;
+        },
+        async rewrites() {
+            const userRewrites = typeof nextConfig.rewrites === 'function'
+                ? await nextConfig.rewrites()
+                : { beforeFiles: [], afterFiles: [], fallback: [] };
+            const normalized = Array.isArray(userRewrites)
+                ? { beforeFiles: userRewrites, afterFiles: [], fallback: [] }
+                : userRewrites;
+            const mcpRewrites = [
+                { source: '/__mcp/:path*', destination: `${gatewayUrl}/__mcp/:path*` },
+                { source: '/__rpc', destination: `${gatewayUrl}/__rpc` },
+                { source: '/__events', destination: `${gatewayUrl}/__events` },
+                { source: '/__webdev.js', destination: `${gatewayUrl}/__webdev.js` },
+                { source: '/__libs/:path*', destination: `${gatewayUrl}/__libs/:path*` },
+                { source: '/__element-grab.js', destination: `${gatewayUrl}/__element-grab.js` },
+            ];
+            return {
+                beforeFiles: [...(normalized.beforeFiles || []), ...mcpRewrites],
+                afterFiles: normalized.afterFiles || [],
+                fallback: normalized.fallback || [],
+            };
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/init.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export declare function WebDevMcpInit(): null;
2	+ //# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.tsx"],"names":[],"mappings":"AAcA,wBAAgB,aAAa,SA6B5B"}

package/dist/init.js ADDED Viewed

@@ -0,0 +1,41 @@
+'use client';
+/**
+ * Pre-built client component for Next.js Turbopack mode.
+ *
+ * Usage in app/layout.tsx:
+ *   import { WebDevMcpInit } from '@winstonfassett/webdev-nextjs/init'
+ *   // <WebDevMcpInit /> in <body>
+ *
+ * Webpack mode doesn't need this — client.js is injected automatically via webpack entry.
+ */
+import { useEffect } from 'react';
+export function WebDevMcpInit() {
+    useEffect(() => {
+        // process.env.NODE_ENV is inlined by Next.js at build time. In prod the
+        // entire useEffect body is dead-code-eliminated.
+        if (process.env.NODE_ENV !== 'development')
+            return;
+        if (!process.env.NEXT_PUBLIC_WEBDEV_GATEWAY)
+            return;
+        if (window.__WEBDEV_LOADED__)
+            return;
+        if (process.env.NEXT_PUBLIC_WEBDEV_SERVER) {
+            window.__WEBDEV_SERVER__ = process.env.NEXT_PUBLIC_WEBDEV_SERVER;
+        }
+        window.__WEBDEV_ORIGIN__ = process.env.NEXT_PUBLIC_WEBDEV_GATEWAY;
+        // Meta tag for extension auto-detection
+        const meta = document.createElement('meta');
+        meta.name = 'webdev';
+        meta.content = process.env.NEXT_PUBLIC_WEBDEV_GATEWAY;
+        if (process.env.NEXT_PUBLIC_WEBDEV_SERVER) {
+            meta.setAttribute('data-server-id', process.env.NEXT_PUBLIC_WEBDEV_SERVER);
+        }
+        document.head.appendChild(meta);
+        const script = document.createElement('script');
+        script.src = '/__webdev.js';
+        script.async = true;
+        document.head.appendChild(script);
+    }, []);
+    return null;
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEjC,MAAM,UAAU,aAAa;IAC3B,SAAS,CAAC,GAAG,EAAE;QACb,wEAAwE;QACxE,iDAAiD;QACjD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa;YAAE,OAAM;QAClD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B;YAAE,OAAM;QACnD,IAAK,MAAc,CAAC,iBAAiB;YAAE,OAAM;QAE7C,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,CAAC;YACzC,MAAc,CAAC,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAA;QAC3E,CAAC;QACA,MAAc,CAAC,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAA;QAE1E,wCAAwC;QACxC,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;QAC3C,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAA;QACpB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAA;QACrD,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,CAAC;YAC1C,IAAI,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAA;QAC5E,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;QAE/B,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;QAC/C,MAAM,CAAC,GAAG,GAAG,cAAc,CAAA;QAC3B,MAAM,CAAC,KAAK,GAAG,IAAI,CAAA;QACnB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IACnC,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/instrument.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export {};
2	+ //# sourceMappingURL=instrument.d.ts.map

package/dist/instrument.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"instrument.d.ts","sourceRoot":"","sources":["../src/instrument.ts"],"names":[],"mappings":""}

package/dist/instrument.js ADDED Viewed

@@ -0,0 +1,30 @@
+/**
+ * Browser instrumentation for Next.js apps (webpack mode).
+ * Loaded automatically via webpack entry injection from withWebDevMcp().
+ *
+ * For Turbopack, use <WebdevInit /> from '@winstonfassett/webdev-nextjs/init' instead.
+ */
+if (typeof window !== 'undefined' && !window.__WEBDEV_INSTRUMENT__) {
+    ;
+    window.__WEBDEV_INSTRUMENT__ = true;
+    if (process.env.NEXT_PUBLIC_WEBDEV_SERVER) {
+        window.__WEBDEV_SERVER__ = process.env.NEXT_PUBLIC_WEBDEV_SERVER;
+    }
+    if (process.env.NEXT_PUBLIC_WEBDEV_GATEWAY) {
+        window.__WEBDEV_ORIGIN__ = process.env.NEXT_PUBLIC_WEBDEV_GATEWAY;
+    }
+    // Meta tag for extension auto-detection
+    const meta = document.createElement('meta');
+    meta.name = 'webdev';
+    meta.content = process.env.NEXT_PUBLIC_WEBDEV_GATEWAY || '';
+    if (process.env.NEXT_PUBLIC_WEBDEV_SERVER) {
+        meta.setAttribute('data-server-id', process.env.NEXT_PUBLIC_WEBDEV_SERVER);
+    }
+    document.head.appendChild(meta);
+    const script = document.createElement('script');
+    script.src = '/__webdev.js';
+    script.async = true;
+    document.head.appendChild(script);
+}
+export {};
+//# sourceMappingURL=instrument.js.map

package/dist/instrument.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"instrument.js","sourceRoot":"","sources":["../src/instrument.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,CAAE,MAAc,CAAC,qBAAqB,EAAE,CAAC;IAC5E,CAAC;IAAC,MAAc,CAAC,qBAAqB,GAAG,IAAI,CAAA;IAC7C,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,CAAC;QACzC,MAAc,CAAC,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAA;IAC3E,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,CAAC;QAC1C,MAAc,CAAC,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAA;IAC5E,CAAC;IACD,wCAAwC;IACxC,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;IAC3C,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAA;IACpB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,EAAE,CAAA;IAC3D,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,CAAC;QAC1C,IAAI,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAA;IAC5E,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;IAE/B,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;IAC/C,MAAM,CAAC,GAAG,GAAG,cAAc,CAAA;IAC3B,MAAM,CAAC,KAAK,GAAG,IAAI,CAAA;IACnB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;AACnC,CAAC"}

package/package.json ADDED Viewed

@@ -0,0 +1,73 @@
+{
+  "name": "@winstonfassett/webdev-nextjs",
+  "version": "0.1.0-alpha.0",
+  "description": "Next.js adapter for webdev — live browser observability for AI agents",
+  "type": "module",
+  "engines": {
+    "node": ">=20.6.0"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./init": {
+      "types": "./dist/init.d.ts",
+      "import": "./dist/init.js",
+      "require": "./dist/init.js"
+    },
+    "./instrument": {
+      "types": "./dist/instrument.d.ts",
+      "import": "./dist/instrument.js",
+      "require": "./dist/instrument.js"
+    }
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc"
+  },
+  "keywords": [
+    "nextjs",
+    "mcp",
+    "ai",
+    "devtools",
+    "webdev"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/WinstonFassett/webdev.git",
+    "directory": "packages/adapter-nextjs"
+  },
+  "homepage": "https://github.com/WinstonFassett/webdev",
+  "bugs": {
+    "url": "https://github.com/WinstonFassett/webdev/issues"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@winstonfassett/webdev-gateway": ">=0.1.0-alpha.0"
+  },
+  "peerDependencies": {
+    "next": ">=14.0.0"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@winstonfassett/webdev-gateway": "file:../../apps/gateway",
+    "@types/node": "^25.5.0",
+    "@types/react": "^19.0.0",
+    "@types/ws": "^8.18.1",
+    "typescript": "^5.8.0"
+  }
+}