@geek-fun/serverlessinsight 0.6.15 → 0.7.0

package/dist/src/common/volcengineClient/vefaasOperations.js

@@ -0,0 +1,386 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createVefaasOperations = void 0;
+const openapi_1 = require("@volcengine/openapi");
+const logger_1 = require("../../common/logger");
+const lang_1 = require("../../lang");
+const fs = __importStar(require("node:fs"));
+const MAX_ZIP_SIZE_MB = 50;
+const MAX_ZIP_SIZE_BYTES = MAX_ZIP_SIZE_MB * 1024 * 1024;
+const MAX_TOS_SIZE_MB = 500;
+const MAX_TOS_SIZE_BYTES = MAX_TOS_SIZE_MB * 1024 * 1024;
+const buildEnvVariables = (envs) => {
+    if (!envs)
+        return undefined;
+    return Object.entries(envs).map(([key, value]) => ({ key, value }));
+};
+const parseEnvVariables = (envs) => {
+    if (!envs || envs.length === 0)
+        return undefined;
+    return envs.reduce((acc, { key, value }) => {
+        acc[key] = value;
+        return acc;
+    }, {});
+};
+const validateCodePackage = async (codePath) => {
+    const stats = await fs.promises.stat(codePath);
+    const sizeMB = (stats.size / 1024 / 1024).toFixed(2);
+    if (stats.size > MAX_TOS_SIZE_BYTES) {
+        throw new Error(lang_1.lang.__('CODE_PACKAGE_TOO_LARGE', {
+            size: sizeMB,
+            maxZip: MAX_ZIP_SIZE_MB.toString(),
+            maxTos: MAX_TOS_SIZE_MB.toString(),
+        }));
+    }
+    if (stats.size > MAX_ZIP_SIZE_BYTES) {
+        logger_1.logger.info(lang_1.lang.__('CODE_PACKAGE_EXCEEDS_ZIP_LIMIT', {
+            size: sizeMB,
+            limit: MAX_ZIP_SIZE_MB.toString(),
+            strategy: 'TOS',
+        }));
+    }
+    try {
+        const zipContent = await fs.promises.readFile(codePath);
+        await Promise.resolve().then(() => __importStar(require('jszip'))).then(async (JSZip) => {
+            const zip = await JSZip.loadAsync(zipContent);
+            const fileCount = Object.keys(zip.files).length;
+            if (fileCount === 0) {
+                throw new Error(lang_1.lang.__('CODE_PACKAGE_EMPTY'));
+            }
+            const hasHandler = Object.keys(zip.files).some((f) => f.endsWith('.js') || f.endsWith('.py') || f.endsWith('.go') || f.endsWith('handler'));
+            if (!hasHandler) {
+                logger_1.logger.warn(lang_1.lang.__('CODE_PACKAGE_MAY_MISS_HANDLER'));
+            }
+        });
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('Empty')) {
+            throw error;
+        }
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        // eslint-disable-next-line preserve-caught-error
+        throw new Error(`${lang_1.lang.__('CODE_PACKAGE_INVALID_ZIP', { error: errorMessage })} (Original: ${errorMessage})`);
+    }
+    return { size: stats.size, sizeMB };
+};
+const uploadCodeToTos = async (tosClient, bucketName, codePath, functionName) => {
+    const codeContent = await fs.promises.readFile(codePath);
+    const timestamp = Date.now();
+    const key = `function-codes/${functionName}/${timestamp}/code.zip`;
+    logger_1.logger.info(lang_1.lang.__('UPLOADING_CODE_TO_TOS', { bucket: bucketName, key }));
+    await tosClient.fetchOpenAPI({
+        Action: 'PutObject',
+        Version: '2018-08-01',
+        method: 'PUT',
+        headers: {
+            'content-type': 'application/zip',
+            'content-length': codeContent.length.toString(),
+        },
+        data: codeContent,
+        query: {
+            bucket: bucketName,
+            key: key,
+        },
+    });
+    logger_1.logger.info(lang_1.lang.__('CODE_UPLOADED_TO_TOS', {
+        bucket: bucketName,
+        key,
+        size: (codeContent.length / 1024 / 1024).toFixed(2),
+    }));
+    return { bucket: bucketName, key };
+};
+const createVefaasOperations = (client) => {
+    const tosClient = new openapi_1.Service({
+        serviceName: 'tos',
+        defaultVersion: '2018-08-01',
+        protocol: 'https',
+        host: 'tos-cn-beijing.volces.com',
+        accessKeyId: client.accessKeyId,
+        secretKey: client.secretKey,
+        region: client.region,
+    });
+    return {
+        createFunction: async (config, codePath) => {
+            const { size, sizeMB } = await validateCodePackage(codePath);
+            let codeSource;
+            if (size <= MAX_ZIP_SIZE_BYTES) {
+                const codeContent = await fs.promises.readFile(codePath);
+                const codeBase64 = codeContent.toString('base64');
+                logger_1.logger.info(lang_1.lang.__('DEPLOYING_FUNCTION_WITH_ZIP', {
+                    functionName: config.functionName,
+                    size: sizeMB,
+                }));
+                codeSource = {
+                    SourceType: 'zip',
+                    Source: codeBase64,
+                };
+            }
+            else {
+                const tosBucket = `vefaas-codes-${client.region || 'cn-beijing'}`;
+                const { bucket, key } = await uploadCodeToTos(tosClient, tosBucket, codePath, config.functionName);
+                logger_1.logger.info(lang_1.lang.__('DEPLOYING_FUNCTION_WITH_TOS', {
+                    functionName: config.functionName,
+                    size: sizeMB,
+                    bucket,
+                    key,
+                }));
+                codeSource = {
+                    SourceType: 'tos',
+                    TosBucket: bucket,
+                    TosKey: key,
+                };
+            }
+            const params = {
+                FunctionName: config.functionName,
+                Runtime: config.runtime,
+                Handler: config.handler,
+                MemoryMb: config.memoryMb,
+                RequestTimeout: config.requestTimeout,
+                ...(config.description && { Description: config.description }),
+                ...(config.environmentVariables && {
+                    Envs: buildEnvVariables(config.environmentVariables),
+                }),
+                ...(config.role && { Role: config.role }),
+                ...codeSource,
+                ...(config.vpcConfig && {
+                    VpcConfig: {
+                        EnableVpc: true,
+                        VpcId: config.vpcConfig.vpcId,
+                        SubnetIds: config.vpcConfig.subnetIds,
+                        SecurityGroupIds: config.vpcConfig.securityGroupIds,
+                    },
+                }),
+                ...(config.tosMountConfig && {
+                    TosMountConfig: {
+                        EnableTos: true,
+                        MountPoints: [
+                            {
+                                BucketName: config.tosMountConfig.bucketName,
+                                LocalMountPath: config.tosMountConfig.mountPath,
+                            },
+                        ],
+                    },
+                }),
+                ...(config.logConfig && {
+                    LogConfig: {
+                        EnableLog: true,
+                        ProjectName: config.logConfig.project,
+                        TopicName: config.logConfig.topic,
+                    },
+                }),
+            };
+            await client.fetchOpenAPI({
+                Action: 'CreateFunction',
+                Version: '2024-06-06',
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                data: params,
+            });
+            logger_1.logger.info(lang_1.lang.__('FUNCTION_CREATED', { functionName: config.functionName }));
+        },
+        getFunction: async (functionName) => {
+            try {
+                const response = await client.fetchOpenAPI({
+                    Action: 'GetFunction',
+                    Version: '2024-06-06',
+                    method: 'POST',
+                    headers: { 'content-type': 'application/json' },
+                    data: { FunctionName: functionName },
+                });
+                const data = (response.Result || {});
+                return {
+                    functionId: data.FunctionId,
+                    functionName: data.FunctionName,
+                    runtime: data.Runtime,
+                    handler: data.Handler,
+                    memoryMb: data.MemoryMb,
+                    requestTimeout: data.RequestTimeout,
+                    description: data.Description,
+                    environmentVariables: parseEnvVariables(data.Envs),
+                    status: data.Status,
+                    createdTime: data.CreationTime,
+                    lastModifiedTime: data.LastUpdateTime,
+                    role: data.Role,
+                    vpcConfig: data.VpcConfig
+                        ? {
+                            vpcId: data.VpcConfig.VpcId,
+                            subnetIds: data.VpcConfig.SubnetIds,
+                            securityGroupIds: data.VpcConfig.SecurityGroupIds,
+                        }
+                        : undefined,
+                    logConfig: data.LogConfig
+                        ? {
+                            project: data.LogConfig.ProjectName,
+                            topic: data.LogConfig.TopicName,
+                        }
+                        : undefined,
+                };
+            }
+            catch (error) {
+                if (error && typeof error === 'object' && 'code' in error) {
+                    if (error.code === 'ResourceNotFound' || error.code === 'FunctionNotFound') {
+                        return null;
+                    }
+                }
+                throw error;
+            }
+        },
+        updateFunctionConfiguration: async (config) => {
+            const params = {
+                FunctionName: config.functionName,
+                Handler: config.handler,
+                Runtime: config.runtime,
+                MemoryMb: config.memoryMb,
+                RequestTimeout: config.requestTimeout,
+                ...(config.description !== undefined && { Description: config.description }),
+                ...(config.environmentVariables && {
+                    Envs: buildEnvVariables(config.environmentVariables),
+                }),
+                ...(config.role && { Role: config.role }),
+                ...(config.vpcConfig && {
+                    VpcConfig: {
+                        EnableVpc: true,
+                        VpcId: config.vpcConfig.vpcId,
+                        SubnetIds: config.vpcConfig.subnetIds,
+                        SecurityGroupIds: config.vpcConfig.securityGroupIds,
+                    },
+                }),
+                ...(config.tosMountConfig && {
+                    TosMountConfig: {
+                        EnableTos: true,
+                        MountPoints: [
+                            {
+                                BucketName: config.tosMountConfig.bucketName,
+                                LocalMountPath: config.tosMountConfig.mountPath,
+                            },
+                        ],
+                    },
+                }),
+                ...(config.logConfig && {
+                    LogConfig: {
+                        EnableLog: true,
+                        ProjectName: config.logConfig.project,
+                        TopicName: config.logConfig.topic,
+                    },
+                }),
+            };
+            await client.fetchOpenAPI({
+                Action: 'UpdateFunction',
+                Version: '2024-06-06',
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                data: params,
+            });
+            logger_1.logger.info(lang_1.lang.__('FUNCTION_CONFIGURATION_UPDATED', { functionName: config.functionName }));
+        },
+        updateFunctionCode: async (functionName, codePath) => {
+            const { size, sizeMB } = await validateCodePackage(codePath);
+            let codeSource;
+            if (size <= MAX_ZIP_SIZE_BYTES) {
+                const codeContent = await fs.promises.readFile(codePath);
+                const codeBase64 = codeContent.toString('base64');
+                logger_1.logger.info(lang_1.lang.__('UPDATING_FUNCTION_CODE_WITH_ZIP', {
+                    functionName,
+                    size: sizeMB,
+                }));
+                codeSource = {
+                    SourceType: 'zip',
+                    Source: codeBase64,
+                };
+            }
+            else {
+                const tosBucket = `vefaas-codes-${client.region || 'cn-beijing'}`;
+                const { bucket, key } = await uploadCodeToTos(tosClient, tosBucket, codePath, functionName);
+                logger_1.logger.info(lang_1.lang.__('UPDATING_FUNCTION_CODE_WITH_TOS', {
+                    functionName,
+                    size: sizeMB,
+                    bucket,
+                    key,
+                }));
+                codeSource = {
+                    SourceType: 'tos',
+                    TosBucket: bucket,
+                    TosKey: key,
+                };
+            }
+            await client.fetchOpenAPI({
+                Action: 'UpdateFunction',
+                Version: '2024-06-06',
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                data: {
+                    FunctionName: functionName,
+                    ...codeSource,
+                },
+            });
+            logger_1.logger.info(lang_1.lang.__('FUNCTION_CODE_UPDATED', { functionName }));
+        },
+        deleteFunction: async (functionName) => {
+            await client.fetchOpenAPI({
+                Action: 'DeleteFunction',
+                Version: '2024-06-06',
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                data: { FunctionName: functionName },
+            });
+            logger_1.logger.info(lang_1.lang.__('FUNCTION_DELETED', { functionName }));
+        },
+        listFunctions: async () => {
+            const response = await client.fetchOpenAPI({
+                Action: 'ListFunctions',
+                Version: '2024-06-06',
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                data: {},
+            });
+            const result = (response.Result || {});
+            const functions = (result.Functions || []);
+            return functions.map((fn) => ({
+                functionId: fn.FunctionId,
+                functionName: fn.FunctionName,
+                runtime: fn.Runtime,
+                handler: fn.Handler,
+                memoryMb: fn.MemoryMb,
+                requestTimeout: fn.RequestTimeout,
+                description: fn.Description,
+                status: fn.Status,
+                createdTime: fn.CreationTime,
+                lastModifiedTime: fn.LastUpdateTime,
+            }));
+        },
+    };
+};
+exports.createVefaasOperations = createVefaasOperations;

