# @digital-nature/licence-verifier 中文文档

规范地址：https://npmcn.com/package/%40digital-nature/licence-verifier/

版本：0\.4\.0
npm 元数据更新时间：2026-11-07T15:38:32.809Z
中文译文更新时间：2026-11-12T13:13:51.623Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40digital-nature/licence-verifier
原文对照：https://npmcn.com/package/%40digital-nature/licence-verifier/?lang=original
项目主页：https://github.com/Digital-Nature-LTD/software.digital-nature.co.uk-licence-verifier-js#readme
源码仓库：https://github.com/Digital-Nature-LTD/software.digital-nature.co.uk-licence-verifier-js

弃用说明：Moved to @digital-nature-ltd/licence-verifier

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：27.4 kB，6 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-05-23T13:11:31.270Z
- 最新版本发布：2026-09-17T18:17:05.365Z
- 近 30 天下载量：2422（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 6 个）

## 中文简介

JavaScript/ TypeScript 数字自然许可证验证客户端 API

## 安装

```sh
npm install @digital-nature/licence-verifier
```

也可以使用：`pnpm add @digital-nature/licence-verifier`、`yarn add @digital-nature/licence-verifier`、`bun add @digital-nature/licence-verifier`

## README

# @ 数字自然/ 许可证验证器

JavaScript/ TypeScript 客户端 [数字性质](https://digital-nature.co.uk/) 许可证核查 API.

## 安装

```bash
npm install @digital-nature/licence-verifier
```

## 使用量

```ts
import { LicenceVerifier } from '@digital-nature/licence-verifier'

const verifier = new LicenceVerifier({
  baseUrl: 'https://verify.software.digital-nature.co.uk',
})

// Check a licence is valid
const result = await verifier.verify('XXXX-XXXX-XXXX-XXXX')
// { valid: true, licenceKey: '...', productSlug: '...', status: 'active', expiresAt: null }

// Activate a domain
const activation = await verifier.activate('XXXX-XXXX-XXXX-XXXX', 'example.com')
// { activated: true, domain: 'example.com', domainType: 'production', activationsUsed: 1, activationLimit: 2 }

// Deactivate a domain
await verifier.deactivate('XXXX-XXXX-XXXX-XXXX', 'example.com')

// Get full licence info
const info = await verifier.info('XXXX-XXXX-XXXX-XXXX')
// { licenceKey: '...', productSlug: '...', status: 'active', activationsUsed: 1, activationLimit: 2, domains: [...] }
```

## 包件、加装和免费试验

`verify` 财务报告和审定财务报表 `info` 并说许可证授予:

```ts
const { package: pkg, addons, trials } = await verifier.verify(key)
// pkg:    'club-platform'            — or null for an ordinary product
// addons: ['club-platform-pitch-x-3'] — everything granted RIGHT NOW
// trials: [{ addon: 'club-platform-pitch-x-3', endsAt: '2026-10-17T09:00:00.000Z' }]
```

-   `addons` 从来没有包括一个结束的审判, 所以欢呼 `addons` 一个人 审判已经结束了.
-   `trials` 说哪个 `addons` 审判是免费的 并且每次停止。 用这个 显示"N days left". `[]` 并且从比试验年长的服务器上发出.
-   缓存 `verify`编号 :`info` 试验结果从未超过最快的试验结束.

## 选项

| 选项 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `baseUrl` | `string` | —— 说 | 校验服务的基础 URL |
| `cacheTtl` | `number` | `30000` | 缓存 TTL 以毫秒计 `verify` 财务报告和审定财务报表 `info` 回应。 设定为 `0` 以禁用. |
| `fetch` | `typeof fetch` | `globalThis.fetch` | 覆盖获取执行( 用于测试) |

## 处理错误

所有可以丢出输入错误的方法 `instanceof` 检查 :

```ts
import {
  LicenceNotFoundError,
  LicenceExpiredError,
  LicenceInactiveError,
  ActivationLimitReachedError,
  DomainAlreadyActiveError,
  LicenceVerifierError,  // base class
} from '@digital-nature/licence-verifier'

try {
  await verifier.activate(key, domain)
} catch (err) {
  if (err instanceof ActivationLimitReachedError) {
    // handle limit
  } else if (err instanceof LicenceNotFoundError) {
    // handle not found
  }
}
```

## 所需资源

节点.js 18 或以后(使用本地 `fetch`) (中文(简体) ).

## 常见问题

### @digital-nature/licence-verifier 是什么？

JavaScript/ TypeScript 数字自然许可证验证客户端 API注意：该包已被作者标记为弃用——Moved to @digital-nature-ltd/licence-verifier

### 如何安装 @digital-nature/licence-verifier？

在项目目录运行 npm install @digital-nature/licence-verifier，或使用 pnpm add / yarn add / bun add。

### @digital-nature/licence-verifier 支持 TypeScript 吗？

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

### @digital-nature/licence-verifier 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @digital-nature/licence-verifier 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @digital-nature/licence-verifier 可以商用吗？

@digital-nature/licence-verifier 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @digital-nature/licence-verifier 的下载量有多少？

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

### @digital-nature/licence-verifier 还在维护吗？

最新版本 0\.4\.0 发布于 2026/09/18（1 个月前）；至今共发布 6 个版本，其中过去 12 个月发布了 6 个；首次发布于 2026/05/23。作者已将其标记为弃用，新项目建议寻找替代方案。