sesame-kit 0.4.0 → 0.4.2

package/README.ja.md

@@ -2,6 +2,8 @@
 
 # sesame-kit — SESAME クラウド CLI & ライブラリ (非公式)
 
+[![npm](https://img.shields.io/npm/v/sesame-kit)](https://www.npmjs.com/package/sesame-kit) [![license](https://img.shields.io/npm/l/sesame-kit)](./LICENSE) [![node](https://img.shields.io/node/v/sesame-kit)](https://nodejs.org)
+
 > English: [README.md](./README.md)
 
 > **ステータス** — pre-1.0 でありバグが残っている可能性があります。実運用で概ね安定が確認できた時点で 1.0 にします。依存する場合はバージョンを固定してください。
@@ -36,14 +38,17 @@
 要件は Node.js 18 以上 (ESM / `node:` プロトコルを使用)。
 
 ```bash
-git clone https://github.com/FukumotoIkuma/sesame-kit.git
-cd sesame-kit
-npm install
-npm link        # グローバルに `sesame` コマンドを公開
-# あるいは: node bin/sesame.js ...
+npm install -g sesame-kit     # グローバル CLI: `sesame ...`
+npx sesame-kit --help         # インストールせず実行
+npm install sesame-kit        # プロジェクトにライブラリとして追加
 ```
 
-ライブラリとして使う場合は `npm link sesame-kit`、または `npm install /path/to/sesame-kit`。
+ソースから:
+
+```bash
+git clone https://github.com/FukumotoIkuma/sesame-kit.git
+cd sesame-kit && npm install && npm link
+```
 
 ---
 

package/README.md

@@ -2,6 +2,8 @@
 
 # sesame-kit — SESAME cloud CLI & library (unofficial)
 
+[![npm](https://img.shields.io/npm/v/sesame-kit)](https://www.npmjs.com/package/sesame-kit) [![license](https://img.shields.io/npm/l/sesame-kit)](./LICENSE) [![node](https://img.shields.io/node/v/sesame-kit)](https://nodejs.org)
+
 A Node.js CLI and library that drives the SESAME cloud WebSocket API using the same Cognito consumer client as the official SESAME iOS / Android apps. It covers lock control, Hub3 IR (emit and learn), device management, history, and battery level. With `sesame serve` it exposes every feature as JSON-RPC so you can drive SESAME from any language.
 
 > 日本語版: [README.ja.md](./README.ja.md)
@@ -36,14 +38,17 @@ A Node.js port of the official biz3 admin web app ([CANDY-HOUSE/biz.candyhouse.c
 Requires Node.js 18+ (uses ESM and the `node:` protocol).
 
 ```bash
-git clone https://github.com/FukumotoIkuma/sesame-kit.git
-cd sesame-kit
-npm install
-npm link        # expose the `sesame` command globally
-# or: node bin/sesame.js ...
+npm install -g sesame-kit     # global CLI: `sesame ...`
+npx sesame-kit --help         # or run without installing
+npm install sesame-kit        # or as a library in your project
 ```
 
-To use it as a library: `npm link sesame-kit`, or `npm install /path/to/sesame-kit`.
+From source:
+
+```bash
+git clone https://github.com/FukumotoIkuma/sesame-kit.git
+cd sesame-kit && npm install && npm link
+```
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sesame-kit",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "SESAME cloud CLI & library (lock control + Hub3 IR + device management). Node.js port of biz3 React app with the Cognito consumer client swapped in for long-lived sessions.",
   "author": "Ikuma Fukumoto",
   "license": "MIT",
@@ -85,7 +85,8 @@
     "build:rpc-schema": "node scripts/gen-rpc-schema.mjs",
     "build:grpc-proto": "node scripts/gen-grpc-proto.mjs",
     "build": "tsc -p tsconfig.json && node scripts/gen-rpc-schema.mjs && node scripts/gen-grpc-proto.mjs",
-    "prepack": "tsc -p tsconfig.json && node scripts/gen-rpc-schema.mjs && node scripts/gen-grpc-proto.mjs"
+    "prepack": "tsc -p tsconfig.json && node scripts/gen-rpc-schema.mjs && node scripts/gen-grpc-proto.mjs",
+    "release": "bash scripts/release.sh"
   },
   "dependencies": {
     "@aws-sdk/client-cognito-identity-provider": "^3.1057.0",

package/src/cli.js

@@ -1508,6 +1508,10 @@ export async function run(argv = process.argv) {
     .name("sesame")
     .description("SESAME cloud CLI: lock control + Hub3 IR + device management (port of biz3 React with Consumer Cognito client)")
     .version(getPkgVersion(), "-V, --version")
+    // 引数不足/未知オプション時に usage を出す (commander 既定はエラー1行のみで不親切)。
+    // この前に設定すると後で追加する全サブコマンドへ継承される。--json 時は writeErr 側で抑止。
+    .showHelpAfterError()
+    .showSuggestionAfterError()
     .option("--config-dir <path>", "設定ディレクトリ上書き (default: ~/.config/sesame-hub3)")
     .option("--debug", "詳細ログ")
     .option("--json", "JSON 出力");
@@ -1751,9 +1755,11 @@ devices だけで完結します (手入力は呼び名のみ):
     // BLE 権限/電源エラーは macOS なら該当設定ペインを自動で開いて誘導する。
     if (maybeHandleBleError(err)) { finishCli(); return; }
     const code = (typeof err.exitCode === "number" && err.exitCode !== 0) ? err.exitCode : 1;
-    // commander の usage エラーは非 JSON 時すでに stderr へ整形済み (usage 付き) なので二重出力を避ける。
-    if (typeof err.code === "string" && err.code.startsWith("commander.") && !CLI_JSON) {
-      process.exitCode = code; finishCli(); return;
+    // commander の usage エラー。非 JSON 時は commander が stderr に整形済み (usage 付き) なので二重出力を避ける。
+    if (typeof err.code === "string" && err.code.startsWith("commander.")) {
+      if (!CLI_JSON) { process.exitCode = code; finishCli(); return; }
+      // --json: commander のメッセージ先頭 "error: " を剥がして封筒に載せる (error が二重にならないように)。
+      die((err.message || "usage error").replace(/^error:\s*/i, ""), code); return;
     }
     die(withStaleHint(err.message || String(err)), code);
   }

package/src/session-ui.js

@@ -5,6 +5,9 @@
 // 状態が変わった瞬間に描き直す Ink (React for CLI) で実装する。BLE の mechStatus publish や
 // バックグラウンド接続の完了を `bus` の "update" イベントで受け、React state を更新して再描画する。
 //
+// 操作: ↑↓ 移動 / → か Enter で決定 / ← か Esc で戻る / q で終了。
+// アクション実行後はホームに戻らず、その操作メニューに留まる (続けて操作できる)。
+//
 // JSX は使わない (本リポは src を素の ESM で実行しビルド工程が無いため)。React.createElement = h。
 
 import React from "react";
@@ -43,6 +46,7 @@ export function SessionApp({ devices, hasCloud, bus, exec, actionsFor, fmtState,
   const [numVal, setNumVal] = React.useState("");      // autolock 秒数 / LED duty 入力
   const [selRemote, setSelRemote] = React.useState(null); // IR: 選択中リモコン
   const [irKeys, setIrKeys] = React.useState(null);    // IR: 取得したキー一覧 (null=未取得)
+  const [hi, setHi] = React.useState(null);            // → 決定用: ハイライト中の項目
 
   // BLE onStatus / 背景接続完了 → 再描画。
   React.useEffect(() => {
@@ -51,18 +55,82 @@ export function SessionApp({ devices, hasCloud, bus, exec, actionsFor, fmtState,
     return () => bus.off("update", on);
   }, [bus]);
 
+  // hi (→ 決定用ハイライト) は各 SelectInput の onHighlight が先頭項目で更新する。
+  // SelectInput を描画しない可能性のある mode (空の IR リスト) に入る時だけ明示的にクリアし、
+  // 前メニューの項目が残って → が誤爆しないようにする (下の selectAction / selectIrRemote 参照)。
+
   const backToActions = () => { setMode("actions"); };
 
-  // q / Esc。Esc は深い階層では1つ戻る、devices(or single の actions)では終了。
+  // ---- 各メニューの選択ハンドラ (SelectInput.onSelect と → 決定の両方から呼ぶ) ----
+  const selectDevice = (it) => {
+    if (!it) return;
+    if (it.value === "__quit") { exit(); return; }
+    setSelName(it.value); setMsg(""); setMode("actions");
+  };
+  const selectAction = (it) => {
+    if (!it) return;
+    if (it.value === "__back") { if (single) exit(); else { setMode("devices"); setMsg(""); } return; }
+    if (it.value === "autolock") { setNumVal(""); setMode("autolock"); return; }
+    if (it.value === "led") { setNumVal(""); setMode("led"); return; }
+    if (it.value === "ir") { setHi(null); setSelRemote(null); setIrKeys(null); setMode("ir-remote"); return; }
+    runExec(it.value, devices.get(selName));
+  };
+  const selectIrRemote = (it) => {
+    if (!it) return;
+    if (it.value === "__back") { backToActions(); return; }
+    setHi(null); setSelRemote(it.value); setIrKeys(null); setMode("ir-key");
+    Promise.resolve(listKeysFor ? listKeysFor(it.value) : []).then(setIrKeys).catch(() => setIrKeys([]));
+  };
+  const selectIrKey = (it) => {
+    if (!it) return;
+    if (it.value === "__back") { setMode("ir-remote"); return; }
+    runExec("ir", devices.get(selName), { remote: selRemote, key: it.value });
+  };
+
+  // ← / Esc で 1 つ戻る。Esc は最上位 (devices / single の actions) では終了する。
+  // ← は最上位では何もしない (誤操作で終了しないように)。
+  const goBack = (allowExitAtTop) => {
+    if (mode === "actions") {
+      if (single) { if (allowExitAtTop) exit(); }
+      else { setMode("devices"); setMsg(""); }
+    } else if (mode === "ir-key") setMode("ir-remote");
+    else if (mode === "devices") { if (allowExitAtTop) exit(); }
+    else backToActions(); // autolock / led / ir-remote
+  };
+
+  // 現在 mode のメニュー項目 (render と → 決定で共有。順序が両者で一致する)。
+  const menuItems = () => {
+    if (mode === "devices") return [...names.map((n) => ({ label: n, value: n })), { label: "終了", value: "__quit" }];
+    if (mode === "actions") return [...actionsFor(devices.get(selName)), { label: single ? "終了" : "← 戻る", value: "__back" }];
+    if (mode === "ir-remote") {
+      const r = hub3RemotesFor ? hub3RemotesFor(devices.get(selName)) : [];
+      return r.length ? [...r, { label: "← 戻る", value: "__back" }] : [];
+    }
+    if (mode === "ir-key") return (irKeys && irKeys.length) ? [...irKeys, { label: "← 戻る", value: "__back" }] : [];
+    return [];
+  };
+
+  // → で決定。ink-select-input の onHighlight は初期項目では発火しないため、移動前は hi=null。
+  // その場合は先頭 (= 既定でハイライトされている項目) にフォールバックする。
+  const goForward = () => {
+    const it = hi || menuItems()[0];
+    if (!it) return;
+    if (mode === "devices") selectDevice(it);
+    else if (mode === "actions") selectAction(it);
+    else if (mode === "ir-remote") selectIrRemote(it);
+    else if (mode === "ir-key") selectIrKey(it);
+  };
+
+  const isList = mode === "devices" || mode === "actions" || mode === "ir-remote" || mode === "ir-key";
+
   useInput((input, key) => {
     if (mode === "busy") return;
-    if (input === "q") { exit(); return; }
-    if (key.escape) {
-      if (mode === "actions") { if (single) exit(); else { setMode("devices"); setMsg(""); } }
-      else if (mode === "ir-key") { setMode("ir-remote"); }
-      else if (mode === "devices") exit();
-      else { backToActions(); } // autolock / led / ir-remote
-    }
+    // q は**メニュー系のみ**で終了。autolock/LED の数値入力中は文字として TextInput へ渡す。
+    if (input === "q" && isList) { exit(); return; }
+    if (key.escape) { goBack(true); return; }       // Esc: 戻る (最上位では終了)
+    // ← / → は数値入力 (autolock/led) ではテキストカーソル移動に使うので、リスト系のみで奪う。
+    if (isList && key.leftArrow) { goBack(false); return; }  // ←: 戻る (最上位では何もしない)
+    if (isList && key.rightArrow) { goForward(); return; }   // →: 決定
   });
 
   const runExec = (op, d, extra) => {
@@ -70,10 +138,10 @@ export function SessionApp({ devices, hasCloud, bus, exec, actionsFor, fmtState,
     exec(op, d, extra)
       .then((m) => setMsg(m))
       .catch((e) => setMsg(`error: ${e?.message || e}`))
-      .finally(() => setMode(single ? "actions" : "devices"));
+      .finally(() => setMode("actions")); // ホームに戻らず操作メニューに留まる (続けて操作できる)
   };
 
-  // ヘッダ: 全デバイスの現在状態 (ライブ)。
+  // ヘッダ: 全デバイスの現在状態 (ライブ) + 操作ヒント。
   const header = h(
     Box,
     { flexDirection: "column" },
@@ -85,6 +153,7 @@ export function SessionApp({ devices, hasCloud, bus, exec, actionsFor, fmtState,
       return h(Text, { key: n, color: d.ble ? "green" : undefined },
         `  ${n} [${label}·${tag}]: ${fmtState(d)}`);
     }),
+    h(Text, { dimColor: true }, "  ↑↓ 移動  → 決定  ← 戻る  q 終了"),
     msg ? h(Text, { color: "yellow" }, msg) : null,
   );
   const box = (...kids) => h(Box, { flexDirection: "column" }, header, ...kids);
@@ -116,66 +185,30 @@ export function SessionApp({ devices, hasCloud, bus, exec, actionsFor, fmtState,
     const d = devices.get(selName);
     const remotes = (hub3RemotesFor ? hub3RemotesFor(d) : []);
     if (remotes.length === 0) {
-      return box(h(Text, null, `${selName}: 登録リモコンがありません ( sesame remote add で登録 )。Esc で戻る`));
+      return box(h(Text, null, `${selName}: 登録リモコンがありません ( sesame remote add で登録 )。← / Esc で戻る`));
     }
-    const items = [...remotes, { label: "← 戻る", value: "__back" }];
     return box(h(Text, null, `${selName} の IR: リモコン選択`),
-      h(SelectInput, {
-        items,
-        onSelect: (it) => {
-          if (it.value === "__back") { backToActions(); return; }
-          setSelRemote(it.value); setIrKeys(null); setMode("ir-key");
-          Promise.resolve(listKeysFor ? listKeysFor(it.value) : []).then(setIrKeys).catch(() => setIrKeys([]));
-        },
-      }),
+      h(SelectInput, { items: menuItems(), onHighlight: setHi, onSelect: selectIrRemote }),
     );
   }
 
   // IR: キー選択 (非同期取得中はローディング表示)。
   if (mode === "ir-key") {
-    const d = devices.get(selName);
     if (irKeys === null) return box(h(Text, null, `${selRemote}: キー取得中...`));
-    if (irKeys.length === 0) return box(h(Text, null, `${selRemote}: キーがありません ( sesame remote sync-keys )。Esc で戻る`));
-    const items = [...irKeys, { label: "← 戻る", value: "__back" }];
+    if (irKeys.length === 0) return box(h(Text, null, `${selRemote}: キーがありません ( sesame remote sync-keys )。← / Esc で戻る`));
     return box(h(Text, null, `${selRemote} のキー選択 (送信)`),
-      h(SelectInput, {
-        items,
-        onSelect: (it) => {
-          if (it.value === "__back") { setMode("ir-remote"); return; }
-          runExec("ir", d, { remote: selRemote, key: it.value });
-        },
-      }),
+      h(SelectInput, { items: menuItems(), onHighlight: setHi, onSelect: selectIrKey }),
     );
   }
 
   if (mode === "actions") {
-    const d = devices.get(selName);
-    const items = [...actionsFor(d)];
-    items.push({ label: single ? "終了" : "← 戻る", value: "__back" });
     return box(h(Text, null, `${selName} の操作:`),
-      h(SelectInput, {
-        items,
-        onSelect: (it) => {
-          if (it.value === "__back") { if (single) exit(); else { setMode("devices"); setMsg(""); } return; }
-          if (it.value === "autolock") { setNumVal(""); setMode("autolock"); return; }
-          if (it.value === "led") { setNumVal(""); setMode("led"); return; }
-          if (it.value === "ir") { setSelRemote(null); setIrKeys(null); setMode("ir-remote"); return; }
-          runExec(it.value, d);
-        },
-      }),
+      h(SelectInput, { items: menuItems(), onHighlight: setHi, onSelect: selectAction }),
     );
   }
 
   // mode === "devices"
-  const items = names.map((n) => ({ label: n, value: n }));
-  items.push({ label: "終了", value: "__quit" });
   return box(h(Text, null, "操作するデバイス:"),
-    h(SelectInput, {
-      items,
-      onSelect: (it) => {
-        if (it.value === "__quit") { exit(); return; }
-        setSelName(it.value); setMsg(""); setMode("actions");
-      },
-    }),
+    h(SelectInput, { items: menuItems(), onHighlight: setHi, onSelect: selectDevice }),
   );
 }

package/types/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.js"],"names":[],"mappings":"AA+9CA,oDAiQC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.js"],"names":[],"mappings":"AA+9CA,oDAuQC"}

package/types/session-ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-ui.d.ts","sourceRoot":"","sources":["../src/session-ui.js"],"names":[],"mappings":"AAgBA;;;;;;;;;;GAUG;AACH,oCATW;IACN,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE;QAAC,KAAK,EAAC,MAAM,CAAC;QAAC,GAAG,EAAC,MAAM,GAAC,IAAI,CAAA;KAAC,CAAC,CAAC;IACtD,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,EAAE,OAAO,aAAa,EAAE,YAAY,CAAC;IACxC,IAAI,EAAE,CAAC,EAAE,EAAC,MAAM,EAAE,MAAM,EAAC,MAAM,EAAE,OAAO,CAAC,EAAC,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnE,UAAU,EAAE,CAAC,MAAM,EAAC,MAAM,KAAG,KAAK,CAAC;QAAC,KAAK,EAAC,MAAM,CAAC;QAAC,KAAK,EAAC,MAAM,CAAA;KAAC,CAAC,CAAC;IACjE,QAAQ,EAAE,CAAC,MAAM,EAAC,MAAM,KAAG,MAAM,CAAC;CACnC,iBAKH;AAED;;;;;;;;;QAoJC"}
+{"version":3,"file":"session-ui.d.ts","sourceRoot":"","sources":["../src/session-ui.js"],"names":[],"mappings":"AAmBA;;;;;;;;;;GAUG;AACH,oCATW;IACN,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE;QAAC,KAAK,EAAC,MAAM,CAAC;QAAC,GAAG,EAAC,MAAM,GAAC,IAAI,CAAA;KAAC,CAAC,CAAC;IACtD,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,EAAE,OAAO,aAAa,EAAE,YAAY,CAAC;IACxC,IAAI,EAAE,CAAC,EAAE,EAAC,MAAM,EAAE,MAAM,EAAC,MAAM,EAAE,OAAO,CAAC,EAAC,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnE,UAAU,EAAE,CAAC,MAAM,EAAC,MAAM,KAAG,KAAK,CAAC;QAAC,KAAK,EAAC,MAAM,CAAC;QAAC,KAAK,EAAC,MAAM,CAAA;KAAC,CAAC,CAAC;IACjE,QAAQ,EAAE,CAAC,MAAM,EAAC,MAAM,KAAG,MAAM,CAAC;CACnC,iBAKH;AAED;;;;;;;;;QAkLC"}