Merge 'services' into 'master'

feat(services): auto-generate services

See merge request: !9

Author: jienigui-1

.github/workflows/ci.yml

@@ -16,12 +16,12 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 18
 
       - name: Setup pnpm
         uses: pnpm/action-setup@v2
         with:
-          version: 8
+          version: 9
 
       - name: Install Dependencies
         run: pnpm install

.github/workflows/release.yml

@@ -20,12 +20,12 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 18
 
       - name: Setup pnpm
         uses: pnpm/action-setup@v2
         with:
-          version: 8
+          version: 9
 
       - name: Install Dependencies
         run: pnpm install

README.EN.md

@@ -2,7 +2,7 @@ English | [中文](README.md)
 
 # Volcengine SDK for Node.js
 
-## Installation
+## Installation Core Packages
 
 ### Requirements
 
@@ -35,34 +35,26 @@ export VOLCSTACK_ACCESS_KEY_ID="YOUR_AK"
 export VOLCSTACK_SECRET_ACCESS_KEY="YOUR_SK"
 ```
 
-## Endpoint Configuration
-
-The SDK supports multiple ways to configure the Endpoint, with the following priority (highest to lowest):
-
-1.  **Custom Endpoint**: Specify `EndpointWithEndpoint` in the client configuration (e.g. `iam.example.com`).
-2.  **Automatic Addressing**: Specify `region`, and the SDK will automatically construct the Endpoint based on the service name and region (e.g. `ecs.cn-beijing.volcengineapi.com`).
-3.  **Default**: If not specified and cannot be deduced, `open.volcengineapi.com` is used by default.
-
 ## Quick Start
 
 The following example shows how to initialize the client and send a request.
-Install the corresponding service SDK package (e.g., `@volcengine/iam`).
+Install the corresponding service SDK package (e.g., `@volcengine/ecs`).
 
 ```bash
 # pnpm
-pnpm add @volcengine/iam
+pnpm add @volcengine/ecs
 ```
 
 ```typescript
-import { IAMClient, ListUsersCommand } from "@volcengine/iam"; // Need to install the corresponding service package
+import { ECSClient, DescribeZonesCommand } from "@volcengine/ecs"; // Need to install the corresponding service package
 
 // 1. Use AK/SK from environment variables and specify Region
