# @cspeach/sap-client 中文文档

规范地址：https://npmcn.com/package/%40cspeach/sap-client/

版本：0\.1\.35
npm 元数据更新时间：2026-11-05T14:22:47.155Z
中文译文更新时间：2026-11-11T06:28:15.390Z
软件包许可：SEE LICENSE IN LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%40cspeach/sap-client
原文对照：https://npmcn.com/package/%40cspeach/sap-client/?lang=original
项目主页：https://cspeach.dev/

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

- 包体积（解压后）：736 kB，53 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0
- 运行依赖：1 个
- 首次发布：2026-05-13T18:03:15.172Z
- 最新版本发布：2026-11-05T14:22:46.957Z
- 近 30 天下载量：2893（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：36（近 12 个月 36 个）

## 中文简介

SAP开发客户端被CSPeach使用. 写出/激活生命周期,TLS用于自签证书,快照+审计钩.

## 安装

```sh
npm install @cspeach/sap-client
```

也可以使用：`pnpm add @cspeach/sap-client`、`yarn add @cspeach/sap-client`、`bun add @cspeach/sap-client`

## README

# @ cspach/ sap- 客户端

SAP开发客户端具有安全写作/激活生命周期. 用于 [社区支助](https://cspeach.dev/) ——AI带动ABAP开发.

> **状态 :** v0.1.0 — npm上首次公开发布(2026-05-13). 专有;见 [自由主义](https://npmcn.com/package/%40cspeach/sap-client/LICENSE) 就条件而言。 可以在您的 CSPeach 计划中自由使用; 无法自由重新分配或分叉 。 见 [决定(md)](https://npmcn.com/package/%40cspeach/sap-client/DECISIONS.md) 设计边界与 `cspeach-cli`。 。 。 .

## 特征

-   SAP REST的全覆盖范围:程序,类,界面,CDS视图,行为定义,服务定义/约束,表格,消息类,传输.
-   正确锁定 ~ PUT ~ 解锁生命周期,423恢复.
-   HTTP/1.1 强制。 默认情况下进行 TLS 验证 – 信任客户的内部/公司 CA `caCertPath`编号 :`caCert` (核查保留);明确 `insecureSkipTlsVerify` 用响亮的警告来禁用它 。 遗产 `sslVerify: false` 仍然被接受(被限制为不安全+警告).
-   通过每条连接的mutex(预防饼干/CSRF种族)请求序列化.
-   抓图 + 审计记录钩;通过 `safety/` 出口.

## 安装

```
npm install @cspeach/sap-client
```

内部使用 `@cspeach/cli`. 直接依赖 只有当您正在针对 SAP REST 构建工具并想要锁定/写入/解锁生命周期时.

需要节点.js 20+.

## 快开始

```typescript
import { SapConnection, AdtClient } from '@cspeach/sap-client';

// Constructor takes 3 positional args: (config, username, password)
const conn = new SapConnection(
  {
    host: '172.16.24.98',
    port: 44300,
    client: '100',
    useSsl: true,
    // TLS verification is ON by default. For self-signed / internal-CA SAP
    // systems, trust the CA instead of disabling verification:
    caCertPath: '/etc/ssl/corp-ca.pem',   // adds the CA, keeps verification ON
    // Dev-only escape hatch (NEVER production) — disables verification and
    // logs a loud warning on connect:
    // insecureSkipTlsVerify: true,
    credentialRef: 'my-sap-alias',
    authType: 'basic',
  },
  'S.LAEEQ',
  process.env.SAP_PASSWORD!,
);

const adt = new AdtClient(conn);
// getSource takes (type, name) — type first
const source = await adt.getSource('CLAS', 'ZCL_FOO');
console.log(source);
```

## API 表面

见 `index.ts` 出口。 核心类别:

-   `SapConnection` 低水平SAP REST HTTPS运输
-   `AdtClient` ——高水平操作:得到Source,设置Source,激活,锁定,解锁,tcRun,运输管理等.

安全模块:

-   `snapshots` ——在写前取出/保存源快照
-   `auditLog` — 仅附件操作日志
-   `rollback` ——将命名对象恢复到快照状态

## 许可证

专有. 版权 (c)2026 Cremencing Solutions. 版权所有. 自由使用在您的 CSPeach 计划中; 不自由重新分配,分叉, 或分许可证。 商业/OEM许可证: [laeeq.siddique@cremencing.com (中文(简体) )](mailto:laeeq.siddique@cremencing.com)。 。 。 .

## 常见问题

### @cspeach/sap-client 是什么？

SAP开发客户端被CSPeach使用\. 写出/激活生命周期,TLS用于自签证书,快照\+审计钩\.

### 如何安装 @cspeach/sap-client？

在项目目录运行 npm install @cspeach/sap-client，或使用 pnpm add / yarn add / bun add。

### @cspeach/sap-client 支持 TypeScript 吗？

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

### @cspeach/sap-client 支持 ESM 还是 CommonJS？

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

### @cspeach/sap-client 需要什么版本的 Node\.js？

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

### @cspeach/sap-client 可以商用吗？

@cspeach/sap-client 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @cspeach/sap-client 的下载量有多少？

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

### @cspeach/sap-client 还在维护吗？

最新版本 0\.1\.35 发布于 2026/11/05（5 天前）；至今共发布 36 个版本，其中过去 12 个月发布了 36 个；首次发布于 2026/05/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。