@hotrepl/sdk 2.0.0 → 3.0.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ArtifactRef, CommandDescriptor, HandshakeMessage, ServerMessage, SubscribeResultMessage, SubscribeErrorMessage, SessionEvictedMessage, JournalEntry, JobCancelResultMessage, ErrorKind, HotReplErrorEnvelope } from '@hotrepl/protocol';
+import { ArtifactRef, CommandDescriptor, HandshakeMessage, ServerMessage, SubscribeResultMessage, SubscribeErrorMessage, SessionEvictedMessage, JournalEntry, CommandSummary, JobCancelResultMessage, ErrorKind, HotReplErrorEnvelope } from '@hotrepl/protocol';
 
 interface ArtifactReader {
     readArtifact(ref: ArtifactRef): Promise<Uint8Array>;
@@ -120,6 +120,7 @@ declare class Session {
     readonly handshake: HandshakeMessage;
     private readonly transport;
     private readonly descriptors;
+    private catalog;
     private readonly evictionListeners;
     private sequence;
     private evicted;
@@ -139,6 +140,8 @@ declare class Session {
         limit?: number;
     }): Promise<JournalEntry[]>;
     artifact(ref: ArtifactRef): Artifact;
+    listCommands(): Promise<CommandSummary[]>;
+    getCatalogEntry(name: string): Promise<CommandSummary>;
     describeCommand(name: string): Promise<CommandDescriptor>;
     pollJob<T>(jobId: string, pollIntervalMs: number): Promise<Result<T>>;
     nextId(prefix: string): string;

package/dist/index.js

@@ -130,6 +130,7 @@ var Session = class {
   handshake;
   transport;
   descriptors = /* @__PURE__ */ new Map();
+  catalog;
   evictionListeners = /* @__PURE__ */ new Set();
   sequence = 0;
   evicted;
@@ -148,7 +149,7 @@ var Session = class {
   }
   async run(name, args, options = {}) {
     this.ensureActive();
-    const descriptor = await this.describeCommand(name);
+    const catalogEntry = await this.getCatalogEntry(name);
     const request = {
       type: "command_call",
       id: this.nextId("cmd"),
@@ -157,7 +158,7 @@ var Session = class {
     };
     if (options.timeoutMs !== void 0) request.timeoutMs = options.timeoutMs;
     const response = await this.request(request);
-    if (descriptor.kind === "sync") {
+    if (catalogEntry.kind === "sync") {
       if (response.type !== MESSAGE_TYPES.commandResult) {
         throw protocolError("unexpectedResponse", "Expected command_result.");
       }
@@ -245,6 +246,24 @@ var Session = class {
   artifact(ref) {
     return new Artifact(ref, this.transport);
   }
+  async listCommands() {
+    this.ensureActive();
+    if (this.catalog !== void 0) return this.catalog;
+    const response = await this.request({
+      type: "commands_list",
+      id: this.nextId("list")
+    });
+    this.catalog = response.commands;
+    return this.catalog;
+  }
+  async getCatalogEntry(name) {
+    const commands = await this.listCommands();
+    const entry = commands.find((command) => command.name === name);
+    if (entry === void 0) {
+      throw protocolError("commandNotFound", `Command '${name}' is not registered.`);
+    }
+    return entry;
+  }
   async describeCommand(name) {
     const cached = this.descriptors.get(name);
     if (cached !== void 0) return cached;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hotrepl/sdk",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "description": "Canonical TypeScript SDK for HotRepl v2 runtimes.",
   "keywords": [
     "hotrepl",
@@ -41,7 +41,7 @@
     "typecheck": "tsc -p tsconfig.json"
   },
   "dependencies": {
-    "@hotrepl/protocol": "2.0.0"
+    "@hotrepl/protocol": "3.0.0"
   },
   "devDependencies": {
     "@hotrepl/testing": "2.0.0"