@unifyport/sdk-node 0.1.0 → 0.1.2

package/README.md

@@ -1,19 +1,320 @@
 # `@unifyport/sdk-node`
 
-面向 Node.js/TypeScript 的 UnifyPort Device API SDK，提供 `UnifyPortDeviceClient`，并通过
-`X-Api-Key` 保持固定认证边界以及统一的 timeout、错误和安全重试模型。Device API 内的 provider
-账号管理、授权和运行态 operation 仍由该客户端提供。
+[English](https://github.com/Unify-Port/UnifyPort-SDK-Nodejs/blob/main/packages/sdk/README.md) | [简体中文](https://github.com/Unify-Port/UnifyPort-SDK-Nodejs/blob/main/packages/sdk/README.zh-CN.md)
 
-## 安装
+The UnifyPort Device API SDK for Node.js and TypeScript. It provides the type-safe
+`UnifyPortDeviceClient`, consistent success response and error models, timeouts, safe retries,
+cancellation, and cursor pagination.
+
+The SDK uses a fixed `X-Api-Key` authentication boundary. Operations under `/v1/accounts/...` belong to
+the Device API and are all available through `UnifyPortDeviceClient`.
+
+## Features
+
+Every operation in the current public contract has a same-named SDK method. Major areas include:
+
+- workspace and provider region queries;
+- provider account resources, authorization flows, and runtime status;
+- conversations, contacts, and groups;
+- message sending and message actions;
+- API key and webhook endpoint management.
+
+Method names match their OpenAPI `operationId` values. See the
+[API Reference](https://github.com/Unify-Port/UnifyPort-SDK-Nodejs/blob/main/docs/api-reference/README.md)
+for each operation's parameters, request body, response fields, and TypeScript example. See
+[API coverage](https://github.com/Unify-Port/UnifyPort-SDK-Nodejs/blob/main/docs/api-coverage.md) for
+HTTP paths, retry behavior, and MCP policies.
+
+## Requirements
+
+- Node.js `>=22.12.0`
+- A TypeScript project or a Node.js project with ESM support
+
+This package provides only ESM `import` exports and TypeScript declarations. It does not provide a
+CommonJS `require()` entry point.
+
+## Installation
 
 ```bash
 npm install @unifyport/sdk-node
 ```
 
-完整用法、契约治理和安全说明见
-[项目 README](https://github.com/Unify-Port/UnifyPort-SDK-Nodejs#readme)。公开发布前必须运行：
+Or with pnpm:
 
 ```bash
-pnpm check
-pnpm public:check
+pnpm add @unifyport/sdk-node
+```
+
+## Quick start
+
+```ts
+import { UnifyPortDeviceClient } from "@unifyport/sdk-node";
+
+function requiredEnv(name: string): string {
+  const value = process.env[name];
+  if (!value) {
+    throw new Error(`Missing required environment variable: ${name}`);
+  }
+  return value;
+}
+
+// Read credentials only from the runtime environment so they never enter source or build artifacts.
+const device = new UnifyPortDeviceClient({
+  baseUrl: requiredEnv("UNIFYPORT_DEVICE_API_BASE_URL"),
+  apiKey: requiredEnv("UNIFYPORT_DEVICE_API_KEY")
+});
+
+const result = await device.getWorkspace();
+
+console.log(result.data.data.name);
+console.log(result.status, result.requestId);
+```
+
+`ApiResult.data` contains the complete API JSON envelope, so resource data is usually available at
+`result.data.data`.
+
+## Client configuration
+
+```ts
+const device = new UnifyPortDeviceClient({
+  baseUrl: "https://device.example.com",
+  apiKey: () => requiredEnv("UNIFYPORT_DEVICE_API_KEY"),
+  timeoutMs: 15_000,
+  maxResponseBytes: 4 * 1024 * 1024,
+  retry: {
+    maxRetries: 2,
+    baseDelayMs: 200,
+    maxDelayMs: 5_000
+  }
+});
+```
+
+| Option              | Required | Description                                                                      |
+| ------------------- | -------- | -------------------------------------------------------------------------------- |
+| `baseUrl`           | Yes      | Absolute Device API URL; remote URLs must use HTTPS                              |
+| `apiKey`            | Yes      | A string or a synchronous/asynchronous provider that returns a string            |
+| `fetch`             | No       | Custom `fetch` implementation with `(request: Request) => Promise<Response>`     |
+| `timeoutMs`         | No       | Defaults to `30000`; total timeout for each operation                            |
+| `maxResponseBytes`  | No       | Defaults to 8 MiB, maximum 64 MiB; limits both wire body and normalized JSON     |
+| `retry`             | No       | Retry count and full-jitter backoff settings for safe operations                 |
+| `allowInsecureHttp` | No       | Defaults to `false`; allows only explicitly enabled loopback HTTP in development |
+
+`baseUrl` must not contain a username, password, query, or fragment. The client injects the API key
+centrally, and an individual operation cannot override the authentication header.
+
+## Calling operations
+
+Every method uses `(request?, execution?)`:
+
+- Omit `request` for operations without parameters.
+- Put path and query parameters in `request.params`.
+- Put a JSON request body in `request.body`.
+- Put per-call timeout, tighter retry settings, and the cancellation signal in `execution`.
+
+### No-parameter reads
+
+```ts
+const workspace = await device.getWorkspace();
+console.log(workspace.data.data);
+
+const accounts = await device.listAccounts();
+for (const account of accounts.data.data) {
+  console.log(account.id, account.provider, account.status);
+}
+```
+
+### Path parameters
+
+```ts
+const regions = await device.listProviderRegions({
+  params: {
+    path: { provider: "whatsapp" }
+  }
+});
+
+for (const region of regions.data.data.regions) {
+  console.log(region.region, region.supported, region.allocatable);
+}
+```
+
+### Path and query parameters
+
+```ts
+const contacts = await device.listContacts({
+  params: {
+    path: { account_id: "acc_xxx" },
+    query: { limit: 100, q: "Alice" }
+  }
+});
+
+console.log(contacts.data.data.items);
+console.log(contacts.data.data.next_cursor);
+```
+
+### JSON request body
+
+```ts
+const message = await device.sendMessage({
+  body: {
+    account_id: "acc_xxx",
+    to: { id: "recipient_xxx", type: "user" },
+    message: { type: "text", text: "Hello from UnifyPort" }
+  }
+});
+
+console.log(message.data.data.message_id, message.data.data.status);
+```
+
+A write operation does not become retryable because of its HTTP method or caller configuration. Do not
+write sensitive inputs such as message bodies to logs.
+
+## Successful responses
+
+Every operation returns `ApiResult<T>`:
+
+| Field       | Description                                                               |
+| ----------- | ------------------------------------------------------------------------- |
+| `data`      | Complete API JSON envelope parsed according to the public contract        |
+| `status`    | HTTP status                                                               |
+| `requestId` | Optional server request ID                                                |
+| `response`  | Underlying `Response` for headers and other successful transport metadata |
+
+The SDK has already parsed the `response` body; do not depend on reading it again. Use the typed `data`
+for application data.
+
+## Timeouts, cancellation, and retries
+
+```ts
+const controller = new AbortController();
+
+const workspace = await device.getWorkspace(
+  {},
+  {
+    timeoutMs: 5_000,
+    retry: { maxRetries: 1 },
+    signal: controller.signal
+  }
+);
 ```
+
+A per-call `execution.retry` setting can only disable or tighten client-level retries:
+
+```ts
+await device.getWorkspace({}, { retry: false });
+await device.getWorkspace({}, { retry: { maxRetries: 0 } });
+```
+
+Automatic retries apply only to safe operations explicitly allowed by policy. They handle network
+failures and temporary statuses such as `408`, `429`, `502`, `503`, and `504`, and honor a valid
+`Retry-After` value. Ordinary writes, account authorization submissions, and one-time secret operations
+are not retried automatically.
+
+## Cursor pagination
+
+`paginateCursor` iterates page items and supports a maximum page count, repeated cursor detection, and
+`AbortSignal`:
+
+```ts
+import { paginateCursor } from "@unifyport/sdk-node";
+
+const accountId = "acc_xxx";
+const controller = new AbortController();
+
+for await (const contact of paginateCursor(
+  async (cursor, pageSignal) => {
+    // With exactOptionalPropertyTypes, do not assign undefined to an optional query field.
+    const query = cursor === undefined ? { limit: 100 } : { cursor, limit: 100 };
+    const result = await device.listContacts(
+      {
+        params: {
+          path: { account_id: accountId },
+          query
+        }
+      },
+      pageSignal === undefined ? {} : { signal: pageSignal }
+    );
+    return result.data.data;
+  },
+  { maxPages: 100, signal: controller.signal }
+)) {
+  console.log(contact.id, contact.display_name);
+}
+```
+
+The pagination helper reads at most 10,000 pages by default. Application code should normally set a
+smaller `maxPages` value appropriate to its workload.
+
+## Error handling
+
+All public errors extend `UnifyPortError`. Record only reviewed fields such as `status`, `code`,
+`requestId`, `api`, and `operationId`. Do not serialize complete errors, requests, responses, or
+headers.
+
+```ts
+import { UnifyPortAbortError, UnifyPortApiError, UnifyPortTimeoutError } from "@unifyport/sdk-node";
+
+try {
+  await device.getWorkspace();
+} catch (error) {
+  if (error instanceof UnifyPortApiError) {
+    console.error({
+      status: error.status,
+      code: error.code,
+      requestId: error.requestId,
+      operationId: error.operationId
+    });
+  } else if (error instanceof UnifyPortTimeoutError) {
+    console.error({ timeoutMs: error.timeoutMs, operationId: error.operationId });
+  } else if (error instanceof UnifyPortAbortError) {
+    console.error({ aborted: true, operationId: error.operationId });
+  } else {
+    throw error;
+  }
+}
+```
+
+| Error type                    | Scenario                                                              |
+| ----------------------------- | --------------------------------------------------------------------- |
+| `UnifyPortConfigurationError` | Invalid client configuration                                          |
+| `UnifyPortNetworkError`       | Network or custom credential provider failure                         |
+| `UnifyPortTimeoutError`       | Operation timeout                                                     |
+| `UnifyPortAbortError`         | Caller cancellation through `AbortSignal`                             |
+| `UnifyPortApiError`           | API returned a non-success HTTP status                                |
+| `UnifyPortResponseParseError` | Successful response could not be parsed safely                        |
+| `UnifyPortPaginationError`    | Missing/repeated cursor, page limit exceeded, or pagination cancelled |
+
+## TypeScript types
+
+The package root also exports the public contract types:
+
+```ts
+import type { DeviceApiComponents, DeviceApiOperations, DeviceApiPaths } from "@unifyport/sdk-node";
+
+type Workspace = DeviceApiComponents["schemas"]["Workspace"];
+type SendMessageOperation = DeviceApiOperations["sendMessage"];
+type DevicePaths = DeviceApiPaths;
+```
+
+To avoid JavaScript precision loss, the SDK preserves integers outside the safe range as strings.
+Fields modeled like `uint64` or `int64` may therefore be `number | string`. Do not call `Number(...)`
+unconditionally unless the value's range is guaranteed.
+
+## Security considerations
+
+- Provide the API key through a secret manager or runtime environment; never hard-code or commit it.
+- Require HTTPS in production. `allowInsecureHttp` accepts only explicitly enabled loopback addresses.
+- Do not log authentication headers, authorization codes/passwords/sessions, message bodies, or
+  one-time secrets.
+- Do not override `baseUrl` dynamically from external input. The client confines credentials to the
+  origin and path established during initialization.
+- Design application-level idempotency and failure recovery for writes. Do not apply read-operation
+  retry assumptions to writes.
+
+For more detail, see the
+[security boundaries](https://github.com/Unify-Port/UnifyPort-SDK-Nodejs/blob/main/docs/security.md).
+
+## Project and license
+
+- [GitHub repository](https://github.com/Unify-Port/UnifyPort-SDK-Nodejs)
+- [Project README](https://github.com/Unify-Port/UnifyPort-SDK-Nodejs#readme)
+- [MIT License](https://github.com/Unify-Port/UnifyPort-SDK-Nodejs/blob/main/LICENSE)

package/README.zh-CN.md

@@ -0,0 +1,306 @@
+# `@unifyport/sdk-node`
+
+[English](https://github.com/Unify-Port/UnifyPort-SDK-Nodejs/blob/main/packages/sdk/README.md) | [简体中文](https://github.com/Unify-Port/UnifyPort-SDK-Nodejs/blob/main/packages/sdk/README.zh-CN.md)
+
+面向 Node.js/TypeScript 的 UnifyPort Device API SDK。它提供类型安全的
+`UnifyPortDeviceClient`、统一的成功响应与错误模型，以及 timeout、安全重试、取消和 cursor
+分页能力。
+
+SDK 使用固定的 `X-Api-Key` 认证边界。`/v1/accounts/...` operation 属于 Device API，统一由
+`UnifyPortDeviceClient` 提供。
+
+## 功能范围
+
+当前公开契约中的全部 operation 都有同名 SDK 方法，主要覆盖：
+
+- workspace 与 provider region 查询；
+- provider 账号资源、授权流程与运行状态；
+- 会话、联系人和群组；
+- 消息发送与消息动作；
+- API Key 与 webhook endpoint 管理。
+
+方法名与 OpenAPI `operationId` 保持一致。每个 operation 的参数、请求体、返回字段和 TypeScript
+示例见 [API Reference](https://github.com/Unify-Port/UnifyPort-SDK-Nodejs/blob/main/docs/zh-CN/api-reference/README.md)；
+HTTP path、重试和 MCP 策略见
+[API 覆盖表](https://github.com/Unify-Port/UnifyPort-SDK-Nodejs/blob/main/docs/zh-CN/api-coverage.md)。
+
+## 环境要求
+
+- Node.js `>=22.12.0`
+- TypeScript 项目或支持 ESM 的 Node.js 项目
+
+该 package 只提供 ESM `import` 和 TypeScript 声明文件，不提供 CommonJS `require()` 入口。
+
+## 安装
+
+```bash
+npm install @unifyport/sdk-node
+```
+
+也可以使用 pnpm：
+
+```bash
+pnpm add @unifyport/sdk-node
+```
+
+## 快速开始
+
+```ts
+import { UnifyPortDeviceClient } from "@unifyport/sdk-node";
+
+function requiredEnv(name: string): string {
+  const value = process.env[name];
+  if (!value) {
+    throw new Error(`Missing required environment variable: ${name}`);
+  }
+  return value;
+}
+
+// 凭据只从运行环境读取，避免进入源码、构建产物或版本控制。
+const device = new UnifyPortDeviceClient({
+  baseUrl: requiredEnv("UNIFYPORT_DEVICE_API_BASE_URL"),
+  apiKey: requiredEnv("UNIFYPORT_DEVICE_API_KEY")
+});
+
+const result = await device.getWorkspace();
+
+console.log(result.data.data.name);
+console.log(result.status, result.requestId);
+```
+
+`ApiResult.data` 是完整 API JSON envelope，因此资源数据通常位于 `result.data.data`。
+
+## Client 配置
+
+```ts
+const device = new UnifyPortDeviceClient({
+  baseUrl: "https://device.example.com",
+  apiKey: () => requiredEnv("UNIFYPORT_DEVICE_API_KEY"),
+  timeoutMs: 15_000,
+  maxResponseBytes: 4 * 1024 * 1024,
+  retry: {
+    maxRetries: 2,
+    baseDelayMs: 200,
+    maxDelayMs: 5_000
+  }
+});
+```
+
+| 配置项              | 必填 | 说明                                                                  |
+| ------------------- | ---- | --------------------------------------------------------------------- |
+| `baseUrl`           | 是   | Device API 的绝对 URL；远程地址必须使用 HTTPS                         |
+| `apiKey`            | 是   | 字符串，或返回字符串的同步/异步 provider                              |
+| `fetch`             | 否   | 自定义 `fetch` 实现，签名为 `(request: Request) => Promise<Response>` |
+| `timeoutMs`         | 否   | 默认 `30000`；每次 operation 的总超时                                 |
+| `maxResponseBytes`  | 否   | 默认 8 MiB，最大 64 MiB；同时限制 wire body 与规范化后的 JSON         |
+| `retry`             | 否   | 安全 operation 的重试次数和 full-jitter 退避配置                      |
+| `allowInsecureHttp` | 否   | 默认 `false`；仅允许显式开启的 loopback HTTP 开发环境                 |
+
+`baseUrl` 不应包含 username、password、query 或 fragment。API key 由 client 统一注入，单次 operation
+不能覆盖认证 header。
+
+## 调用 operation
+
+方法统一使用 `(request?, execution?)`：
+
+- 没有参数的 operation 可以省略 `request`；
+- path 和 query 参数放在 `request.params`；
+- JSON 请求体放在 `request.body`；
+- 单次 timeout、重试收紧和取消信号放在 `execution`。
+
+### 无参数读取
+
+```ts
+const workspace = await device.getWorkspace();
+console.log(workspace.data.data);
+
+const accounts = await device.listAccounts();
+for (const account of accounts.data.data) {
+  console.log(account.id, account.provider, account.status);
+}
+```
+
+### Path 参数
+
+```ts
+const regions = await device.listProviderRegions({
+  params: {
+    path: { provider: "whatsapp" }
+  }
+});
+
+for (const region of regions.data.data.regions) {
+  console.log(region.region, region.supported, region.allocatable);
+}
+```
+
+### Path 与 query 参数
+
+```ts
+const contacts = await device.listContacts({
+  params: {
+    path: { account_id: "acc_xxx" },
+    query: { limit: 100, q: "Alice" }
+  }
+});
+
+console.log(contacts.data.data.items);
+console.log(contacts.data.data.next_cursor);
+```
+
+### JSON 请求体
+
+```ts
+const message = await device.sendMessage({
+  body: {
+    account_id: "acc_xxx",
+    to: { id: "recipient_xxx", type: "user" },
+    message: { type: "text", text: "Hello from UnifyPort" }
+  }
+});
+
+console.log(message.data.data.message_id, message.data.data.status);
+```
+
+写操作不会因为 HTTP method 或调用方配置而自动获得重试能力。消息正文等敏感输入不应写入日志。
+
+## 成功响应
+
+所有 operation 都返回 `ApiResult<T>`：
+
+| 字段        | 说明                                                    |
+| ----------- | ------------------------------------------------------- |
+| `data`      | 按公开契约解析后的完整 API JSON envelope                |
+| `status`    | HTTP status                                             |
+| `requestId` | 可选的服务端 request ID                                 |
+| `response`  | 底层 `Response`，用于读取正常响应的 header 等传输元数据 |
+
+`response` 的 body 已由 SDK 解析，不应依赖再次读取；业务数据使用类型化的 `data`。
+
+## Timeout、取消与重试
+
+```ts
+const controller = new AbortController();
+
+const workspace = await device.getWorkspace(
+  {},
+  {
+    timeoutMs: 5_000,
+    retry: { maxRetries: 1 },
+    signal: controller.signal
+  }
+);
+```
+
+单次 `execution.retry` 只能关闭或收紧 client 级重试：
+
+```ts
+await device.getWorkspace({}, { retry: false });
+await device.getWorkspace({}, { retry: { maxRetries: 0 } });
+```
+
+自动重试只适用于策略明确允许的安全 operation，处理网络失败和 `408`、`429`、`502`、`503`、
+`504` 等临时状态，并遵守合法的 `Retry-After`。普通写操作、账号授权提交和一次性 secret operation
+不会自动重试。
+
+## Cursor 分页
+
+`paginateCursor` 会逐项迭代分页数据，并提供最大页数、重复 cursor 检测与 `AbortSignal` 支持：
+
+```ts
+import { paginateCursor } from "@unifyport/sdk-node";
+
+const accountId = "acc_xxx";
+const controller = new AbortController();
+
+for await (const contact of paginateCursor(
+  async (cursor, pageSignal) => {
+    // exactOptionalPropertyTypes 下不把 undefined 写入可选 query 字段。
+    const query = cursor === undefined ? { limit: 100 } : { cursor, limit: 100 };
+    const result = await device.listContacts(
+      {
+        params: {
+          path: { account_id: accountId },
+          query
+        }
+      },
+      pageSignal === undefined ? {} : { signal: pageSignal }
+    );
+    return result.data.data;
+  },
+  { maxPages: 100, signal: controller.signal }
+)) {
+  console.log(contact.id, contact.display_name);
+}
+```
+
+分页 helper 默认最多读取 10,000 页。业务代码通常应根据自身任务量设置更小的 `maxPages`。
+
+## 错误处理
+
+所有公开错误都继承 `UnifyPortError`。建议只记录经过筛选的 `status`、`code`、`requestId`、`api` 和
+`operationId`，不要直接序列化完整错误、请求、响应或 header。
+
+```ts
+import { UnifyPortAbortError, UnifyPortApiError, UnifyPortTimeoutError } from "@unifyport/sdk-node";
+
+try {
+  await device.getWorkspace();
+} catch (error) {
+  if (error instanceof UnifyPortApiError) {
+    console.error({
+      status: error.status,
+      code: error.code,
+      requestId: error.requestId,
+      operationId: error.operationId
+    });
+  } else if (error instanceof UnifyPortTimeoutError) {
+    console.error({ timeoutMs: error.timeoutMs, operationId: error.operationId });
+  } else if (error instanceof UnifyPortAbortError) {
+    console.error({ aborted: true, operationId: error.operationId });
+  } else {
+    throw error;
+  }
+}
+```
+
+| 错误类型                      | 场景                                    |
+| ----------------------------- | --------------------------------------- |
+| `UnifyPortConfigurationError` | client 配置无效                         |
+| `UnifyPortNetworkError`       | 网络或自定义 credential provider 失败   |
+| `UnifyPortTimeoutError`       | operation 超时                          |
+| `UnifyPortAbortError`         | 调用方通过 `AbortSignal` 取消           |
+| `UnifyPortApiError`           | API 返回非成功 HTTP status              |
+| `UnifyPortResponseParseError` | 成功响应无法安全解析                    |
+| `UnifyPortPaginationError`    | cursor 缺失、重复、超出页数或分页被取消 |
+
+## TypeScript 类型
+
+根入口同时导出公开契约类型：
+
+```ts
+import type { DeviceApiComponents, DeviceApiOperations, DeviceApiPaths } from "@unifyport/sdk-node";
+
+type Workspace = DeviceApiComponents["schemas"]["Workspace"];
+type SendMessageOperation = DeviceApiOperations["sendMessage"];
+type DevicePaths = DeviceApiPaths;
+```
+
+为避免 JavaScript 精度丢失，SDK 会把超出安全范围的整数保留为字符串。因此 `uint64`/`int64` 风格
+字段可能是 `number | string`；不要在没有范围保证时无条件调用 `Number(...)`。
+
+## 安全注意事项
+
+- API key 应从 secret manager 或运行环境提供，不要硬编码或提交到版本控制；
+- 生产环境必须使用 HTTPS；`allowInsecureHttp` 只接受显式开启的 loopback 地址；
+- 不要记录认证 header、授权 code/password/session、消息正文或一次性 secret；
+- 不要从外部输入动态覆盖 `baseUrl`；client 会把凭据限制在初始化时确定的 origin/path；
+- 对写操作自行设计业务幂等和失败恢复，不要把读取 operation 的重试假设套用到写入。
+
+更多设计细节见[安全边界](https://github.com/Unify-Port/UnifyPort-SDK-Nodejs/blob/main/docs/zh-CN/security.md)。
+
+## 项目与许可证
+
+- [GitHub 仓库](https://github.com/Unify-Port/UnifyPort-SDK-Nodejs)
+- [项目 README](https://github.com/Unify-Port/UnifyPort-SDK-Nodejs/blob/main/README.zh-CN.md)
+- [MIT License](https://github.com/Unify-Port/UnifyPort-SDK-Nodejs/blob/main/LICENSE)

package/package.json

@@ -1,14 +1,25 @@
 {
   "name": "@unifyport/sdk-node",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "license": "MIT",
-  "description": "面向 Node.js 的 UnifyPort Device API 类型安全 SDK。",
+  "description": "Type-safe Node.js SDK for the UnifyPort Device API.",
   "type": "module",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Unify-Port/UnifyPort-SDK-Nodejs.git",
     "directory": "packages/sdk"
   },
+  "homepage": "https://github.com/Unify-Port/UnifyPort-SDK-Nodejs#readme",
+  "bugs": {
+    "url": "https://github.com/Unify-Port/UnifyPort-SDK-Nodejs/issues"
+  },
+  "keywords": [
+    "unifyport",
+    "sdk",
+    "device-api",
+    "nodejs",
+    "typescript"
+  ],
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
@@ -28,16 +39,17 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "README.zh-CN.md"
   ],
   "sideEffects": false,
-  "dependencies": {
-    "openapi-fetch": "0.17.0",
-    "openapi-typescript-helpers": "0.1.0"
-  },
   "scripts": {
     "build": "pnpm clean && tsc -p tsconfig.build.json",
     "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
     "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "openapi-fetch": "0.17.0",
+    "openapi-typescript-helpers": "0.1.0"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 UnifyPort
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.