@morphql/server

中文文档
0.1.47发布于 2026/11/02MITTypeScriptES Module构建来源已验证

MorphQL服务器核心-无头转换引擎

中文使用文档
文档目录6 节
  1. 核心功能
  2. 安装
  3. 基本用法(NestJS/Node)
  4. 独立使用
  5. 了解更多
  6. 许可证

MorphQL

npm version License: MIT

@morphql /服务器

的无头转换服务器核心 MorphQL. 旨在嵌入到现有的NestJS或Node.js应用程序中,提供具有缓存和OpenAPI支持的托管转换端点。

核心功能

  • 🏗️ 无头的核心:将MorphQL管理嵌入到您自己的后端。
  • 🔗 上演了查询:地图 .morphql 文件自动传送到指定的API端点。
  • ⚡ 复述,集成:对编译查询进行战略性缓存,以获得最大吞吐量。
  • 📖 Auto-OpenAPI为所有已定义的转换生成Swagger/OpenAPI片段。
  • 🛡️ 类型安全的:请求和响应格式的推断模式。

安装

npm install @morphql/server @morphql/core

基本用法(NestJS/Node)

import { MorphServer } from '@morphql/server';

const morph = new MorphServer({
  queriesDir: './queries', // automatically load .morphql files
  cache: redisCache, // optional Redis caching
});

await morph.initialize();

// Execute a named staged query
const result = await morph.executeStaged('user-profile', sourceData);

独立使用

如果您需要准备部署的微服务,请检查 服务器实例启动器模板 在我们的存储库中。它包括:

  • Docker & Docker组合设置
  • 预配置的NestJS应用程序
  • 健康检查(活跃度/就绪度)
  • API密钥认证

了解更多

许可证

麻省理工学院

版本与发布记录

@morphql/server 共发布 43 个版本,首次发布于 2026/01/25;过去 12 个月发布了 43 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.1.47latest2026/11/021 天前
0.1.462026/07/283 个月前
0.1.452026/05/275 个月前
0.1.442026/05/275 个月前
0.1.432026/05/215 个月前
0.1.422026/05/195 个月前

关于 @morphql/server 的常见问题

@morphql/server 是什么?

MorphQL服务器核心-无头转换引擎

如何安装 @morphql/server?

在项目目录运行 npm install @morphql/server,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@morphql/core(^0.1.47)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@morphql/server 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@morphql/server 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@morphql/server 可以商用吗?

@morphql/server 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@morphql/server 还在维护吗?

最新版本 0.1.47 发布于 2026/11/02(1 天前);至今共发布 43 个版本,其中过去 12 个月发布了 43 个;首次发布于 2026/01/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。