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

package/.turbo/turbo-build.log

@@ -0,0 +1,8 @@
+
+> @0xobelisk/graphql-server@1.2.0-pre.100 build /home/runner/work/dubhe/dubhe/packages/graphql-server
+> pnpm run type-check && tsc
+
+
+> @0xobelisk/graphql-server@1.2.0-pre.100 type-check /home/runner/work/dubhe/dubhe/packages/graphql-server
+> tsc --noEmit
+

package/DUAL_POOL_CONFIG.md

@@ -0,0 +1,188 @@
+# Unified Connection Pool Configuration
+
+## Overview
+
+The GraphQL server now uses a **unified connection pool architecture**, with a single connection pool handling all GraphQL operations:
+
+- Query
+- Mutation
+- Subscription
+
+## Connection Pool Parameters
+
+### Core Parameters
+
+1. **`max`** - Maximum Connections
+
+   - The maximum number of connections the pool can create
+   - Should be set based on database server capacity and application requirements
+
+2. **`min`** - Minimum Connections
+
+   - The minimum number of connections the pool maintains
+   - Usually set to around 10% of `max`
+
+3. **`connectionTimeoutMillis`** - Connection Timeout
+
+   - Timeout for acquiring connections from the pool
+   - Balanced value: 10 seconds (supports various operations)
+
+4. **`idleTimeoutMillis`** - Idle Timeout
+
+   - How long a connection stays idle before being disconnected
+   - Balanced value: 5 minutes (supports subscriptions while avoiding resource waste)
+
+5. **`maxLifetimeSeconds`** - Maximum Connection Lifetime
+   - Maximum lifetime of a connection, after which it's forcibly rotated
+   - Balanced value: 1 hour (prevents connection leaks)
+
+## Current Configuration
+
+```javascript
+const pgPool = new Pool({
+  connectionString: DATABASE_URL,
+  max: config.maxConnections, // Total connections
+  min: Math.min(5, Math.floor(config.maxConnections * 0.1)), // 10% minimum connections
+  connectionTimeoutMillis: 10000, // 10 second timeout
+  idleTimeoutMillis: 600000, // 10 minute idle cleanup
+  maxLifetimeSeconds: 3600, // 1 hour rotation
+  allowExitOnIdle: config.env === 'development'
+});
+```
+
+## Monitoring Endpoints
+
+### `/pool-status` - Connection Pool Status
+
+Returns detailed status of the current connection pool:
+
+```json
+{
+  "status": "ok",
+  "connectionPool": {
+    "totalCount": 25,
+    "idleCount": 20,
+    "waitingCount": 0,
+    "maxConnections": 1000,
+    "minConnections": 5
+  },
+  "strategy": "single-pool-unified",
+  "operations": ["query", "mutation", "subscription"],
+  "timestamp": "2024-01-20T10:30:45.123Z",
+  "uptime": 3600.5,
+  "memory": {
+    "rss": 52428800,
+    "heapTotal": 29360128,
+    "heapUsed": 18874568,
+    "external": 1089024
+  }
+}
+```
+
+### Status Field Descriptions
+
+- **totalCount**: Current active connections
+- **idleCount**: Idle connections
+- **waitingCount**: Clients waiting for connections
+- **maxConnections**: Configured maximum connections
+- **minConnections**: Configured minimum connections
+
+## Configuration Recommendations
+
+### Basic Configuration
+
+```bash
+# Small applications (< 100 concurrent)
+--max-connections 100
+
+# Medium applications (100-500 concurrent)
+--max-connections 300
+
+# Large applications (500+ concurrent)
+--max-connections 1000
+```
+
+### Subscription-Heavy Applications
+
+If your application has many long-term subscription connections:
+
+- Appropriately increase `idleTimeoutMillis` to 10-15 minutes
+- Increase `maxLifetimeSeconds` to 2-4 hours
+- Monitor `idleCount` to ensure sufficient idle connections for new requests
+
+### Query-Heavy Applications
+
+If your application is primarily short-term queries/mutations:
+
+- Reduce `idleTimeoutMillis` to 1-2 minutes
+- Reduce `maxLifetimeSeconds` to 30 minutes
+- Monitor `waitingCount` to ensure the connection pool is large enough
+
+## Performance Optimization
+
+### Connection Count Calculation Formula
+
+Recommended maximum connection calculation:
+
+```
+maxConnections = min(
+  Database max connections * 0.8,
+  (CPU cores * 2) + effective disk count,
+  Expected concurrent users * 1.2
+)
+```
+
+### Monitoring Metrics
+
+Key monitoring metrics:
+
+1. **Connection Utilization** = `totalCount / maxConnections`
+   - Target: 60-80%
+2. **Wait Queue** = `waitingCount`
+   - Target: < 5% of time with waiting
+3. **Idle Rate** = `idleCount / totalCount`
+   - Target: 20-40%
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Connection Timeout**
+
+   ```
+   Error: timeout acquiring a connection from the pool
+   ```
+
+   Solution: Increase `maxConnections` or optimize query performance
+
+2. **Insufficient Connections**
+
+   ```
+   Error: remaining connection slots are reserved
+   ```
+
+   Solution: Check database connection limits, adjust `maxConnections`
+
+3. **Subscription Disconnections**
+   - Check if `idleTimeoutMillis` is too short
+   - Verify network stability
+   - Monitor `maxLifetimeSeconds` settings
+
+### Tuning Steps
+
+1. **Baseline Testing**: Record connection usage under normal load
+2. **Stress Testing**: Simulate high load, observe `waitingCount`
+3. **Gradual Adjustment**: Incrementally increase `maxConnections`, observe effects
+4. **Continuous Monitoring**: Use `/pool-status` endpoint for ongoing monitoring
+
+## Best Practices
+
+1. **Progressive Scaling**: Start with smaller connection counts, gradually increase based on needs
+2. **Monitoring-Driven**: Base tuning on actual monitoring data rather than guesswork
+3. **Environment Isolation**: Use different connection configurations for dev/test/production environments
+4. **Reserve Capacity**: Reserve 20% connection capacity for burst traffic
+5. **Regular Checks**: Regularly check connection pool status to identify potential issues early
+
+## Summary
+
+The unified connection pool architecture simplifies configuration and management. Through proper parameter settings, it can effectively support various GraphQL operation modes. The key is to tune based on actual monitoring data to ensure a balance between resource efficiency and performance.