package/dist/src/lang/en.js

@@ -522,4 +522,124 @@ exports.en = {
     RETRY_ATTEMPT_FAILED: '{{operation}} attempt {{attempt}}/{{max}} failed: {{error}}. Retrying...',
     RETRY_ALL_ATTEMPTS_FAILED: '{{operation}} failed after {{max}} attempts: {{error}}',
     RETRY_UNEXPECTED_FAILURE: '{{operation}} failed unexpectedly',
+    // Rate Limit messages
+    RATE_LIMIT_CREATING: 'Creating traffic control policy: {{policyName}}',
+    RATE_LIMIT_CREATED: 'Traffic control policy created: {{policyName}} (ID: {{policyId}})',
+    RATE_LIMIT_UPDATING: 'Updating traffic control policy: {{policyName}}',
+    RATE_LIMIT_UPDATED: 'Traffic control policy updated: {{policyName}}',
+    RATE_LIMIT_DELETING: 'Deleting traffic control policy: {{policyId}}',
+    RATE_LIMIT_DELETED: 'Traffic control policy deleted: {{policyId}}',
+    RATE_LIMIT_BINDING: 'Binding traffic control {{policyId}} to APIs in group {{groupId}}',
+    RATE_LIMIT_BOUND: 'Traffic control {{policyId}} bound to {{apiCount}} API(s)',
+    RATE_LIMIT_UNBINDING: 'Unbinding traffic control from APIs in group {{groupId}}',
+    RATE_LIMIT_UNBOUND: 'Traffic control unbound from APIs in group {{groupId}}',
+    RATE_LIMIT_NOT_FOUND: 'Traffic control policy not found: {{policyId}}',
+    RATE_LIMIT_CREATE_FAILED: 'Failed to create traffic control policy: {{error}}',
+    RATE_LIMIT_UPDATE_FAILED: 'Failed to update traffic control policy: {{error}}',
+    RATE_LIMIT_DELETE_FAILED: 'Failed to delete traffic control policy: {{error}}',
+    RATE_LIMIT_BIND_FAILED: 'Failed to bind traffic control to APIs: {{error}}',
+    RATE_LIMIT_UNBIND_FAILED: 'Failed to unbind traffic control from APIs: {{error}}',
+    RATE_LIMIT_CONFIG_INVALID: 'Invalid rate_limit configuration: must specify either qps or scopes',
+    RATE_LIMIT_SCOPE_INVALID: 'Rate limit scope "{{scope}}" is not supported by provider "{{provider}}"',
+    RATE_LIMIT_LIMITBY_REQUIRES_NAME: 'Rate limit limit_by type "{{type}}" requires a "name" parameter',
+    RATE_LIMIT_SKIPPED_WARNING: 'Rate limit creation failed but API deployment succeeded. You can retry by running deploy again.',
+    // Volcengine provider messages
+    PROVIDER_VOLCENGINE: 'Volcengine',
+    VOLCENGINE_DEPLOYING_STACK: 'Deploying stack to Volcengine...',
+    VOLCENGINE_CREATING_FUNCTION: 'Creating Volcengine function {{functionName}}',
+    VOLCENGINE_UPDATING_FUNCTION: 'Updating Volcengine function {{functionName}}',
+    VOLCENGINE_DELETING_FUNCTION: 'Deleting Volcengine function {{functionName}}',
+    VOLCENGINE_FUNCTION_NOT_FOUND: 'Volcengine function {{functionName}} not found',
+    VOLCENGINE_FUNCTION_READY: 'Volcengine function {{functionName}} is ready',
+    VOLCENGINE_CREATING_BUCKET: 'Creating Volcengine TOS bucket {{bucketName}}',
+    VOLCENGINE_DELETING_BUCKET: 'Deleting Volcengine TOS bucket {{bucketName}}',
+    VOLCENGINE_BUCKET_NOT_FOUND: 'Volcengine TOS bucket {{bucketName}} not found',
+    VOLCENGINE_CREATING_ROLE: 'Creating Volcengine IAM role {{roleName}}',
+    VOLCENGINE_DELETING_ROLE: 'Deleting Volcengine IAM role {{roleName}}',
+    VOLCENGINE_ROLE_NOT_FOUND: 'Volcengine IAM role {{roleName}} not found',
+    VOLCENGINE_CREATING_APIGW: 'Creating Volcengine API Gateway {{gatewayName}}',
+    VOLCENGINE_DELETING_APIGW: 'Deleting Volcengine API Gateway {{gatewayName}}',
+    VOLCENGINE_APIGW_NOT_FOUND: 'Volcengine API Gateway {{gatewayName}} not found',
+    // Additional Volcengine-specific messages
+    RESOURCE_STATE_NOT_FOUND: 'Resource state not found for logical ID: {{logicalId}}',
+    RESOURCE_INSTANCE_NOT_FOUND: 'Resource instance not found for logical ID: {{logicalId}}',
+    UPDATING_RESOURCE_WITH_NO_CHANGES: 'No changes detected for {{resourceType}}: {{name}}',
+    // Code deployment messages
+    CODE_PACKAGE_TOO_LARGE: 'Code package size ({{size}} MB) exceeds maximum limit. Max ZIP: {{maxZip}} MB, Max TOS: {{maxTos}} MB',
+    CODE_PACKAGE_EXCEEDS_ZIP_LIMIT: 'Code package ({{size}} MB) exceeds ZIP limit ({{limit}} MB), using TOS upload strategy',
+    CODE_PACKAGE_EMPTY: 'Code package is empty',
+    CODE_PACKAGE_MAY_MISS_HANDLER: 'Code package may not contain a handler file',
+    CODE_PACKAGE_INVALID_ZIP: 'Invalid ZIP package: {{error}}',
+    DEPLOYING_FUNCTION_WITH_ZIP: 'Deploying function {{functionName}} with ZIP package ({{size}} MB)',
+    DEPLOYING_FUNCTION_WITH_TOS: 'Deploying function {{functionName}} with TOS ({{size}} MB) to {{bucket}}/{{key}}',
+    UPLOADING_CODE_TO_TOS: 'Uploading code to TOS: {{bucket}}/{{key}}',
+    CODE_UPLOADED_TO_TOS: 'Code uploaded to TOS: {{bucket}}/{{key}} ({{size}} MB)',
+    FUNCTION_CREATED: 'Function {{functionName}} created successfully',
+    FUNCTION_CONFIGURATION_UPDATED: 'Function {{functionName}} configuration updated',
+    UPDATING_FUNCTION_CODE_WITH_ZIP: 'Updating function {{functionName}} code with ZIP package ({{size}} MB)',
+    UPDATING_FUNCTION_CODE_WITH_TOS: 'Updating function {{functionName}} code with TOS ({{size}} MB) to {{bucket}}/{{key}}',
+    FUNCTION_CODE_UPDATED: 'Function {{functionName}} code updated',
+    FUNCTION_DELETED: 'Function {{functionName}} deleted',
+    // TOS Object Storage messages
+    TOS_BUCKET_CREATED: 'TOS bucket {{bucketName}} created successfully',
+    TOS_BUCKET_DELETED: 'TOS bucket {{bucketName}} deleted successfully',
+    TOS_BUCKET_ACL_UPDATED: 'TOS bucket {{bucketName}} ACL updated to {{acl}}',
+    TOS_BUCKET_WEBSITE_CONFIGURED: 'TOS bucket {{bucketName}} website configured',
+    TOS_BUCKET_WEBSITE_UPDATED: 'TOS bucket {{bucketName}} website configuration updated',
+    TOS_BUCKET_NOT_FOUND: 'TOS bucket {{bucketName}} not found',
+    TOS_BUCKET_TRACKED_CAN_RETRY: 'Bucket is tracked in state, you can retry deployment to upload files',
+    TOS_BUCKET_FILE_UPLOAD_FAILED_STATE_SAVED: 'Failed to upload files to bucket, but bucket was created and saved to state: {{error}}',
+    TOS_OBJECT_UPLOADED: 'Uploaded object {{key}} to bucket {{bucket}}',
+    TOS_FILES_UPLOADED: 'Uploaded files from {{path}} to bucket {{bucket}}',
+    VOLCENGINE_TOS_CLIENT_NOT_INITIALIZED: 'TOS client not initialized. Check your credentials.',
+    VOLCENGINE_BUCKET_DELETE_FAILED: 'Failed to delete bucket {{bucketName}}: {{error}}',
+    VOLCENGINE_FUNCTION_DELETE_FAILED: 'Failed to delete function {{functionName}}: {{error}}',
+    VOLCENGINE_APIGW_CLIENT_NOT_INITIALIZED: 'API Gateway client not initialized. Check your credentials.',
+    VOLCENGINE_APIGW_DELETE_FAILED: 'Failed to delete API Gateway {{logicalId}}: {{error}}',
+    // Volcengine IAM messages
+    IAM_ROLE_CREATED: 'IAM role {{roleName}} created successfully',
+    IAM_ROLE_DELETED: 'IAM role {{roleName}} deleted successfully',
+    IAM_ROLE_ALREADY_EXISTS: 'IAM role "{{roleName}}" already exists in cloud (state drift detected). ' +
+        'Updating trust policy and reusing existing role.',
+    IAM_ROLE_NOT_FOUND_IN_CLOUD: 'IAM role "{{roleName}}" does not exist in the cloud provider. ' +
+        'The role may have been deleted manually. ' +
+        'To fix: remove the role from state and redeploy.',
+    IAM_ROLE_DRIFT_RECOVERY_FAILED: 'Failed to recover from IAM role state drift for "{{roleName}}": {{error}}. ' +
+        'The role existed in the cloud but recovery operations failed. ' +
+        'To fix: manually verify the role in the cloud console, remove it from state, and redeploy.',
+    IAM_ROLE_TRUST_POLICY_UPDATED: 'IAM role {{roleName}} trust policy updated',
+    IAM_POLICY_ALREADY_EXISTS: 'IAM policy {{policyName}} already exists, reusing',
+    IAM_POLICY_ALREADY_ATTACHED: 'IAM policy {{policyName}} already attached to role {{roleName}}',
+    IAM_POLICY_ATTACHED: 'IAM policy {{policyName}} attached to role {{roleName}}',
+    IAM_POLICY_DETACHED: 'IAM policy {{policyName}} detached from role {{roleName}}',
+    IAM_ROLE_INSTANCE_NOT_FOUND: 'IAM role instance not found in state for {{roleName}}',
+    IAM_ROLE_TRN_MISSING: 'IAM role TRN is missing and accountId is not available to construct it for {{roleName}}. ' +
+        'Ensure the IAM role was created successfully and accountId is configured.',
+    CREATING_IAM_ROLE: 'Creating IAM role: {{roleName}}',
+    DELETING_IAM_ROLE: 'Deleting IAM role: {{id}}',
+    IAM_POLICY_DETACH_FAILED: 'Failed to detach IAM policy {{policyName}} from role {{roleName}}: {{error}}',
+    // Volcengine TLS (Log Service) messages
+    TLS_PROJECT_CREATED: 'TLS project {{projectName}} created successfully',
+    TLS_PROJECT_DELETED: 'TLS project {{projectName}} deleted successfully',
+    TLS_PROJECT_NOT_FOUND: 'TLS project {{projectName}} not found',
+    TLS_PROJECT_TIMEOUT: 'Timeout waiting for TLS project {{projectName}} to be ready',
+    TLS_TOPIC_CREATED: 'TLS topic {{topicName}} created successfully',
+    TLS_TOPIC_DELETED: 'TLS topic {{topicName}} deleted successfully',
+    TLS_TOPIC_NOT_FOUND: 'TLS topic {{topicName}} not found',
+    TLS_TOPIC_TIMEOUT: 'Timeout waiting for TLS topic {{topicName}} to be ready',
+    TLS_INDEX_CREATED: 'TLS index for topic {{topicName}} created successfully',
+    TLS_INDEX_DELETED: 'TLS index for topic {{topicName}} deleted successfully',
+    TLS_PROJECT_FAILED: 'TLS project {{projectName}} failed to create',
+    TLS_TOPIC_FAILED: 'TLS topic {{topicName}} failed to create',
+    CREATING_TLS_PROJECT: 'Creating TLS project: {{projectName}}',
+    CREATING_TLS_TOPIC: 'Creating TLS topic: {{topicName}}',
+    CREATING_TLS_INDEX: 'Creating TLS index for topic: {{topicName}}',
+    DELETING_TLS_PROJECT: 'Deleting TLS project: {{id}}',
+    DELETING_TLS_TOPIC: 'Deleting TLS topic: {{id}}',
+    DELETING_TLS_INDEX: 'Deleting TLS index: {{id}}',
+    WAITING_FOR_TLS_RESOURCES: 'Waiting for TLS resources to be ready: {{projectName}}/{{topicName}}',
+    // Volcengine veFaaS dependent resources
+    VEFAAS_DEPENDENT_RESOURCES_TRACKED: 'Dependent resources (TLS, IAM) are tracked in state',
+    VEFAAS_CAN_RETRY_DEPLOYMENT: 'You can retry deployment - the system will reuse existing dependent resources',
+    VEFAAS_FUNCTION_EXISTS_RECOVERY: 'Function {{functionName}} already exists in provider (tainted recovery), skipping create and refreshing state',
 };