-const client = new IAMClient({
+const client = new ECSClient({
   region: "cn-beijing",
 });
 
 // 2. Or explicitly pass AK/SK in the code
-// const client = new IAMClient({
+// const client = new ECSClient({
 //   accessKeyId: "YOUR_AK",
 //   secretAccessKey: "YOUR_SK",
 //   region: "cn-beijing",
@@ -71,7 +63,7 @@ const client = new IAMClient({
 async function main() {
   try {
     // Send request (refer to service SDK documentation for specific Commands)
-    const command = new ListUsersCommand({});
+    const command = new DescribeZonesCommand({});
     const response = await client.send(command);
     console.log(response);
   } catch (error) {

README.md

@@ -2,7 +2,7 @@
 
 # Volcengine SDK for Node.js
 
-## 安装
+## 安装 Core 包
 
 ### 环境要求
 
@@ -35,35 +35,27 @@ export VOLCSTACK_ACCESS_KEY_ID="YOUR_AK"
 export VOLCSTACK_SECRET_ACCESS_KEY="YOUR_SK"
 ```
 
-## Endpoint 设置
-
-SDK 支持多种方式配置 Endpoint，优先级从高到低：
-
-1.  **自定义 Endpoint**: 在客户端配置中指定 `host` (e.g. `open.volcengineapi.com`).
-2.  **自动寻址**: 指定 `region`，SDK 会根据服务名和区域自动构造 Endpoint (e.g. `ecs.cn-beijing.volcengineapi.com`).
-3.  **默认**: 如果未指定且无法推导，默认使用 `open.volcengineapi.com`.
-
 ## 快速开始
 
 以下示例展示了如何初始化客户端并发送请求。
-安装对应的业务 SDK 包（如 `@volcengine/iam`）。
+安装对应的业务 SDK 包（如 `@volcengine/ecs`）。
 
 ```bash
 # pnpm
-pnpm add @volcengine/iam
+pnpm add @volcengine/ecs
 
 ```
 
 ```typescript
-import { IAMClient } from "@volcengine/iam"; // 需安装对应的业务包
+import { ECSClient, DescribeZonesCommand } from "@volcengine/ecs"; // 需安装对应的业务包
 
 // 1. 使用环境变量中的 AK/SK，并指定 Region
-const client = new IAMClient({
+const client = new ECSClient({
   region: "cn-beijing",
 });
 
 // 2. 或者在代码中显式传入 AK/SK
-// const client = new IAMClient({
+// const client = new ECSClient({
 //   accessKeyId: "YOUR_AK",
 //   secretAccessKey: "YOUR_SK",
 //   region: "cn-beijing",
@@ -72,7 +64,7 @@ const client = new IAMClient({
 async function main() {
   try {
     // 发送请求 (具体 Command 需参考业务 SDK 文档)
-    const command = new ListUsersCommand({});
+    const command = new DescribeZonesCommand({});
     const response = await client.send(command);
     console.log(response);
   } catch (error) {

SDK_Integration.md

@@ -441,9 +441,10 @@ The backoff strategy determines the wait time between each retry. You can choose
 - `ExponentialWithRandomJitterBackoffStrategy` (Default): Exponential backoff with jitter. Adds a random delay on top of exponential backoff to help avoid "thundering herd" effects.
 
 ```typescript
+import { StrategyName } from "@volcengine/sdk-core";
 const client = new EcsClient({
   // ... other configurations
-  retryMode: "ExponentialBackoffStrategy",
+  strategyName: StrategyName.ExponentialWithRandomJitterBackoffStrategy,
 });
 ```
 
@@ -502,7 +503,7 @@ try {
     if (error.status !== undefined) {
       // 1.1 SSL Error (status === 0)
       if (error.status === 0) {
-        console.error(`❌ SSL Error: ${error.message}`);
+        console.error(`❌ SSL Error`);
       }
       // 1.2 Server returned error (status > 0)
       else {
@@ -514,7 +515,6 @@ try {
           console.error(`   RequestId: ${RequestId}`);
         } else {
           // Other HTTP errors (such as 404, 500, 502, etc.)
-          console.error(`❌ HTTP Error ${error.status}: ${error.message}`);
         }
       }
     }
@@ -530,17 +530,12 @@ try {
     }
     // 3. Handle other SDK exceptions (Exception)
     else {
-      console.error("❌ SDK Exception Occurred:");
-      console.error(`   Message: ${error.message}`);
-      console.error(`   Name:    ${error.name}`);
-      if (error.originalError) {
-        console.error("   Cause:", error.originalError);
-      }
+      console.error("❌ SDK Exception Occurred");
     }
   }
   // 4. Unknown error (Error not thrown by SDK)
   else {
-    console.error("❌ Unknown Error:", error);
+    console.error("❌ Unknown Error");
   }
 }
 ```

SDK_Integration_zh.md

@@ -441,9 +441,11 @@ SDK 只会对特定的错误进行重试，包括：
 - `ExponentialWithRandomJitterBackoffStrategy` (默认): 带抖动的指数退避。在指数退避的基础上增加一个随机延迟，有助于避免“惊群效应”。
 
 ```typescript
+import { StrategyName } from "@volcengine/sdk-core";
+
 const client = new EcsClient({
   // ... 其他配置
-  retryMode: "ExponentialBackoffStrategy",
+  strategyName: StrategyName.ExponentialWithRandomJitterBackoffStrategy,
 });
 ```
 
@@ -502,7 +504,7 @@ try {
     if (error.status !== undefined) {
       // 1.1 SSL 错误 (status === 0)
       if (error.status === 0) {
-        console.error(`❌ SSL Error: ${error.message}`);
+        console.error(`❌ SSL Error`);
       }
       // 1.2 服务端返回的错误 (status > 0)
       else {
@@ -514,7 +516,6 @@ try {
           console.error(`   RequestId: ${RequestId}`);
         } else {
           // 其他 HTTP 错误 (如 404, 500, 502 等)
-          console.error(`❌ HTTP Error ${error.status}: ${error.message}`);
         }
       }
     }
@@ -530,17 +531,12 @@ try {
     }
     // 3. 处理其他 SDK 异常 (Exception)
     else {
-      console.error("❌ SDK Exception Occurred:");
-      console.error(`   Message: ${error.message}`);
-      console.error(`   Name:    ${error.name}`);
-      if (error.originalError) {
-        console.error("   Cause:", error.originalError);
-      }
+      console.error("❌ SDK Exception Occurred");
     }
   }
   // 4. 未知错误 (非 SDK 抛出的错误)
   else {
-    console.error("❌ Unknown Error:", error);
+    console.error("❌ Unknown Error");
   }
 }
 ```

meta.json

@@ -1,4 +1,4 @@
 {
-	"lasted": "1.0.91",
+	"lasted": "1.0.1",
 	"meta_commit": "416a374787b965e9d18b4f1c640a654cf4ede574"
-}
+}

packages/sdk-core/src/client/Client.ts

@@ -102,22 +102,18 @@ export class Client {
 
   async send<
     TInput extends CommandInput,
+    TOutput extends any,
     TCommandName extends keyof CommandOutputMap
   >(
-    command: Command<TInput, CommandOutputMap[TCommandName], TCommandName>,
+    command: Command<TInput, TOutput, TCommandName>,
     options?: SendOptions
-  ): Promise<CommandOutputMap[TCommandName]> {
+  ): Promise<TOutput> {
     const stack = this.middlewareStack.merge(command.middlewareStack);
     const context: MiddlewareContext = {
       clientName: this.constructor.name,
       commandName: command.constructor.name,
       clientConfig: this.config,
       contentType: command.requestConfig?.contentType || "",
-      castMap: {
-        requestMap: command.requestMap,
-        responseMap: command.responseMap,
-      },
-      skipResponseCasting: options?.skipResponseCasting,
     };
     const handler = stack.resolve(async (args: Args) => args, context);
 
@@ -189,10 +185,9 @@ export class Client {
    */
   debugMiddlewareStack<
     TInput extends CommandInput,
+    TOutput extends any,
     TCommandName extends keyof CommandOutputMap
-  >(
-    command: Command<TInput, CommandOutputMap[TCommandName], TCommandName>
-  ): string {
+  >(command: Command<TInput, TOutput, TCommandName>): string {
     const mergedStack = this.middlewareStack.merge(command.middlewareStack);
     return mergedStack.toString();
   }

packages/sdk-core/src/client/stsClient/api.ts

@@ -28,11 +28,6 @@ import { AssumeRoleResponse } from "./types/index";
 // ============================================================================
 export type AssumeRoleCommandOutput = CommandOutput<AssumeRoleResponse>;
 
-declare module "../../types/types" {
-  interface CommandOutputMap {
-    AssumeRoleCommand: AssumeRoleCommandOutput;
-  }
-}
 /**
  * STSClient Service Client
  */

packages/sdk-core/src/command/Command.ts

@@ -19,8 +19,6 @@ export class Command<
     pathname?: string;
     contentType?: string;
   };
-  requestMap?: Record<string, any>;
-  responseMap?: Record<string, any>;
 
   protected __type?: {
     output: TOutput;