@veloxts/web 0.6.26 → 0.6.27

package/CHANGELOG.md

@@ -0,0 +1,312 @@
+# @veloxts/web
+
+## 0.6.27
+
+### Patch Changes
+
+- chore: add GUIDE, LICENSE and CHANGELOG.md to npm files
+- Updated dependencies
+  - @veloxts/auth@0.6.27
+  - @veloxts/client@0.6.27
+  - @veloxts/core@0.6.27
+  - @veloxts/router@0.6.27
+
+## 0.6.26
+
+### Patch Changes
+
+- docs(mcp): add README and GUIDE, docs(web): simplify README and create concise GUIDE
+- Updated dependencies
+  - @veloxts/auth@0.6.26
+  - @veloxts/client@0.6.26
+  - @veloxts/core@0.6.26
+  - @veloxts/router@0.6.26
+
+## 0.6.25
+
+### Patch Changes
+
+- docs(create): add guide for React Server Components setup
+- Updated dependencies
+  - @veloxts/auth@0.6.25
+  - @veloxts/client@0.6.25
+  - @veloxts/core@0.6.25
+  - @veloxts/router@0.6.25
+
+## 0.6.24
+
+### Patch Changes
+
+- clarify installation paths and package contents
+- Updated dependencies
+  - @veloxts/auth@0.6.24
+  - @veloxts/client@0.6.24
+  - @veloxts/core@0.6.24
+  - @veloxts/router@0.6.24
+
+## 0.6.23
+
+### Patch Changes
+
+- add defineContract for improved type inference DX
+- Updated dependencies
+  - @veloxts/auth@0.6.23
+  - @veloxts/client@0.6.23
+  - @veloxts/core@0.6.23
+  - @veloxts/router@0.6.23
+
+## 0.6.22
+
+### Patch Changes
+
+- support {method, path} route entry format
+- Updated dependencies
+  - @veloxts/auth@0.6.22
+  - @veloxts/client@0.6.22
+  - @veloxts/core@0.6.22
+  - @veloxts/router@0.6.22
+
+## 0.6.21
+
+### Patch Changes
+
+- separate schemas from procedures for browser-safe import
+- Updated dependencies
+  - @veloxts/auth@0.6.21
+  - @veloxts/client@0.6.21
+  - @veloxts/core@0.6.21
+  - @veloxts/router@0.6.21
+
+## 0.6.20
+
+### Patch Changes
+
+- add Fastify ecosystem stubs and debuglog to util
+- Updated dependencies
+  - @veloxts/auth@0.6.20
+  - @veloxts/client@0.6.20
+  - @veloxts/core@0.6.20
+  - @veloxts/router@0.6.20
+
+## 0.6.19
+
+### Patch Changes
+
+- restore dotenv stub for browser compatibility
+- Updated dependencies
+  - @veloxts/auth@0.6.19
+  - @veloxts/client@0.6.19
+  - @veloxts/core@0.6.19
+  - @veloxts/router@0.6.19
+
+## 0.6.18
+
+### Patch Changes
+
+- add node:fs/promises stub and fix esbuild plugin
+- Updated dependencies
+  - @veloxts/auth@0.6.18
+  - @veloxts/client@0.6.18
+  - @veloxts/core@0.6.18
+  - @veloxts/router@0.6.18
+
+## 0.6.17
+
+### Patch Changes
+
+- remove optimizeDeps.exclude to fix CJS/ESM interop
+- Updated dependencies
+  - @veloxts/auth@0.6.17
+  - @veloxts/client@0.6.17
+  - @veloxts/core@0.6.17
+  - @veloxts/router@0.6.17
+
+## 0.6.16
+
+### Patch Changes
+
+- add stubs for Fastify ecosystem packages
+- Updated dependencies
+  - @veloxts/auth@0.6.16
+  - @veloxts/client@0.6.16
+  - @veloxts/core@0.6.16
+  - @veloxts/router@0.6.16
+
+## 0.6.15
+
+### Patch Changes
+
+- implement three-layer Node.js stubbing for Vite
+- Updated dependencies
+  - @veloxts/auth@0.6.15
+  - @veloxts/client@0.6.15
+  - @veloxts/core@0.6.15
+  - @veloxts/router@0.6.15
+
+## 0.6.14
+
+### Patch Changes
+
+- stub dotenv as virtual module instead of process shims
+- Updated dependencies
+  - @veloxts/auth@0.6.14
+  - @veloxts/client@0.6.14
+  - @veloxts/core@0.6.14
+  - @veloxts/router@0.6.14
+
+## 0.6.13
+
+### Patch Changes
+
+- add process.argv stub for dotenv browser compatibility
+- Updated dependencies
+  - @veloxts/auth@0.6.13
+  - @veloxts/client@0.6.13
+  - @veloxts/core@0.6.13
+  - @veloxts/router@0.6.13
+
+## 0.6.12
+
+### Patch Changes
+
+- Fixes the "process is not defined" error from dotenv
+- Updated dependencies
+  - @veloxts/auth@0.6.12
+  - @veloxts/client@0.6.12
+  - @veloxts/core@0.6.12
+  - @veloxts/router@0.6.12
+
+## 0.6.11
+
+### Patch Changes
+
+- add Vite plugin for Node.js module stubs
+- Updated dependencies
+  - @veloxts/auth@0.6.11
+  - @veloxts/client@0.6.11
+  - @veloxts/core@0.6.11
+  - @veloxts/router@0.6.11
+
+## 0.6.10
+
+### Patch Changes
+
+- use import() type syntax for AppRouter
+- Updated dependencies
+  - @veloxts/auth@0.6.10
+  - @veloxts/client@0.6.10
+  - @veloxts/core@0.6.10
+  - @veloxts/router@0.6.10
+
+## 0.6.9
+
+### Patch Changes
+
+- isolate auth procedures from database imports
+- Updated dependencies
+  - @veloxts/auth@0.6.9
+  - @veloxts/client@0.6.9
+  - @veloxts/core@0.6.9
+  - @veloxts/router@0.6.9
+
+## 0.6.8
+
+### Patch Changes
+
+- prevent dotenv from leaking into browser bundle
+- Updated dependencies
+  - @veloxts/auth@0.6.8
+  - @veloxts/client@0.6.8
+  - @veloxts/core@0.6.8
+  - @veloxts/router@0.6.8
+
+## 0.6.7
+
+### Patch Changes
+
+- better-sqlite3 versions mismatch fix
+- Updated dependencies
+  - @veloxts/auth@0.6.7
+  - @veloxts/client@0.6.7
+  - @veloxts/core@0.6.7
+  - @veloxts/router@0.6.7
+
+## 0.6.6
+
+### Patch Changes
+
+- ensure the web app never imports server-side code paths
+- Updated dependencies
+  - @veloxts/auth@0.6.6
+  - @veloxts/client@0.6.6
+  - @veloxts/core@0.6.6
+  - @veloxts/router@0.6.6
+
+## 0.6.5
+
+### Patch Changes
+
+- move @prisma/client-runtime-utils to root package.json
+- Updated dependencies
+  - @veloxts/auth@0.6.5
+  - @veloxts/client@0.6.5
+  - @veloxts/core@0.6.5
+  - @veloxts/router@0.6.5
+
+## 0.6.4
+
+### Patch Changes
+
+- add @prisma/client-runtime-utils dependency
+- Updated dependencies
+  - @veloxts/auth@0.6.4
+  - @veloxts/client@0.6.4
+  - @veloxts/core@0.6.4
+  - @veloxts/router@0.6.4
+
+## 0.6.3
+
+### Patch Changes
+
+- Add workspaces field to root package.json template + Fix Prisma ESM/CJS import for Node.js v24
+- Updated dependencies
+  - @veloxts/auth@0.6.3
+  - @veloxts/client@0.6.3
+  - @veloxts/core@0.6.3
+  - @veloxts/router@0.6.3
+
+## 0.6.2
+
+### Patch Changes
+
+- add server actions, removed some deprecated and other chore
+- Updated dependencies
+  - @veloxts/auth@0.6.2
+  - @veloxts/client@0.6.2
+  - @veloxts/core@0.6.2
+  - @veloxts/router@0.6.2
+
+## 0.6.1
+
+### Patch Changes
+
+- route groups for file-based routing; add dynamic route support with [param] segments
+- Updated dependencies
+  - @veloxts/auth@0.6.1
+  - @veloxts/client@0.6.1
+  - @veloxts/core@0.6.1
+  - @veloxts/router@0.6.1
+
+## 0.6.0
+
+### Minor Changes
+
+- RSC streaming, dynamic routes, Vinxi integration
+
+### Patch Changes
+
+- Updated dependencies
+  - @veloxts/auth@0.6.0
+  - @veloxts/client@0.6.0
+  - @veloxts/core@0.6.0
+  - @veloxts/router@0.6.0

