@leaflow/sdk 0.5.0 → 0.6.0

package/dist/generated/tunnel/models/operationLogResource.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 { OperationLogResourceActor } from './operationLogResourceActor.js';
+import type { OperationLogResourcePayload } from './operationLogResourcePayload.js';
+export interface OperationLogResource {
+    action: string;
+    /** 操作者的用户 id；null 表示由平台执行 */
+    actor: OperationLogResourceActor;
+    created_at: string;
+    failure: string;
+    id: string;
+    payload: OperationLogResourcePayload;
+    subject_id: string;
+    subject_type: string;
+    succeeded: boolean;
+}

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

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

package/dist/generated/tunnel/models/operationLogResourceActor.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
+ */
+/**
+ * 操作者的用户 id；null 表示由平台执行
+ */
+export type OperationLogResourceActor = string | null;

package/dist/generated/tunnel/models/operationLogResourceActor.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/operationLogResourcePayload.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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 OperationLogResourcePayload = {
+    [key: string]: unknown;
+};

package/dist/generated/tunnel/models/operationLogResourcePayload.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/subscriptionResource.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 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 { SubscriptionResourceStatus } from './subscriptionResourceStatus.js';
+export interface SubscriptionResource {
+    /** ready 表示节点已全部下发；preparing 表示仍在下发——此时链接照样可用 */
+    status: SubscriptionResourceStatus;
+    updated_at: string;
+    /** 订阅地址。这是一条长期有效的凭据，等同于密码，请勿转发或截图分享 */
+    url: string;
+    version: number;
+}

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

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

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

@@ -0,0 +1,32 @@
+/**
+ * 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
+ */
+/**
+ * ready 表示节点已全部下发；preparing 表示仍在下发——此时链接照样可用
+ */
+export type SubscriptionResourceStatus = typeof SubscriptionResourceStatus[keyof typeof SubscriptionResourceStatus];
+export declare const SubscriptionResourceStatus: {
+    readonly preparing: "preparing";
+    readonly ready: "ready";
+};

package/dist/generated/tunnel/models/subscriptionResourceStatus.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 SubscriptionResourceStatus = {
+    preparing: 'preparing',
+    ready: 'ready',
+};

package/dist/generated/tunnel/models/tunnelPlanListResponseBody.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
+ */
+import type { TunnelPlanResource } from './tunnelPlanResource.js';
+export interface TunnelPlanListResponseBody {
+    items: TunnelPlanResource[];
+}

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * 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 TunnelPlanResource {
+    description: string;
+    id: string;
+    name: string;
+    /** 套餐标称的流量额度，仅供比较。实际额度以隧道用量接口返回的 quota_bytes 为准 */
+    quota_bytes: number;
+    /** 货架上的排列顺序，越小越靠前 */
+    sort: number;
+}

package/dist/generated/tunnel/models/tunnelPlanResource.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/tunnelResource.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 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 { TunnelResourceEmail } from './tunnelResourceEmail.js';
+import type { TunnelResourceFailure } from './tunnelResourceFailure.js';
+import type { TunnelResourceStatus } from './tunnelResourceStatus.js';
+import type { TunnelResourceSubscriptionStatus } from './tunnelResourceSubscriptionStatus.js';
+import type { TunnelResourceSuspendedAt } from './tunnelResourceSuspendedAt.js';
+import type { TunnelUsageSnapshot } from './tunnelUsageSnapshot.js';
+export interface TunnelResource {
+    created_at: string;
+    display_name: string;
+    /** 转发给上游面板的联系邮箱；平台不使用它 */
+    email: TunnelResourceEmail;
+    /** 用户自己的开关。停用会把实例从调度器撤下，但端口保留，启用后原样回来 */
+    enabled: boolean;
+    /** 最近一次上游拒绝的说明，仅在存在时非空 */
+    failure: TunnelResourceFailure;
+    id: string;
+    plan_id: string;
+    plan_name: string;
+    /** deleting 表示已退订但上游尚未删除完成 */
+    status: TunnelResourceStatus;
+    /** preparing 表示节点仍在下发；订阅链接此时照样可用 */
+    subscription_status: TunnelResourceSubscriptionStatus;
+    /** 每次重置订阅后递增 */
+    subscription_version: number;
+    /** 被平台停用（欠费、违规或项目停服）。为 true 时无法自行启用 */
+    suspended: boolean;
+    /** 被平台停用的时刻 */
+    suspended_at: TunnelResourceSuspendedAt;
+    usage: TunnelUsageSnapshot;
+}

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

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

package/dist/generated/tunnel/models/tunnelResourceEmail.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 TunnelResourceEmail = string | null;

package/dist/generated/tunnel/models/tunnelResourceEmail.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/tunnelResourceFailure.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 TunnelResourceFailure = string | null;

package/dist/generated/tunnel/models/tunnelResourceFailure.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/tunnelResourceStatus.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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
+ */
+/**
+ * deleting 表示已退订但上游尚未删除完成
+ */
+export type TunnelResourceStatus = typeof TunnelResourceStatus[keyof typeof TunnelResourceStatus];
+export declare const TunnelResourceStatus: {
+    readonly active: "active";
+    readonly deleting: "deleting";
+};

package/dist/generated/tunnel/models/tunnelResourceStatus.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 TunnelResourceStatus = {
+    active: 'active',
+    deleting: 'deleting',
+};

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

@@ -0,0 +1,32 @@
+/**
+ * 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
+ */
+/**
+ * preparing 表示节点仍在下发；订阅链接此时照样可用
+ */
+export type TunnelResourceSubscriptionStatus = typeof TunnelResourceSubscriptionStatus[keyof typeof TunnelResourceSubscriptionStatus];
+export declare const TunnelResourceSubscriptionStatus: {
+    readonly preparing: "preparing";
+    readonly ready: "ready";
+};