@leaflow/sdk 0.5.1 → 0.6.0

package/dist/generated/tunnel/models/tunnelResourceSubscriptionStatus.js

@@ -0,0 +1,29 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow 隧道用户 API
+ * Leaflow 隧道的用户接口，用于开通与管理项目的加速隧道、订阅地址和流量用量。
+
+## 身份与鉴权
+
+每个请求需携带 `Authorization: Bearer <项目令牌>`。先在 auth.leaflow.net 登录获取账号令牌，再用它向 IAM 换取项目令牌（`POST /api/v1/projects/{projectId}/token`）。一张项目令牌同时说明当前用户和当前项目。
+
+**路径和请求头上都没有 `project_id`**：当前项目由令牌决定。
+
+鉴权在网关完成，失败的请求不会到达这些接口。按错误码区分处理方式：`TOKEN_MISSING` 表示没带令牌；`TOKEN_EXPIRED` 表示令牌过期，用账号令牌重新换取即可，无需重新登录；`TOKEN_INVALID` 表示令牌验不过；`NOT_A_MEMBER` 表示当前账号不是该项目成员；`USER_SUSPENDED` / `USER_BANNED` 表示账号本身不能操作。
+
+## 通用约定
+
+- **一个项目一条隧道。** 所以路径是单数的 `/tunnel`，不带 id。已经有一条时再开通会被拒绝（`TUNNEL_ALREADY_OPEN`）。
+- **订阅地址是凭据。** 它等同于密码，只由 `GET /tunnel/subscription` 单独返回，不出现在隧道详情或任何列表里。怀疑泄露时用重置接口，它会让已分发的每一份订阅立即失效。
+- **停用不是退订。** 停用保留端口和订阅地址，重新启用后原样回来；退订不可逆，重新开通得到的是全新的地址。
+- **判断超额只看 `billed_bytes`。** 线路可以设置倍率（如 1.5× 或 0×），`raw_bytes` 是实际传输量，两者不一定相等。
+- **用量最多滞后一个采集周期。** 适合用量管控，不适合作为计费结算依据。隧道详情里那份还额外经过一层缓存，`usage.synced_at` 说明它有多旧。
+- **换套餐不是瞬时的。** 多出来的线路马上可用，少掉的那些有宽限期，到期才真正释放。
+ * OpenAPI spec version: 1.0.0
+ */
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const TunnelResourceSubscriptionStatus = {
+    preparing: 'preparing',
+    ready: 'ready',
+};

package/dist/generated/tunnel/models/tunnelResourceSuspendedAt.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow 隧道用户 API
+ * Leaflow 隧道的用户接口，用于开通与管理项目的加速隧道、订阅地址和流量用量。
+
+## 身份与鉴权
+
+每个请求需携带 `Authorization: Bearer <项目令牌>`。先在 auth.leaflow.net 登录获取账号令牌，再用它向 IAM 换取项目令牌（`POST /api/v1/projects/{projectId}/token`）。一张项目令牌同时说明当前用户和当前项目。
+
+**路径和请求头上都没有 `project_id`**：当前项目由令牌决定。
+
+鉴权在网关完成，失败的请求不会到达这些接口。按错误码区分处理方式：`TOKEN_MISSING` 表示没带令牌；`TOKEN_EXPIRED` 表示令牌过期，用账号令牌重新换取即可，无需重新登录；`TOKEN_INVALID` 表示令牌验不过；`NOT_A_MEMBER` 表示当前账号不是该项目成员；`USER_SUSPENDED` / `USER_BANNED` 表示账号本身不能操作。
+
+## 通用约定
+
+- **一个项目一条隧道。** 所以路径是单数的 `/tunnel`，不带 id。已经有一条时再开通会被拒绝（`TUNNEL_ALREADY_OPEN`）。
+- **订阅地址是凭据。** 它等同于密码，只由 `GET /tunnel/subscription` 单独返回，不出现在隧道详情或任何列表里。怀疑泄露时用重置接口，它会让已分发的每一份订阅立即失效。
+- **停用不是退订。** 停用保留端口和订阅地址，重新启用后原样回来；退订不可逆，重新开通得到的是全新的地址。
+- **判断超额只看 `billed_bytes`。** 线路可以设置倍率（如 1.5× 或 0×），`raw_bytes` 是实际传输量，两者不一定相等。
+- **用量最多滞后一个采集周期。** 适合用量管控，不适合作为计费结算依据。隧道详情里那份还额外经过一层缓存，`usage.synced_at` 说明它有多旧。
+- **换套餐不是瞬时的。** 多出来的线路马上可用，少掉的那些有宽限期，到期才真正释放。
+ * OpenAPI spec version: 1.0.0
+ */
+/**
+ * 被平台停用的时刻
+ */
+export type TunnelResourceSuspendedAt = string | null;

package/dist/generated/tunnel/models/tunnelResourceSuspendedAt.js