package/GUIDE.md

@@ -0,0 +1,170 @@
+# @veloxts/web Guide
+
+React Server Components integration for VeloxTS Framework using Vinxi.
+
+## Quick Start
+
+Scaffold a new RSC project:
+
+```bash
+npx create-velox-app my-app --rsc
+cd my-app
+pnpm install
+pnpm dev
+```
+
+## Key Features
+
+- **React Server Components** - Full RSC support with streaming
+- **File-Based Routing** - Laravel-inspired routing from `app/pages/`
+- **Server Actions** - Type-safe mutations with Zod validation
+- **tRPC Bridge** - Connect server actions to existing procedures
+- **Route Groups** - Organize routes with `(group)` folders
+
+## Server Actions
+
+Create type-safe server actions with Zod validation:
+
+```typescript
+// src/actions/users.ts
+import { action } from '@veloxts/web';
+import { z } from 'zod';
+
+export const createUser = action()
+  .input(z.object({
+    name: z.string().min(1),
+    email: z.string().email(),
+  }))
+  .output(z.object({
+    id: z.string(),
+    name: z.string(),
+    email: z.string(),
+  }))
+  .handler(async (input) => {
+    return await db.user.create({ data: input });
+  });
+
+// Protected action (requires authentication)
+export const updateProfile = action()
+  .input(z.object({ name: z.string() }))
+  .protected()
+  .handler(async (input, ctx) => {
+    // ctx.user is guaranteed to exist
+    return await db.user.update({
+      where: { id: ctx.user.id },
+      data: input,
+    });
+  });
+```
+
+Use in React components:
+
+```tsx
+'use client';
+
+import { createUser } from '@/actions/users';
+
+export default function NewUserPage() {
+  async function handleSubmit(formData: FormData) {
+    const result = await createUser({
+      name: formData.get('name') as string,
+      email: formData.get('email') as string,
+    });
+
+    if (result.success) {
+      console.log('Created:', result.data);
+    } else {
+      console.error('Error:', result.error.message);
+    }
+  }
+
+  return (
+    <form action={handleSubmit}>
+      <input name="name" required />
+      <input name="email" type="email" required />
+      <button type="submit">Create</button>
+    </form>
+  );
+}
+```
+
+## File-Based Routing
+
+Routes are derived from file structure in `app/pages/`:
+
+| File Path | Route Pattern | Description |
+|-----------|--------------|-------------|
+| `index.tsx` | `/` | Home page |
+| `about.tsx` | `/about` | Static page |
+| `users/[id].tsx` | `/users/:id` | Dynamic segment |
+| `docs/[...slug].tsx` | `/docs/*` | Catch-all route |
+| `(auth)/login.tsx` | `/login` | Route group (no prefix) |
+
+### Dynamic Routes
+
+```tsx
+// app/pages/users/[id].tsx
+interface PageProps {
+  params: { id: string };
+  searchParams: Record<string, string | string[]>;
+}
+
+export default async function UserPage({ params }: PageProps) {
+  const user = await db.user.findUnique({ where: { id: params.id } });
+  return <h1>{user.name}</h1>;
+}
+```
+
+### Layouts
+
+Create `_layout.tsx` for shared layouts:
+
+```tsx
+// app/pages/_layout.tsx (root layout)
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body>
+        <nav>{/* Navigation */}</nav>
+        <main>{children}</main>
+      </body>
+    </html>
+  );
+}
+```
+
+## tRPC Bridge
+
+Connect server actions to existing tRPC procedures:
+
+```typescript
+// src/actions/bridge.ts
+import { createTrpcBridge } from '@veloxts/web';
+import type { AppRouter } from '@/trpc/router';
+
+export const bridge = createTrpcBridge<AppRouter>({
+  trpcBase: '/trpc',
+});
+
+// Create type-safe actions from procedures
+export const getUser = bridge.createAction('users.get');
+export const updateUser = bridge.createProtectedAction('users.update');
+```
+
+## Requirements
+
+- Node.js 20+
+- React 19+
+- TypeScript 5.5+
+
+## Documentation
+
+Complete documentation at [@veloxts/velox](https://www.npmjs.com/package/@veloxts/velox).
+
+## Status
+
+**v0.6.x** - Early preview. APIs stabilizing with 615+ tests and 94.4% coverage.
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/web",
-  "version": "0.6.26",
+  "version": "0.6.27",
   "description": "React Server Components integration for VeloxTS framework using Vinxi",
   "type": "module",
   "main": "dist/index.js",
@@ -30,7 +30,10 @@
   "files": [
     "dist",
     "templates",
-    "README.md"
+    "README.md",
+    "GUIDE.md",
+    "LICENSE",
+    "CHANGELOG.md"
   ],
   "dependencies": {
     "@vinxi/server-functions": "0.5.1",
@@ -41,10 +44,10 @@
   "peerDependencies": {
     "react": ">=19.2.0",
     "react-dom": ">=19.2.0",
-    "@veloxts/auth": "0.6.26",
-    "@veloxts/client": "0.6.26",
-    "@veloxts/core": "0.6.26",
-    "@veloxts/router": "0.6.26"
+    "@veloxts/client": "0.6.27",
+    "@veloxts/core": "0.6.27",
+    "@veloxts/router": "0.6.27",
+    "@veloxts/auth": "0.6.27"
   },
   "peerDependenciesMeta": {
     "@veloxts/auth": {
@@ -67,10 +70,10 @@
     "react-server-dom-webpack": "19.2.3",
     "typescript": "5.9.3",
     "vitest": "4.0.16",
-    "@veloxts/client": "0.6.26",
-    "@veloxts/auth": "0.6.26",
-    "@veloxts/router": "0.6.26",
-    "@veloxts/core": "0.6.26"
+    "@veloxts/auth": "0.6.27",
+    "@veloxts/client": "0.6.27",
+    "@veloxts/router": "0.6.27",
+    "@veloxts/core": "0.6.27"
   },
   "keywords": [
     "velox",