@0xobelisk/graphql-server 1.2.0-pre.24

package/docker-compose.yml

@@ -0,0 +1,87 @@
+version: "3.8"
+
+services:
+  postgres:
+    image: postgres:15-alpine
+    environment:
+      POSTGRES_DB: dubhe_graphql
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
+    ports:
+      - "5432:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+      - ./init.sql:/docker-entrypoint-initdb.d/init.sql
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+  redis:
+    image: redis:7-alpine
+    ports:
+      - "6379:6379"
+    command: redis-server --appendonly yes
+    volumes:
+      - redis_data:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 5s
+      timeout: 3s
+      retries: 5
+
+  graphql-server:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    ports:
+      - "4000:4000"
+    environment:
+      DATABASE_URL: postgres://postgres:postgres@postgres:5432/dubhe_graphql
+      NODE_ENV: production
+      PORT: 4000
+      GRAPHQL_ENDPOINT: /graphql
+      PG_SCHEMA: public
+      ENABLE_CORS: "true"
+      ENABLE_SUBSCRIPTIONS: "true"
+      WATCH_PG: "false"
+    depends_on:
+      postgres:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+    restart: unless-stopped
+    healthcheck:
+      test:
+        [
+          "CMD",
+          "wget",
+          "--no-verbose",
+          "--tries=1",
+          "--spider",
+          "http://localhost:4000/graphql",
+        ]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+
+  # 可选：添加 pgAdmin 用于数据库管理
+  pgadmin:
+    image: dpage/pgadmin4:latest
+    environment:
+      PGADMIN_DEFAULT_EMAIL: admin@dubhe.com
+      PGADMIN_DEFAULT_PASSWORD: admin
+    ports:
+      - "5050:80"
+    volumes:
+      - pgadmin_data:/var/lib/pgadmin
+    depends_on:
+      - postgres
+    profiles:
+      - tools
+
+volumes:
+  postgres_data:
+  redis_data:
+  pgadmin_data:

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@0xobelisk/graphql-server",
+  "version": "1.2.0-pre.24",
+  "description": "Tookit for interacting with dubhe graphql server",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "keywords": [
+    "graphql",
+    "postgraphile",
+    "sui-indexer",
+    "database-adapter",
+    "websocket",
+    "subscription",
+    "postgresql",
+    "dynamic"
+  ],
+  "author": "Dubhe Team",
+  "license": "MIT",
+  "dependencies": {
+    "@graphile-contrib/pg-simplify-inflector": "^6.1.0",
+    "@graphile/pg-pubsub": "^4.14.1",
+    "@graphile/subscriptions-lds": "^4.14.1",
+    "apollo-server-express": "^3.13.0",
+    "cors": "^2.8.5",
+    "dotenv": "^16.3.1",
+    "express": "^4.21.2",
+    "graphile-utils": "^4.14.1",
+    "graphql": "^15.8.0",
+    "graphql-subscriptions": "^2.0.0",
+    "graphql-ws": "^5.16.2",
+    "node-fetch": "^3.3.2",
+    "pg": "^8.11.3",
+    "pino": "^8.16.2",
+    "pino-pretty": "^10.2.3",
+    "postgraphile": "^4.13.0",
+    "postgraphile-plugin-connection-filter": "^2.3.0",
+    "ws": "^8.14.2"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.18",
+    "@types/express": "^4.17.23",
+    "@types/node": "^20.8.10",
+    "@types/pg": "^8.10.7",
+    "@types/ws": "^8.5.8",
+    "@typescript-eslint/eslint-plugin": "^6.9.1",
+    "@typescript-eslint/parser": "^6.9.1",
+    "eslint": "^8.52.0",
+    "jest": "^29.7.0",
+    "nodemon": "^3.1.10",
+    "ts-node": "^10.9.1",
+    "tsx": "^3.12.10",
+    "typescript": "^5.2.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "dev": "nodemon --exec ts-node src/index.ts",
+    "dev:node": "node --loader tsx/esm src/index.ts",
+    "dev:ts-node": "ts-node-esm src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "test": "jest",
+    "test:subscription": "node test-subscription.js",
+    "test:enhanced": "node test_enhanced_subscriptions.js",
+    "test:all": "node test_all_subscriptions.js",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "type-check": "tsc --noEmit"
+  }
+}

package/server.log