@@ -0,0 +1,25 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow 隧道用户 API
+ * Leaflow 隧道的用户接口，用于开通与管理项目的加速隧道、订阅地址和流量用量。
+
+## 身份与鉴权
+
+每个请求需携带 `Authorization: Bearer <项目令牌>`。先在 auth.leaflow.net 登录获取账号令牌，再用它向 IAM 换取项目令牌（`POST /api/v1/projects/{projectId}/token`）。一张项目令牌同时说明当前用户和当前项目。
+
+**路径和请求头上都没有 `project_id`**：当前项目由令牌决定。
+
+鉴权在网关完成，失败的请求不会到达这些接口。按错误码区分处理方式：`TOKEN_MISSING` 表示没带令牌；`TOKEN_EXPIRED` 表示令牌过期，用账号令牌重新换取即可，无需重新登录；`TOKEN_INVALID` 表示令牌验不过；`NOT_A_MEMBER` 表示当前账号不是该项目成员；`USER_SUSPENDED` / `USER_BANNED` 表示账号本身不能操作。
+
+## 通用约定
+
+- **一个项目一条隧道。** 所以路径是单数的 `/tunnel`，不带 id。已经有一条时再开通会被拒绝（`TUNNEL_ALREADY_OPEN`）。
+- **订阅地址是凭据。** 它等同于密码，只由 `GET /tunnel/subscription` 单独返回，不出现在隧道详情或任何列表里。怀疑泄露时用重置接口，它会让已分发的每一份订阅立即失效。
+- **停用不是退订。** 停用保留端口和订阅地址，重新启用后原样回来；退订不可逆，重新开通得到的是全新的地址。
+- **判断超额只看 `billed_bytes`。** 线路可以设置倍率（如 1.5× 或 0×），`raw_bytes` 是实际传输量，两者不一定相等。
+- **用量最多滞后一个采集周期。** 适合用量管控，不适合作为计费结算依据。隧道详情里那份还额外经过一层缓存，`usage.synced_at` 说明它有多旧。
+- **换套餐不是瞬时的。** 多出来的线路马上可用，少掉的那些有宽限期，到期才真正释放。
+ * OpenAPI spec version: 1.0.0
+ */
+export {};

package/dist/generated/tunnel/models/tunnelUsageSnapshot.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow 隧道用户 API
+ * Leaflow 隧道的用户接口，用于开通与管理项目的加速隧道、订阅地址和流量用量。
+
+## 身份与鉴权
+
+每个请求需携带 `Authorization: Bearer <项目令牌>`。先在 auth.leaflow.net 登录获取账号令牌，再用它向 IAM 换取项目令牌（`POST /api/v1/projects/{projectId}/token`）。一张项目令牌同时说明当前用户和当前项目。
+
+**路径和请求头上都没有 `project_id`**：当前项目由令牌决定。
+
+鉴权在网关完成，失败的请求不会到达这些接口。按错误码区分处理方式：`TOKEN_MISSING` 表示没带令牌；`TOKEN_EXPIRED` 表示令牌过期，用账号令牌重新换取即可，无需重新登录；`TOKEN_INVALID` 表示令牌验不过；`NOT_A_MEMBER` 表示当前账号不是该项目成员；`USER_SUSPENDED` / `USER_BANNED` 表示账号本身不能操作。
+
+## 通用约定
+
+- **一个项目一条隧道。** 所以路径是单数的 `/tunnel`，不带 id。已经有一条时再开通会被拒绝（`TUNNEL_ALREADY_OPEN`）。
+- **订阅地址是凭据。** 它等同于密码，只由 `GET /tunnel/subscription` 单独返回，不出现在隧道详情或任何列表里。怀疑泄露时用重置接口，它会让已分发的每一份订阅立即失效。
+- **停用不是退订。** 停用保留端口和订阅地址，重新启用后原样回来；退订不可逆，重新开通得到的是全新的地址。
+- **判断超额只看 `billed_bytes`。** 线路可以设置倍率（如 1.5× 或 0×），`raw_bytes` 是实际传输量，两者不一定相等。
+- **用量最多滞后一个采集周期。** 适合用量管控，不适合作为计费结算依据。隧道详情里那份还额外经过一层缓存，`usage.synced_at` 说明它有多旧。
+- **换套餐不是瞬时的。** 多出来的线路马上可用，少掉的那些有宽限期，到期才真正释放。
+ * OpenAPI spec version: 1.0.0
+ */
+import type { TunnelUsageSnapshotSyncedAt } from './tunnelUsageSnapshotSyncedAt.js';
+export interface TunnelUsageSnapshot {
+    /** 按线路倍率折算后的用量，配额比对以此为准 */
+    billed_bytes: number;
+    /** billed_bytes 是否已超过 quota_bytes；配额为 0 时恒为 false */
+    over_quota: boolean;
+    /** 上游给出的真实配额，0 表示不限量 */
+    quota_bytes: number;
+    /** 实际传输的字节，不用于配额比对 */
+    raw_bytes: number;
+    /** 这份用量是什么时候采集的；null 表示尚未采集 */
+    synced_at: TunnelUsageSnapshotSyncedAt;
+    upload_bytes: number;
+}

