@cmscraft/schema

中文文档
0.3.29发布于 2026/11/09MITTypeScriptES Module零依赖近 30 天下载 2395

Public GraphQL schema (SDL) and TypeScript types for the cms-craft API

原始使用文档
文档目录5 节
  1. Install
  2. Use as a codegen schema
  3. Types
  4. Documentation
  5. License

@cmscraft/schema

The public GraphQL schema of the CMS Craft API, as SDL, plus generated TypeScript types. Use it to generate a typed client without introspecting the live API.

Free during beta. Paid plans will follow; we will announce pricing and give notice before any charge.

Install

npm i -D @cmscraft/schema

pnpm add -D @cmscraft/schema and yarn add -D @cmscraft/schema work the same way.

Use as a codegen schema

@cmscraft/schema/schema.gql is the schema file. Point GraphQL Code Generator at it:

// codegen.ts
import type { CodegenConfig } from '@graphql-codegen/cli'

const config: CodegenConfig = {
    schema: 'node_modules/@cmscraft/schema/schema.gql',
    documents: ['src/**/*.graphql'],
    generates: {
        'src/generated/graphql.ts': { plugins: ['typescript', 'typescript-operations'] }
    }
}

export default config

Types

The generated schema types are exported from @cmscraft/schema/types:

import type { Query } from '@cmscraft/schema/types'

Documentation

Endpoint, authentication and API guides: https://docs.cms-craft.com

Questions: [email protected]

License

MIT

版本与发布记录

@cmscraft/schema 共发布 18 个版本,首次发布于 2026/10/20;过去 12 个月发布了 18 个版本。

版本发布日期距今
0.3.29latest2026/11/09今天
0.3.282026/11/091 天前
0.3.272026/11/081 天前
0.3.262026/11/082 天前
0.3.252026/11/072 天前
0.3.242026/11/072 天前

关于 @cmscraft/schema 的常见问题

@cmscraft/schema 是什么?

Public GraphQL schema (SDL) and TypeScript types for the cms-craft API

如何安装 @cmscraft/schema?

在项目目录运行 npm install @cmscraft/schema,或使用 pnpm add / yarn add / bun add。

@cmscraft/schema 支持 TypeScript 吗?

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

@cmscraft/schema 支持 ESM 还是 CommonJS?

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

@cmscraft/schema 可以商用吗?

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

@cmscraft/schema 的下载量有多少?

根据 npm 官方下载统计,@cmscraft/schema 在 2026/10/10 – 2026/11/08 这 30 天内被下载 2,395 次,日均约 80 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@cmscraft/schema 还在维护吗?

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