@hile/message-ipc 1.0.0 → 1.0.2

package/README.md

@@ -39,6 +39,10 @@ class WorkerIpc extends MessageIpc {
         return data; // echo
     }
   }
+
+  public request<T = any>(data: T, timeout?: number) {
+    return this._send(data, timeout);
+  }
 }
 ```
 
@@ -51,6 +55,10 @@ class ParentIpc extends MessageIpc {
   protected async exec(data: any): Promise<any> {
     return { reply: 'from parent', query: data };
   }
+
+  public request<T = any>(data: T, timeout?: number) {
+    return this._send(data, timeout);
+  }
 }
 
 const child = fork('./worker.js');
@@ -77,10 +85,11 @@ const ipc = new WorkerIpc(); // 无参数 → 自动使用 process
 |------|------|------|
 | `constructor` | `new SubClass(channel?: ChildProcess)` | 父进程传 `fork()` 返回值；子进程不传参数 |
 | `exec` | `protected abstract exec(data: any): Promise<any>` | 子类实现：处理对端请求的业务逻辑 |
-| `request` | `request<T>(data: T, timeout?: number)` | 向对端发送请求，返回 `{ abort, response }` |
+| `_send` | `protected _send<T>(data: T, timeout?: number)` | 发送双向请求（`twoway: true`），返回 `{ abort, response }`。子类自行暴露为 public |
+| `_push` | `protected _push<T>(data: T, timeout?: number)` | 发送单向推送（`twoway: false`），接收方不回复 RESPONSE |
 | `dispose` | `dispose(): void` | 移除消息监听，释放资源 |
 
-### `request` 返回值
+### `_send` 返回值
 
 | 属性 | 类型 | 说明 |
 |------|------|------|

package/SKILL.md

@@ -39,8 +39,14 @@ abstract class MessageIpc extends MessageModem {
   // 子类必须实现
   protected abstract exec(data: any): Promise<any>;
 
-  // 向对端发送请求
-  public request<T = any>(data: T, timeout?: number): {
+  // 发送双向请求（protected，子类自行暴露）
+  protected _send<T = any>(data: T, timeout?: number): {
+    abort: () => void;
+    response: <U = any>() => Promise<U>;
+  };
+
+  // 发送单向推送（protected，子类自行暴露）
+  protected _push<T = any>(data: T, timeout?: number): {
     abort: () => void;
     response: <U = any>() => Promise<U>;
   };
@@ -69,6 +75,11 @@ class MyIpc extends MessageIpc {
         return data;
     }
   }
+
+  // 自行暴露发送方法
+  public request<T = any>(data: T, timeout?: number) {
+    return this._send(data, timeout);
+  }
 }
 ```
 
@@ -82,6 +93,10 @@ class ParentIpc extends MessageIpc {
     // 处理子进程发来的请求
     return { reply: 'from parent', query: data };
   }
+
+  public request<T = any>(data: T, timeout?: number) {
+    return this._send(data, timeout);
+  }
 }
 
 const child = fork('./worker.js');
@@ -107,6 +122,10 @@ class WorkerIpc extends MessageIpc {
     if (data.action === 'restricted') throw new Exception(403, 'not allowed');
     return data;
   }
+
+  public request<T = any>(data: T, timeout?: number) {
+    return this._send(data, timeout);
+  }
 }
 
 const ipc = new WorkerIpc(); // 无参数 → 使用 process
@@ -120,7 +139,8 @@ const ipc = new WorkerIpc(); // 无参数 → 使用 process
 | **父进程端必须传入 `ChildProcess`** | `fork()` 返回值 |
 | **子进程端不传参数** | 自动使用 `process`，要求进程通过 `fork()` 启动 |
 | **用完必须 `dispose()`** | 避免内存泄漏 |
-| **`request` 返回 `{ abort, response }`** | 继承 `send` 语义 |
+| **`_send` 是 `protected`** | 子类需自行暴露为 public 方法（如 `request`） |
+| **`_push` 是 `protected`** | 单向推送，接收方不回复 RESPONSE。子类自行暴露 |
 
 ### 3.5 反模式
 
@@ -128,9 +148,10 @@ const ipc = new WorkerIpc(); // 无参数 → 使用 process
 // ❌ 不能直接实例化 MessageIpc
 const ipc = new MessageIpc(child); // TypeError: Cannot construct abstract class
 
-// ✅ 继承并实现 exec
+// ✅ 继承并实现 exec，自行暴露 _send
 class MyIpc extends MessageIpc {
   protected async exec(data: any) { return data; }
+  public request<T = any>(data: T, timeout?: number) { return this._send(data, timeout); }
 }
 const ipc = new MyIpc(child);
 

package/dist/index.d.ts

@@ -26,13 +26,6 @@ export declare abstract class MessageIpc extends MessageModem {
     private readonly listener;
     constructor(channel?: ChildProcess);
     protected post<T = any>(data: MessageTransferFormat<T>): void;
-    /**
-     * 向对端发送请求
-     */
-    request<T = any>(data: T, timeout?: number): {
-        abort: () => void;
-        response: <U = any>() => Promise<U>;
-    };
     /**
      * 移除消息监听，释放资源
      */

package/dist/index.js

@@ -35,12 +35,6 @@ export class MessageIpc extends MessageModem {
         }
         ch.send(data);
     }
-    /**
-     * 向对端发送请求
-     */
-    request(data, timeout) {
-        return this.send(data, timeout);
-    }
     /**
      * 移除消息监听，释放资源
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hile/message-ipc",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "type": "module",
   "main": "./dist/index.js",
   "scripts": {
@@ -22,7 +22,7 @@
     "vitest": "^4.0.18"
   },
   "dependencies": {
-    "@hile/message-modem": "1.0.1"
+    "@hile/message-modem": "^1.0.2"
   },
-  "gitHead": "f8add8c808b4c0a4e51ee97f49557ca189e1471c"
+  "gitHead": "86b1ce38e9eeb069acb2188834a0ff5b466a050a"
 }