tidewave 0.4.0 → 0.5.0

package/README.md

@@ -1,23 +1,25 @@
 # Tidewave
 
-> Tidewave Web for Next.js is currently in alpha testing!
+> Tidewave Web for Next.js and React+Vite is currently in alpha testing!
 
 Tidewave is the coding agent for full-stack web app development.
 [See our website](https://tidewave.ai) for more information.
 
-This package is recommended for JavaScript-powered backends as well as
-JavaScript libraries/applications using a backend as a service (such as
-Supabase). If you are using React with Phoenix, Rails, Django, or another
-server-side framework, [follow the steps here instead](http://hexdocs.pm/tidewave/react.html).
+If you are using Next.js or you have a React + Vite frontend, talking either to
+a backend as a service (such as Supabase) or a third-party framework, you are in
+the right place!
 
-This project can also be used as a standalone Model Context Protocol (MCP)
-server for your editors.
+If you are using React with Django, FastAPI, Flask, Phoenix, or Rails,
+[follow the steps here instead](http://hexdocs.pm/tidewave/react.html).
+
+This project can also be used through the CLI or as a standalone Model Context
+Protocol (MCP) server for your editors.
 
 ## Installation
 
 ### Next.js
 
-Install it with:
+If you are using Next.js, install Tidewave with:
 
 ```sh
 $ npm install -D tidewave
@@ -39,7 +41,7 @@ export default async function handler(
   res: NextApiResponse,
 ) {
   if (process.env.NODE_ENV === 'development') {
-    const { tidewaveHandler } = await import('tidewave/next-js');
+    const { tidewaveHandler } = await import('tidewave/next-js/handler');
     const handler = await tidewaveHandler();
     return handler(req, res);
   } else {
@@ -58,14 +60,29 @@ export const config = {
 _Note: this uses the **Pages Router**, however it works regardless of the router
 type you use in your application._
 
-Then create (or modify) `middleware.ts` with:
+If you are using Next.js 16+, then create (or modify) `proxy.ts` with:
+
+```typescript
+import { NextRequest, NextResponse } from 'next/server';
+
+export function proxy(req: NextRequest): NextResponse {
+  if (req.nextUrl.pathname.startsWith('/tidewave')) {
+    return NextResponse.rewrite(new URL('/api/tidewave', req.url));
+  }
+
+  // Here you could add your own logic or different middlewares.
+  return NextResponse.next();
+}
+```
+
+For Next.js 15+ and earlier, create (or modify) `middleware.ts` with:
 
 ```typescript
 import { NextRequest, NextResponse } from 'next/server';
 
 export function middleware(req: NextRequest): NextResponse {
   if (req.nextUrl.pathname.startsWith('/tidewave')) {
-    return NextResponse.rewrite(new URL(`/api/tidewave`, req.url));
+    return NextResponse.rewrite(new URL('/api/tidewave', req.url));
   }
 
   // Here you could add your own logic or different middlewares.
@@ -77,20 +94,31 @@ export const config = {
 };
 ```
 
-Finally, we recommend creating the `instrumentation.ts` file below,
-to expose your application's spans, events, and logs to Tidewave/MCP:
+Finally, we expose your application's spans, events, and logs to Tidewave MCP.
+First install the NodeSDK:
+
+```sh
+npm install @opentelemetry/sdk-node
+```
+
+And then create (or modify) a custom `instrumentation.ts` file in the root
+directory of the project (or inside `src` folder if using one):
 
 ```typescript
 // instrumentation.ts
 import { NodeSDK } from '@opentelemetry/sdk-node';
-import { BatchSpanProcessor } from '@opentelemetry/sdk-trace-node';
+import type { SpanProcessor } from '@opentelemetry/sdk-trace-base';
+import type { LogRecordProcessor } from '@opentelemetry/sdk-logs';
 
 export async function register() {
   const runtime = process.env.NEXT_RUNTIME;
   const env = process.env.NODE_ENV;
 
   // Add your app own processes here existing configuration
-  const sdkConfig = {
+  const sdkConfig: {
+    spanProcessors: SpanProcessor[];
+    logRecordProcessors: LogRecordProcessor[];
+  } = {
     spanProcessors: [],
     logRecordProcessors: [],
   };
@@ -110,8 +138,16 @@ export async function register() {
 }
 ```
 
+Now make sure
+[Tidewave is installed](https://hexdocs.pm/tidewave/installation.html) and you
+are ready to connect Tidewave to your app.
+
 ### React + Vite
 
+If you are building a front-end application, using a backend as a service, such
+as Supabase, or a non-officially supported web framework, we recommend using our
+React + Vite integration.
+
 Install it with:
 
 ```sh
@@ -135,9 +171,21 @@ export default defineConfig({
 });
 ```
 
+Now make sure
+[Tidewave is installed](https://hexdocs.pm/tidewave/installation.html) and you
+are ready to connect Tidewave to your app.
+
+If you are using Supabase or similar, you can prompt Tidewave to use the
+`supabase` CLI so it has complete access to your database. For non-officially
+supported web frameworks, our React + Vite integration allows Tidewave Web to
+perform changes on the front-end, and the agent will be able to modify your
+backend code as usual, but some functionality (such as accessing logs, doing
+database calls, etc) won't be available.
+
 ### Configuration
 
-Next.js' `tidewaveHandler` and Vite's `tidewave` accept the configuration options below:
+Next.js' `tidewaveHandler` and Vite's `tidewave` accept the configuration
+options below:
 
 - `allow_remote_access:` allow remote connections when true (default false)
 - `allowed_origins:` defaults to the current host/port
@@ -145,9 +193,9 @@ Next.js' `tidewaveHandler` and Vite's `tidewave` accept the configuration option
 
 ## CLI
 
-Tidewave.js also comes with a CLI for developers who want to use it
-as a standalone MCP or query its functionality directly. Note this
-functionality is separate from Tidewave Web.
+Tidewave.js also comes with a CLI for developers who want to use it as a
+standalone MCP or query its functionality directly. Note this functionality is
+separate from Tidewave Web.
 
 ### STDIO MCP
 

package/dist/cli/index.js

@@ -4007,12 +4007,12 @@ Module reference format:
 
 Examples:
 - src/types.ts:SymbolInfo (local file symbol)
-- lodash:isEmpty (dependency function)  
+- lodash:isEmpty (dependency function)
 - react:Component#render (instance method)
 - node:Math.max (builtin static method)`, docsInputSchema, sourceInputSchema, getLogsInputSchema, tools;
 var init_tools = __esm(() => {
   init_zod();
-  projectEvalDescription = `  
+  projectEvalDescription = `
 Evaluates JavaScript/TypeScript code in the context of the project.
 
 The current NodeJS version is: ${process.version}
@@ -4039,7 +4039,7 @@ Defaults to 30000 (30 seconds).`),
     reference: exports_external.string().describe(referenceDescription)
   });
   getLogsInputSchema = exports_external.object({
-    tail: exports_external.number().min(1).max(1e4).default(100).describe("Number of log entries to return from the end"),
+    tail: exports_external.number().describe("Number of log entries to return from the end"),
     grep: exports_external.string().optional().describe("Filter logs with regex pattern (case insensitive)"),
     level: exports_external.enum(["DEBUG", "INFO", "WARN", "ERROR"]).optional().describe("Filter by log severity level"),
     since: exports_external.string().optional().describe("ISO 8601 timestamp - return logs after this time")
@@ -4924,12 +4924,12 @@ var init_src = __esm(() => {
 });
 
 // package.json
-var name = "tidewave", version = "0.4.0", package_default;
+var name = "tidewave", version = "0.5.0", package_default;
 var init_package = __esm(() => {
   package_default = {
     name,
     version,
-    description: "Tidewave JavaScript CLI for documentation extraction and MCP server",
+    description: "Tidewave for JavaScript/Next.js",
     keywords: [
       "typescript",
       "documentation",
@@ -4940,7 +4940,7 @@ var init_package = __esm(() => {
     homepage: "https://tidewave.ai",
     repository: {
       type: "git",
-      url: "git+https://github.com/dashbit/tidewave_javascript.git"
+      url: "git+https://github.com/tidewave-ai/tidewave_js.git"
     },
     license: "Apache-2.0",
     author: "Dashbit",

package/dist/next-js/handler.js

@@ -28,7 +28,7 @@ var __export = (target, all) => {
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
-// node_modules/connect/node_modules/debug/node_modules/ms/index.js
+// node_modules/connect/node_modules/ms/index.js
 var require_ms = __commonJS((exports, module) => {
   var s = 1000;
   var m = s * 60;
@@ -19623,12 +19623,12 @@ Module reference format:
 
 Examples:
 - src/types.ts:SymbolInfo (local file symbol)
-- lodash:isEmpty (dependency function)  
+- lodash:isEmpty (dependency function)
 - react:Component#render (instance method)
 - node:Math.max (builtin static method)`, docsInputSchema, sourceInputSchema, getLogsInputSchema, tools;
 var init_tools = __esm(() => {
   init_zod();
-  projectEvalDescription = `  
+  projectEvalDescription = `
 Evaluates JavaScript/TypeScript code in the context of the project.
 
 The current NodeJS version is: ${process.version}
@@ -19655,7 +19655,7 @@ Defaults to 30000 (30 seconds).`),
     reference: exports_external.string().describe(referenceDescription)
   });
   getLogsInputSchema = exports_external.object({
-    tail: exports_external.number().min(1).max(1e4).default(100).describe("Number of log entries to return from the end"),
+    tail: exports_external.number().describe("Number of log entries to return from the end"),
     grep: exports_external.string().optional().describe("Filter logs with regex pattern (case insensitive)"),
     level: exports_external.enum(["DEBUG", "INFO", "WARN", "ERROR"]).optional().describe("Filter by log severity level"),
     since: exports_external.string().optional().describe("ISO 8601 timestamp - return logs after this time")
@@ -19721,12 +19721,12 @@ Defaults to 30000 (30 seconds).`),
 });
 
 // package.json
-var name = "tidewave", version = "0.4.0", package_default;
+var name = "tidewave", version = "0.5.0", package_default;
 var init_package = __esm(() => {
   package_default = {
     name,
     version,
-    description: "Tidewave JavaScript CLI for documentation extraction and MCP server",
+    description: "Tidewave for JavaScript/Next.js",
     keywords: [
       "typescript",
       "documentation",
@@ -19737,7 +19737,7 @@ var init_package = __esm(() => {
     homepage: "https://tidewave.ai",
     repository: {
       type: "git",
-      url: "git+https://github.com/dashbit/tidewave_javascript.git"
+      url: "git+https://github.com/tidewave-ai/tidewave_js.git"
     },
     license: "Apache-2.0",
     author: "Dashbit",

package/dist/tools.d.ts

@@ -57,7 +57,7 @@ declare const sourceInputSchema: z.ZodObject<{
     reference: string;
 }>;
 export declare const getLogsInputSchema: z.ZodObject<{
-    tail: z.ZodDefault<z.ZodNumber>;
+    tail: z.ZodNumber;
     grep: z.ZodOptional<z.ZodString>;
     level: z.ZodOptional<z.ZodEnum<["DEBUG", "INFO", "WARN", "ERROR"]>>;
     since: z.ZodOptional<z.ZodString>;
@@ -67,7 +67,7 @@ export declare const getLogsInputSchema: z.ZodObject<{
     level?: "DEBUG" | "INFO" | "WARN" | "ERROR" | undefined;
     since?: string | undefined;
 }, {
-    tail?: number | undefined;
+    tail: number;
     grep?: string | undefined;
     level?: "DEBUG" | "INFO" | "WARN" | "ERROR" | undefined;
     since?: string | undefined;

package/dist/vite-plugin.js

@@ -28,7 +28,7 @@ var __export = (target, all) => {
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
-// node_modules/connect/node_modules/debug/node_modules/ms/index.js
+// node_modules/connect/node_modules/ms/index.js
 var require_ms = __commonJS((exports, module) => {
   var s = 1000;
   var m = s * 60;
@@ -19623,12 +19623,12 @@ Module reference format:
 
 Examples:
 - src/types.ts:SymbolInfo (local file symbol)
-- lodash:isEmpty (dependency function)  
+- lodash:isEmpty (dependency function)
 - react:Component#render (instance method)
 - node:Math.max (builtin static method)`, docsInputSchema, sourceInputSchema, getLogsInputSchema, tools;
 var init_tools = __esm(() => {
   init_zod();
-  projectEvalDescription = `  
+  projectEvalDescription = `
 Evaluates JavaScript/TypeScript code in the context of the project.
 
 The current NodeJS version is: ${process.version}
@@ -19655,7 +19655,7 @@ Defaults to 30000 (30 seconds).`),
     reference: exports_external.string().describe(referenceDescription)
   });
   getLogsInputSchema = exports_external.object({
-    tail: exports_external.number().min(1).max(1e4).default(100).describe("Number of log entries to return from the end"),
+    tail: exports_external.number().describe("Number of log entries to return from the end"),
     grep: exports_external.string().optional().describe("Filter logs with regex pattern (case insensitive)"),
     level: exports_external.enum(["DEBUG", "INFO", "WARN", "ERROR"]).optional().describe("Filter by log severity level"),
     since: exports_external.string().optional().describe("ISO 8601 timestamp - return logs after this time")
@@ -19721,12 +19721,12 @@ Defaults to 30000 (30 seconds).`),
 });
 
 // package.json
-var name = "tidewave", version = "0.4.0", package_default;
+var name = "tidewave", version = "0.5.0", package_default;
 var init_package = __esm(() => {
   package_default = {
     name,
     version,
-    description: "Tidewave JavaScript CLI for documentation extraction and MCP server",
+    description: "Tidewave for JavaScript/Next.js",
     keywords: [
       "typescript",
       "documentation",
@@ -19737,7 +19737,7 @@ var init_package = __esm(() => {
     homepage: "https://tidewave.ai",
     repository: {
       type: "git",
-      url: "git+https://github.com/dashbit/tidewave_javascript.git"
+      url: "git+https://github.com/tidewave-ai/tidewave_js.git"
     },
     license: "Apache-2.0",
     author: "Dashbit",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tidewave",
-  "version": "0.4.0",
-  "description": "Tidewave JavaScript CLI for documentation extraction and MCP server",
+  "version": "0.5.0",
+  "description": "Tidewave for JavaScript/Next.js",
   "keywords": [
     "typescript",
     "documentation",
@@ -12,7 +12,7 @@
   "homepage": "https://tidewave.ai",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/dashbit/tidewave_javascript.git"
+    "url": "git+https://github.com/tidewave-ai/tidewave_js.git"
   },
   "license": "Apache-2.0",
   "author": "Dashbit",