@hile/micro 3.0.4 → 4.0.0

package/dist/application.d.ts

@@ -1,6 +1,6 @@
 import { Client } from './client.js';
 import { Server, type MicroServerProps } from './server.js';
-import { RegistryAddress } from './registry.js';
+import type { RegistryAddress, RegistryTopicSnapshot, RegistryTopicSummary } from './registry';
 type UnionToIntersection<U> = (U extends any ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
 type EnvRequest<T extends Record<string, Record<string, any>>> = {
     [N in keyof T]: {
@@ -120,6 +120,12 @@ export declare class Application extends Server {
         update: (payload: T) => Promise</*elided*/ any>;
         unpublish: () => Promise</*elided*/ any>;
     }>;
+    /** Reads Registry topic metadata without creating a pub/sub subscription. */
+    listRegistryTopics(prefix?: string): Promise<RegistryTopicSummary[]>;
+    /** Reads one retained/current Registry topic payload without subscribing to it. */
+    getRegistryTopic<T = unknown>(topic: string): Promise<RegistryTopicSnapshot & {
+        payload: T;
+    } | undefined>;
     /**
      * 对同一 topic 可多次 subscribe，各自独立回调。
      * 传入同一个 callback 引用第二次调用时幂等返回 unsubscribe，不重复注册。

package/dist/application.js

@@ -848,6 +848,29 @@ export class Application extends Server {
         };
         return ref;
     }
+    /** Reads Registry topic metadata without creating a pub/sub subscription. */
+    async listRegistryTopics(prefix) {
+        const registry = this.registry;
+        if (!registry) {
+            this.ensureRegistryReconnectScheduled();
+            throw new Error('Registry is not connected');
+        }
+        const result = await registry.request('/-/topics', prefix === undefined ? {} : { prefix }, this.registryRequestOptions());
+        return structuredClone(result.topics);
+    }
+    /** Reads one retained/current Registry topic payload without subscribing to it. */
+    async getRegistryTopic(topic) {
+        if (typeof topic !== 'string' || topic.length === 0) {
+            throw new TypeError('Registry topic must not be empty');
+        }
+        const registry = this.registry;
+        if (!registry) {
+            this.ensureRegistryReconnectScheduled();
+            throw new Error('Registry is not connected');
+        }
+        const snapshot = await registry.request('/-/topic/get', { topic }, this.registryRequestOptions());
+        return snapshot === undefined ? undefined : structuredClone(snapshot);
+    }
     /**
      * 对同一 topic 可多次 subscribe，各自独立回调。
      * 传入同一个 callback 引用第二次调用时幂等返回 unsubscribe，不重复注册。

package/dist/client.d.ts

@@ -30,7 +30,7 @@ export declare class Client extends MessageWs {
     readonly events: EventEmitter<any>;
     constructor(props: ClientProps);
     private startHeartbeat;
-    protected exec(data: MicroMessage): Promise<any>;
+    protected exec(data: MicroMessage, signal?: AbortSignal): Promise<any>;
     request<T = any>(url: string, data: any, options?: {
         timeout?: number;
         signal?: AbortSignal;

package/dist/client.js

@@ -87,7 +87,7 @@ export class Client extends MessageWs {
             }
         }, checkInterval);
     }
-    async exec(data) {
+    async exec(data, signal) {
         if (data.url === '/-/heartbeat') {
             this.lastHeartbeat = Date.now();
             return;
@@ -99,6 +99,7 @@ export class Client extends MessageWs {
             const result = await this.server.dispatch(data.url, data.data, {
                 client: this,
                 metadata: data.metadata,
+                signal,
             });
             if (context && isAsyncIterable(result)) {
                 return bindAsyncIterableToContext(result, context);

package/package.json

@@ -1,8 +1,13 @@
 {
   "name": "@hile/micro",
-  "version": "3.0.4",
+  "version": "4.0.0",
   "type": "module",
   "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc -b && fix-esm-import-path --preserve-import-type ./dist",
+    "dev": "tsc -b --watch",
+    "test": "vitest run"
+  },
   "files": [
     "dist",
     "README.md",
@@ -13,22 +18,19 @@
     "access": "public"
   },
   "devDependencies": {
+    "@types/node": "^26.2.0",
     "@types/ws": "^8.18.1",
     "fix-esm-import-path": "^1.10.3",
     "vitest": "^4.0.18"
   },
   "dependencies": {
+    "@hile/context": "^4.0.0",
+    "@hile/logger": "^4.0.0",
+    "@hile/message-loader": "^4.0.0",
+    "@hile/message-ws": "^4.0.0",
     "internal-ip": "^9.0.0",
     "ws": "^8.21.0",
-    "yaml": "^2.9.0",
-    "@hile/context": "^3.0.2",
-    "@hile/logger": "^3.0.0",
-    "@hile/message-loader": "^3.0.0",
-    "@hile/message-ws": "^3.0.0"
+    "yaml": "^2.9.0"
   },
-  "scripts": {
-    "build": "tsc -b && fix-esm-import-path --preserve-import-type ./dist",
-    "dev": "tsc -b --watch",
-    "test": "vitest run"
-  }
-}
+  "gitHead": "b46cb7f3705a226f58e4d65a2ff985ea54b9a159"
+}