@leaflow/sdk 0.5.0 → 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/http.d.ts

@@ -96,5 +96,31 @@ export type Bound<T> = {
  * `scripts/check-generated-arity.mjs` fails the build if that changes: a slot
  * that silently shifts by one would pass the client as somebody's request body,
  * and no amount of type checking on generated code would catch it.
+ *
+ * # Why this builds an object instead of returning a Proxy
+ *
+ * It used to be a `Proxy` over the namespace, which is smaller and binds lazily.
+ * It also threw, in production only:
+ *
+ *     'get' on proxy: property 'getAccount' is a read-only and non-configurable
+ *     data property on the proxy target but the proxy did not return its actual
+ *     value
+ *
+ * That is a Proxy invariant, not a bug in the trap. `api` is an ES module
+ * namespace object, and a bundler is free to emit its exports as non-writable and
+ * non-configurable — Next's production build does, its dev server does not. When
+ * a target property is a read-only non-configurable data property, `get` **must**
+ * return that exact value, so a trap whose entire purpose is to return a wrapper
+ * cannot be correct. The old code was not wrong about the bundler; it was wrong
+ * about Proxy.
+ *
+ * It failed the worst possible way: every local check passes, `pnpm dev` passes,
+ * the production bundle throws on the first call. In the console that first call
+ * is `getAccount` during sign-in, so the symptom was "nobody can log in" with an
+ * error naming IAM — a service that was fine.
+ *
+ * Copying costs one pass over a few dozen keys per client. Clients are made per
+ * request here, which sounds like a lot until you notice the request that follows
+ * goes over a network.
  */
 export declare function bindClient<T extends object>(api: T, client: Client): Bound<T>;

package/dist/http.js

@@ -83,23 +83,56 @@ export async function request(config, options) {
  * `scripts/check-generated-arity.mjs` fails the build if that changes: a slot
  * that silently shifts by one would pass the client as somebody's request body,
  * and no amount of type checking on generated code would catch it.
+ *
+ * # Why this builds an object instead of returning a Proxy
+ *
+ * It used to be a `Proxy` over the namespace, which is smaller and binds lazily.
+ * It also threw, in production only:
+ *
+ *     'get' on proxy: property 'getAccount' is a read-only and non-configurable
+ *     data property on the proxy target but the proxy did not return its actual
+ *     value
+ *
+ * That is a Proxy invariant, not a bug in the trap. `api` is an ES module
+ * namespace object, and a bundler is free to emit its exports as non-writable and
+ * non-configurable — Next's production build does, its dev server does not. When
+ * a target property is a read-only non-configurable data property, `get` **must**
+ * return that exact value, so a trap whose entire purpose is to return a wrapper
+ * cannot be correct. The old code was not wrong about the bundler; it was wrong
+ * about Proxy.
+ *
+ * It failed the worst possible way: every local check passes, `pnpm dev` passes,
+ * the production bundle throws on the first call. In the console that first call
+ * is `getAccount` during sign-in, so the symptom was "nobody can log in" with an
+ * error naming IAM — a service that was fine.
+ *
+ * Copying costs one pass over a few dozen keys per client. Clients are made per
+ * request here, which sounds like a lot until you notice the request that follows
+ * goes over a network.
  */
 export function bindClient(api, client) {
-    return new Proxy(api, {
-        get(target, property, receiver) {
-            const value = Reflect.get(target, property, receiver);
-            if (typeof value !== 'function') {
-                return value;
+    const bound = {};
+    /*
+     * `for...in` rather than `Object.keys`: a namespace object's exports are its
+     * own enumerable properties either way, but re-exported members can arrive on
+     * the prototype chain depending on how the bundler emitted them, and an
+     * operation that is silently missing is worse than one that is bound twice.
+     */
+    for (const property in api) {
+        const value = api[property];
+        if (typeof value !== 'function') {
+            bound[property] = value;
+            continue;
+        }
+        const operation = value;
+        bound[property] = (...args) => {
+            const slot = Math.max(operation.length - 1, 0);
+            const head = args.slice(0, slot);
+            while (head.length < slot) {
+                head.push(undefined);
             }
-            const operation = value;
-            return (...args) => {
-                const slot = Math.max(operation.length - 1, 0);
-                const head = args.slice(0, slot);
-                while (head.length < slot) {
-                    head.push(undefined);
-                }
-                return operation(...head, { client });
-            };
-        },
-    });
+            return operation(...head, { client });
+        };
+    }
+    return bound;
 }

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>;