@cloudbase/manager-node 5.8.9-beta.0 → 5.9.0

package/types/function/index.d.ts

@@ -1,5 +1,5 @@
 import { Environment } from '../environment';
-import { IResponseInfo, ICloudFunction, ICloudFunctionV2, IFunctionLogOptions, ICloudFunctionTrigger, IFunctionInvokeRes, IFunctionLogRes, IFunctionDownloadUrlRes, IFunctionLogDetailOptions, IFunctionLogDetailRes, IFunctionLogOptionsV2, IFunctionLogResV2 } from '../interfaces';
+import { IResponseInfo, ICloudFunction, ICloudFunctionV2, IFunctionLogOptions, ICloudFunctionTrigger, IFunctionInvokeRes, IFunctionLogRes, IFunctionDownloadUrlRes, IFunctionLogDetailOptions, IFunctionLogDetailRes, IFunctionLogOptionsV2, IFunctionLogResV2, IFunctionImageConfig } from '../interfaces';
 import { IFunctionInfo, IFunctionCode as IScfFunctionCode } from './types';
 export interface IFunctionCode {
     func: ICloudFunction;
@@ -228,6 +228,13 @@ export interface ILayer {
 }
 /** 企业版 TCR 镜像对 SCF 不可见时的排查指引 */
 export declare const ENTERPRISE_IMAGE_REGION_GUIDANCE = "\u8BF7\u786E\u8BA4 TCR \u4F01\u4E1A\u7248\u5B9E\u4F8B\u5DF2\u5728\u5F53\u524D\u51FD\u6570\u5730\u57DF\u63D0\u4F9B\u53EF\u8BBF\u95EE\u7684\u5B9E\u4F8B\u6216\u590D\u5236\u5B9E\u4F8B\uFF0C\u5E76\u68C0\u67E5 RegistryId\u3001\u955C\u50CF\u5730\u5740\u53CA\u62C9\u53D6\u6743\u9650\u3002";
+/**
+ * 为企业版镜像的典型不可见错误补充排查指引，同时保留原始错误和 requestId。
+ * 仅匹配 SCF 已进入 enterprise 镜像查询阶段的错误，避免给普通网络或鉴权错误误导提示。
+ *
+ * 纯函数：只读入参，**不修改**传进来的错误对象；幂等由 WeakMap 缓存保证。
+ */
+export declare function formatImageDeploymentErrorMessage(error: unknown, imageConfig?: IFunctionImageConfig): string;
 export declare class FunctionService {
     private environment;
     private vpcService;
@@ -537,6 +544,12 @@ export declare class FunctionService {
     }>;
     private createAccessPath;
     private getTempCosInfo;
+    /**
+     * 创建触发器（带重试）。
+     *
+     * ⚠️ AIP-194：**只重试可重试错误**。旧实现是 catch-all 盲重试 —— 权限不足 / 参数非法这类
+     * **必然失败**的错误也会被重试 3 次，既浪费时间，又把确定性失败伪装成偶发失败、掩盖真实原因。
+     */
     private retryCreateTrigger;
     /**
      * 获取函数配置信息

package/types/utils/cloudbase-request.d.ts

@@ -12,3 +12,25 @@ export declare function cloudBaseRequest(options: {
     method?: string;
     headers?: Record<string, any>;
 }): Promise<any>;
+/**
+ * 数据面（/admin）错误响应结构。
+ *
+ * 来源：`tcblinker/internal/tcberror` 的 `TcbError.ToJSON()`，形如
+ * `{ code, message, requestId }`。无 docs 字段——文档链接由 CLI 侧
+ * `resolveErrorDoc` 按 code + source 生成（见错误码治理方案 §4.6）。
+ */
+export interface IDataPlaneErrorResponse {
+    /** 数据面稳定错误码，见 tcblinker/internal/tcberror（如 INVALID_PARAM / STORAGE_FILE_NONEXIST） */
+    code?: string;
+    message?: string;
+    requestId?: string;
+}
+/**
+ * 校验数据面（/admin）响应，命中错误时抛出带 code 的 CloudBaseError。
+ *
+ * 必须把 `res.code` 落到 `CloudBaseError.code` 并标记 `source: 'runtime'`：
+ * 否则 CLI 侧 `resolveErrorDoc` 拿不到 code → 文档链接哑火，
+ * `resolveExitCode` 也会兜底成 1，灯塔上报退化为 `ERROR`。
+ * 这是「错误码治理方案」D11 的修复点。
+ */
+export declare function assertDataPlaneOk(res: IDataPlaneErrorResponse | null | undefined, action: string): void;