create-velox-app 0.6.27 → 0.6.29

package/src/templates/source/api/env.auth

@@ -1,8 +1,5 @@
 # Database URL
-# SQLite (local development):
-DATABASE_URL="file:./dev.db"
-# PostgreSQL (production):
-# DATABASE_URL="postgresql://user:password@localhost:5432/myapp"
+DATABASE_URL="__DATABASE_URL__"
 
 # Server Configuration
 PORT=__API_PORT__

package/src/templates/source/api/env.default

@@ -1,8 +1,5 @@
 # Database URL
-# SQLite (local development):
-DATABASE_URL="file:./dev.db"
-# PostgreSQL (production):
-# DATABASE_URL="postgresql://user:password@localhost:5432/myapp"
+DATABASE_URL="__DATABASE_URL__"
 
 # Server Configuration
 PORT=__API_PORT__

package/src/templates/source/api/prisma/schema.auth.prisma

@@ -1,7 +1,6 @@
 // Prisma Schema
 //
 // This schema defines the database structure with authentication support.
-// Using SQLite for simplicity - easily swap to PostgreSQL for production.
 
 generator client {
   provider = "prisma-client-js"
@@ -10,7 +9,7 @@ generator client {
 }
 
 datasource db {
-  provider = "sqlite"
+  provider = "__DATABASE_PROVIDER__"
 }
 
 // ============================================================================

package/src/templates/source/api/prisma/schema.default.prisma

@@ -1,7 +1,6 @@
 // Prisma Schema
 //
 // This schema defines the database structure.
-// Using SQLite for simplicity - easily swap to PostgreSQL for production.
 
 generator client {
   provider = "prisma-client-js"
@@ -10,7 +9,7 @@ generator client {
 }
 
 datasource db {
-  provider = "sqlite"
+  provider = "__DATABASE_PROVIDER__"
 }
 
 // ============================================================================

package/src/templates/source/api/procedures/auth.ts

@@ -15,10 +15,10 @@ import {
   AuthError,
   authenticated,
   createAuthRateLimiter,
-  defineProcedures,
   hashPassword,
   jwtManager,
   procedure,
+  procedures,
   verifyPassword,
 } from '@veloxts/velox';
 
@@ -104,7 +104,7 @@ const DUMMY_HASH = '$2b$12$LQv3c1yqBWVHxkd0LHAkCOYz6TtxMQJqhN8/X4.uy7dPSSXB5G6Uy
 // Auth Procedures
 // ============================================================================
 
-export const authProcedures = defineProcedures('auth', {
+export const authProcedures = procedures('auth', {
   createAccount: procedure()
     .rest({ method: 'POST', path: '/auth/register' })
     .use(rateLimiter.register())

package/src/templates/source/api/procedures/health.ts

@@ -2,11 +2,11 @@
  * Health Check Procedures
  */
 
-import { defineProcedures, procedure, VELOX_VERSION } from '@veloxts/velox';
+import { procedure, procedures, VELOX_VERSION } from '@veloxts/velox';
 
 import { HealthResponse } from '../schemas/health.js';
 
-export const healthProcedures = defineProcedures('health', {
+export const healthProcedures = procedures('health', {
   getHealth: procedure()
     .rest({ method: 'GET', path: '/health' })
     .output(HealthResponse)

package/src/templates/source/api/procedures/users.auth.ts

@@ -11,12 +11,12 @@
 import {
   AuthError,
   authenticated,
-  defineProcedures,
   GuardError,
   hasRole,
   NotFoundError,
   paginationInputSchema,
   procedure,
+  procedures,
   z,
 } from '@veloxts/velox';
 
@@ -31,7 +31,7 @@ import {
 // User Procedures
 // ============================================================================
 
-export const userProcedures = defineProcedures('users', {
+export const userProcedures = procedures('users', {
   getUser: procedure()
     .input(z.object({ id: z.string().uuid() }))
     .output(UserSchema)

package/src/templates/source/api/procedures/users.default.ts

@@ -7,13 +7,7 @@
  * - Output schema automatically serializes Date → string via withTimestamps()
  */
 
-import {
-  defineProcedures,
-  NotFoundError,
-  paginationInputSchema,
-  procedure,
-  z,
-} from '@veloxts/velox';
+import { NotFoundError, paginationInputSchema, procedure, procedures, z } from '@veloxts/velox';
 
 import {
   CreateUserInput,
@@ -22,7 +16,7 @@ import {
   UserSchema,
 } from '../schemas/user.js';
 
-export const userProcedures = defineProcedures('users', {
+export const userProcedures = procedures('users', {
   getUser: procedure()
     .input(z.object({ id: z.string().uuid() }))
     .output(UserSchema)

package/src/templates/source/root/.cursorrules

@@ -53,9 +53,9 @@ CRITICAL - Never violate these rules:
 ### Procedure Pattern
 
 ```typescript
-import { defineProcedures, procedure, z } from '@veloxts/velox';
+import { procedure, procedures, z } from '@veloxts/velox';
 
-export const entityProcedures = defineProcedures('entities', {
+export const entityProcedures = procedures('entities', {
   getEntity: procedure()
     .input(z.object({ id: z.string().uuid() }))
     .output(EntitySchema)
@@ -144,7 +144,7 @@ __RUN_CMD__ db:studio                # Open Prisma Studio
 
 ```typescript
 // VeloxTS imports (use umbrella package)
-import { defineProcedures, procedure, z } from '@veloxts/velox';
+import { procedure, procedures, z } from '@veloxts/velox';
 /* @if auth */
 import { authenticated, hasRole } from '@veloxts/auth';
 /* @endif auth */

package/src/templates/source/root/CLAUDE.auth.md

@@ -46,9 +46,9 @@ apps/
 
 ```typescript
 // apps/api/src/procedures/posts.ts
-import { defineProcedures, procedure, z } from '@veloxts/velox';
+import { procedure, procedures, z } from '@veloxts/velox';
 
-export const postProcedures = defineProcedures('posts', {
+export const postProcedures = procedures('posts', {
   // GET /api/posts/:id
   getPost: procedure()
     .input(z.object({ id: z.string().uuid() }))

package/src/templates/source/root/CLAUDE.default.md

@@ -45,9 +45,9 @@ apps/
 
 ```typescript
 // apps/api/src/procedures/posts.ts
-import { defineProcedures, procedure, z } from '@veloxts/velox';
+import { procedure, procedures, z } from '@veloxts/velox';
 
-export const postProcedures = defineProcedures('posts', {
+export const postProcedures = procedures('posts', {
   // GET /api/posts/:id
   getPost: procedure()
     .input(z.object({ id: z.string().uuid() }))

package/src/templates/source/rsc/env.example

@@ -1,5 +1,5 @@
 # Database
-DATABASE_URL="file:./dev.db"
+DATABASE_URL="__DATABASE_URL__"
 
 # Server
 PORT=__API_PORT__

package/src/templates/source/rsc/prisma/schema.prisma

@@ -6,7 +6,7 @@ generator client {
 }
 
 datasource db {
-  provider = "sqlite"
+  provider = "__DATABASE_PROVIDER__"
 }
 
 model User {

package/src/templates/source/rsc/src/api/database.ts

@@ -13,16 +13,33 @@ import { createRequire } from 'node:module';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
+/* @if sqlite */
 // Type imports (erased at runtime, safe for ESM)
 import type { PrismaBetterSqlite3 as PrismaBetterSqlite3Type } from '@prisma/adapter-better-sqlite3';
+/* @endif sqlite */
+/* @if postgresql */
+// Type imports (erased at runtime, safe for ESM)
+import type { PrismaPg as PrismaPgType } from '@prisma/adapter-pg';
+/* @endif postgresql */
 import type { PrismaClient as PrismaClientType } from '@prisma/client';
 import dotenv from 'dotenv';
+import type { Pool as PoolType } from 'pg';
 
 // Runtime imports using createRequire for Node.js v24+ CJS interop
 const require = createRequire(import.meta.url);
+/* @if sqlite */
 const { PrismaBetterSqlite3 } = require('@prisma/adapter-better-sqlite3') as {
   PrismaBetterSqlite3: typeof PrismaBetterSqlite3Type;
 };
+/* @endif sqlite */
+/* @if postgresql */
+const { PrismaPg } = require('@prisma/adapter-pg') as {
+  PrismaPg: typeof PrismaPgType;
+};
+const { Pool } = require('pg') as {
+  Pool: typeof PoolType;
+};
+/* @endif postgresql */
 const { PrismaClient } = require('@prisma/client') as {
   PrismaClient: typeof PrismaClientType;
 };
@@ -39,8 +56,13 @@ declare global {
   // Allow global `var` declarations for hot reload in development
   // eslint-disable-next-line no-var
   var __db: PrismaClient | undefined;
+  /* @if postgresql */
+  // eslint-disable-next-line no-var
+  var __pool: InstanceType<typeof PoolType> | undefined;
+  /* @endif postgresql */
 }
 
+/* @if sqlite */
 /**
  * Create a Prisma client instance using the SQLite adapter.
  *
@@ -63,10 +85,64 @@ function createPrismaClient(): PrismaClient {
   const adapter = new PrismaBetterSqlite3({ url: databaseUrl });
   return new PrismaClient({ adapter });
 }
+/* @endif sqlite */
+/* @if postgresql */
+/**
+ * Create a PostgreSQL connection pool.
+ * Uses connection pooling for better performance in production.
+ */
+function createPool(): InstanceType<typeof PoolType> {
+  const databaseUrl = process.env.DATABASE_URL;
 
+  if (!databaseUrl) {
+    throw new Error(
+      '[VeloxTS] DATABASE_URL environment variable is not set. ' +
+        'Ensure .env file exists in project root with DATABASE_URL defined.'
+    );
+  }
+
+  return new Pool({
+    connectionString: databaseUrl,
+    max: 10, // Maximum connections in pool
+  });
+}
+
+/**
+ * Create a Prisma client instance using the PostgreSQL adapter.
+ * Uses connection pooling for efficient database access.
+ */
+function createPrismaClient(pool: InstanceType<typeof PoolType>): PrismaClient {
+  // Prisma 7 requires driver adapters for direct connections
+  const adapter = new PrismaPg(pool);
+  return new PrismaClient({ adapter });
+}
+/* @endif postgresql */
+
+/* @if sqlite */
 // Use global singleton for hot reload in development
 export const db = globalThis.__db ?? createPrismaClient();
 
 if (process.env.NODE_ENV !== 'production') {
   globalThis.__db = db;
 }
+/* @endif sqlite */
+/* @if postgresql */
+// Use global singletons for hot reload in development
+const pool = globalThis.__pool ?? createPool();
+export const db = globalThis.__db ?? createPrismaClient(pool);
+
+if (process.env.NODE_ENV !== 'production') {
+  globalThis.__pool = pool;
+  globalThis.__db = db;
+}
+
+// Graceful shutdown - close pool on process exit
+const shutdown = async () => {
+  await db.$disconnect();
+  await pool.end();
+  process.exit(0);
+};
+
+process.on('SIGTERM', shutdown);
+process.on('SIGINT', shutdown);
+/* @endif postgresql */

package/src/templates/source/rsc/src/api/procedures/health.ts

@@ -4,11 +4,11 @@
  * API endpoints for application health monitoring.
  */
 
-import { defineProcedures, procedure } from '@veloxts/router';
+import { procedure, procedures } from '@veloxts/router';
 
 import { db } from '../database.js';
 
-export const healthProcedures = defineProcedures('health', {
+export const healthProcedures = procedures('health', {
   /**
    * Basic health check
    * GET /api/health

package/src/templates/source/rsc/src/api/procedures/posts.ts

@@ -6,7 +6,7 @@
  * Routes: /api/users/:userId/posts/*
  */
 
-import { defineProcedures, procedure } from '@veloxts/router';
+import { procedure, procedures } from '@veloxts/router';
 import { z } from 'zod';
 
 import { db } from '../database.js';
@@ -17,7 +17,7 @@ import {
   UpdatePostSchema,
 } from '../schemas/post.js';
 
-export const postProcedures = defineProcedures('posts', {
+export const postProcedures = procedures('posts', {
   /**
    * List all posts for a user
    * GET /api/users/:userId/posts

package/src/templates/source/rsc/src/api/procedures/users.ts

@@ -5,13 +5,13 @@
  * Uses direct db import for proper PrismaClient typing.
  */
 
-import { defineProcedures, procedure } from '@veloxts/router';
+import { procedure, procedures } from '@veloxts/router';
 import { z } from 'zod';
 
 import { db } from '../database.js';
 import { CreateUserSchema, UpdateUserSchema, UserSchema } from '../schemas/user.js';
 
-export const userProcedures = defineProcedures('users', {
+export const userProcedures = procedures('users', {
   /**
    * List all users
    * GET /api/users