package/dist/generated/tunnel/models/tunnelUsageSnapshot.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/tunnel/models/tunnelUsageSnapshotSyncedAt.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow 隧道用户 API
+ * Leaflow 隧道的用户接口，用于开通与管理项目的加速隧道、订阅地址和流量用量。
+
+## 身份与鉴权
+
+每个请求需携带 `Authorization: Bearer <项目令牌>`。先在 auth.leaflow.net 登录获取账号令牌，再用它向 IAM 换取项目令牌（`POST /api/v1/projects/{projectId}/token`）。一张项目令牌同时说明当前用户和当前项目。
+
+**路径和请求头上都没有 `project_id`**：当前项目由令牌决定。
+
+鉴权在网关完成，失败的请求不会到达这些接口。按错误码区分处理方式：`TOKEN_MISSING` 表示没带令牌；`TOKEN_EXPIRED` 表示令牌过期，用账号令牌重新换取即可，无需重新登录；`TOKEN_INVALID` 表示令牌验不过；`NOT_A_MEMBER` 表示当前账号不是该项目成员；`USER_SUSPENDED` / `USER_BANNED` 表示账号本身不能操作。
+
+## 通用约定
+
+- **一个项目一条隧道。** 所以路径是单数的 `/tunnel`，不带 id。已经有一条时再开通会被拒绝（`TUNNEL_ALREADY_OPEN`）。
+- **订阅地址是凭据。** 它等同于密码，只由 `GET /tunnel/subscription` 单独返回，不出现在隧道详情或任何列表里。怀疑泄露时用重置接口，它会让已分发的每一份订阅立即失效。
+- **停用不是退订。** 停用保留端口和订阅地址，重新启用后原样回来；退订不可逆，重新开通得到的是全新的地址。
+- **判断超额只看 `billed_bytes`。** 线路可以设置倍率（如 1.5× 或 0×），`raw_bytes` 是实际传输量，两者不一定相等。
+- **用量最多滞后一个采集周期。** 适合用量管控，不适合作为计费结算依据。隧道详情里那份还额外经过一层缓存，`usage.synced_at` 说明它有多旧。
+- **换套餐不是瞬时的。** 多出来的线路马上可用，少掉的那些有宽限期，到期才真正释放。
+ * OpenAPI spec version: 1.0.0
+ */
+/**
+ * 这份用量是什么时候采集的；null 表示尚未采集
+ */
+export type TunnelUsageSnapshotSyncedAt = string | null;

package/dist/generated/tunnel/models/tunnelUsageSnapshotSyncedAt.js

@@ -0,0 +1,25 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow 隧道用户 API
+ * Leaflow 隧道的用户接口，用于开通与管理项目的加速隧道、订阅地址和流量用量。
+
+## 身份与鉴权
+
+每个请求需携带 `Authorization: Bearer <项目令牌>`。先在 auth.leaflow.net 登录获取账号令牌，再用它向 IAM 换取项目令牌（`POST /api/v1/projects/{projectId}/token`）。一张项目令牌同时说明当前用户和当前项目。
+
+**路径和请求头上都没有 `project_id`**：当前项目由令牌决定。
+
+鉴权在网关完成，失败的请求不会到达这些接口。按错误码区分处理方式：`TOKEN_MISSING` 表示没带令牌；`TOKEN_EXPIRED` 表示令牌过期，用账号令牌重新换取即可，无需重新登录；`TOKEN_INVALID` 表示令牌验不过；`NOT_A_MEMBER` 表示当前账号不是该项目成员；`USER_SUSPENDED` / `USER_BANNED` 表示账号本身不能操作。
+
+## 通用约定
+
+- **一个项目一条隧道。** 所以路径是单数的 `/tunnel`，不带 id。已经有一条时再开通会被拒绝（`TUNNEL_ALREADY_OPEN`）。
+- **订阅地址是凭据。** 它等同于密码，只由 `GET /tunnel/subscription` 单独返回，不出现在隧道详情或任何列表里。怀疑泄露时用重置接口，它会让已分发的每一份订阅立即失效。
+- **停用不是退订。** 停用保留端口和订阅地址，重新启用后原样回来；退订不可逆，重新开通得到的是全新的地址。
+- **判断超额只看 `billed_bytes`。** 线路可以设置倍率（如 1.5× 或 0×），`raw_bytes` 是实际传输量，两者不一定相等。
+- **用量最多滞后一个采集周期。** 适合用量管控，不适合作为计费结算依据。隧道详情里那份还额外经过一层缓存，`usage.synced_at` 说明它有多旧。
+- **换套餐不是瞬时的。** 多出来的线路马上可用，少掉的那些有宽限期，到期才真正释放。
+ * OpenAPI spec version: 1.0.0
+ */
+export {};

