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

package/lib/sandbox/index.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SandboxService = void 0;
 const utils_1 = require("../utils");
+const error_1 = require("../error");
 class SandboxService {
     constructor(environment) {
         this.environment = environment;
@@ -17,23 +18,23 @@ class SandboxService {
         const { toolId, description, networkConfiguration, tags, customConfiguration } = options;
         // ToolId 校验：必填
         if (typeof toolId !== 'string' || toolId.trim().length === 0) {
-            throw new Error('toolId is required');
+            (0, error_1.throwInvalidParam)('toolId is required');
         }
         // Description 校验：最大 200 字符
         if (description !== undefined && description.length > 200) {
-            throw new Error('description length must be <= 200');
+            (0, error_1.throwInvalidParam)('description length must be <= 200');
         }
         // NetworkConfiguration 校验
         if (networkConfiguration !== undefined) {
             const validModes = ['PUBLIC', 'VPC', 'SANDBOX'];
             if (!networkConfiguration.NetworkMode || !validModes.includes(networkConfiguration.NetworkMode)) {
-                throw new Error(`NetworkMode must be one of: ${validModes.join(', ')}`);
+                (0, error_1.throwInvalidParam)(`NetworkMode must be one of: ${validModes.join(', ')}`);
             }
         }
         // Tags 校验
         if (tags !== undefined) {
             if (!Array.isArray(tags)) {
-                throw new Error('tags must be an array');
+                (0, error_1.throwInvalidParam)('tags must be an array');
             }
         }
         // CustomConfiguration 校验
@@ -41,32 +42,32 @@ class SandboxService {
             // Image 镜像地址格式基本校验
             if (customConfiguration.Image !== undefined) {
                 if (typeof customConfiguration.Image !== 'string' || customConfiguration.Image.trim().length === 0) {
-                    throw new Error('Image must be a non-empty string');
+                    (0, error_1.throwInvalidParam)('Image must be a non-empty string');
                 }
             }
             // ImageRegistryType 校验
             if (customConfiguration.ImageRegistryType !== undefined) {
                 const validTypes = ['enterprise', 'personal'];
                 if (!validTypes.includes(customConfiguration.ImageRegistryType)) {
-                    throw new Error(`ImageRegistryType must be one of: ${validTypes.join(', ')}`);
+                    (0, error_1.throwInvalidParam)(`ImageRegistryType must be one of: ${validTypes.join(', ')}`);
                 }
             }
             // Ports 校验
             if (customConfiguration.Ports !== undefined) {
                 if (!Array.isArray(customConfiguration.Ports)) {
-                    throw new Error('Ports must be an array');
+                    (0, error_1.throwInvalidParam)('Ports must be an array');
                 }
             }
             // Env 校验
             if (customConfiguration.Env !== undefined) {
                 if (!Array.isArray(customConfiguration.Env)) {
-                    throw new Error('Env must be an array');
+                    (0, error_1.throwInvalidParam)('Env must be an array');
                 }
             }
             // DNSConfig.Servers 校验：文档标注为必填
             if (customConfiguration.DNSConfig !== undefined) {
                 if (!Array.isArray(customConfiguration.DNSConfig.Servers) || customConfiguration.DNSConfig.Servers.length === 0) {
-                    throw new Error('DNSConfig.Servers is required and must be a non-empty array');
+                    (0, error_1.throwInvalidParam)('DNSConfig.Servers is required and must be a non-empty array');
                 }
             }
         }
@@ -98,28 +99,28 @@ class SandboxService {
         // ToolIds 校验
         if (toolIds !== undefined) {
             if (!Array.isArray(toolIds)) {
-                throw new Error('toolIds must be an array');
+                (0, error_1.throwInvalidParam)('toolIds must be an array');
             }
             if (toolIds.length > 100) {
-                throw new Error('toolIds length must be <= 100');
+                (0, error_1.throwInvalidParam)('toolIds length must be <= 100');
             }
             const invalidId = toolIds.find(id => typeof id !== 'string' || id.trim().length === 0);
             if (invalidId !== undefined) {
-                throw new Error('toolIds contains invalid item');
+                (0, error_1.throwInvalidParam)('toolIds contains invalid item');
             }
         }
         // Offset 校验
         if (offset !== undefined && (!Number.isInteger(offset) || offset < 0)) {
-            throw new Error('offset must be a non-negative integer');
+            (0, error_1.throwInvalidParam)('offset must be a non-negative integer');
         }
         // Limit 校验
         if (limit !== undefined && (!Number.isInteger(limit) || limit < 1 || limit > 100)) {
-            throw new Error('limit must be an integer between 1 and 100');
+            (0, error_1.throwInvalidParam)('limit must be an integer between 1 and 100');
         }
         // Filters 校验
         if (filters !== undefined) {
             if (!Array.isArray(filters)) {
-                throw new Error('filters must be an array');
+                (0, error_1.throwInvalidParam)('filters must be an array');
             }
         }
         // 构造请求体
@@ -147,69 +148,72 @@ class SandboxService {
         const { toolName, toolType, networkConfiguration, description, defaultTimeout, tags, clientToken, roleArn, storageMounts, customConfiguration, logConfiguration } = options;
         // ToolName 校验：必填，1-50 字符，英文/数字/下划线/连接线
         if (typeof toolName !== 'string' || toolName.trim().length === 0) {
-            throw new Error('toolName is required');
+            (0, error_1.throwInvalidParam)('toolName is required');
         }
         if (toolName.length > 50) {
-            throw new Error('toolName length must be <= 50');
+            (0, error_1.throwInvalidParam)('toolName length must be <= 50');
         }
         if (!/^[a-zA-Z0-9_-]+$/.test(toolName)) {
-            throw new Error('toolName can only contain letters, digits, underscores and hyphens');
+            (0, error_1.throwInvalidParam)('toolName can only contain letters, digits, underscores and hyphens');
         }
         // ToolType 校验：必填，枚举
         const validToolTypes = ['browser', 'code-interpreter', 'custom'];
         if (!toolType || !validToolTypes.includes(toolType)) {
-            throw new Error(`toolType must be one of: ${validToolTypes.join(', ')}`);
+            (0, error_1.throwInvalidParam)(`toolType must be one of: ${validToolTypes.join(', ')}`);
         }
         // NetworkConfiguration 校验：必填
         if (!networkConfiguration) {
-            throw new Error('networkConfiguration is required');
+            (0, error_1.throwInvalidParam)('networkConfiguration is required');
         }
         const validModes = ['PUBLIC', 'VPC', 'SANDBOX'];
         if (!networkConfiguration.NetworkMode || !validModes.includes(networkConfiguration.NetworkMode)) {
-            throw new Error(`NetworkMode must be one of: ${validModes.join(', ')}`);
+            (0, error_1.throwInvalidParam)(`NetworkMode must be one of: ${validModes.join(', ')}`);
         }
         // Description 校验
         if (description !== undefined && description.length > 200) {
-            throw new Error('description length must be <= 200');
+            (0, error_1.throwInvalidParam)('description length must be <= 200');
         }
         // DefaultTimeout 校验：格式如 5m、300s、1h
         if (defaultTimeout !== undefined) {
             if (typeof defaultTimeout !== 'string' || !/^\d+[smh]$/.test(defaultTimeout)) {
-                throw new Error('defaultTimeout must match format like 5m, 300s, 1h');
+                (0, error_1.throwInvalidParam)('defaultTimeout must match format like 5m, 300s, 1h');
             }
         }
         // ClientToken 校验：最大 64 字符
         if (clientToken !== undefined && clientToken.length > 64) {
-            throw new Error('clientToken length must be <= 64');
+            (0, error_1.throwInvalidParam)('clientToken length must be <= 64');
         }
         // Tags 校验
         if (tags !== undefined) {
             if (!Array.isArray(tags)) {
-                throw new Error('tags must be an array');
+                (0, error_1.throwInvalidParam)('tags must be an array');
             }
         }
         // StorageMounts 校验
         if (storageMounts !== undefined) {
             if (!Array.isArray(storageMounts)) {
-                throw new Error('storageMounts must be an array');
+                (0, error_1.throwInvalidParam)('storageMounts must be an array');
             }
         }
         // CustomConfiguration 校验
-        if (customConfiguration !== undefined) {
+        // customConfiguration 运行时可能被传 null（类型上不允许）⇒ 真值判断，避免取属性时空指针
+        if (customConfiguration) {
             if (customConfiguration.Image !== undefined) {
                 if (typeof customConfiguration.Image !== 'string' || customConfiguration.Image.trim().length === 0) {
-                    throw new Error('Image must be a non-empty string');
+                    (0, error_1.throwInvalidParam)('Image must be a non-empty string');
                 }
             }
             if (customConfiguration.ImageRegistryType !== undefined) {
                 const validTypes = ['enterprise', 'personal'];
                 if (!validTypes.includes(customConfiguration.ImageRegistryType)) {
-                    throw new Error(`ImageRegistryType must be one of: ${validTypes.join(', ')}`);
+                    (0, error_1.throwInvalidParam)(`ImageRegistryType must be one of: ${validTypes.join(', ')}`);
                 }
             }
-            if (customConfiguration.DNSConfig !== undefined) {
-                if (!Array.isArray(customConfiguration.DNSConfig.Servers) || customConfiguration.DNSConfig.Servers.length === 0) {
-                    throw new Error('DNSConfig.Servers is required and must be a non-empty array');
+            // DNSConfig 同样可能为 null ⇒ 真值判断后再取 Servers
+            if (customConfiguration.DNSConfig) {
+                const { Servers } = customConfiguration.DNSConfig;
+                if (!Array.isArray(Servers) || Servers.length === 0) {
+                    (0, error_1.throwInvalidParam)('DNSConfig.Servers is required and must be a non-empty array');
                 }
             }
         }
@@ -254,7 +258,7 @@ class SandboxService {
         const { toolId } = options;
         // ToolId 校验：必填
         if (typeof toolId !== 'string' || toolId.trim().length === 0) {
-            throw new Error('toolId is required');
+            (0, error_1.throwInvalidParam)('toolId is required');
         }
         const reqData = {
             ToolId: toolId
@@ -270,7 +274,7 @@ class SandboxService {
         const { instanceId } = options;
         // InstanceId 校验：必填
         if (typeof instanceId !== 'string' || instanceId.trim().length === 0) {
-            throw new Error('instanceId is required');
+            (0, error_1.throwInvalidParam)('instanceId is required');
         }
         const reqData = {
             InstanceId: instanceId
@@ -286,7 +290,7 @@ class SandboxService {
         const { instanceId } = options;
         // InstanceId 校验：必填
         if (typeof instanceId !== 'string' || instanceId.trim().length === 0) {
-            throw new Error('instanceId is required');
+            (0, error_1.throwInvalidParam)('instanceId is required');
         }
         const reqData = {
             InstanceId: instanceId
@@ -303,18 +307,18 @@ class SandboxService {
         const { instanceId, timeout, metadata } = options;
         // InstanceId 校验：必填
         if (typeof instanceId !== 'string' || instanceId.trim().length === 0) {
-            throw new Error('instanceId is required');
+            (0, error_1.throwInvalidParam)('instanceId is required');
         }
         // Timeout 校验：格式如 30s、5m、1h，最小 30s，最大 24h
         if (timeout !== undefined) {
             if (typeof timeout !== 'string' || !/^\d+[smh]$/.test(timeout)) {
-                throw new Error('timeout must match format like 30s, 5m, 1h');
+                (0, error_1.throwInvalidParam)('timeout must match format like 30s, 5m, 1h');
             }
         }
         // Metadata 校验
         if (metadata !== undefined) {
             if (!Array.isArray(metadata)) {
-                throw new Error('metadata must be an array');
+                (0, error_1.throwInvalidParam)('metadata must be an array');
             }
         }
         // 构造请求体
@@ -338,7 +342,7 @@ class SandboxService {
         const { instanceId } = options;
         // InstanceId 校验：必填
         if (typeof instanceId !== 'string' || instanceId.trim().length === 0) {
-            throw new Error('instanceId is required');
+            (0, error_1.throwInvalidParam)('instanceId is required');
         }
         const reqData = {
             InstanceId: instanceId
@@ -356,54 +360,57 @@ class SandboxService {
         const hasToolId = toolId !== undefined && toolId.trim().length > 0;
         const hasToolName = toolName !== undefined && toolName.trim().length > 0;
         if (!hasToolId && !hasToolName) {
-            throw new Error('toolId or toolName is required, at least one must be provided');
+            (0, error_1.throwInvalidParam)('toolId or toolName is required, at least one must be provided');
         }
         // Timeout 校验：格式如 30s、5m、1h
         if (timeout !== undefined) {
             if (typeof timeout !== 'string' || !/^\d+[smh]$/.test(timeout)) {
-                throw new Error('timeout must match format like 30s, 5m, 1h');
+                (0, error_1.throwInvalidParam)('timeout must match format like 30s, 5m, 1h');
             }
         }
         // ClientToken 校验：最大 64 字符
         if (clientToken !== undefined && clientToken.length > 64) {
-            throw new Error('clientToken length must be <= 64');
+            (0, error_1.throwInvalidParam)('clientToken length must be <= 64');
         }
         // MountOptions 校验
         if (mountOptions !== undefined) {
             if (!Array.isArray(mountOptions)) {
-                throw new Error('mountOptions must be an array');
+                (0, error_1.throwInvalidParam)('mountOptions must be an array');
             }
         }
         // AuthMode 校验
         if (authMode !== undefined) {
             const validAuthModes = ['DEFAULT', 'TOKEN', 'NONE'];
             if (!validAuthModes.includes(authMode)) {
-                throw new Error(`authMode must be one of: ${validAuthModes.join(', ')}`);
+                (0, error_1.throwInvalidParam)(`authMode must be one of: ${validAuthModes.join(', ')}`);
             }
         }
         // CustomConfiguration 校验
-        if (customConfiguration !== undefined) {
+        // customConfiguration 运行时可能被传 null（类型上不允许）⇒ 真值判断，避免取属性时空指针
+        if (customConfiguration) {
             if (customConfiguration.Image !== undefined) {
                 if (typeof customConfiguration.Image !== 'string' || customConfiguration.Image.trim().length === 0) {
-                    throw new Error('Image must be a non-empty string');
+                    (0, error_1.throwInvalidParam)('Image must be a non-empty string');
                 }
             }
             if (customConfiguration.ImageRegistryType !== undefined) {
                 const validTypes = ['enterprise', 'personal'];
                 if (!validTypes.includes(customConfiguration.ImageRegistryType)) {
-                    throw new Error(`ImageRegistryType must be one of: ${validTypes.join(', ')}`);
+                    (0, error_1.throwInvalidParam)(`ImageRegistryType must be one of: ${validTypes.join(', ')}`);
                 }
             }
-            if (customConfiguration.DNSConfig !== undefined) {
-                if (!Array.isArray(customConfiguration.DNSConfig.Servers) || customConfiguration.DNSConfig.Servers.length === 0) {
-                    throw new Error('DNSConfig.Servers is required and must be a non-empty array');
+            // DNSConfig 同样可能为 null ⇒ 真值判断后再取 Servers
+            if (customConfiguration.DNSConfig) {
+                const { Servers } = customConfiguration.DNSConfig;
+                if (!Array.isArray(Servers) || Servers.length === 0) {
+                    (0, error_1.throwInvalidParam)('DNSConfig.Servers is required and must be a non-empty array');
                 }
             }
         }
         // Metadata 校验
         if (metadata !== undefined) {
             if (!Array.isArray(metadata)) {
-                throw new Error('metadata must be an array');
+                (0, error_1.throwInvalidParam)('metadata must be an array');
             }
         }
         // 构造请求体
@@ -444,34 +451,34 @@ class SandboxService {
         // InstanceIds 校验
         if (instanceIds !== undefined) {
             if (!Array.isArray(instanceIds)) {
-                throw new Error('instanceIds must be an array');
+                (0, error_1.throwInvalidParam)('instanceIds must be an array');
             }
             if (instanceIds.length > 100) {
-                throw new Error('instanceIds length must be <= 100');
+                (0, error_1.throwInvalidParam)('instanceIds length must be <= 100');
             }
             const invalidId = instanceIds.find(id => typeof id !== 'string' || id.trim().length === 0);
             if (invalidId !== undefined) {
-                throw new Error('instanceIds contains invalid item');
+                (0, error_1.throwInvalidParam)('instanceIds contains invalid item');
             }
         }
         // ToolId 校验
         if (toolId !== undefined) {
             if (typeof toolId !== 'string' || toolId.trim().length === 0) {
-                throw new Error('toolId must be a non-empty string');
+                (0, error_1.throwInvalidParam)('toolId must be a non-empty string');
             }
         }
         // Offset 校验
         if (offset !== undefined && (!Number.isInteger(offset) || offset < 0)) {
-            throw new Error('offset must be a non-negative integer');
+            (0, error_1.throwInvalidParam)('offset must be a non-negative integer');
         }
         // Limit 校验
         if (limit !== undefined && (!Number.isInteger(limit) || limit < 1 || limit > 100)) {
-            throw new Error('limit must be an integer between 1 and 100');
+            (0, error_1.throwInvalidParam)('limit must be an integer between 1 and 100');
         }
         // Filters 校验
         if (filters !== undefined) {
             if (!Array.isArray(filters)) {
-                throw new Error('filters must be an array');
+                (0, error_1.throwInvalidParam)('filters must be an array');
             }
         }
         // 构造请求体
@@ -504,7 +511,7 @@ class SandboxService {
         const { instanceId } = options;
         // InstanceId 校验：必填
         if (typeof instanceId !== 'string' || instanceId.trim().length === 0) {
-            throw new Error('instanceId is required');
+            (0, error_1.throwInvalidParam)('instanceId is required');
         }
         const reqData = {
             InstanceId: instanceId
@@ -531,7 +538,7 @@ class SandboxService {
         // Name 校验
         if (name !== undefined) {
             if (typeof name !== 'string' || name.trim().length === 0) {
-                throw new Error('name must be a non-empty string');
+                (0, error_1.throwInvalidParam)('name must be a non-empty string');
             }
         }
         // 构造请求体
@@ -551,7 +558,7 @@ class SandboxService {
         const { keyId } = options;
         // KeyId 校验：必填
         if (typeof keyId !== 'string' || keyId.trim().length === 0) {
-            throw new Error('keyId is required');
+            (0, error_1.throwInvalidParam)('keyId is required');
         }
         const reqData = {
             KeyId: keyId