@criipto/signatures

中文文档
2.0.1发布于 2026/10/15MITTypeScriptCommonJS构建来源已验证近 30 天下载 4万

A Node.JS SDK for Criipto Signatures

原始使用文档
文档目录6 节
  1. Getting started
  2. Requirements
  3. Installation
  4. Configure the SDK
  5. Overriding the GraphQL endpoint
  6. Basic example

@criipto/signatures

A Node.js SDK for Criipto Signatures

Sign PAdeS-LTA documents using MitID, BankID or any other eID supported by Criipto.

Examples

Getting started

Requirements

This library supports Node 16 and later.

Installation

The SDK is available on NPM:

npm install --save @criipto/signatures
yarn add @criipto/signatures

Configure the SDK

import CriiptoSignatures from '@criipto/signatures';
const client = new CriiptoSignatures('{YOUR_CRIIPTO_CLIENT_ID}', '{YOUR_CRIIPTO_CLIENT_SECRET}');

Overriding the GraphQL endpoint

By default the SDK targets https://signatures.idura.app. You can override the endpoint by passing an endpoint option:

import CriiptoSignatures from '@criipto/signatures';
const client = new CriiptoSignatures('{YOUR_CRIIPTO_CLIENT_ID}', '{YOUR_CRIIPTO_CLIENT_SECRET}', {
  endpoint: 'https://signatures.idura.app/v1/graphql',
});

The same option is supported by SignatoryViewerClient:

import { SignatoryViewerClient } from '@criipto/signatures';
const client = new SignatoryViewerClient(
  { token: '{SIGNATORY_TOKEN}' },
  { endpoint: 'https://signatures.idura.app/v1/graphql' },
);

Basic example

import CriiptoSignatures from '@criipto/signatures';
const client = new CriiptoSignatures("{YOUR_CRIIPTO_CLIENT_ID}", "{YOUR_CRIIPTO_CLIENT_SECRET}");

// Create signature order
const signatureOrder = await client.createSignatureOrder({
  title: "Node.js sample",
  documents: [
    {
      pdf: {
        title: "Node.js Sample",
        blob: pdf // Buffer
        storageMode: 'Temporary'
      }
    }
  ]
});

// Add signatory to signature order
const signatory = await client.addSignatory(signatureOrder.id);
console.log(signatory.href);

const closed = await client.closeSignatureOrder(signatureOrder.id);

版本与发布记录

@criipto/signatures 共发布 180 个版本,首次发布于 2023/05/10;过去 12 个月发布了 14 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.0.1latest2026/10/1526 天前
2.0.02026/10/071 个月前
1.35.12026/06/264 个月前
1.35.02026/06/174 个月前
1.34.02026/05/195 个月前
1.33.02026/05/046 个月前

关于 @criipto/signatures 的常见问题

@criipto/signatures 是什么?

A Node.JS SDK for Criipto Signatures

如何安装 @criipto/signatures?

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

@criipto/signatures 支持 TypeScript 吗?

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

@criipto/signatures 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@criipto/signatures 可以商用吗?

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

@criipto/signatures 的下载量有多少?

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

@criipto/signatures 还在维护吗?

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