@@ -0,0 +1,62 @@
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [system]: 🚀 启动 Sui Indexer GraphQL 服务器... {"component":"system","nodeVersion":"v18.20.4","platform":"darwin"}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [system]: 正在初始化数据库连接和扫描表结构... {"component":"system","schema":"public","databaseUrl":"postgres://postgres:****@127.0.0.1:5432/postgres"}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [database]: 数据库连接成功 {"component":"database","schema":"public"}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [database]: 扫描表结构完成 {"component":"database","tableCount":5,"storeTableCount":4,"tableNames":["store_accounts","store_encounter","store_map_config","store_position","table_fields"]}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [subscription]: 启动统一实时引擎 (Live Queries + Native WebSocket) {"component":"subscription","enableSubscriptions":"true","availableTableCount":5,"storeTablesCount":4}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [system]: 🚀 统一实时引擎启动 {"component":"system","port":4001,"enableLiveQueries":true,"enableNativeWebSocket":true,"tablesCount":5}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [server]: 创建 PostGraphile 配置 {"component":"server","endpoint":"/graphql","enableCors":"true","enableSubscriptions":"true"}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [subscription]: 创建简化订阅插件 {"component":"subscription","totalTables":5,"storeTables":4,"storeTableNames":["store_accounts","store_encounter","store_map_config","store_position"]}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [server]: 初始化服务器管理器 {"component":"server","port":4000,"endpoint":"/graphql","subscriptions":"true","realtimePort":"4001"}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [subscription]: PostGraphile Live Queries已启用，无需额外配置 {"component":"subscription"}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [server]: 🚀 Sui Indexer GraphQL 服务器启动成功！ {"component":"server"}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [server]: 服务器地址 {"component":"server","url":"http://localhost:4000"}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [server]: GraphQL API {"component":"server","url":"http://localhost:4000/graphql"}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [server]: 增强版 GraphQL Playground {"component":"server","url":"http://localhost:4000/playground","features":["现代化界面","Schema Explorer","代码导出"],"note":"旧路径 /graphiql 会自动重定向到 /playground"}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [server]: WebSocket 订阅 {"component":"server","url":"ws://localhost:4000/graphql"}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [server]: 服务器配置 {"component":"server","environment":"development","schema":"public","totalTables":5,"storeTables":4,"systemTables":1,"cors":"启用","subscriptions":"启用"}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [system]: 💡 访问根路径查看详细信息和使用指南 {"component":"system"}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [system]: 按 Ctrl+C 停止服务器 {"component":"system"}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [performance]: 服务器启动 completed {"component":"performance","duration":"81ms","port":4000,"tableCount":5,"nodeEnv":"development"}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [database]: 开始监听数据库通道 {"component":"database","channel":"table_change_store_accounts"}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [database]: 开始监听数据库通道 {"component":"database","channel":"table_change_store_encounter"}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [database]: 开始监听数据库通道 {"component":"database","channel":"table_change_store_map_config"}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [database]: 开始监听数据库通道 {"component":"database","channel":"table_change_store_position"}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [database]: 开始监听数据库通道 {"component":"database","channel":"table_change_table_fields"}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [database]: ✅ 数据库变更监听器设置完成 {"component":"database"}
+🔍 原始字段列表: [
+  'query',
+  'nodeId',
+  'node',
+  'allStoreAccounts',
+  'allStoreEncounters',
+  'allStoreMapConfigs',
+  'allStorePositions',
+  'allTableFields',
+  'storeAccountByAssetIdAndAccount',
+  'storeEncounterByPlayer',
+  'storePositionByPlayer',
+  'tableFieldByTableNameAndFieldName',
+  'storeAccount',
+  'storeEncounter',
+  'storePosition',
+  'tableField'
+]
+🔄 字段重命名统计: { '原始字段数': 16, '最终字段数': 16, '重命名字段数': 10 }
+📝 重命名映射: {
+  allStoreAccounts: 'accounts',
+  allStoreEncounters: 'encounters',
+  allStoreMapConfigs: 'mapConfigs',
+  allStorePositions: 'positions',
+  storeAccountByAssetIdAndAccount: 'accountByAssetIdAndAccount',
+  storeEncounterByPlayer: 'encounterByPlayer',
+  storePositionByPlayer: 'positionByPlayer',
+  storeAccount: 'account',
+  storeEncounter: 'encounter',
+  storePosition: 'position'
+}
+[2025-06-06 07:48:10] INFO: dubhe-graphql-server [subscription]: 启用PostGraphile原生Live Queries功能 {"component":"subscription"}
+[2025-06-06 07:48:31] INFO: dubhe-graphql-server [performance]: GraphQL GET completed {"component":"performance","duration":"1ms","endpoint":"/graphql"}
+[2025-06-06 07:51:36] INFO: dubhe-graphql-server [system]: 收到 SIGTERM 信号，开始优雅关闭服务器... {"component":"system"}
+[2025-06-06 07:51:36] INFO: dubhe-graphql-server [system]: 🛑 开始关闭统一实时引擎... {"component":"system"}
+[2025-06-06 07:51:36] INFO: dubhe-graphql-server [system]: ✅ 统一实时引擎已关闭 {"component":"system"}
+[2025-06-06 07:51:36] INFO: dubhe-graphql-server [system]: ⏹️  正在关闭服务器... {"component":"system"}

