jest.setup.js

process.env.NODE_ENV = 'test';
// Load test-specific env first when present, and never override variables already
// provided by the shell/CI job.
const path = require('path');
const dotenv = require('dotenv');

dotenv.config({ path: path.resolve(__dirname, '.env.test'), override: false });
dotenv.config({ override: false });

// Ensure JWT_SECRET is set so validateEnv() in src/index.ts does not process.exit(1) when tests import createApp.
if (!process.env.JWT_SECRET || process.env.JWT_SECRET.length < 16) {
  process.env.JWT_SECRET = 'test-jwt-secret-with-sufficient-length';
}

const DUMMY_DB_URL = 'postgresql://test_user:test_pass@localhost:5432/test_db?schema=public';

// Ensure DATABASE_URL is set so src/config/index.ts validation passes in unit tests
// that mock Prisma and do not require a real database.
if (!process.env.DATABASE_URL) {
  process.env.DATABASE_URL = DUMMY_DB_URL;
}

// Soroban fixture defaults — used by src/tests/soroban-fixture.spec.ts.
// These must be set BEFORE any module loads because SorobanService is a
// singleton whose constructor calls init() during its module import.
// Override via .env.test or shell to use real testnet credentials.
if (!process.env.SOROBAN_CONTRACT_ID) {
  process.env.SOROBAN_CONTRACT_ID = 'CCJZ5DGZBW5JRZYPZ6J6V3JZ5Z5Z5Z5Z5Z5Z5Z5Z5Z5Z5Z5Z5Z5Z5Z5Z5Z';
}
if (!process.env.SOROBAN_NETWORK) {
  process.env.SOROBAN_NETWORK = 'testnet';
}
if (!process.env.SOROBAN_RPC_URL) {
  process.env.SOROBAN_RPC_URL = 'https://soroban-testnet.stellar.org';
}
if (!process.env.SOROBAN_ADMIN_SECRET) {
  process.env.SOROBAN_ADMIN_SECRET = 'SBJDSFHKJDFHKJDSHFKJDSHFKJDSHFKJDSHFKJDSHFKJDSHFKJDSHFKJDSHF';
}
if (!process.env.SOROBAN_ORACLE_SECRET) {
  process.env.SOROBAN_ORACLE_SECRET = 'SABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDE';
}

// Global helper to check if a real DB is available
global.hasDb = Boolean(
  process.env.DATABASE_URL &&
  process.env.DATABASE_URL !== DUMMY_DB_URL &&
  !process.env.DATABASE_URL.includes('test_pass@localhost') &&
  !process.env.DATABASE_URL.includes('test_user:test_pass@localhost')
);

/**
 * Utility to skip DB-dependent tests if database is unavailable.
 * Use in test suites that require a real database connection.
 */
global.describeIfDb = (name, fn) => {
  const { describe } = require('@jest/globals');
  if (global.hasDb || process.env.RUN_DB_TESTS === 'true' || process.env.CI === 'true') {
    describe(name, fn);
  } else {
    describe.skip(`[DB SKIPPED] ${name}`, fn);
  }
};

/**
 * Helper to verify database connectivity.
 * Returns true if database is available, false otherwise.
 */
global.checkDbConnectivity = async () => {
  if (!global.hasDb) {
    console.warn('DATABASE_URL not configured or is dummy URL. Database tests will be skipped.');
    return false;
  }
  
  try {
    const { prisma } = require('./src/lib/prisma');
    await prisma.$queryRaw`SELECT 1`;
    return true;
  } catch (error) {
    console.error('Database connectivity check failed:', error.message);
    console.error('');
    console.error('To set up the test database, run:');
    console.error('  npm run test:db:setup');
    console.error('');
    return false;
  }
};

/**
 * Auto-setup helper for integration tests.
 * Checks if database is set up and provides helpful error messages.
 */
global.ensureTestDb = async () => {
  if (!global.hasDb) {
    throw new Error(
      'Test database not configured. Set DATABASE_URL in .env.test or run: npm run test:db:setup'
    );
  }
  
  const isConnected = await global.checkDbConnectivity();
  if (!isConnected) {
    throw new Error(
      'Cannot connect to test database. Run: npm run test:db:setup'
    );
  }
  
  return true;
};