@hmcs/sdk 1.0.0 → 1.1.0

package/dist/commands.cjs

@@ -248,24 +248,33 @@ exports.output = void 0;
     }
     output.writeError = writeError;
     /**
-     * Write a JSON result to stdout and exit the process with code 0.
+     * Exit the process with code 0, optionally writing a JSON result to stdout.
      *
-     * This is a convenience wrapper that calls {@link output.write} followed by
-     * `process.exit(0)`. Use this as the final call in a successful bin command.
+     * When called with a `data` argument, serializes it to stdout via
+     * {@link output.write} before exiting. When called without arguments,
+     * exits immediately without writing to stdout — useful for commands
+     * that perform a side effect (e.g., opening a UI) with no return value.
      *
-     * @param data - The value to serialize as JSON and write to stdout
+     * @param data - Optional value to serialize as JSON and write to stdout
      *
      * @example
      * ```typescript
      * import { input, output } from "@hmcs/sdk/commands";
      *
+     * // With payload
      * const data = await input.parse(schema);
      * const result = await doWork(data);
      * output.succeed({ processed: result.count });
+     *
+     * // Without payload (side-effect only command)
+     * await openWebview();
+     * output.succeed();
      * ```
      */
     function succeed(data) {
-        write(data);
+        if (data !== undefined) {
+            write(data);
+        }
         process.exit(0);
     }
     output.succeed = succeed;

package/dist/commands.d.ts

@@ -810,23 +810,30 @@ declare namespace output {
      */
     function writeError(code: string, message: string): void;
     /**
-     * Write a JSON result to stdout and exit the process with code 0.
+     * Exit the process with code 0, optionally writing a JSON result to stdout.
      *
-     * This is a convenience wrapper that calls {@link output.write} followed by
-     * `process.exit(0)`. Use this as the final call in a successful bin command.
+     * When called with a `data` argument, serializes it to stdout via
+     * {@link output.write} before exiting. When called without arguments,
+     * exits immediately without writing to stdout — useful for commands
+     * that perform a side effect (e.g., opening a UI) with no return value.
      *
-     * @param data - The value to serialize as JSON and write to stdout
+     * @param data - Optional value to serialize as JSON and write to stdout
      *
      * @example
      * ```typescript
      * import { input, output } from "@hmcs/sdk/commands";
      *
+     * // With payload
      * const data = await input.parse(schema);
      * const result = await doWork(data);
      * output.succeed({ processed: result.count });
+     *
+     * // Without payload (side-effect only command)
+     * await openWebview();
+     * output.succeed();
      * ```
      */
-    function succeed(data: unknown): never;
+    function succeed(data?: unknown): never;
     /**
      * Write a structured error to stderr and exit the process.
      *

package/dist/commands.js

@@ -246,24 +246,33 @@ var output;
     }
     output.writeError = writeError;
     /**
-     * Write a JSON result to stdout and exit the process with code 0.
+     * Exit the process with code 0, optionally writing a JSON result to stdout.
      *
-     * This is a convenience wrapper that calls {@link output.write} followed by
-     * `process.exit(0)`. Use this as the final call in a successful bin command.
+     * When called with a `data` argument, serializes it to stdout via
+     * {@link output.write} before exiting. When called without arguments,
+     * exits immediately without writing to stdout — useful for commands
+     * that perform a side effect (e.g., opening a UI) with no return value.
      *
-     * @param data - The value to serialize as JSON and write to stdout
+     * @param data - Optional value to serialize as JSON and write to stdout
      *
      * @example
      * ```typescript
      * import { input, output } from "@hmcs/sdk/commands";
      *
+     * // With payload
      * const data = await input.parse(schema);
      * const result = await doWork(data);
      * output.succeed({ processed: result.count });
+     *
+     * // Without payload (side-effect only command)
+     * await openWebview();
+     * output.succeed();
      * ```
      */
     function succeed(data) {
-        write(data);
+        if (data !== undefined) {
+            write(data);
+        }
         process.exit(0);
     }
     output.succeed = succeed;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hmcs/sdk",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "TypeScript SDK for building mods and extensions for Desktop Homunculus",
   "author": "notelm",
   "license": "MIT",
@@ -36,20 +36,20 @@
   ],
   "dependencies": {
     "eventsource": "^4.1.0",
-    "zod": "^3.25.0"
+    "zod": "^3.25.76"
   },
   "devDependencies": {
-    "@eslint/js": "^9.39.2",
+    "@eslint/js": "^9.39.3",
     "@rollup/plugin-typescript": "^11.1.6",
-    "@types/node": "^20.19.33",
-    "eslint": "^9.39.2",
-    "rimraf": "^6.1.2",
-    "rollup": "^4.57.1",
+    "@types/node": "^20.19.35",
+    "eslint": "^9.39.3",
+    "rimraf": "^6.1.3",
+    "rollup": "^4.59.0",
     "rollup-plugin-dts": "^6.3.0",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.56.0",
-    "vitest": "^3.0.0"
+    "typescript-eslint": "^8.56.1",
+    "vitest": "^3.2.4"
   },
   "scripts": {
     "dev": "rollup -c --configPlugin typescript --watch",