package/src/config/subscription-config.ts

@@ -0,0 +1,186 @@
+// Subscription configuration manager - supports dynamic configuration for three subscription modes
+
+export interface SubscriptionCapabilities {
+  liveQueries: boolean;
+  pgSubscriptions: boolean;
+  nativeWebSocket: boolean;
+}
+
+export interface SubscriptionConfig {
+  // Basic configuration
+  enableSubscriptions: boolean;
+
+  // Capability configuration
+  capabilities: SubscriptionCapabilities;
+
+  // Database configuration detection
+  walLevel: 'minimal' | 'replica' | 'logical';
+  pgVersion: string;
+
+  // Port configuration
+  graphqlPort: number;
+  websocketPort?: number;
+
+  // Performance configuration
+  maxConnections: number;
+  heartbeatInterval: number;
+
+  // Debug configuration
+  enableNotificationLogging: boolean;
+  enablePerformanceMetrics: boolean;
+}
+
+export class SubscriptionConfigManager {
+  private config: SubscriptionConfig;
+
+  constructor(envVars: Record<string, string>) {
+    this.config = this.parseEnvironmentVariables(envVars);
+  }
+
+  // Parse configuration from environment variables
+  private parseEnvironmentVariables(env: Record<string, string>): SubscriptionConfig {
+    const enableSubscriptions = env.ENABLE_SUBSCRIPTIONS !== 'false'; // Default enabled unless explicitly set to false
+
+    // Auto-detect WAL level (in actual applications, query through database)
+    const walLevel = this.detectWalLevel(env.DATABASE_URL);
+
+    // Determine capabilities based on WAL level and environment variables - default enable all features
+    const capabilities: SubscriptionCapabilities = {
+      liveQueries:
+        enableSubscriptions && env.ENABLE_LIVE_QUERIES !== 'false' && walLevel === 'logical',
+
+      pgSubscriptions: enableSubscriptions && env.ENABLE_PG_SUBSCRIPTIONS !== 'false',
+
+      nativeWebSocket: enableSubscriptions && env.ENABLE_NATIVE_WEBSOCKET !== 'false'
+    };
+
+    return {
+      enableSubscriptions,
+      capabilities,
+      walLevel,
+      pgVersion: '13+', // In actual applications, get through query
+
+      graphqlPort: parseInt(env.PORT || '4000'),
+      websocketPort: env.REALTIME_PORT ? parseInt(env.REALTIME_PORT) : undefined,
+
+      maxConnections: parseInt(env.MAX_SUBSCRIPTION_CONNECTIONS || '1000'),
+      heartbeatInterval: parseInt(env.SUBSCRIPTION_HEARTBEAT_INTERVAL || '30000'),
+
+      enableNotificationLogging: env.DEBUG_NOTIFICATIONS === 'true',
+      enablePerformanceMetrics: env.ENABLE_SUBSCRIPTION_METRICS === 'true'
+    };
+  }
+
+  // Detect database WAL level
+  private detectWalLevel(databaseUrl?: string): 'minimal' | 'replica' | 'logical' {
+    // In actual applications should query database
+    // SELECT setting FROM pg_settings WHERE name = 'wal_level';
+
+    // Currently return default value
+    return 'replica';
+  }
+
+  // Get current configuration
+  getConfig(): SubscriptionConfig {
+    return { ...this.config };
+  }
+
+  // Check if specific capability is available
+  isCapabilityEnabled(capability: keyof SubscriptionCapabilities): boolean {
+    return this.config.capabilities[capability];
+  }
+
+  // Get recommended subscription method
+  getRecommendedSubscriptionMethod(): string {
+    if (this.config.capabilities.liveQueries) {
+      return 'live-queries';
+    } else if (this.config.capabilities.pgSubscriptions) {
+      return 'pg-subscriptions';
+    } else if (this.config.capabilities.nativeWebSocket) {
+      return 'native-websocket';
+    } else {
+      return 'none';
+    }
+  }
+
+  // Generate client configuration
+  generateClientConfig() {
+    const baseUrl = `http://localhost:${this.config.graphqlPort}`;
+
+    return {
+      graphqlEndpoint: `${baseUrl}/graphql`,
+      subscriptionEndpoint:
+        this.config.capabilities.pgSubscriptions || this.config.capabilities.liveQueries
+          ? `ws://localhost:${this.config.graphqlPort}/graphql`
+          : undefined,
+      nativeWebSocketEndpoint: this.config.capabilities.nativeWebSocket
+        ? `ws://localhost:${this.config.websocketPort || this.config.graphqlPort}`
+        : undefined,
+      capabilities: this.config.capabilities,
+      recommendedMethod: this.getRecommendedSubscriptionMethod()
+    };
+  }
+
+  // Generate PostGraphile configuration - simplified version, only keep listen subscriptions
+  generatePostGraphileConfig() {
+    return {
+      subscriptions: this.config.enableSubscriptions,
+      live: false, // Disable live queries, only use listen subscriptions
+      simpleSubscriptions: this.config.capabilities.pgSubscriptions,
+
+      // Performance configuration - optimized for listen subscriptions
+      pgSettings: {
+        statement_timeout: '30s',
+        default_transaction_isolation: 'read committed'
+      },
+
+      // Monitoring configuration
+      allowExplain: this.config.enablePerformanceMetrics,
+      disableQueryLog: !this.config.enableNotificationLogging
+    };
+  }
+
+  // Generate environment variable documentation
+  generateDocumentation(): string {
+    return `
+# 📡 Subscription System Configuration Guide
+
+## Basic Configuration
+ENABLE_SUBSCRIPTIONS=false         # Disable subscription features (default enabled, set to false to disable)
+
+## Capability Configuration (optional, auto-detect by default)
+ENABLE_LIVE_QUERIES=true           # Enable @live directive (requires wal_level=logical)
+ENABLE_PG_SUBSCRIPTIONS=true       # Enable PostgreSQL subscriptions 
+ENABLE_NATIVE_WEBSOCKET=true       # Enable native WebSocket
+
+## Port Configuration
+PORT=4000                          # GraphQL port
+REALTIME_PORT=4001                 # Native WebSocket port (optional)
+
+## Performance Configuration
+MAX_SUBSCRIPTION_CONNECTIONS=1000  # Maximum connections
+SUBSCRIPTION_HEARTBEAT_INTERVAL=30000  # Heartbeat interval (ms)
+
+## Debug Configuration
+DEBUG_NOTIFICATIONS=false         # Notification logging
+ENABLE_SUBSCRIPTION_METRICS=false # Performance metrics
+
+## Current Configuration Status:
+- Subscription Features: ${this.config.enableSubscriptions ? '✅ Enabled' : '❌ Disabled'}
+- Live Queries: ${this.config.capabilities.liveQueries ? '✅ Available' : '❌ Not Available'}
+- PG Subscriptions: ${
+      this.config.capabilities.pgSubscriptions ? '✅ Available' : '❌ Not Available'
+    }  
+- Native WebSocket: ${
+      this.config.capabilities.nativeWebSocket ? '✅ Available' : '❌ Not Available'
+    }
+- WAL Level: ${this.config.walLevel}
+- Recommended Method: ${this.getRecommendedSubscriptionMethod()}
+		`;
+  }
+}
+
+// Export singleton instance
+export const subscriptionConfig = new SubscriptionConfigManager(
+  process.env as Record<string, string>
+);