package/dist/src/lang/zh-CN.js

@@ -517,4 +517,123 @@ exports.zhCN = {
     RETRY_ATTEMPT_FAILED: '{{operation}} 第 {{attempt}}/{{max}} 次尝试失败：{{error}}。正在重试...',
     RETRY_ALL_ATTEMPTS_FAILED: '{{operation}} 在 {{max}} 次尝试后失败：{{error}}',
     RETRY_UNEXPECTED_FAILURE: '{{operation}} 意外失败',
+    // 流量限制消息
+    RATE_LIMIT_CREATING: '正在创建流量控制策略：{{policyName}}',
+    RATE_LIMIT_CREATED: '流量控制策略已创建：{{policyName}}（ID: {{policyId}}）',
+    RATE_LIMIT_UPDATING: '正在更新流量控制策略：{{policyName}}',
+    RATE_LIMIT_UPDATED: '流量控制策略已更新：{{policyName}}',
+    RATE_LIMIT_DELETING: '正在删除流量控制策略：{{policyId}}',
+    RATE_LIMIT_DELETED: '流量控制策略已删除：{{policyId}}',
+    RATE_LIMIT_BINDING: '正在将流量控制 {{policyId}} 绑定到分组 {{groupId}} 的 API',
+    RATE_LIMIT_BOUND: '流量控制 {{policyId}} 已绑定到 {{apiCount}} 个 API',
+    RATE_LIMIT_UNBINDING: '正在解除分组 {{groupId}} 中 API 的流量控制绑定',
+    RATE_LIMIT_UNBOUND: '已解除分组 {{groupId}} 中 API 的流量控制绑定',
+    RATE_LIMIT_NOT_FOUND: '未找到流量控制策略：{{policyId}}',
+    RATE_LIMIT_CREATE_FAILED: '创建流量控制策略失败：{{error}}',
+    RATE_LIMIT_UPDATE_FAILED: '更新流量控制策略失败：{{error}}',
+    RATE_LIMIT_DELETE_FAILED: '删除流量控制策略失败：{{error}}',
+    RATE_LIMIT_BIND_FAILED: '绑定流量控制到 API 失败：{{error}}',
+    RATE_LIMIT_UNBIND_FAILED: '解除流量控制绑定失败：{{error}}',
+    RATE_LIMIT_CONFIG_INVALID: '无效的 rate_limit 配置：必须指定 qps 或 scopes',
+    RATE_LIMIT_SCOPE_INVALID: '流量限制范围 "{{scope}}" 不被提供商 "{{provider}}" 支持',
+    RATE_LIMIT_LIMITBY_REQUIRES_NAME: '流量限制 limit_by 类型 "{{type}}" 需要指定 "name" 参数',
+    RATE_LIMIT_SKIPPED_WARNING: '流量控制创建失败但 API 部署成功。您可以重新运行 deploy 重试。',
+    // Volcengine provider messages
+    PROVIDER_VOLCENGINE: '火山引擎',
+    VOLCENGINE_DEPLOYING_STACK: '正在部署资源栈到火山引擎...',
+    VOLCENGINE_CREATING_FUNCTION: '正在创建火山引擎函数 {{functionName}}',
+    VOLCENGINE_UPDATING_FUNCTION: '正在更新火山引擎函数 {{functionName}}',
+    VOLCENGINE_DELETING_FUNCTION: '正在删除火山引擎函数 {{functionName}}',
+    VOLCENGINE_FUNCTION_NOT_FOUND: '火山引擎函数 {{functionName}} 未找到',
+    VOLCENGINE_FUNCTION_READY: '火山引擎函数 {{functionName}} 已就绪',
+    VOLCENGINE_CREATING_BUCKET: '正在创建火山引擎 TOS 存储桶 {{bucketName}}',
+    VOLCENGINE_DELETING_BUCKET: '正在删除火山引擎 TOS 存储桶 {{bucketName}}',
+    VOLCENGINE_BUCKET_NOT_FOUND: '火山引擎 TOS 存储桶 {{bucketName}} 未找到',
+    VOLCENGINE_CREATING_ROLE: '正在创建火山引擎 IAM 角色 {{roleName}}',
+    VOLCENGINE_DELETING_ROLE: '正在删除火山引擎 IAM 角色 {{roleName}}',
+    VOLCENGINE_ROLE_NOT_FOUND: '火山引擎 IAM 角色 {{roleName}} 未找到',
+    VOLCENGINE_CREATING_APIGW: '正在创建火山引擎 API 网关 {{gatewayName}}',
+    VOLCENGINE_DELETING_APIGW: '正在删除火山引擎 API 网关 {{gatewayName}}',
+    VOLCENGINE_APIGW_NOT_FOUND: '火山引擎 API 网关 {{gatewayName}} 未找到',
+    // Additional Volcengine-specific messages
+    RESOURCE_STATE_NOT_FOUND: '未找到逻辑 ID 为 {{logicalId}} 的资源状态',
+    RESOURCE_INSTANCE_NOT_FOUND: '未找到逻辑 ID 为 {{logicalId}} 的资源实例',
+    UPDATING_RESOURCE_WITH_NO_CHANGES: '未检测到 {{resourceType}}: {{name}} 的变更',
+    // Code deployment messages
+    CODE_PACKAGE_TOO_LARGE: '代码包大小 ({{size}} MB) 超过最大限制。ZIP 最大：{{maxZip}} MB, TOS 最大：{{maxTos}} MB',
+    CODE_PACKAGE_EXCEEDS_ZIP_LIMIT: '代码包 ({{size}} MB) 超过 ZIP 限制 ({{limit}} MB)，使用 TOS 上传策略',
+    CODE_PACKAGE_EMPTY: '代码包为空',
+    CODE_PACKAGE_MAY_MISS_HANDLER: '代码包可能不包含处理函数文件',
+    CODE_PACKAGE_INVALID_ZIP: '无效的 ZIP 包：{{error}}',
+    DEPLOYING_FUNCTION_WITH_ZIP: '正在部署函数 {{functionName}}，使用 ZIP 包 ({{size}} MB)',
+    DEPLOYING_FUNCTION_WITH_TOS: '正在部署函数 {{functionName}}，使用 TOS ({{size}} MB) 到 {{bucket}}/{{key}}',
+    UPLOADING_CODE_TO_TOS: '正在上传代码到 TOS: {{bucket}}/{{key}}',
+    CODE_UPLOADED_TO_TOS: '代码已上传到 TOS: {{bucket}}/{{key}} ({{size}} MB)',
+    FUNCTION_CREATED: '函数 {{functionName}} 创建成功',
+    FUNCTION_CONFIGURATION_UPDATED: '函数 {{functionName}} 配置已更新',
+    UPDATING_FUNCTION_CODE_WITH_ZIP: '正在更新函数 {{functionName}} 代码，使用 ZIP 包 ({{size}} MB)',
+    UPDATING_FUNCTION_CODE_WITH_TOS: '正在更新函数 {{functionName}} 代码，使用 TOS ({{size}} MB) 到 {{bucket}}/{{key}}',
+    FUNCTION_CODE_UPDATED: '函数 {{functionName}} 代码已更新',
+    FUNCTION_DELETED: '函数 {{functionName}} 已删除',
+    // TOS Object Storage messages
+    TOS_BUCKET_CREATED: 'TOS 存储桶 {{bucketName}} 创建成功',
+    TOS_BUCKET_DELETED: 'TOS 存储桶 {{bucketName}} 删除成功',
+    TOS_BUCKET_ACL_UPDATED: 'TOS 存储桶 {{bucketName}} ACL 已更新为 {{acl}}',
+    TOS_BUCKET_WEBSITE_CONFIGURED: 'TOS 存储桶 {{bucketName}} 静态网站已配置',
+    TOS_BUCKET_WEBSITE_UPDATED: 'TOS 存储桶 {{bucketName}} 静态网站配置已更新',
+    TOS_BUCKET_NOT_FOUND: 'TOS 存储桶 {{bucketName}} 未找到',
+    TOS_BUCKET_TRACKED_CAN_RETRY: '存储桶已在状态中跟踪，您可以重试部署以上传文件',
+    TOS_BUCKET_FILE_UPLOAD_FAILED_STATE_SAVED: '上传文件到存储桶失败，但存储桶已创建并保存到状态：{{error}}',
+    TOS_OBJECT_UPLOADED: '已上传对象 {{key}} 到存储桶 {{bucket}}',
+    TOS_FILES_UPLOADED: '已从 {{path}} 上传文件到存储桶 {{bucket}}',
+    VOLCENGINE_TOS_CLIENT_NOT_INITIALIZED: 'TOS 客户端未初始化。请检查您的凭证。',
+    VOLCENGINE_BUCKET_DELETE_FAILED: '删除存储桶 {{bucketName}} 失败：{{error}}',
+    VOLCENGINE_FUNCTION_DELETE_FAILED: '删除函数 {{functionName}} 失败：{{error}}',
+    VOLCENGINE_APIGW_CLIENT_NOT_INITIALIZED: 'API 网关客户端未初始化。请检查您的凭证。',
+    VOLCENGINE_APIGW_DELETE_FAILED: '删除 API 网关 {{logicalId}} 失败：{{error}}',
+    // Volcengine IAM messages
+    IAM_ROLE_CREATED: 'IAM 角色 {{roleName}} 创建成功',
+    IAM_ROLE_DELETED: 'IAM 角色 {{roleName}} 删除成功',
+    IAM_ROLE_ALREADY_EXISTS: 'IAM 角色 "{{roleName}}" 在云端已存在（检测到状态漂移）。' + '正在更新信任策略并复用现有角色。',
+    IAM_ROLE_NOT_FOUND_IN_CLOUD: '云提供商中不存在 IAM 角色 "{{roleName}}"。' +
+        '该角色可能已被手动删除。' +
+        '修复方法：从状态中移除该角色并重新部署。',
+    IAM_ROLE_DRIFT_RECOVERY_FAILED: 'IAM 角色 "{{roleName}}" 状态漂移恢复失败：{{error}}。' +
+        '角色在云端存在但恢复操作失败。' +
+        '修复方法：在云控制台手动确认角色状态，从状态中移除该角色并重新部署。',
+    IAM_ROLE_TRUST_POLICY_UPDATED: 'IAM 角色 {{roleName}} 信任策略已更新',
+    IAM_POLICY_ALREADY_EXISTS: 'IAM 策略 {{policyName}} 已存在，复用现有策略',
+    IAM_POLICY_ALREADY_ATTACHED: 'IAM 策略 {{policyName}} 已附加到角色 {{roleName}}',
+    IAM_POLICY_ATTACHED: 'IAM 策略 {{policyName}} 已附加到角色 {{roleName}}',
+    IAM_POLICY_DETACHED: 'IAM 策略 {{policyName}} 已从角色 {{roleName}} 分离',
+    IAM_ROLE_INSTANCE_NOT_FOUND: 'IAM 角色实例在状态中未找到：{{roleName}}',
+    IAM_ROLE_TRN_MISSING: 'IAM 角色 TRN 缺失且无法获取 accountId 来构造 {{roleName}} 的 TRN。' +
+        '请确保 IAM 角色创建成功且 accountId 已配置。',
+    CREATING_IAM_ROLE: '正在创建 IAM 角色：{{roleName}}',
+    DELETING_IAM_ROLE: '正在删除 IAM 角色：{{id}}',
+    IAM_POLICY_DETACH_FAILED: '从角色 {{roleName}} 解除 IAM 策略 {{policyName}} 失败：{{error}}',
+    // Volcengine TLS (Log Service) messages
+    TLS_PROJECT_CREATED: 'TLS 项目 {{projectName}} 创建成功',
+    TLS_PROJECT_DELETED: 'TLS 项目 {{projectName}} 删除成功',
+    TLS_PROJECT_NOT_FOUND: 'TLS 项目 {{projectName}} 未找到',
+    TLS_PROJECT_TIMEOUT: '等待 TLS 项目 {{projectName}} 就绪超时',
+    TLS_TOPIC_CREATED: 'TLS 主题 {{topicName}} 创建成功',
+    TLS_TOPIC_DELETED: 'TLS 主题 {{topicName}} 删除成功',
+    TLS_TOPIC_NOT_FOUND: 'TLS 主题 {{topicName}} 未找到',
+    TLS_TOPIC_TIMEOUT: '等待 TLS 主题 {{topicName}} 就绪超时',
+    TLS_INDEX_CREATED: 'TLS 主题 {{topicName}} 索引创建成功',
+    TLS_INDEX_DELETED: 'TLS 主题 {{topicName}} 索引删除成功',
+    TLS_PROJECT_FAILED: 'TLS 项目 {{projectName}} 创建失败',
+    TLS_TOPIC_FAILED: 'TLS 主题 {{topicName}} 创建失败',
+    CREATING_TLS_PROJECT: '正在创建 TLS 项目：{{projectName}}',
+    CREATING_TLS_TOPIC: '正在创建 TLS 主题：{{topicName}}',
+    CREATING_TLS_INDEX: '正在为 TLS 主题创建索引：{{topicName}}',
+    DELETING_TLS_PROJECT: '正在删除 TLS 项目：{{id}}',
+    DELETING_TLS_TOPIC: '正在删除 TLS 主题：{{id}}',
+    DELETING_TLS_INDEX: '正在删除 TLS 索引：{{id}}',
+    WAITING_FOR_TLS_RESOURCES: '等待 TLS 资源就绪：{{projectName}}/{{topicName}}',
+    // Volcengine veFaaS dependent resources
+    VEFAAS_DEPENDENT_RESOURCES_TRACKED: '依赖资源（TLS、IAM）已在状态中跟踪',
+    VEFAAS_CAN_RETRY_DEPLOYMENT: '您可以重试部署 - 系统将复用现有的依赖资源',
+    VEFAAS_FUNCTION_EXISTS_RECOVERY: '函数 {{functionName}} 在提供商中已存在（状态恢复中），跳过创建并刷新状态',
 };

package/dist/src/stack/deploy.js

@@ -4,6 +4,7 @@ exports.deployStack = void 0;
 const common_1 = require("../common");
 const scfStack_1 = require("./scfStack");
 const aliyunStack_1 = require("./aliyunStack");
+const volcengineStack_1 = require("./volcengineStack");
 const deployHuawei = async () => {
     throw new Error('Huawei deployment is not yet implemented. ' +
         'The provider currently generates HCL templates but does not deploy them. ' +
@@ -19,5 +20,8 @@ const deployStack = async (iac, backend) => {
     else if (iac.provider.name === common_1.ProviderEnum.HUAWEI) {
         await deployHuawei();
     }
+    else if (iac.provider.name === common_1.ProviderEnum.VOLCENGINE) {
+        await (0, volcengineStack_1.deployVolcengineStack)(iac, backend);
+    }
 };
 exports.deployStack = deployStack;