package/dist/generated/tunnel/models/updateTunnelProfileRequestBody.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow 隧道用户 API
+ * Leaflow 隧道的用户接口，用于开通与管理项目的加速隧道、订阅地址和流量用量。
+
+## 身份与鉴权
+
+每个请求需携带 `Authorization: Bearer <项目令牌>`。先在 auth.leaflow.net 登录获取账号令牌，再用它向 IAM 换取项目令牌（`POST /api/v1/projects/{projectId}/token`）。一张项目令牌同时说明当前用户和当前项目。
+
+**路径和请求头上都没有 `project_id`**：当前项目由令牌决定。
+
+鉴权在网关完成，失败的请求不会到达这些接口。按错误码区分处理方式：`TOKEN_MISSING` 表示没带令牌；`TOKEN_EXPIRED` 表示令牌过期，用账号令牌重新换取即可，无需重新登录；`TOKEN_INVALID` 表示令牌验不过；`NOT_A_MEMBER` 表示当前账号不是该项目成员；`USER_SUSPENDED` / `USER_BANNED` 表示账号本身不能操作。
+
+## 通用约定
+
+- **一个项目一条隧道。** 所以路径是单数的 `/tunnel`，不带 id。已经有一条时再开通会被拒绝（`TUNNEL_ALREADY_OPEN`）。
+- **订阅地址是凭据。** 它等同于密码，只由 `GET /tunnel/subscription` 单独返回，不出现在隧道详情或任何列表里。怀疑泄露时用重置接口，它会让已分发的每一份订阅立即失效。
+- **停用不是退订。** 停用保留端口和订阅地址，重新启用后原样回来；退订不可逆，重新开通得到的是全新的地址。
+- **判断超额只看 `billed_bytes`。** 线路可以设置倍率（如 1.5× 或 0×），`raw_bytes` 是实际传输量，两者不一定相等。
+- **用量最多滞后一个采集周期。** 适合用量管控，不适合作为计费结算依据。隧道详情里那份还额外经过一层缓存，`usage.synced_at` 说明它有多旧。
+- **换套餐不是瞬时的。** 多出来的线路马上可用，少掉的那些有宽限期，到期才真正释放。
+ * OpenAPI spec version: 1.0.0
+ */
+import type { UpdateTunnelProfileRequestBodyEmail } from './updateTunnelProfileRequestBodyEmail.js';
+export interface UpdateTunnelProfileRequestBody {
+    /** @maxLength 128 */
+    display_name: string;
+    /**
+     * 联系邮箱。不传表示不改动，传空字符串表示清空
+     * @maxLength 255
+     */
+    email?: UpdateTunnelProfileRequestBodyEmail;
+}

package/dist/generated/tunnel/models/updateTunnelProfileRequestBody.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/tunnel/models/updateTunnelProfileRequestBodyEmail.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow 隧道用户 API
+ * Leaflow 隧道的用户接口，用于开通与管理项目的加速隧道、订阅地址和流量用量。
+
+## 身份与鉴权
+
+每个请求需携带 `Authorization: Bearer <项目令牌>`。先在 auth.leaflow.net 登录获取账号令牌，再用它向 IAM 换取项目令牌（`POST /api/v1/projects/{projectId}/token`）。一张项目令牌同时说明当前用户和当前项目。
+
+**路径和请求头上都没有 `project_id`**：当前项目由令牌决定。
+
+鉴权在网关完成，失败的请求不会到达这些接口。按错误码区分处理方式：`TOKEN_MISSING` 表示没带令牌；`TOKEN_EXPIRED` 表示令牌过期，用账号令牌重新换取即可，无需重新登录；`TOKEN_INVALID` 表示令牌验不过；`NOT_A_MEMBER` 表示当前账号不是该项目成员；`USER_SUSPENDED` / `USER_BANNED` 表示账号本身不能操作。
+
+## 通用约定
+
+- **一个项目一条隧道。** 所以路径是单数的 `/tunnel`，不带 id。已经有一条时再开通会被拒绝（`TUNNEL_ALREADY_OPEN`）。
+- **订阅地址是凭据。** 它等同于密码，只由 `GET /tunnel/subscription` 单独返回，不出现在隧道详情或任何列表里。怀疑泄露时用重置接口，它会让已分发的每一份订阅立即失效。
+- **停用不是退订。** 停用保留端口和订阅地址，重新启用后原样回来；退订不可逆，重新开通得到的是全新的地址。
+- **判断超额只看 `billed_bytes`。** 线路可以设置倍率（如 1.5× 或 0×），`raw_bytes` 是实际传输量，两者不一定相等。
+- **用量最多滞后一个采集周期。** 适合用量管控，不适合作为计费结算依据。隧道详情里那份还额外经过一层缓存，`usage.synced_at` 说明它有多旧。
+- **换套餐不是瞬时的。** 多出来的线路马上可用，少掉的那些有宽限期，到期才真正释放。
+ * OpenAPI spec version: 1.0.0
+ */
+/**
+ * 联系邮箱。不传表示不改动，传空字符串表示清空
+ * @maxLength 255
+ */
+export type UpdateTunnelProfileRequestBodyEmail = string | null;

package/dist/generated/tunnel/models/updateTunnelProfileRequestBodyEmail.js

