@cloudbase/manager-node 5.7.1-beta.0 → 5.8.0-beta.0

package/types/index.d.ts

@@ -1,5 +1,6 @@
 import { EnvService } from './env';
 import { FunctionService } from './function';
+import { FunctionDeployer } from './deploy/FunctionDeployer';
 import { CloudRunService } from './cloudrun';
 import { AgentService } from './agent';
 import { StorageService } from './storage';
@@ -21,6 +22,8 @@ import { CloudAppService } from './cloudApp';
 import { AiModelService } from './aiModel';
 import { IntegrationService } from './integration';
 import { MonitorService } from './monitor';
+import { ProjectValidator } from './projectValidator';
+import { DeployOrchestrator } from './deploy/DeployOrchestrator';
 interface CloudBaseConfig {
     secretId?: string;
     secretKey?: string;
@@ -47,10 +50,17 @@ declare class CloudBase {
     private cloudBaseConfig;
     private environmentManager;
     private docsService;
+    private projectValidatorService;
+    private deployOrchestratorService;
     constructor(config?: CloudBaseConfig);
     addEnvironment(envId: string): void;
     currentEnvironment(): Environment;
     get functions(): FunctionService;
+    /**
+     * 函数部署编排器（FunctionDeployer）
+     * 在现有 FunctionService 之上，按 buildStrategy 编排 Event/HTTP 函数的创建、更新与访问收敛
+     */
+    get functionDeployer(): FunctionDeployer;
     get cloudrun(): CloudRunService;
     get agent(): AgentService;
     get storage(): StorageService;
@@ -101,6 +111,14 @@ declare class CloudBase {
      */
     get monitor(): MonitorService;
     get docs(): DocsService;
+    get projectValidator(): ProjectValidator;
+    getProjectValidator(): ProjectValidator;
+    /**
+     * 声明式部署编排器
+     * 顺序：database → functions → app → hosting → gateway；支持 dry-run / only / skip / 幂等重试
+     */
+    get deployOrchestrator(): DeployOrchestrator;
+    getDeployOrchestrator(): DeployOrchestrator;
     getEnvironmentManager(): EnvironmentManager;
     getManagerConfig(): CloudBaseConfig;
     get isInternalEndpoint(): Boolean;

package/types/interfaces/function.interface.d.ts

@@ -44,7 +44,7 @@ export interface ICloudFunction extends ICloudFunctionConfig {
     name: string;
     description?: string;
     type?: 'Event' | 'HTTP';
-    protocolType?: 'WS';
+    protocolType?: 'HTTP' | 'WS';
     protocolParams?: {
         wsParams?: {
             idleTimeOut?: number;

package/types/projectValidator/index.d.ts

@@ -0,0 +1,38 @@
+import { ProjectValidationResult, ProjectValidatorValidateOptions } from './types';
+export declare class ProjectValidator {
+    validate(options?: ProjectValidatorValidateOptions): Promise<ProjectValidationResult>;
+    private loadProjectConfig;
+    private validateSchema;
+    private validateEnvId;
+    /**
+     * 个人版 TCR 的 username/password/namespace 必须在 cloudbaserc 中显式声明。
+     * ConfigParser 已先解析 {{env.*}}，因此这里同时承担缺失 env 值的前置校验。
+     */
+    private validatePersonalRegistryConfig;
+    private hasPersonalCloudFunction;
+    private isPersonalCloudFunction;
+    private validateResources;
+    private validateConsistency;
+    /**
+     * 检测 hosting 路由中 enablePathTransmission=true 与自动生成 pathRewrite 的冲突
+     *
+     * hosting 目标未显式配置 pathRewrite 时，部署会自动生成 PathRewrite.Prefix = hosting.deployPath。
+     * 若同时显式开启 enablePathTransmission=true，路径透传会覆盖路径重写，导致请求打到错误的托管路径（404）。
+     */
+    private validateGatewayPathRewriteConflicts;
+    /**
+     * 子路径部署（deployPath !== '/'）下，前端构建产物若仍使用根路径 base（如 Vite 默认 '/'），
+     * 会导致资源请求落到 /assets/* 而非 /{deployPath}/assets/*，出现 404/白屏。
+     *
+     * 这里在“可能存在构建步骤”的 hosting 配置上给出防坑告警。
+     */
+    private validateHostingSubPathBaseRisks;
+    private validateUniqueNames;
+    private validateUniqueField;
+    private validateGatewayTargets;
+    private getSummary;
+    private getLinkedEnvId;
+    private normalizeSchemaPath;
+    private getErrorMessage;
+}
+export * from './types';

package/types/projectValidator/types.d.ts

@@ -0,0 +1,26 @@
+export type ProjectValidationIssueLevel = 'error' | 'warning';
+export interface ProjectValidationIssue {
+    level: ProjectValidationIssueLevel;
+    resource?: string;
+    field?: string;
+    message: string;
+    fix?: string;
+}
+export interface ProjectValidationSummary {
+    functions: number;
+    hosting: number;
+    databases: number;
+    gateways: number;
+}
+export interface ProjectValidationResult {
+    valid: boolean;
+    version: string;
+    errors: ProjectValidationIssue[];
+    warnings: ProjectValidationIssue[];
+    summary: ProjectValidationSummary;
+}
+export interface ProjectValidatorValidateOptions {
+    cwd?: string;
+    configPath?: string;
+    mode?: string;
+}

package/types/storage/index.d.ts

@@ -49,6 +49,12 @@ export interface IRoutingRules {
 export interface IBucketWebsiteOptions {
     indexDocument: string;
     errorDocument?: string;
+    /** 错误文档是否保留原始 HTTP 状态码：Enabled / Disabled（SPA 回退需 Disabled，否则 404 状态码使前端路由失效） */
+    originalHttpStatus?: string;
+    /** 404 是否展示腾讯云公益页面：Enabled / Disabled（SPA 回退需 Disabled，否则覆盖错误文档） */
+    charity404?: string;
+    /** 忽略 HTML 扩展名：Enabled / Disabled（未传则保持默认 Disabled） */
+    autoAddressing?: string;
     routingRules?: Array<IRoutingRules>;
     region: string;
     bucket: string;

package/types/utils/index.d.ts

@@ -6,11 +6,24 @@ export * from './envLazy';
 export * from './fs';
 export * from './http-request';
 export { guid6 } from './uuid';
+interface IZipExtraEntry {
+    /** zip 包内的相对路径 */
+    zipPath: string;
+    /** 文件文本内容 */
+    content: string | Buffer;
+    /** unix 权限位（八进制），如 0o755 */
+    mode?: number;
+}
 interface IZipOption {
     dirPath: string;
     outputPath: string;
     ignore?: string | string[];
     pattern?: string;
+    /**
+     * 额外注入 zip 的文件条目（不来自 dirPath），用于把 SDK 生成的辅助文件
+     * （如构建推送脚本）打进包内，而不污染用户源码目录。
+     */
+    extraEntries?: IZipExtraEntry[];
 }
 export declare function compressToZip(option: IZipOption): Promise<unknown>;
 /**