package/Dockerfile

@@ -0,0 +1,35 @@
+FROM node:18-alpine
+
+WORKDIR /app
+
+# Install pnpm
+RUN npm install -g pnpm
+
+# Copy dependency files
+COPY package.json pnpm-lock.yaml* ./
+
+# Install dependencies
+RUN pnpm install --frozen-lockfile
+
+# Copy source code
+COPY . .
+
+# Build project
+RUN pnpm build
+
+# Create non-root user
+RUN addgroup -g 1001 -S nodejs
+RUN adduser -S nodejs -u 1001
+
+# Set user
+USER nodejs
+
+# Expose port
+EXPOSE 4000
+
+# Start application (can use CLI or direct start)
+# Start using CLI method
+CMD ["node", "dist/cli.js", "start"]
+
+# Or start directly (optional)
+# CMD ["pnpm", "start"] 

package/LICENSE

@@ -0,0 +1,92 @@
+Business Source License 1.1
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+-----------------------------------------------------------------------------
+
+Parameters
+
+Licensor:             Obelisk Labs
+
+Licensed Work:        Dubhe
+                      The Licensed Work is (c) 2023 Obelisk Labs
+
+-----------------------------------------------------------------------------
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License’s text to license
+your works, and to refer to it using the trademark "Business Source License",
+as long as you comply with the Covenants of Licensor below.
+
+-----------------------------------------------------------------------------
+
+Covenants of Licensor
+
+In consideration of the right to use this License’s text and the "Business
+Source License" name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where "compatible" means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 2.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text "None".
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.
+
+-----------------------------------------------------------------------------
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.