@@ -0,0 +1,25 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow 隧道用户 API
+ * Leaflow 隧道的用户接口，用于开通与管理项目的加速隧道、订阅地址和流量用量。
+
+## 身份与鉴权
+
+每个请求需携带 `Authorization: Bearer <项目令牌>`。先在 auth.leaflow.net 登录获取账号令牌，再用它向 IAM 换取项目令牌（`POST /api/v1/projects/{projectId}/token`）。一张项目令牌同时说明当前用户和当前项目。
+
+**路径和请求头上都没有 `project_id`**：当前项目由令牌决定。
+
+鉴权在网关完成，失败的请求不会到达这些接口。按错误码区分处理方式：`TOKEN_MISSING` 表示没带令牌；`TOKEN_EXPIRED` 表示令牌过期，用账号令牌重新换取即可，无需重新登录；`TOKEN_INVALID` 表示令牌验不过；`NOT_A_MEMBER` 表示当前账号不是该项目成员；`USER_SUSPENDED` / `USER_BANNED` 表示账号本身不能操作。
+
+## 通用约定
+
+- **一个项目一条隧道。** 所以路径是单数的 `/tunnel`，不带 id。已经有一条时再开通会被拒绝（`TUNNEL_ALREADY_OPEN`）。
+- **订阅地址是凭据。** 它等同于密码，只由 `GET /tunnel/subscription` 单独返回，不出现在隧道详情或任何列表里。怀疑泄露时用重置接口，它会让已分发的每一份订阅立即失效。
+- **停用不是退订。** 停用保留端口和订阅地址，重新启用后原样回来；退订不可逆，重新开通得到的是全新的地址。
+- **判断超额只看 `billed_bytes`。** 线路可以设置倍率（如 1.5× 或 0×），`raw_bytes` 是实际传输量，两者不一定相等。
+- **用量最多滞后一个采集周期。** 适合用量管控，不适合作为计费结算依据。隧道详情里那份还额外经过一层缓存，`usage.synced_at` 说明它有多旧。
+- **换套餐不是瞬时的。** 多出来的线路马上可用，少掉的那些有宽限期，到期才真正释放。
+ * OpenAPI spec version: 1.0.0
+ */
+export {};

package/dist/generated/tunnel/models/usageDayResource.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow 隧道用户 API
+ * Leaflow 隧道的用户接口，用于开通与管理项目的加速隧道、订阅地址和流量用量。
+
+## 身份与鉴权
+
+每个请求需携带 `Authorization: Bearer <项目令牌>`。先在 auth.leaflow.net 登录获取账号令牌，再用它向 IAM 换取项目令牌（`POST /api/v1/projects/{projectId}/token`）。一张项目令牌同时说明当前用户和当前项目。
+
+**路径和请求头上都没有 `project_id`**：当前项目由令牌决定。
+
+鉴权在网关完成，失败的请求不会到达这些接口。按错误码区分处理方式：`TOKEN_MISSING` 表示没带令牌；`TOKEN_EXPIRED` 表示令牌过期，用账号令牌重新换取即可，无需重新登录；`TOKEN_INVALID` 表示令牌验不过；`NOT_A_MEMBER` 表示当前账号不是该项目成员；`USER_SUSPENDED` / `USER_BANNED` 表示账号本身不能操作。
+
+## 通用约定
+
+- **一个项目一条隧道。** 所以路径是单数的 `/tunnel`，不带 id。已经有一条时再开通会被拒绝（`TUNNEL_ALREADY_OPEN`）。
+- **订阅地址是凭据。** 它等同于密码，只由 `GET /tunnel/subscription` 单独返回，不出现在隧道详情或任何列表里。怀疑泄露时用重置接口，它会让已分发的每一份订阅立即失效。
+- **停用不是退订。** 停用保留端口和订阅地址，重新启用后原样回来；退订不可逆，重新开通得到的是全新的地址。
+- **判断超额只看 `billed_bytes`。** 线路可以设置倍率（如 1.5× 或 0×），`raw_bytes` 是实际传输量，两者不一定相等。
+- **用量最多滞后一个采集周期。** 适合用量管控，不适合作为计费结算依据。隧道详情里那份还额外经过一层缓存，`usage.synced_at` 说明它有多旧。
+- **换套餐不是瞬时的。** 多出来的线路马上可用，少掉的那些有宽限期，到期才真正释放。
+ * OpenAPI spec version: 1.0.0
+ */
+export interface UsageDayResource {
+    billed_bytes: number;
+    /** YYYY-MM-DD */
+    day: string;
+    raw_bytes: number;
+}

package/dist/generated/tunnel/models/usageDayResource.js