package/src/index.ts

@@ -0,0 +1,239 @@
+import { postgraphile } from 'postgraphile';
+import { Pool } from 'pg';
+import * as dotenv from 'dotenv';
+import {
+  dbLogger,
+  serverLogger,
+  systemLogger,
+  subscriptionLogger,
+  logPerformance
+} from './utils/logger';
+import {
+  DatabaseIntrospector,
+  createPostGraphileConfig,
+  PostGraphileConfigOptions,
+  WelcomePageConfig
+} from './plugins';
+import { EnhancedServerManager } from './plugins/enhanced-server-manager';
+import { subscriptionConfig } from './config/subscription-config';
+import {
+  generateStoreTablesInfo,
+  createUniversalSubscriptionsPlugin
+} from './universal-subscriptions';
+
+// Load environment variables
+dotenv.config();
+
+// Environment variable configuration
+const {
+  DATABASE_URL = 'postgres://postgres:postgres@127.0.0.1:5432/postgres',
+  PORT = 4000,
+  NODE_ENV = 'development',
+  GRAPHQL_ENDPOINT = '/graphql',
+  PG_SCHEMA = 'public',
+  ENABLE_CORS = 'true'
+} = process.env;
+
+// Subscription feature is enabled by default unless explicitly set to false
+const ENABLE_SUBSCRIPTIONS = process.env.ENABLE_SUBSCRIPTIONS !== 'false' ? 'true' : 'false';
+
+// Create database connection pool
+const pgPool = new Pool({
+  connectionString: DATABASE_URL
+});
+
+// Start server
+const startServer = async (): Promise<void> => {
+  const startTime = Date.now();
+
+  try {
+    // 1. Test database connection and scan table structure
+    systemLogger.info('Initializing database connection and scanning table structure...', {
+      schema: PG_SCHEMA,
+      databaseUrl: DATABASE_URL.replace(/:[^:]*@/, ':****@') // Hide password
+    });
+
+    const introspector = new DatabaseIntrospector(pgPool, PG_SCHEMA);
+
+    const isConnected = await introspector.testConnection();
+    if (!isConnected) {
+      throw new Error('Database connection failed');
+    }
+    dbLogger.info('Database connection successful', { schema: PG_SCHEMA });
+
+    const allTables = await introspector.getAllTables();
+    const tableNames = allTables.map((t) => t.table_name);
+
+    dbLogger.info('Table structure scan completed', {
+      tableCount: allTables.length,
+      storeTableCount: tableNames.filter((name) => name.startsWith('store_')).length,
+      tableNames: tableNames.slice(0, 10) // Only show first 10 table names
+    });
+
+    // 2. Display subscription configuration status
+    const config = subscriptionConfig.getConfig();
+    subscriptionLogger.info('📡 Subscription system configuration status', {
+      enableSubscriptions: config.enableSubscriptions,
+      capabilities: {
+        pgSubscriptions: config.capabilities.pgSubscriptions
+      },
+      recommendedMethod: 'pg-subscriptions',
+      walLevel: config.walLevel
+    });
+
+    // 3. Pre-generate store table information for dynamic queries
+    subscriptionLogger.info('Pre-generating store table information for tool queries...');
+    const storeTablesInfo = await generateStoreTablesInfo(pgPool);
+    const storeTableNames = Object.keys(storeTablesInfo);
+
+    subscriptionLogger.info(`Discovered store tables: ${storeTableNames.join(', ')}`);
+
+    // 4. Create PostGraphile configuration
+    const postgraphileConfigOptions: PostGraphileConfigOptions = {
+      port: PORT,
+      nodeEnv: NODE_ENV,
+      graphqlEndpoint: GRAPHQL_ENDPOINT,
+      enableSubscriptions: ENABLE_SUBSCRIPTIONS,
+      enableCors: ENABLE_CORS,
+      databaseUrl: DATABASE_URL,
+      availableTables: tableNames
+    };
+
+    serverLogger.info('Creating PostGraphile configuration', {
+      endpoint: GRAPHQL_ENDPOINT,
+      enableCors: ENABLE_CORS,
+      enableSubscriptions: ENABLE_SUBSCRIPTIONS
+    });
+
+    // Use simplified configuration
+    const postgraphileConfig = {
+      ...createPostGraphileConfig(postgraphileConfigOptions),
+      ...subscriptionConfig.generatePostGraphileConfig()
+    };
+
+    // Add tools query plugin
+    const toolsPlugin = createUniversalSubscriptionsPlugin(storeTablesInfo);
+    postgraphileConfig.appendPlugins = [...(postgraphileConfig.appendPlugins || []), toolsPlugin];
+
+    // 5. Create PostGraphile middleware
+    console.log('🔧 Creating PostGraphile middleware...');
+    const postgraphileMiddleware = postgraphile(pgPool, PG_SCHEMA, {
+      ...postgraphileConfig
+    });
+    console.log('✅ PostGraphile middleware creation completed:', typeof postgraphileMiddleware);
+
+    // 6. Configure welcome page
+    const welcomeConfig: WelcomePageConfig = {
+      port: PORT,
+      graphqlEndpoint: GRAPHQL_ENDPOINT,
+      nodeEnv: NODE_ENV,
+      schema: PG_SCHEMA,
+      enableCors: ENABLE_CORS,
+      enableSubscriptions: ENABLE_SUBSCRIPTIONS
+    };
+
+    // 7. Create Express server manager
+    const serverManager = new EnhancedServerManager();
+
+    // 8. Create Express server
+    await serverManager.createEnhancedServer({
+      postgraphileMiddleware,
+      pgPool,
+      tableNames,
+      databaseUrl: DATABASE_URL,
+      allTables,
+      welcomeConfig,
+      postgraphileConfigOptions
+    });
+
+    // 9. Start Express server
+    await serverManager.startServer();
+
+    logPerformance('Express server startup', startTime, {
+      port: PORT,
+      tableCount: allTables.length,
+      storeTableCount: storeTableNames.length,
+      nodeEnv: NODE_ENV,
+      framework: 'Express',
+      capabilities: {
+        pgSubscriptions: config.capabilities.pgSubscriptions
+      }
+    });
+
+    // 10. Display usage instructions
+    if (NODE_ENV === 'development') {
+      console.log('\n' + '='.repeat(80));
+      console.log('📖 Quick Access (Express Architecture):');
+      console.log(`Visit http://localhost:${PORT}/ to view homepage`);
+      console.log(`Visit http://localhost:${PORT}/playground to use GraphQL Playground`);
+      console.log(`Visit http://localhost:${PORT}/health to check server status`);
+      console.log(`Visit http://localhost:${PORT}/subscription-config to get client configuration`);
+      console.log(`Visit http://localhost:${PORT}/subscription-docs to view configuration guide`);
+      console.log('='.repeat(80) + '\n');
+    }
+
+    // 11. Set up simple and direct shutdown handling
+    let isShuttingDown = false;
+    const quickShutdown = (signal: string) => {
+      if (isShuttingDown) {
+        systemLogger.info('⚡ Force exiting process...');
+        process.exit(0);
+      }
+
+      isShuttingDown = true;
+      systemLogger.info(`🛑 Received ${signal} signal, shutting down Express server...`);
+
+      // Set 1 second force exit timeout
+      setTimeout(() => {
+        systemLogger.info('⚡ Quick exit');
+        process.exit(0);
+      }, 1000);
+
+      // Try to shutdown Express server quickly
+      serverManager.quickShutdown().finally(() => {
+        process.exit(0);
+      });
+    };
+
+    process.on('SIGINT', () => quickShutdown('SIGINT'));
+    process.on('SIGTERM', () => quickShutdown('SIGTERM'));
+
+    // Simplified exception handling
+    process.on('unhandledRejection', (reason) => {
+      console.error('❌ Unhandled Promise rejection:', reason);
+    });
+
+    process.on('uncaughtException', (error) => {
+      console.error('❌ Uncaught exception:', error.message);
+      process.exit(1);
+    });
+  } catch (error) {
+    systemLogger.error('Failed to start Express server', error, {
+      databaseUrl: DATABASE_URL.replace(/:[^:]*@/, ':****@'),
+      schema: PG_SCHEMA,
+      port: PORT
+    });
+
+    systemLogger.info('💡 Possible causes:');
+    systemLogger.info('1. Database connection failed - check DATABASE_URL');
+    systemLogger.info(
+      '2. Expected table structure not found in database - ensure sui-rust-indexer is running'
+    );
+    systemLogger.info('3. Permission issues - ensure database user has sufficient permissions');
+    systemLogger.info('4. Missing dependencies - run pnpm install');
+
+    // Display subscription configuration help
+    console.log('\n' + subscriptionConfig.generateDocumentation());
+
+    process.exit(1);
+  }
+};
+
+// Start application
+systemLogger.info('🚀 Starting Sui Indexer GraphQL Server (Express Architecture)...', {
+  nodeVersion: process.version,
+  platform: process.platform,
+  pid: process.pid
+});
+
+startServer();