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

package/Dockerfile

@@ -0,0 +1,31 @@
+FROM node:18-alpine
+
+WORKDIR /app
+
+# 安装 pnpm
+RUN npm install -g pnpm
+
+# 复制依赖文件
+COPY package.json pnpm-lock.yaml* ./
+
+# 安装依赖
+RUN pnpm install --frozen-lockfile
+
+# 复制源代码
+COPY . .
+
+# 构建项目
+RUN pnpm build
+
+# 创建非root用户
+RUN addgroup -g 1001 -S nodejs
+RUN adduser -S nodejs -u 1001
+
+# 设置用户
+USER nodejs
+
+# 暴露端口
+EXPOSE 4000
+
+# 启动应用
+CMD ["pnpm", "start"] 

package/EXPRESS_MIGRATION.md

@@ -0,0 +1,176 @@
+# Express架构迁移指南
+
+## 概述
+
+原本的GraphQL服务器使用Node.js原生HTTP模块实现，现已成功迁移至Express框架。这次迁移带来了更好的中间件支持、更清晰的路由管理和更强的扩展性。
+
+## 主要变更
+
+### 1. 架构变更
+- **之前**: Node.js原生HTTP + 手动路由处理
+- **现在**: Express框架 + 中间件和路由系统
+
+### 2. 新增依赖
+```json
+{
+  "express": "^4.18.2",
+  "cors": "^2.8.5",
+  "@types/express": "^4.17.21",
+  "@types/cors": "^2.8.17"
+}
+```
+
+### 3. 核心文件变更
+
+#### `enhanced-server-manager.ts`
+- 从原生HTTP服务器改为Express应用
+- 使用Express中间件系统
+- 更清晰的路由定义
+- 专业的错误处理
+
+#### `index.ts`
+- 更新启动日志，标明使用Express架构
+- 错误信息中提到使用`pnpm install`
+
+## 功能对比
+
+| 功能 | 原生HTTP | Express |
+|------|----------|---------|
+| 路由管理 | 手动`if/else`判断 | 专业路由系统 |
+| 中间件 | 手动实现 | 内置中间件系统 |
+| CORS | 手动设置头部 | `cors`中间件 |
+| 错误处理 | 手动try/catch | 全局错误中间件 |
+| 请求日志 | 分散在各处 | 统一中间件 |
+| 代码可读性 | 较低 | 大幅提升 |
+
+## API端点
+
+所有原有端点保持不变：
+
+- `GET /` - 欢迎页面
+- `GET /playground` - GraphQL Playground
+- `GET /graphiql*` - 重定向到`/playground`
+- `POST /graphql` - GraphQL端点
+- `GET /health` - 健康检查
+- `GET /subscription-config` - 订阅配置
+- `GET /subscription-docs` - 配置文档
+
+## 安装和运行
+
+### 安装依赖
+```bash
+pnpm install
+```
+
+### 开发模式
+```bash
+pnpm dev
+```
+
+### 生产模式
+```bash
+pnpm build
+pnpm start
+```
+
+### 测试服务器
+```bash
+node test-express.js
+```
+
+## Express架构优势
+
+### 1. 更好的中间件系统
+```javascript
+// CORS处理
+app.use(cors({
+  origin: '*',
+  methods: ['GET', 'POST', 'OPTIONS'],
+  allowedHeaders: ['Content-Type', 'Authorization'],
+}));
+
+// 请求日志
+app.use((req, res, next) => {
+  // 统一的请求日志处理
+  next();
+});
+```
+
+### 2. 清晰的路由定义
+```javascript
+// 具体路由
+app.get('/', handleHomePage);
+app.get('/health', handleHealthCheck);
+app.use('/graphql', postgraphileMiddleware);
+
+// 404处理
+app.use('*', handle404);
+
+// 错误处理
+app.use(errorHandler);
+```
+
+### 3. 专业的错误处理
+```javascript
+app.use((err, req, res, next) => {
+  serverLogger.error('Express错误处理', err, {
+    url: req.originalUrl,
+    method: req.method,
+    userAgent: req.get('user-agent')?.substring(0, 50),
+  });
+  res.status(500).send('Internal Server Error');
+});
+```
+
+## 迁移后的好处
+
+1. **可维护性**: 代码结构更清晰，易于维护
+2. **扩展性**: 可以轻松添加新的中间件和路由
+3. **标准化**: 使用业界标准的Express框架
+4. **生态系统**: 可以利用Express丰富的中间件生态
+5. **调试体验**: 更好的错误堆栈和调试信息
+
+## 潜在影响
+
+### 正面影响
+- 更稳定的HTTP处理
+- 更好的错误恢复机制
+- 更专业的中间件处理
+- 更清晰的代码结构
+
+### 注意事项
+- 轻微的性能开销（但在实际应用中可以忽略）
+- 新增了Express依赖
+
+## 验证迁移
+
+运行测试脚本验证所有端点正常工作：
+
+```bash
+node test-express.js
+```
+
+预期输出：
+```
+🧪 开始测试Express服务器 (localhost:4000)
+============================================================
+🔍 测试 / (主页)
+✅ / - 状态码: 200
+
+🔍 测试 /health (健康检查)
+✅ /health - 状态码: 200
+
+🔍 测试 /playground (GraphQL Playground)
+✅ /playground - 状态码: 200
+
+🔍 测试 /subscription-config (订阅配置)
+✅ /subscription-config - 状态码: 200
+
+============================================================
+📊 测试结果: 4/4 通过
+🎉 所有测试通过！Express服务器运行正常
+```
+
+## 总结
+
+Express架构迁移成功完成，服务器现在使用更专业的Web框架，提供了更好的开发体验和更强的扩展性。所有原有功能保持不变，同时代码质量得到显著提升。 

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.