@@ -0,0 +1,25 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow 隧道用户 API
+ * Leaflow 隧道的用户接口，用于开通与管理项目的加速隧道、订阅地址和流量用量。
+
+## 身份与鉴权
+
+每个请求需携带 `Authorization: Bearer <项目令牌>`。先在 auth.leaflow.net 登录获取账号令牌，再用它向 IAM 换取项目令牌（`POST /api/v1/projects/{projectId}/token`）。一张项目令牌同时说明当前用户和当前项目。
+
+**路径和请求头上都没有 `project_id`**：当前项目由令牌决定。
+
+鉴权在网关完成，失败的请求不会到达这些接口。按错误码区分处理方式：`TOKEN_MISSING` 表示没带令牌；`TOKEN_EXPIRED` 表示令牌过期，用账号令牌重新换取即可，无需重新登录；`TOKEN_INVALID` 表示令牌验不过；`NOT_A_MEMBER` 表示当前账号不是该项目成员；`USER_SUSPENDED` / `USER_BANNED` 表示账号本身不能操作。
+
+## 通用约定
+
+- **一个项目一条隧道。** 所以路径是单数的 `/tunnel`，不带 id。已经有一条时再开通会被拒绝（`TUNNEL_ALREADY_OPEN`）。
+- **订阅地址是凭据。** 它等同于密码，只由 `GET /tunnel/subscription` 单独返回，不出现在隧道详情或任何列表里。怀疑泄露时用重置接口，它会让已分发的每一份订阅立即失效。
+- **停用不是退订。** 停用保留端口和订阅地址，重新启用后原样回来；退订不可逆，重新开通得到的是全新的地址。
+- **判断超额只看 `billed_bytes`。** 线路可以设置倍率（如 1.5× 或 0×），`raw_bytes` 是实际传输量，两者不一定相等。
+- **用量最多滞后一个采集周期。** 适合用量管控，不适合作为计费结算依据。隧道详情里那份还额外经过一层缓存，`usage.synced_at` 说明它有多旧。
+- **换套餐不是瞬时的。** 多出来的线路马上可用，少掉的那些有宽限期，到期才真正释放。
+ * OpenAPI spec version: 1.0.0
+ */
+export {};

package/dist/generated/tunnel/models/usageResource.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow 隧道用户 API
+ * Leaflow 隧道的用户接口，用于开通与管理项目的加速隧道、订阅地址和流量用量。
+
+## 身份与鉴权
+
+每个请求需携带 `Authorization: Bearer <项目令牌>`。先在 auth.leaflow.net 登录获取账号令牌，再用它向 IAM 换取项目令牌（`POST /api/v1/projects/{projectId}/token`）。一张项目令牌同时说明当前用户和当前项目。
+
+**路径和请求头上都没有 `project_id`**：当前项目由令牌决定。
+
+鉴权在网关完成，失败的请求不会到达这些接口。按错误码区分处理方式：`TOKEN_MISSING` 表示没带令牌；`TOKEN_EXPIRED` 表示令牌过期，用账号令牌重新换取即可，无需重新登录；`TOKEN_INVALID` 表示令牌验不过；`NOT_A_MEMBER` 表示当前账号不是该项目成员；`USER_SUSPENDED` / `USER_BANNED` 表示账号本身不能操作。
+
+## 通用约定
+
+- **一个项目一条隧道。** 所以路径是单数的 `/tunnel`，不带 id。已经有一条时再开通会被拒绝（`TUNNEL_ALREADY_OPEN`）。
+- **订阅地址是凭据。** 它等同于密码，只由 `GET /tunnel/subscription` 单独返回，不出现在隧道详情或任何列表里。怀疑泄露时用重置接口，它会让已分发的每一份订阅立即失效。
+- **停用不是退订。** 停用保留端口和订阅地址，重新启用后原样回来；退订不可逆，重新开通得到的是全新的地址。
+- **判断超额只看 `billed_bytes`。** 线路可以设置倍率（如 1.5× 或 0×），`raw_bytes` 是实际传输量，两者不一定相等。
+- **用量最多滞后一个采集周期。** 适合用量管控，不适合作为计费结算依据。隧道详情里那份还额外经过一层缓存，`usage.synced_at` 说明它有多旧。
+- **换套餐不是瞬时的。** 多出来的线路马上可用，少掉的那些有宽限期，到期才真正释放。
+ * OpenAPI spec version: 1.0.0
+ */
+import type { UsageResourceQuotaExceededAt } from './usageResourceQuotaExceededAt.js';
+export interface UsageResource {
+    /** 按线路倍率折算后的用量，配额比对以此为准 */
+    billed_bytes: number;
+    over_quota: boolean;
+    /** 本期计费周期的结束日（YYYY-MM-DD） */
+    period_end: string;
+    /** 本期计费周期的起始日（YYYY-MM-DD） */
+    period_start: string;
+    /** 上游给出的真实配额，0 表示不限量 */
+    quota_bytes: number;
+    /** 上游判定超额的时刻；null 表示未超额 */
+    quota_exceeded_at: UsageResourceQuotaExceededAt;
+    /** 实际传输的字节，不用于配额比对 */
+    raw_bytes: number;
+    upload_bytes: number;
+    /** 上游给出的用量百分比 */
+    usage_percent: number;
+}

