nuxt-users 1.30.0 → 1.31.0

package/CHANGELOG.md

@@ -1,6 +1,30 @@
 # Changelog
 
 
+## v1.31.0
+
+[compare changes](https://github.com/rrd108/nuxt-users/compare/v1.30.0...v1.31.0)
+
+### 🚀 Enhancements
+
+- Extends NUsersList with customizable user actions ([1ea4f61](https://github.com/rrd108/nuxt-users/commit/1ea4f61))
+- Adds filtering functionality to user list ([c3d25a9](https://github.com/rrd108/nuxt-users/commit/c3d25a9))
+
+### 🩹 Fixes
+
+- Missing connector.options closes #96 ([#96](https://github.com/rrd108/nuxt-users/issues/96))
+- Using user provided properties ([07dd6a2](https://github.com/rrd108/nuxt-users/commit/07dd6a2))
+- Typo in file name ([d833e52](https://github.com/rrd108/nuxt-users/commit/d833e52))
+- Includes scripts directory in the published package ([ceaa188](https://github.com/rrd108/nuxt-users/commit/ceaa188))
+
+### 🏡 Chore
+
+- **release:** V1.30.0 ([08d081c](https://github.com/rrd108/nuxt-users/commit/08d081c))
+
+### ❤️ Contributors
+
+- Rrd108 ([@rrd108](https://github.com/rrd108))
+
 ## v1.30.0
 
 [compare changes](https://github.com/rrd108/nuxt-users/compare/v1.29.1...v1.30.0)

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "nuxt-users",
   "configKey": "nuxtUsers",
-  "version": "1.30.0",
+  "version": "1.31.0",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nuxt-users",
-  "version": "1.30.0",
+  "version": "1.31.0",
   "description": "A comprehensive user management module for Nuxt 3 and Nuxt 4 applications with authentication, authorization, database support, and CLI tools",
   "keywords": [
     "nuxt",
@@ -47,7 +47,8 @@
   "main": "./dist/module.mjs",
   "types": "./dist/types.d.mts",
   "files": [
-    "dist"
+    "dist",
+    "scripts"
   ],
   "bin": {
     "nuxt-users": "./dist/cli.mjs"

package/scripts/check-peer-dependencies.js

@@ -0,0 +1,141 @@
+#!/usr/bin/env node
+
+import { readFileSync, existsSync } from 'node:fs'
+import { join } from 'node:path'
+
+const REQUIRED_PEERS = ['bcrypt', 'nodemailer', '@nuxt/kit']
+const OPTIONAL_PEERS = ['nuxt-api-shield']
+
+function checkPackageJson() {
+  const missing = []
+  const optional = []
+
+  try {
+    // Look for package.json in the consumer app (current working directory)
+    const pkgPath = join(process.cwd(), 'package.json')
+
+    if (!existsSync(pkgPath)) {
+      console.log('⚠️  Could not find package.json in current directory')
+      return { missing: REQUIRED_PEERS, optional: OPTIONAL_PEERS }
+    }
+
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'))
+
+    // Check all possible dependency locations
+    const allDeps = {
+      ...pkg.dependencies || {},
+      ...pkg.devDependencies || {},
+      ...pkg.peerDependencies || {}
+    }
+
+    // Check required dependencies
+    for (const dep of REQUIRED_PEERS) {
+      if (!allDeps[dep]) {
+        missing.push(dep)
+      }
+    }
+
+    // Check optional dependencies
+    for (const dep of OPTIONAL_PEERS) {
+      if (!allDeps[dep]) {
+        optional.push(dep)
+      }
+    }
+
+    return { missing, optional, packageName: pkg.name || 'your project' }
+  }
+  catch (error) {
+    console.log('⚠️  Error reading package.json:', error.message)
+    // If we can't read package.json, assume all deps are missing
+    return { missing: REQUIRED_PEERS, optional: OPTIONAL_PEERS, packageName: 'your project' }
+  }
+}
+
+function getPackageManagerCommand() {
+  // Detect package manager from lock files or environment
+  const cwd = process.cwd()
+
+  if (existsSync(join(cwd, 'pnpm-lock.yaml'))) {
+    return 'pnpm add'
+  }
+  else if (existsSync(join(cwd, 'yarn.lock'))) {
+    return 'yarn add'
+  }
+  else if (existsSync(join(cwd, 'package-lock.json'))) {
+    return 'npm install'
+  }
+  else if (process.env.npm_config_user_agent?.includes('pnpm')) {
+    return 'pnpm add'
+  }
+  else if (process.env.npm_config_user_agent?.includes('yarn')) {
+    return 'yarn add'
+  }
+
+  // Default fallback
+  return 'npm install'
+}
+
+function displayResults({ missing, optional, packageName }) {
+  const primaryCmd = getPackageManagerCommand()
+
+  if (missing.length > 0) {
+    console.log('\n🚨 nuxt-users: Missing required peer dependencies!')
+    console.log(`Project: ${packageName}`)
+    console.log('These dependencies are required for nuxt-users to work properly.\n')
+
+    console.log('💾 Missing dependencies:')
+    missing.forEach(dep => console.log(`  - ${dep}`))
+    console.log('')
+
+    console.log('🔧 Install command (detected):')
+    console.log(`  ${primaryCmd} ${missing.join(' ')}\n`)
+
+    console.log('🔧 Alternative install commands:')
+    console.log(`  npm install ${missing.join(' ')}`)
+    console.log(`  pnpm add ${missing.join(' ')}`)
+    console.log(`  yarn add ${missing.join(' ')}\n`)
+
+    console.log('📚 Documentation: https://nuxt-users.webmania.cc/installation')
+    console.log('🐛 Issues: https://github.com/rrd108/nuxt-users/issues\n')
+
+    // Exit with error code to make installation fail
+    process.exit(1)
+  }
+
+  if (optional.length > 0 && missing.length === 0) {
+    console.log('\n💡 nuxt-users: Optional dependencies available!')
+    console.log(`Project: ${packageName}`)
+    console.log('These provide additional security and features:\n')
+
+    console.log('🔒 Optional dependencies:')
+    optional.forEach(dep => console.log(`  - ${dep}`))
+    console.log('')
+
+    console.log('🔧 Install command (detected):')
+    console.log(`  ${primaryCmd} ${optional.join(' ')}\n`)
+
+    console.log('🔧 Alternative install commands:')
+    console.log(`  npm install ${optional.join(' ')}`)
+    console.log(`  pnpm add ${optional.join(' ')}`)
+    console.log(`  yarn add ${optional.join(' ')}\n`)
+  }
+
+  if (missing.length === 0 && optional.length === 0) {
+    console.log(`✅ nuxt-users: All dependencies found in ${packageName}!`)
+  }
+  else if (missing.length === 0) {
+    console.log(`✅ nuxt-users: All required dependencies found in ${packageName}!`)
+  }
+}
+
+async function checkPeerDependencies() {
+  const result = checkPackageJson()
+  displayResults(result)
+}
+
+// Handle both direct execution and module import
+if (import.meta.url === `file://${process.argv[1]}`) {
+  checkPeerDependencies().catch(console.error)
+}
+
+export { checkPeerDependencies }

package/scripts/deploy-docs.sh

@@ -0,0 +1,69 @@
+#!/bin/bash
+
+# Configuration
+SERVER_HOST="35.198.93.8"
+SERVER_USER="sravanam"
+REMOTE_DOCS_PATH="/var/www/nuxt-users.webmania.cc"
+LOCAL_BUILD_PATH="docs/.vitepress/dist"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+echo -e "${YELLOW}🚀 Starting documentation deployment...${NC}"
+
+# Check if build directory exists
+if [ ! -d "$LOCAL_BUILD_PATH" ]; then
+    echo -e "${RED}❌ Build directory not found: $LOCAL_BUILD_PATH${NC}"
+    echo -e "${YELLOW}💡 Make sure to run 'npm run docs:build' first${NC}"
+    exit 1
+fi
+
+# Create a temporary tar file for transfer
+TEMP_TAR="docs-build-$(date +%Y%m%d-%H%M%S).tar.gz"
+echo -e "${YELLOW}📦 Creating archive: $TEMP_TAR${NC}"
+tar -czf "$TEMP_TAR" -C "$LOCAL_BUILD_PATH" .
+
+# Upload and deploy
+echo -e "${YELLOW}📤 Uploading to $SERVER_HOST...${NC}"
+ssh "$SERVER_USER@$SERVER_HOST" << EOF
+    # Create backup of current docs
+    if [ -d "$REMOTE_DOCS_PATH" ]; then
+        echo "📋 Creating backup of current documentation..."
+        cp -r "$REMOTE_DOCS_PATH" "${REMOTE_DOCS_PATH}-backup-\$(date +%Y%m%d-%H%M%S)"
+    fi
+    
+    # Create docs directory if it doesn't exist
+    mkdir -p "$REMOTE_DOCS_PATH"
+    
+    # Clean the docs directory
+    rm -rf "$REMOTE_DOCS_PATH"/*
+    
+    echo "✅ Ready for new files"
+EOF
+
+# Copy the tar file to server
+scp "$TEMP_TAR" "$SERVER_USER@$SERVER_HOST:/tmp/"
+
+# Extract and deploy on server
+ssh "$SERVER_USER@$SERVER_HOST" << EOF
+    echo "📦 Extracting documentation..."
+    tar -xzf "/tmp/$TEMP_TAR" -C "$REMOTE_DOCS_PATH"
+    
+    # Set proper permissions
+    chmod -R 755 "$REMOTE_DOCS_PATH"
+    
+    # Clean up temporary files
+    rm "/tmp/$TEMP_TAR"
+    
+    echo "✅ Documentation deployed successfully!"
+    echo "📁 Location: $REMOTE_DOCS_PATH"
+EOF
+
+# Clean up local temporary file
+rm "$TEMP_TAR"
+
+echo -e "${GREEN}✅ Documentation deployment completed!${NC}"
+echo -e "${YELLOW}🌐 Your docs should now be available on your server${NC}" 

package/scripts/post-build.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+import { fileURLToPath } from 'node:url'
+import { dirname, join } from 'node:path'
+import { existsSync, writeFileSync, rmdirSync, unlinkSync, readdirSync, readFileSync } from 'node:fs'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const projectRoot = join(__dirname, '..')
+const distDir = join(projectRoot, 'dist')
+const utilsDir = join(distDir, 'utils')
+const utilsIndexFile = join(utilsDir, 'index.js')
+const utilsRootFile = join(distDir, 'utils.js')
+
+// Remove existing utils directory if it exists
+if (existsSync(utilsDir)) {
+  try {
+    if (existsSync(utilsIndexFile)) {
+      unlinkSync(utilsIndexFile)
+    }
+    rmdirSync(utilsDir)
+  }
+  catch {
+    // Ignore errors
+  }
+}
+
+// Create utils.js in the dist root to handle "../../../utils" imports
+// This allows imports like "../../../utils" to resolve to a file instead of directory
+const rootIndexContent = `export * from './utils.mjs'
+`
+writeFileSync(utilsRootFile, rootIndexContent)
+
+// Note: Types imports should be handled by TypeScript compilation, not runtime
+
+// Fix import paths in built files to include .js extensions for ES modules
+const runtimeUtilsDir = join(distDir, 'runtime')
+
+// Function to recursively find and fix import statements
+function fixImportPaths(dir) {
+  const items = readdirSync(dir, { withFileTypes: true })
+
+  for (const item of items) {
+    const fullPath = join(dir, item.name)
+
+    if (item.isDirectory()) {
+      fixImportPaths(fullPath)
+    }
+    else if (item.isFile() && (item.name.endsWith('.js') || item.name.endsWith('.mjs') || item.name.endsWith('.vue') || item.name.endsWith('.ts'))) {
+      let content = readFileSync(fullPath, 'utf8')
+      let modified = false
+
+      // Transform relative imports to utils/imports back to nuxt-users/utils for consumers
+      const relativeImportsRegex = /from\s+["'](\.\.[/\\])*utils[/\\]imports["']/g
+      if (relativeImportsRegex.test(content)) {
+        content = content.replace(relativeImportsRegex, 'from "nuxt-users/utils"')
+        modified = true
+      }
+
+      // Transform other relative utils imports
+      const utilsImportRegex = /from\s+["']\.\.[/\\]utils[/\\]imports["']/g
+      if (utilsImportRegex.test(content)) {
+        content = content.replace(utilsImportRegex, 'from "nuxt-users/utils"')
+        modified = true
+      }
+
+      if (modified) {
+        writeFileSync(fullPath, content)
+        console.log(`[Nuxt Users] Transformed import paths in ${fullPath}`)
+      }
+    }
+  }
+}
+
+fixImportPaths(runtimeUtilsDir)
+
+console.log('[Nuxt Users] Created utils.js file and fixed import paths for ES modules')

package/scripts/test-integration.sh

@@ -0,0 +1,136 @@
+#!/bin/bash
+
+# Integration test script for nuxt-users module
+# Tests playground middleware functionality locally
+
+set -e
+
+echo "🚀 Starting nuxt-users integration tests..."
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Function to print colored output
+print_status() {
+    local color=$1
+    local message=$2
+    echo -e "${color}${message}${NC}"
+}
+
+# Function to cleanup background processes
+cleanup() {
+    if [ ! -z "$SERVER_PID" ]; then
+        print_status $YELLOW "🧹 Cleaning up server (PID: $SERVER_PID)..."
+        kill $SERVER_PID 2>/dev/null || true
+        wait $SERVER_PID 2>/dev/null || true
+    fi
+}
+
+# Set up trap for cleanup on script exit
+trap cleanup EXIT
+
+# Check if we're in the right directory
+if [ ! -f "package.json" ] || [ ! -d "playground" ]; then
+    print_status $RED "❌ Please run this script from the nuxt-users root directory"
+    exit 1
+fi
+
+print_status $BLUE "📦 Preparing development environment..."
+
+# Prepare the module
+npm run dev:prepare
+
+print_status $BLUE "🏗️  Building playground..."
+
+# Build the playground
+cd playground
+npm run build
+
+print_status $BLUE "🖥️  Starting production server..."
+
+# Start the server in background
+node .output/server/index.mjs &
+SERVER_PID=$!
+
+# Wait for server to start
+sleep 3
+
+# Check if server is running
+if ! kill -0 $SERVER_PID 2>/dev/null; then
+    print_status $RED "❌ Server failed to start"
+    exit 1
+fi
+
+print_status $GREEN "✅ Server started successfully (PID: $SERVER_PID)"
+
+# Wait a bit more for server to be fully ready
+sleep 2
+
+print_status $BLUE "🧪 Running integration tests..."
+
+# Test 1: /me endpoint should require authentication (401 without token)
+print_status $YELLOW "🔐 Testing /me endpoint requires authentication..."
+response=$(curl -s -o /dev/null -w "%{http_code}" "http://localhost:3000/api/nuxt-users/me" || echo "000")
+
+if [ "$response" = "401" ]; then
+    print_status $GREEN "✅ /me endpoint properly requires authentication (401 without token)"
+else
+    print_status $RED "❌ /me endpoint should require authentication - expected 401, got $response"
+    print_status $RED "   This means server middleware is not properly registered!"
+    exit 1
+fi
+
+# Test 2: Session endpoint should be accessible (not 401)
+print_status $YELLOW "📝 Testing session endpoint /api/nuxt-users/session..."
+response=$(curl -s -o /dev/null -w "%{http_code}" "http://localhost:3000/api/nuxt-users/session" -X POST || echo "000")
+
+if [ "$response" != "401" ]; then
+    print_status $GREEN "✅ Session endpoint accessible (HTTP $response - auth not blocking)"
+else
+    print_status $RED "❌ Session endpoint blocked by auth - should be accessible for login"
+    exit 1
+fi
+
+# Test 3: Registration endpoint should be auto-whitelisted
+print_status $YELLOW "📋 Testing registration endpoint /api/nuxt-users/register..."
+response=$(curl -s -o /dev/null -w "%{http_code}" "http://localhost:3000/api/nuxt-users/register" -X POST || echo "000")
+
+if [ "$response" != "401" ]; then
+    print_status $GREEN "✅ Registration endpoint accessible (HTTP $response - auto-whitelisted)"
+else
+    print_status $RED "❌ Registration endpoint blocked - auto-whitelisting not working"
+    exit 1
+fi
+
+# Test 4: Test a few more protected endpoints if they exist
+print_status $YELLOW "🔍 Testing other protected endpoints..."
+
+endpoints=(
+    "/api/nuxt-users/profile"
+    "/api/nuxt-users/users"
+)
+
+for endpoint in "${endpoints[@]}"; do
+    response=$(curl -s -o /dev/null -w "%{http_code}" "http://localhost:3000$endpoint" || echo "000")
+    
+    if [ "$response" = "401" ]; then
+        print_status $GREEN "✅ $endpoint properly protected (401)"
+    elif [ "$response" = "404" ]; then
+        print_status $YELLOW "⚠️  $endpoint not found (404) - endpoint may not exist"
+    else
+        print_status $YELLOW "⚠️  $endpoint returned $response - verify this is expected"
+    fi
+done
+
+print_status $GREEN "🎉 All integration tests passed!"
+print_status $BLUE "📊 Test Summary:"
+print_status $BLUE "   • Server middleware registration: ✅ Working"
+print_status $BLUE "   • Authentication enforcement: ✅ Working"
+print_status $BLUE "   • Auto-whitelisting: ✅ Working"
+print_status $BLUE "   • Endpoint accessibility: ✅ Working"
+
+print_status $GREEN "✨ Your nuxt-users module is ready for production!"

package/scripts/test-mysql.sh

@@ -0,0 +1,54 @@
+#!/bin/bash
+
+# MySQL Test Runner Script
+# This script sets up environment variables for MySQL testing
+
+echo "Setting up MySQL test environment..."
+
+# Default MySQL configuration
+export DB_CONNECTOR="mysql"
+export DB_HOST=${DB_HOST:-"localhost"}
+export DB_PORT=${DB_PORT:-"3306"}
+export DB_USER=${DB_USER:-"root"}
+export DB_PASSWORD=${DB_PASSWORD:-"123"}
+export DB_NAME=${DB_NAME:-"test_db"}
+
+echo "Database configuration:"
+echo "  Host: $DB_HOST"
+echo "  Port: $DB_PORT"
+echo "  User: $DB_USER"
+echo "  Database: $DB_NAME"
+
+# Set MySQL password environment variable for consistent authentication
+export MYSQL_PWD="$DB_PASSWORD"
+
+# Wait for MySQL to be ready
+echo "Waiting for MySQL connection..."
+for i in {1..10}; do
+    if mysql -h"$DB_HOST" -P"$DB_PORT" -u"$DB_USER" -e "SELECT 1;" >/dev/null 2>&1; then
+        echo "MySQL connection successful!"
+        break
+    fi
+    echo "MySQL not ready, retrying in 3 seconds... (attempt $i/10)"
+    sleep 3
+done
+
+# Final check if MySQL is running
+if ! mysql -h"$DB_HOST" -P"$DB_PORT" -u"$DB_USER" -e "SELECT 1;" >/dev/null 2>&1; then
+    echo "Error: Cannot connect to MySQL after multiple retries. Please ensure MySQL is running and accessible."
+    echo "You can start MySQL with: docker run --name mysql-test -e MYSQL_ROOT_PASSWORD=123 -e MYSQL_DATABASE=test_db -p 3306:3306 -d mysql:5.7"
+    exit 1
+fi
+
+# Create test database if it doesn't exist
+mysql -h"$DB_HOST" -P"$DB_PORT" -u"$DB_USER" -e "CREATE DATABASE IF NOT EXISTS $DB_NAME;" >/dev/null 2>&1
+
+echo "Running tests against MySQL..."
+
+# Check if any arguments were passed
+if [ $# -eq 0 ]; then
+    # Run all tests except unit tests (database-independent)
+    vitest run --exclude="test/unit/"
+else
+    vitest run "$@"
+fi

package/scripts/test-postgresql.sh

@@ -0,0 +1,93 @@
+#!/bin/bash
+
+# PostgreSQL Test Runner Script
+# This script sets up environment variables for PostgreSQL testing
+
+echo "Setting up PostgreSQL test environment..."
+
+# Default PostgreSQL configuration
+export DB_CONNECTOR="postgresql"
+export DB_HOST=${DB_HOST:-"localhost"}
+export DB_PORT=${DB_PORT:-"5432"}
+export DB_USER=${DB_USER:-"postgres"}
+export DB_PASSWORD=${DB_PASSWORD:-"123"}
+export DB_NAME=${DB_NAME:-"test_db"}
+
+echo "Database configuration:"
+echo "  Host: $DB_HOST"
+echo "  Port: $DB_PORT"
+echo "  User: $DB_USER"
+echo "  Database: $DB_NAME"
+
+# Wait for PostgreSQL to be ready
+echo "Waiting for PostgreSQL connection..."
+for i in {1..10}; do
+    if pg_isready -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -q; then
+        echo "PostgreSQL connection successful!"
+        break
+    fi
+    echo "PostgreSQL not ready, retrying in 3 seconds... (attempt $i/10)"
+    sleep 3
+done
+
+# Final check if PostgreSQL is running
+if ! pg_isready -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -q; then
+    echo "Error: Cannot connect to PostgreSQL after multiple retries. Please ensure PostgreSQL is running and accessible."
+    echo "You can start PostgreSQL with: docker run --name postgres-test -e POSTGRES_PASSWORD=123 -e POSTGRES_DB=test_db -p 5432:5432 -d postgres:13"
+    exit 1
+fi
+
+# Recreate the test database to ensure a clean state
+echo "Recreating test database '$DB_NAME'..."
+
+# Drop database if exists (ignore errors)
+PGPASSWORD="$DB_PASSWORD" psql -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -d postgres -c "DROP DATABASE IF EXISTS \"$DB_NAME\";" >/dev/null 2>&1
+
+# Create database with proper encoding to avoid collation issues
+PGPASSWORD="$DB_PASSWORD" psql -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -d postgres -c "CREATE DATABASE \"$DB_NAME\" WITH ENCODING 'UTF8' LC_COLLATE='C' LC_CTYPE='C';" >/dev/null 2>&1
+
+# Verify database was created
+if ! PGPASSWORD="$DB_PASSWORD" psql -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -d "$DB_NAME" -c "SELECT 1;" >/dev/null 2>&1; then
+    echo "Error: Failed to create or connect to database '$DB_NAME'"
+    echo "Trying alternative approach..."
+    
+    # Try creating with template0 to avoid collation issues
+    PGPASSWORD="$DB_PASSWORD" psql -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -d postgres -c "CREATE DATABASE \"$DB_NAME\" TEMPLATE template0;" >/dev/null 2>&1
+    
+    if ! PGPASSWORD="$DB_PASSWORD" psql -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -d "$DB_NAME" -c "SELECT 1;" >/dev/null 2>&1; then
+        echo "Error: Still cannot create database. Please check PostgreSQL configuration."
+        exit 1
+    fi
+fi
+
+echo "Database '$DB_NAME' created successfully!"
+
+# Wait a moment for database to be ready
+sleep 2
+
+# Configure PostgreSQL for testing (increase connection limits)
+echo "Configuring PostgreSQL for testing..."
+PGPASSWORD="$DB_PASSWORD" psql -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -d "$DB_NAME" -c "ALTER SYSTEM SET max_connections = 500;" >/dev/null 2>&1
+PGPASSWORD="$DB_PASSWORD" psql -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -d "$DB_NAME" -c "ALTER SYSTEM SET shared_preload_libraries = 'pg_stat_statements';" >/dev/null 2>&1
+PGPASSWORD="$DB_PASSWORD" psql -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -d "$DB_NAME" -c "ALTER SYSTEM SET log_statement = 'none';" >/dev/null 2>&1
+PGPASSWORD="$DB_PASSWORD" psql -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -d "$DB_NAME" -c "ALTER SYSTEM SET log_min_duration_statement = -1;" >/dev/null 2>&1
+PGPASSWORD="$DB_PASSWORD" psql -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -d "$DB_NAME" -c "ALTER SYSTEM SET idle_in_transaction_session_timeout = '10s';" >/dev/null 2>&1
+PGPASSWORD="$DB_PASSWORD" psql -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -d "$DB_NAME" -c "SELECT pg_reload_conf();" >/dev/null 2>&1
+
+# Kill any idle connections to free up slots
+echo "Cleaning up idle connections..."
+PGPASSWORD="$DB_PASSWORD" psql -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -d "$DB_NAME" -c "
+SELECT pg_terminate_backend(pid) 
+FROM pg_stat_activity 
+WHERE state IN ('idle', 'idle in transaction') AND pid <> pg_backend_pid();
+" >/dev/null 2>&1
+
+echo "Running tests against PostgreSQL..."
+
+# Check if any arguments were passed
+if [ $# -eq 0 ]; then
+    # Run all tests except unit tests (database-independent)
+    vitest run --exclude="test/unit/"
+else
+    vitest run "$@"
+fi

package/scripts/test-sqlite.sh

@@ -0,0 +1,23 @@
+#!/bin/bash
+
+# SQLite Test Runner Script
+# This script sets up environment variables for SQLite testing
+
+echo "Setting up SQLite test environment..."
+
+# Force SQLite configuration
+export DB_CONNECTOR="sqlite"
+
+echo "Database configuration:"
+echo "  Type: SQLite"
+echo "  Path: ./_test-db (default)"
+
+echo "Running tests against SQLite..."
+
+# Check if any arguments were passed
+if [ $# -eq 0 ]; then
+    # Run all tests except unit tests (database-independent)
+    vitest run --exclude="test/unit/"
+else
+    vitest run "$@"
+fi

package/scripts/test-unit.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+
+# Unit Test Runner Script
+# This script runs tests that don't require database access
+
+echo "Running unit tests (no database required)..."
+
+# Check if any arguments were passed
+if [ $# -eq 0 ]; then
+    # Run all unit tests
+    vitest run test/unit/
+else
+    # Run only the specified test
+    vitest run "$@"
+fi