package/dist/generated/tunnel/models/usageResource.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/tunnel/models/usageResourceQuotaExceededAt.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow 隧道用户 API
+ * Leaflow 隧道的用户接口，用于开通与管理项目的加速隧道、订阅地址和流量用量。
+
+## 身份与鉴权
+
+每个请求需携带 `Authorization: Bearer <项目令牌>`。先在 auth.leaflow.net 登录获取账号令牌，再用它向 IAM 换取项目令牌（`POST /api/v1/projects/{projectId}/token`）。一张项目令牌同时说明当前用户和当前项目。
+
+**路径和请求头上都没有 `project_id`**：当前项目由令牌决定。
+
+鉴权在网关完成，失败的请求不会到达这些接口。按错误码区分处理方式：`TOKEN_MISSING` 表示没带令牌；`TOKEN_EXPIRED` 表示令牌过期，用账号令牌重新换取即可，无需重新登录；`TOKEN_INVALID` 表示令牌验不过；`NOT_A_MEMBER` 表示当前账号不是该项目成员；`USER_SUSPENDED` / `USER_BANNED` 表示账号本身不能操作。
+
+## 通用约定
+
+- **一个项目一条隧道。** 所以路径是单数的 `/tunnel`，不带 id。已经有一条时再开通会被拒绝（`TUNNEL_ALREADY_OPEN`）。
+- **订阅地址是凭据。** 它等同于密码，只由 `GET /tunnel/subscription` 单独返回，不出现在隧道详情或任何列表里。怀疑泄露时用重置接口，它会让已分发的每一份订阅立即失效。
+- **停用不是退订。** 停用保留端口和订阅地址，重新启用后原样回来；退订不可逆，重新开通得到的是全新的地址。
+- **判断超额只看 `billed_bytes`。** 线路可以设置倍率（如 1.5× 或 0×），`raw_bytes` 是实际传输量，两者不一定相等。
+- **用量最多滞后一个采集周期。** 适合用量管控，不适合作为计费结算依据。隧道详情里那份还额外经过一层缓存，`usage.synced_at` 说明它有多旧。
+- **换套餐不是瞬时的。** 多出来的线路马上可用，少掉的那些有宽限期，到期才真正释放。
+ * OpenAPI spec version: 1.0.0
+ */
+/**
+ * 上游判定超额的时刻；null 表示未超额
+ */
+export type UsageResourceQuotaExceededAt = string | null;

package/dist/generated/tunnel/models/usageResourceQuotaExceededAt.js

@@ -0,0 +1,25 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow 隧道用户 API
+ * Leaflow 隧道的用户接口，用于开通与管理项目的加速隧道、订阅地址和流量用量。
+
+## 身份与鉴权
+
+每个请求需携带 `Authorization: Bearer <项目令牌>`。先在 auth.leaflow.net 登录获取账号令牌，再用它向 IAM 换取项目令牌（`POST /api/v1/projects/{projectId}/token`）。一张项目令牌同时说明当前用户和当前项目。
+
+**路径和请求头上都没有 `project_id`**：当前项目由令牌决定。
+
+鉴权在网关完成，失败的请求不会到达这些接口。按错误码区分处理方式：`TOKEN_MISSING` 表示没带令牌；`TOKEN_EXPIRED` 表示令牌过期，用账号令牌重新换取即可，无需重新登录；`TOKEN_INVALID` 表示令牌验不过；`NOT_A_MEMBER` 表示当前账号不是该项目成员；`USER_SUSPENDED` / `USER_BANNED` 表示账号本身不能操作。
+
+## 通用约定
+
+- **一个项目一条隧道。** 所以路径是单数的 `/tunnel`，不带 id。已经有一条时再开通会被拒绝（`TUNNEL_ALREADY_OPEN`）。
+- **订阅地址是凭据。** 它等同于密码，只由 `GET /tunnel/subscription` 单独返回，不出现在隧道详情或任何列表里。怀疑泄露时用重置接口，它会让已分发的每一份订阅立即失效。
+- **停用不是退订。** 停用保留端口和订阅地址，重新启用后原样回来；退订不可逆，重新开通得到的是全新的地址。
+- **判断超额只看 `billed_bytes`。** 线路可以设置倍率（如 1.5× 或 0×），`raw_bytes` 是实际传输量，两者不一定相等。
+- **用量最多滞后一个采集周期。** 适合用量管控，不适合作为计费结算依据。隧道详情里那份还额外经过一层缓存，`usage.synced_at` 说明它有多旧。
+- **换套餐不是瞬时的。** 多出来的线路马上可用，少掉的那些有宽限期，到期才真正释放。
+ * OpenAPI spec version: 1.0.0
+ */
+export {};

package/dist/generated/tunnel/models/usageSeriesResource.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow 隧道用户 API
+ * Leaflow 隧道的用户接口，用于开通与管理项目的加速隧道、订阅地址和流量用量。
+
+## 身份与鉴权
+
+每个请求需携带 `Authorization: Bearer <项目令牌>`。先在 auth.leaflow.net 登录获取账号令牌，再用它向 IAM 换取项目令牌（`POST /api/v1/projects/{projectId}/token`）。一张项目令牌同时说明当前用户和当前项目。
+
+**路径和请求头上都没有 `project_id`**：当前项目由令牌决定。
+
+鉴权在网关完成，失败的请求不会到达这些接口。按错误码区分处理方式：`TOKEN_MISSING` 表示没带令牌；`TOKEN_EXPIRED` 表示令牌过期，用账号令牌重新换取即可，无需重新登录；`TOKEN_INVALID` 表示令牌验不过；`NOT_A_MEMBER` 表示当前账号不是该项目成员；`USER_SUSPENDED` / `USER_BANNED` 表示账号本身不能操作。
+
+## 通用约定
+
+- **一个项目一条隧道。** 所以路径是单数的 `/tunnel`，不带 id。已经有一条时再开通会被拒绝（`TUNNEL_ALREADY_OPEN`）。
+- **订阅地址是凭据。** 它等同于密码，只由 `GET /tunnel/subscription` 单独返回，不出现在隧道详情或任何列表里。怀疑泄露时用重置接口，它会让已分发的每一份订阅立即失效。
+- **停用不是退订。** 停用保留端口和订阅地址，重新启用后原样回来；退订不可逆，重新开通得到的是全新的地址。
+- **判断超额只看 `billed_bytes`。** 线路可以设置倍率（如 1.5× 或 0×），`raw_bytes` 是实际传输量，两者不一定相等。
+- **用量最多滞后一个采集周期。** 适合用量管控，不适合作为计费结算依据。隧道详情里那份还额外经过一层缓存，`usage.synced_at` 说明它有多旧。
+- **换套餐不是瞬时的。** 多出来的线路马上可用，少掉的那些有宽限期，到期才真正释放。
+ * OpenAPI spec version: 1.0.0
+ */
+import type { UsageDayResource } from './usageDayResource.js';
+export interface UsageSeriesResource {
+    /** 上游实际采用的天数，可能被它夹到 1–365 */
+    days: number;
+    points: UsageDayResource[];
+}

package/dist/generated/tunnel/models/usageSeriesResource.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -3,12 +3,14 @@ import * as assistantOperations from './generated/assistant/index.js';
 import * as computeOperations from './generated/compute/index.js';
 import * as iamOperations from './generated/iam/index.js';
 import * as monitoringOperations from './generated/monitoring/index.js';
+import * as tunnelOperations from './generated/tunnel/index.js';
 export { createClient } from './http.js';
 export type { Client, ClientOptions, TokenProvider } from './http.js';
 export * as assistant from './generated/assistant/index.js';
 export * as compute from './generated/compute/index.js';
 export * as iam from './generated/iam/index.js';
 export * as monitoring from './generated/monitoring/index.js';
+export * as tunnel from './generated/tunnel/index.js';
 /** Every assistant operation, bound to one address and one token. */
 export type AssistantClient = Bound<typeof assistantOperations>;
 /**
@@ -57,5 +59,17 @@ export type MonitoringClient = Bound<typeof monitoringOperations>;
  * process-wide alternative; see `createClient`.
  */
 export declare function createMonitoringClient(options: ClientOptions): MonitoringClient;
+/** Every tunnel operation, bound to one address and one token. */
+export type TunnelClient = Bound<typeof tunnelOperations>;
+/**
+ * A client for tunnel.
+ *
+ *     const tunnel = createTunnelClient({ baseURL, getToken });
+ *
+ * Hold one per address, and — where the token belongs to the request
+ * rather than to the process — one per request. There is no
+ * process-wide alternative; see `createClient`.
+ */
+export declare function createTunnelClient(options: ClientOptions): TunnelClient;
 /** Service versions the bundled specs were generated from. */
 export declare const SERVICE_VERSIONS: Record<string, string>;

package/dist/index.js

@@ -4,12 +4,14 @@ import * as assistantOperations from './generated/assistant/index.js';
 import * as computeOperations from './generated/compute/index.js';
 import * as iamOperations from './generated/iam/index.js';
 import * as monitoringOperations from './generated/monitoring/index.js';
+import * as tunnelOperations from './generated/tunnel/index.js';
 export { createClient } from './http.js';
 /* The models, and the operations as free functions for anyone binding a client themselves. */
 export * as assistant from './generated/assistant/index.js';
 export * as compute from './generated/compute/index.js';
 export * as iam from './generated/iam/index.js';
 export * as monitoring from './generated/monitoring/index.js';
+export * as tunnel from './generated/tunnel/index.js';
 /**
  * A client for assistant.
  *
@@ -58,10 +60,23 @@ export function createIamClient(options) {
 export function createMonitoringClient(options) {
     return bindClient(monitoringOperations, createClient(options));
 }
+/**
+ * A client for tunnel.
+ *
+ *     const tunnel = createTunnelClient({ baseURL, getToken });
+ *
+ * Hold one per address, and — where the token belongs to the request
+ * rather than to the process — one per request. There is no
+ * process-wide alternative; see `createClient`.
+ */
+export function createTunnelClient(options) {
+    return bindClient(tunnelOperations, createClient(options));
+}
 /** Service versions the bundled specs were generated from. */
 export const SERVICE_VERSIONS = {
-    assistant: "v2.2.0",
-    compute: "v2.7.0",
+    assistant: "v3.0.0",
+    compute: "v2.8.0",
     iam: "v0.32.0",
-    monitoring: "v9.2.0",
+    monitoring: "v9.3.0",
+    tunnel: "v0.0.1",
 };

package/openapi/assistant.version

@@ -1 +1 @@
-v2.2.0
+v3.0.0