sesame-kit 0.4.0

package/types/presetir.d.ts

@@ -0,0 +1,286 @@
+/**
+ * エアコンの発射 command (HEX 文字列) を生成。
+ * biz3 buildCommand を再現 (remote-air/index.js:117-138, 呼び出しフロー extraLogic D)。
+ *
+ * 状態は buildAirCommand が buf[4..10] へ直接書き込むため、key 値は発射にほぼ影響しない
+ * (key は buf[9] に入るが、power は buf[8] が支配的)。keyType 未指定時は default 0x01。
+ *
+ * @param {{
+ *   code: number,            // remote.code (プリセット DB 由来の数値)
+ *   power?: boolean,         // 電源 ON/OFF (remote-air:126: power?0x01:0x00)
+ *   temperature?: number,    // UI 温度値 (16-32, 変換なしでそのまま)
+ *   mode?: number,           // mode index 0-4 (getModeValue で HXD 値に変換)
+ *   fanSpeed?: number,       // fanSpeed index 0-3
+ *   windDirection?: number,  // windDirection index 0-2
+ *   autoSwing?: boolean,     // 自動風向 (remote-air:131: autoSwing?0x01:0x00)
+ *   keyType?: string,        // getAirKey に渡す type (省略時 buf[9]=0x01)
+ * }} state
+ * @returns {string} 大文字 HEX command 文字列
+ */
+export function buildAirCommandHex(state: {
+    code: number;
+    power?: boolean;
+    temperature?: number;
+    mode?: number;
+    fanSpeed?: number;
+    windDirection?: number;
+    autoSwing?: boolean;
+    keyType?: string;
+}): string;
+/**
+ * 非エアコン (TV/ライト/扇風機) の発射 command (HEX 文字列) を生成。
+ * biz3 buildCommand を再現 (remote-non-air/index.js:113-124, 呼び出しフロー extraLogic D)。
+ *
+ * @param {{
+ *   irType: number,   // IR_TYPE.TV / LIGHT / FAN (getKeyByDeviceType に渡す)
+ *   code: number,     // remote.code
+ *   buttonType: string, // ボタン種別 (getTVKey/getLightKey/getFanKey の keyMap キー)
+ * }} p
+ * @returns {string} 大文字 HEX command 文字列
+ */
+export function buildNonAirCommandHex({ irType, code, buttonType }: {
+    irType: number;
+    code: number;
+    buttonType: string;
+}): string;
+/**
+ * 既に生成した HEX command をそのまま Hub3 に発射する。
+ * frame は learnIR 等の sendIR と完全共通 (useRemoteCtrl.js:460-484)。
+ *
+ * フィールド名トラップ:
+ *   - deviceId    : Hub3 の deviceUUID 文字列 (hub3DeviceId ではなく **deviceId**)
+ *   - irDeviceUUID: 保存済みリモコンの uuid。未保存プリセットでは **空文字 ''**
+ *                   (remote-air:369 / remote-non-air:155 で remote.uuid || '')
+ *
+ * 応答: action:'biz3IRRemote', op:'sendIR', success:bool, message?, data?
+ *   (handleRemoteResponse:65-80 は op==='sendIR' && success で成功扱い)
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{
+ *   deviceId: string,        // Hub3 deviceUUID
+ *   command: string,         // HEX command (buildAir/NonAirCommandHex の戻り値)
+ *   irType: number,          // remote.type 実値 (IR_TYPE)
+ *   companyID: string,       // gStripe.customerInfo.companyID
+ *   irDeviceUUID?: string,   // remote.uuid (未保存は '')
+ *   operation?: string,      // 既定 'remoteEmit'
+ *   timeoutMs?: number,
+ * }} p
+ * @returns {Promise<object>} 応答メッセージ (success / data / message)
+ */
+export function sendIR(client: import("./transport.js").Hub3WsClient, p: {
+    deviceId: string;
+    command: string;
+    irType: number;
+    companyID: string;
+    irDeviceUUID?: string;
+    operation?: string;
+    timeoutMs?: number;
+}): Promise<object>;
+/**
+ * エアコン: 状態から command を生成してそのまま発射する複合関数。
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{
+ *   deviceId: string, companyID: string, code: number,
+ *   irDeviceUUID?: string, timeoutMs?: number,
+ *   power?: boolean, temperature?: number, mode?: number,
+ *   fanSpeed?: number, windDirection?: number, autoSwing?: boolean, keyType?: string,
+ * }} p
+ * @returns {Promise<{command:string, response:object}>}
+ */
+export function emitAir(client: import("./transport.js").Hub3WsClient, p: {
+    deviceId: string;
+    companyID: string;
+    code: number;
+    irDeviceUUID?: string;
+    timeoutMs?: number;
+    power?: boolean;
+    temperature?: number;
+    mode?: number;
+    fanSpeed?: number;
+    windDirection?: number;
+    autoSwing?: boolean;
+    keyType?: string;
+}): Promise<{
+    command: string;
+    response: object;
+}>;
+/**
+ * 非エアコン (TV/ライト/扇風機): ボタン押下を生成して発射する複合関数。
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{
+ *   deviceId: string, companyID: string, code: number,
+ *   irType: number, buttonType: string,
+ *   irDeviceUUID?: string, timeoutMs?: number,
+ * }} p
+ * @returns {Promise<{command:string, response:object}>}
+ */
+export function emitButton(client: import("./transport.js").Hub3WsClient, p: {
+    deviceId: string;
+    companyID: string;
+    code: number;
+    irType: number;
+    buttonType: string;
+    irDeviceUUID?: string;
+    timeoutMs?: number;
+}): Promise<{
+    command: string;
+    response: object;
+}>;
+/**
+ * irType (remote.type) の確定値。
+ * 一次資料: presetIR.json extraLogic C / HXDParametersSwapper.getKeyByDeviceType:166-180。
+ * @readonly
+ */
+export const IR_TYPE: Readonly<{
+    AIR: 49152;
+    FAN: 32768;
+    LIGHT: 57344;
+    TV: 8192;
+}>;
+/**
+ * HXD プリセット command の組み立て器。
+ * biz3 HXDCommandProcessor.js を 1:1 移植 (constructor 既定値・byte 配置・checksum 完全一致)。
+ */
+export class HXDCommandProcessor {
+    power: number;
+    temperature: number;
+    fanSpeed: number;
+    windDirection: number;
+    autoWindDirection: number;
+    mode: number;
+    key: number;
+    code: number;
+    defaultTable: number[];
+    AirPrefixCode: number[];
+    commonPrefixCode: number[];
+    /**
+     * エアコン command (16 byte) を生成。
+     * vendor: HXDCommandProcessor.js:17-34。
+     * 配置: [0x30,0x01, codeHi,codeLo, temp,fanSpeed,windDir,autoWind,power,key,mode, 1,0,0, 0xff, checksum]
+     * @returns {number[]} 16 byte の配列
+     */
+    buildAirCommand(): number[];
+    /**
+     * 非エアコン (TV/ライト/扇風機) command (16 byte) を生成。
+     * vendor: HXDCommandProcessor.js:36-47。
+     * 配置: [0x30,0x00, codeHi,codeLo, 0,0,0,0,0, key, 0, 1,0,0, 0xff, checksum]
+     * @returns {number[]} 16 byte の配列
+     */
+    buildNonAirCommand(): number[];
+    /**
+     * command の骨格 (16 byte) を生成。Air/NonAir 共通。
+     * vendor: HXDCommandProcessor.js:49-71。
+     * @param {number[]} prefixCodeArray 2 byte prefix ([0x30,0x01] か [0x30,0x00])
+     * @param {number} code  remote.code (16bit, ビッグエンディアンで 2 byte に分割)
+     * @param {number[]} table  既定 [0,0,0] (table[0]+1 が buf[11] に入る)
+     * @returns {number[]} 16 byte
+     */
+    buildKeyData(prefixCodeArray: number[], code: number, table: number[]): number[];
+    /**
+     * 数値を 16bit ビッグエンディアンの 2 byte に分割。
+     * vendor: HXDCommandProcessor.js:73-77。
+     * @param {number} number
+     * @returns {[number, number]} [上位 byte, 下位 byte]
+     */
+    decimalToTwoHexInts(number: number): [number, number];
+    /**
+     * byte 配列を大文字 HEX 文字列に変換 (区切り無し・各 byte 2 桁 0 埋め)。
+     * これが sendIR の command フィールドに入る文字列。
+     * vendor: HXDCommandProcessor.js:132-134。
+     * @param {number[]} byteArray
+     * @returns {string} 例 "30010000..."
+     */
+    toHexString(byteArray: number[]): string;
+    /**
+     * HEX 文字列を byte 配列に戻す。
+     * vendor: HXDCommandProcessor.js:124-130。
+     * @param {string} hexString
+     * @returns {number[]}
+     */
+    hexStringToByteArray(hexString: string): number[];
+    /**
+     * 保存済みエアコン command HEX から状態を復元 (発射には不要・state 復元用)。
+     * vendor: HXDCommandProcessor.js:84-117。
+     * 前提: length>=22, bytes[0]===0x30 && bytes[1]===0x01。不正時は null。
+     * @param {string} hexString
+     * @returns {{temperature:number,fanSpeed:number,windDirection:number,autoWindDirection:number,power:number,key:number,mode:number}|null}
+     */
+    parseAirCommand(hexString: string): {
+        temperature: number;
+        fanSpeed: number;
+        windDirection: number;
+        autoWindDirection: number;
+        power: number;
+        key: number;
+        mode: number;
+    } | null;
+    setPower(power: any): this;
+    setTemperature(temperature: any): this;
+    setModel(model: any): this;
+    setFanSpeed(fanSpeed: any): this;
+    setWindDirection(windDirection: any): this;
+    setAutoWindDirection(autoWindDirection: any): this;
+    setKey(key: any): this;
+    setCode(code: any): this;
+}
+/**
+ * HXD パラメータ変換器。biz3 HXDParametersSwapper.js を 1:1 移植。
+ * key テーブルは vendor の値・default フォールバックまで完全一致させている。
+ */
+export class HXDParametersSwapper {
+    /**
+     * エアコン key (HXDParametersSwapper.js:4-17)。
+     * 注: UI type 'POWER_ON'/'TEMP_ADD' 等は keyMap に無く default 0x01 (ファイル冒頭トラップ参照)。
+     * @param {string} type
+     * @returns {number}
+     */
+    getAirKey(type: string): number;
+    /**
+     * mode index → HXD 値 (vendor:45-54)。{0:自動,1:制冷,2:除湿,3:送風,4:制熱}
+     * @param {number} index @returns {number}
+     */
+    getModeValue(index: number): number;
+    /**
+     * fanSpeed index → HXD 値 (vendor:67-75)。{0:自動,1:低,2:中,3:高}
+     * @param {number} index @returns {number}
+     */
+    getFanSpeedValue(index: number): number;
+    /**
+     * windDirection index → HXD 値 (vendor:87-94)。{0:上,1:中,2:下}。default 0x02。
+     * @param {number} index @returns {number}
+     */
+    getWindDirectionValue(index: number): number;
+    /**
+     * ライト key (vendor:114-125)。
+     * @param {string} type @returns {number}
+     */
+    getLightKey(type: string): number;
+    /**
+     * TV key (vendor:128-147)。
+     * @param {string} type @returns {number}
+     */
+    getTVKey(type: string): number;
+    /**
+     * 扇風機 key (vendor:150-162)。
+     * @param {string} type @returns {number}
+     */
+    getFanKey(type: string): number;
+    /**
+     * device type (irType) 別に key を引く (非エアコン UI 経由)。
+     * vendor: HXDParametersSwapper.js:166-180。
+     * 未知 type は warn を出さず default 0x01 (CLI なので console.warn は省略)。
+     * @param {number} irType  IR_TYPE のいずれか
+     * @param {string} type    ボタン種別文字列
+     * @returns {number}
+     */
+    getKeyByDeviceType(irType: number, type: string): number;
+}
+/**
+ * namespace (hub.presetir.*) に露出する client op の allowlist。
+ * HXDCommandProcessor / HXDParametersSwapper (class) と buildAirCommandHex /
+ * buildNonAirCommandHex (client を取らない純ビルダ) は namespace に出さない
+ * (client.js _bindNs が ws を第1引数に注入して壊れるため)。これらは低レベル
+ * ユーティリティとして index.js の presetir namespace から直接 import して使う。
+ */
+export const NAMESPACE_OPS: string[];
+//# sourceMappingURL=presetir.d.ts.map

package/types/presetir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presetir.d.ts","sourceRoot":"","sources":["../src/presetir.js"],"names":[],"mappings":"AAyWA;;;;;;;;;;;;;;;;;;GAkBG;AACH,0CAZW;IACN,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACS,MAAM,CAiBlB;AAED;;;;;;;;;;GAUG;AACH,oEAPW;IACN,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB,GACS,MAAM,CAQlB;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,+BAZW,OAAO,gBAAgB,EAAE,YAAY,KACrC;IACN,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACS,OAAO,CAAC,MAAM,CAAC,CAsB3B;AAED;;;;;;;;;;GAUG;AACH,gCATW,OAAO,gBAAgB,EAAE,YAAY,KACrC;IACN,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC1C,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClF,GACS,OAAO,CAAC;IAAC,OAAO,EAAC,MAAM,CAAC;IAAC,QAAQ,EAAC,MAAM,CAAA;CAAC,CAAC,CAatD;AAED;;;;;;;;;GASG;AACH,mCARW,OAAO,gBAAgB,EAAE,YAAY,KACrC;IACN,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAClD,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC3C,GACS,OAAO,CAAC;IAAC,OAAO,EAAC,MAAM,CAAC;IAAC,QAAQ,EAAC,MAAM,CAAA;CAAC,CAAC,CAiBtD;AA7dD;;;;GAIG;AACH;;;;;GAKG;AAOH;;;GAGG;AACH;IAGI,cAAiB;IACjB,oBAAqB;IACrB,iBAAoB;IACpB,sBAAyB;IACzB,0BAA6B;IAC7B,aAAgB;IAChB,YAAe;IACf,aAAgB;IAChB,uBAA6B;IAC7B,wBAAiC;IACjC,2BAAoC;IAGtC;;;;;OAKG;IACH,mBAFa,MAAM,EAAE,CAiBpB;IAED;;;;;OAKG;IACH,sBAFa,MAAM,EAAE,CAUpB;IAED;;;;;;;OAOG;IACH,8BALW,MAAM,EAAE,QACR,MAAM,SACN,MAAM,EAAE,GACN,MAAM,EAAE,CAwBpB;IAED;;;;;OAKG;IACH,4BAHW,MAAM,GACJ,CAAC,MAAM,EAAE,MAAM,CAAC,CAM5B;IAED;;;;;;OAMG;IACH,uBAHW,MAAM,EAAE,GACN,MAAM,CAIlB;IAED;;;;;OAKG;IACH,gCAHW,MAAM,GACJ,MAAM,EAAE,CAQpB;IAED;;;;;;OAMG;IACH,2BAHW,MAAM,GACJ;QAAC,WAAW,EAAC,MAAM,CAAC;QAAA,QAAQ,EAAC,MAAM,CAAC;QAAA,aAAa,EAAC,MAAM,CAAC;QAAA,iBAAiB,EAAC,MAAM,CAAC;QAAA,KAAK,EAAC,MAAM,CAAC;QAAA,GAAG,EAAC,MAAM,CAAC;QAAA,IAAI,EAAC,MAAM,CAAA;KAAC,GAAC,IAAI,CAevI;IAGD,2BAAoD;IACpD,uCAA4E;IAC5E,2BAAmD;IACnD,iCAAgE;IAChE,2CAAoF;IACpF,mDAAoG;IACpG,uBAA4C;IAC5C,yBAAgD;CACjD;AAOD;;;GAGG;AACH;IACE;;;;;OAKG;IACH,gBAHW,MAAM,GACJ,MAAM,CAclB;IAED;;;OAGG;IACH,oBAFW,MAAM,GAAkB,MAAM,CAKxC;IAED;;;OAGG;IACH,wBAFW,MAAM,GAAkB,MAAM,CAKxC;IAED;;;OAGG;IACH,6BAFW,MAAM,GAAkB,MAAM,CAKxC;IAED;;;OAGG;IACH,kBAFW,MAAM,GAAiB,MAAM,CAavC;IAED;;;OAGG;IACH,eAFW,MAAM,GAAiB,MAAM,CAqBvC;IAED;;;OAGG;IACH,gBAFW,MAAM,GAAiB,MAAM,CAcvC;IAED;;;;;;;OAOG;IACH,2BAJW,MAAM,QACN,MAAM,GACJ,MAAM,CAelB;CACF;AAkKD;;;;;;GAMG;AACH,qCAAiE"}

package/types/prompts.d.ts

@@ -0,0 +1,39 @@
+export function isInteractive(): boolean;
+/**
+ * テキスト入力 prompt。空 OK なら required=false で。
+ * @param {string} message
+ * @param {{required?:boolean, defaultValue?:string|null}} [opts]
+ */
+export function promptText(message: string, { required, defaultValue }?: {
+    required?: boolean;
+    defaultValue?: string | null;
+}): Promise<string>;
+/**
+ * yes/no 確認。デフォルトは defaultYes。
+ * @param {string} message
+ * @param {{defaultYes?:boolean}} [opts]
+ */
+export function confirm(message: string, { defaultYes }?: {
+    defaultYes?: boolean;
+}): Promise<boolean>;
+/**
+ * リストから 1 つ選ばせる (↑↓ で移動 / Enter で決定)。要素 1 個なら auto-pick。空ならエラー。
+ *
+ * @template T
+ * @param {string} message
+ * @param {T[]} items
+ * @param {(item:T) => string} [getLabel]  表示ラベル (default: String)
+ * @returns {Promise<T>}
+ */
+export function selectFromList<T>(message: string, items: T[], getLabel?: (item: T) => string): Promise<T>;
+/**
+ * メニュー (selectFromList の薄いラッパ、ラベルだけ表示)。戻り値は選ばれたエントリの `value`。
+ *
+ * @param {string} title
+ * @param {{label:string, value:any}[]} entries
+ */
+export function menu(title: string, entries: {
+    label: string;
+    value: any;
+}[]): Promise<any>;
+//# sourceMappingURL=prompts.d.ts.map

package/types/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.js"],"names":[],"mappings":"AAUA,yCAEC;AAOD;;;;GAIG;AACH,oCAHW,MAAM,+BACN;IAAC,QAAQ,CAAC,EAAC,OAAO,CAAC;IAAC,YAAY,CAAC,EAAC,MAAM,GAAC,IAAI,CAAA;CAAC,mBAQxD;AAED;;;;GAIG;AACH,iCAHW,MAAM,mBACN;IAAC,UAAU,CAAC,EAAC,OAAO,CAAA;CAAC,oBAI/B;AAED;;;;;;;;GAQG;AACH,+BANa,CAAC,WACH,MAAM,SACN,CAAC,EAAE,aACH,CAAC,IAAI,EAAC,CAAC,KAAK,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CActB;AAED;;;;;GAKG;AACH,4BAHW,MAAM,WACN;IAAC,KAAK,EAAC,MAAM,CAAC;IAAC,KAAK,EAAC,GAAG,CAAA;CAAC,EAAE,gBAKrC"}

package/types/schedule.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @typedef {Object} ScheduleItem
+ * @property {string} scheduleId  取消に使う ID (schedule-list/index.js:49,82,102)
+ * @property {string} action      'lock' | 'unlock' | 'upgrade_firmware' 等
+ *                                 (schedule-list/index.js:77 / UI ラベルは正規化された表示用で
+ *                                  サーバ側の正式 enum は未確認)
+ * @property {string} displayTime '2026-01-01 09:00' または 'HH:MM' 形式 (index.js:78,31)
+ * @property {string} deviceName  対象デバイス名 (index.js:92)
+ */
+/**
+ * サーバに登録済みの予約スケジュール一覧を取得する。
+ *
+ * フレーム: { action: "biz3Schedule", userId: <subUUID>, op: "getScheduleList" }
+ * 応答:     { action: "biz3Schedule", op: "getScheduleList", data: [ ScheduleItem, ... ] }
+ *           message.data は **オブジェクトでラップされず直接配列** (useManageSchedule.js:34-35
+ *           が count=data.length / Items=data に自前で詰め替えている点に注意)。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{subUUID:string, timeoutMs?:number}} params
+ *   subUUID は gStripe.customerInfo.subUUID 相当 (生の文字列をそのまま userId に入れる)
+ * @returns {Promise<ScheduleItem[]>} スケジュール item の配列 (空なら [])
+ */
+export function getScheduleList(client: import("./transport.js").Hub3WsClient, { subUUID, timeoutMs }?: {
+    subUUID: string;
+    timeoutMs?: number;
+}): Promise<ScheduleItem[]>;
+/**
+ * 予約スケジュールを 1 件取消す。
+ *
+ * フレーム: { action: "biz3Schedule", userId: <subUUID>, scheduleId: <scheduleId>, op: "cancelSchedule" }
+ *           (フィールド順は原典 useManageSchedule.js:54-59 のリテラル順)
+ * 応答:     { action: "biz3Schedule", op: "cancelSchedule", ... }
+ *
+ * 未確認: cancelSchedule 応答 data の具体構造は web コードからは判別不可。biz3 hook の switch
+ * には cancelSchedule ケースが無く (useManageSchedule.js:31-41 は getScheduleList のみ)、
+ * 完了は registerCallback の cb 受信 (= ack) でしか確認していない。UI は楽観的に isCancelling
+ * フラグを立てるだけ (schedule-list/index.js:47-51)。よって本実装は **ack 受信=成功** とみなし、
+ * resp.success が明示的に false の場合のみ throw する。成功フラグ等の data 形は実機検証要。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{subUUID:string, scheduleId:string, timeoutMs?:number}} params
+ *   scheduleId は getScheduleList で得た item.scheduleId をそのまま渡す。
+ * @returns {Promise<any>} サーバ応答 (ack)。data の構造は未確認のため raw を返す。
+ */
+export function cancelSchedule(client: import("./transport.js").Hub3WsClient, { subUUID, scheduleId, timeoutMs }?: {
+    subUUID: string;
+    scheduleId: string;
+    timeoutMs?: number;
+}): Promise<any>;
+export const NAMESPACE_OPS: string[];
+export type ScheduleItem = {
+    /**
+     * 取消に使う ID (schedule-list/index.js:49,82,102)
+     */
+    scheduleId: string;
+    /**
+     * 'lock' | 'unlock' | 'upgrade_firmware' 等
+     *  (schedule-list/index.js:77 / UI ラベルは正規化された表示用で
+     *   サーバ側の正式 enum は未確認)
+     */
+    action: string;
+    /**
+     * '2026-01-01 09:00' または 'HH:MM' 形式 (index.js:78,31)
+     */
+    displayTime: string;
+    /**
+     * 対象デバイス名 (index.js:92)
+     */
+    deviceName: string;
+};
+//# sourceMappingURL=schedule.d.ts.map

package/types/schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../src/schedule.js"],"names":[],"mappings":"AA6BA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;GAYG;AACH,wCALW,OAAO,gBAAgB,EAAE,YAAY,2BACrC;IAAC,OAAO,EAAC,MAAM,CAAC;IAAC,SAAS,CAAC,EAAC,MAAM,CAAA;CAAC,GAEjC,OAAO,CAAC,YAAY,EAAE,CAAC,CAkBnC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,uCALW,OAAO,gBAAgB,EAAE,YAAY,uCACrC;IAAC,OAAO,EAAC,MAAM,CAAC;IAAC,UAAU,EAAC,MAAM,CAAC;IAAC,SAAS,CAAC,EAAC,MAAM,CAAA;CAAC,GAEpD,OAAO,CAAC,GAAG,CAAC,CAkBxB;AAGD,qCAAmE;;;;;gBA5ErD,MAAM;;;;;;YACN,MAAM;;;;iBAGN,MAAM;;;;gBACN,MAAM"}

package/types/serve/daemon.d.ts

@@ -0,0 +1,133 @@
+export class Daemon {
+    /**
+     * @param {{ hub: object, version?: string, debug?: boolean }} args
+     *   hub は SesameHub3 (テストでは狭いインターフェースの fake)。
+     */
+    constructor({ hub, version, debug }: {
+        hub: object;
+        version?: string;
+        debug?: boolean;
+    });
+    hub: any;
+    version: string;
+    _debug: boolean;
+    authState: string;
+    _registry: Map<string, {
+        summary: string;
+        params: any[];
+        result: string;
+        handler: Function;
+        namespace?: string;
+    }>;
+    _openrpc: {
+        openrpc: string;
+        info: {
+            title: string;
+            version: any;
+            "x-contractVersion": string;
+            description: string;
+        };
+        methods: {
+            name: any;
+            summary: any;
+            params: any;
+            result: {
+                name: string;
+                schema: {
+                    description: any;
+                    type: string;
+                };
+            };
+        }[];
+        "x-events": {
+            name: string;
+            description: string;
+        }[];
+    };
+    /** @type {Map<string, Promise<any>>} メソッド名→直列化チェーン末尾 */
+    _locks: Map<string, Promise<any>>;
+    /** @type {Map<object, Set<string>>} Connection→購読 topic */
+    _subs: Map<object, Set<string>>;
+    /** hub 状態 push の単一購読の unsubscribe (張っている時のみ非 null) */
+    _stateUnsub: any;
+    _stopped: boolean;
+    _shuttingDown: boolean;
+    _retryTimer: NodeJS.Timeout;
+    _log(...a: any[]): void;
+    start(): void;
+    _connectLoop(): Promise<void>;
+    _hasStoredTokens(): boolean;
+    /** キャンセル可能な sleep。shutdown 時に即 resolve してループを抜けさせる。 */
+    _sleep(ms: any): Promise<any>;
+    _retryResolve: (value: any) => void;
+    addConnection(conn: any): void;
+    removeConnection(conn: any): void;
+    /** 1 メッセージを処理して応答オブジェクト (通知なら null) を返す。push はしない (HTTP POST 用)。 */
+    dispatchMessage(conn: any, raw: any): Promise<any>;
+    /** framing から: 1 行を処理し、応答があれば conn.send で push する。throw しない。 */
+    handleLine(conn: any, raw: any): Promise<void>;
+    /** メソッド実行。registry 解決 + rpc.discover + メソッド名単位の直列化。常に Promise を返す。 */
+    invoke(method: any, params: any, conn: any): Promise<any>;
+    /**
+     * 同名メソッドを直列化する。これは応答入替の主防御ではなく (request() ベースの op は
+     * transport の (action:op) FIFO が保証する) **listDevices 等 onMessage 先着 resolve で
+     * 解決する op** を、複数クライアント同時呼び出しから守る防御。同名 op を 1 並行に絞る。
+     */
+    _serialize(key: any, run: any): Promise<any>;
+    subscribe(conn: any, topics: any): {
+        subscribed: string[];
+    };
+    unsubscribe(conn: any, topics: any): {
+        subscribed: string[];
+    };
+    _anySubscribers(): boolean;
+    /** 状態 push の単一購読を (必要なら) 張る。hub 未接続なら接続時に再試行。 */
+    _ensureStateSub(): void;
+    _reestablishStateSub(): void;
+    _maybeTeardownStateSub(): void;
+    /**
+     * 状態 push を購読 Connection へ配信する。
+     * 注: lockState と deviceUpdate は現状どちらも biz3 の pubDeviceStateChange を源とする
+     * (同一ストリームの別ラベル)。両方購読している接続には **1 回だけ** 配信する
+     * (最初に購読している topic のラベルで) — 同一イベントの二重配信を避ける。
+     */
+    _fanout(msg: any): void;
+    /** 冪等。受付停止 → hub.close()(=_pendingCleanups 実行) → 解決。 */
+    shutdown(): Promise<void>;
+    /** 購読可能な topic 一覧 (framing が事前検証に使う)。 */
+    get topics(): string[];
+    /** テスト/イントロスペクション用。 */
+    get registry(): Map<string, {
+        summary: string;
+        params: any[];
+        result: string;
+        handler: Function;
+        namespace?: string;
+    }>;
+    get openrpc(): {
+        openrpc: string;
+        info: {
+            title: string;
+            version: any;
+            "x-contractVersion": string;
+            description: string;
+        };
+        methods: {
+            name: any;
+            summary: any;
+            params: any;
+            result: {
+                name: string;
+                schema: {
+                    description: any;
+                    type: string;
+                };
+            };
+        }[];
+        "x-events": {
+            name: string;
+            description: string;
+        }[];
+    };
+}
+//# sourceMappingURL=daemon.d.ts.map

package/types/serve/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../src/serve/daemon.js"],"names":[],"mappings":"AAgCA;IACE;;;OAGG;IACH,qCAHW;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAoB5D;IAfC,SAAc;IACd,gBAAsB;IACtB,gBAAmB;IACnB,kBAA2B;IAC3B;;;;;;OAAgC;IAChC;;;;;;;;;;;;;;;;;;;;;;;;MAAwD;IACxD,wDAAwD;IACxD,QADW,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CACb;IACvB,2DAA2D;IAC3D,OADW,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CACb;IACtB,sDAAsD;IACtD,iBAAuB;IACvB,kBAAqB;IACrB,uBAA0B;IAC1B,4BAAuB;IAGzB,wBAA+D;IAG/D,cAMC;IAED,8BAoBC;IAED,4BAKC;IAED,uDAAuD;IACvD,8BAKC;IAHG,oCAA4B;IAMhC,+BAAwD;IAExD,kCAGC;IAGD,oEAAoE;IACpE,mDAEC;IAED,gEAAgE;IAChE,+CAKC;IAED,sEAAsE;IACtE,0DAqBC;IAED;;;;OAIG;IACH,6CAQC;IAGD;;MAMC;IAED;;MAMC;IAED,2BAGC;IAED,iDAAiD;IACjD,wBAWC;IAED,6BAMC;IAED,+BAMC;IAED;;;;;OAKG;IACH,wBAOC;IAGD,wDAAwD;IACxD,0BAQC;IAED,yCAAyC;IACzC,uBAA+B;IAE/B,uBAAuB;IACvB;;;;;;OAAyC;IACzC;;;;;;;;;;;;;;;;;;;;;;;;MAAuC;CACxC"}

package/types/serve/framing/grpc.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @param {import("../daemon.js").Daemon} daemon
+ * @param {{ bind?:string, port:number, token:string }} opts
+ * @returns {Promise<{ port:number, stop:()=>Promise<void> }>}
+ */
+export function startGrpcFraming(daemon: import("../daemon.js").Daemon, { bind, port, token }: {
+    bind?: string;
+    port: number;
+    token: string;
+}): Promise<{
+    port: number;
+    stop: () => Promise<void>;
+}>;
+//# sourceMappingURL=grpc.d.ts.map

package/types/serve/framing/grpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpc.d.ts","sourceRoot":"","sources":["../../../src/serve/framing/grpc.js"],"names":[],"mappings":"AA4CA;;;;GAIG;AACH,yCAJW,OAAO,cAAc,EAAE,MAAM,yBAC7B;IAAE,IAAI,CAAC,EAAC,MAAM,CAAC;IAAC,IAAI,EAAC,MAAM,CAAC;IAAC,KAAK,EAAC,MAAM,CAAA;CAAE,GACzC,OAAO,CAAC;IAAE,IAAI,EAAC,MAAM,CAAC;IAAC,IAAI,EAAC,MAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAiG5D"}

package/types/serve/framing/http.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @param {import("../daemon.js").Daemon} daemon
+ * @param {{ bind?:string, port:number, token:string }} opts
+ * @returns {Promise<{ url:string, stop:()=>Promise<void> }>}
+ */
+export function startHttpFraming(daemon: import("../daemon.js").Daemon, { bind, port, token }: {
+    bind?: string;
+    port: number;
+    token: string;
+}): Promise<{
+    url: string;
+    stop: () => Promise<void>;
+}>;
+//# sourceMappingURL=http.d.ts.map

package/types/serve/framing/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/serve/framing/http.js"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,yCAJW,OAAO,cAAc,EAAE,MAAM,yBAC7B;IAAE,IAAI,CAAC,EAAC,MAAM,CAAC;IAAC,IAAI,EAAC,MAAM,CAAC;IAAC,KAAK,EAAC,MAAM,CAAA;CAAE,GACzC,OAAO,CAAC;IAAE,GAAG,EAAC,MAAM,CAAC;IAAC,IAAI,EAAC,MAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAiI3D"}

package/types/serve/framing/ndjson.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @param {import("node:stream").Readable} readable
+ * @param {import("node:stream").Writable} writable
+ * @param {{ onLine:(conn:object, raw:string)=>void, onClose?:()=>void,
+ *           maxQueue?:number, maxLine?:number, closeWritable?:boolean }} opts
+ * @returns {{ id:string, send:(obj:object)=>void, close:()=>void }}
+ */
+export function makeLineConnection(readable: import("node:stream").Readable, writable: import("node:stream").Writable, opts: {
+    onLine: (conn: object, raw: string) => void;
+    onClose?: () => void;
+    maxQueue?: number;
+    maxLine?: number;
+    closeWritable?: boolean;
+}): {
+    id: string;
+    send: (obj: object) => void;
+    close: () => void;
+};
+//# sourceMappingURL=ndjson.d.ts.map

package/types/serve/framing/ndjson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ndjson.d.ts","sourceRoot":"","sources":["../../../src/serve/framing/ndjson.js"],"names":[],"mappings":"AAYA;;;;;;GAMG;AACH,6CANW,OAAO,aAAa,EAAE,QAAQ,YAC9B,OAAO,aAAa,EAAE,QAAQ,QAC9B;IAAE,MAAM,EAAC,CAAC,IAAI,EAAC,MAAM,EAAE,GAAG,EAAC,MAAM,KAAG,IAAI,CAAC;IAAC,OAAO,CAAC,EAAC,MAAI,IAAI,CAAC;IAC1D,QAAQ,CAAC,EAAC,MAAM,CAAC;IAAC,OAAO,CAAC,EAAC,MAAM,CAAC;IAAC,aAAa,CAAC,EAAC,OAAO,CAAA;CAAE,GAC3D;IAAE,EAAE,EAAC,MAAM,CAAC;IAAC,IAAI,EAAC,CAAC,GAAG,EAAC,MAAM,KAAG,IAAI,CAAC;IAAC,KAAK,EAAC,MAAI,IAAI,CAAA;CAAE,CAyDlE"}

package/types/serve/framing/socket.d.ts

@@ -0,0 +1,14 @@
+/** 既存ソケットが生きてれば throw、stale なら unlink して継続。 */
+export function ensureFreeSocket(socketPath: any): Promise<any>;
+/**
+ * @param {import("../daemon.js").Daemon} daemon
+ * @param {{ socketPath:string }} opts
+ * @returns {Promise<{ path:string, stop:()=>Promise<void> }>}
+ */
+export function startSocketFraming(daemon: import("../daemon.js").Daemon, { socketPath }: {
+    socketPath: string;
+}): Promise<{
+    path: string;
+    stop: () => Promise<void>;
+}>;
+//# sourceMappingURL=socket.d.ts.map

package/types/serve/framing/socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../../src/serve/framing/socket.js"],"names":[],"mappings":"AAYA,+CAA+C;AAC/C,gEAcC;AAED;;;;GAIG;AACH,2CAJW,OAAO,cAAc,EAAE,MAAM,kBAC7B;IAAE,UAAU,EAAC,MAAM,CAAA;CAAE,GACnB,OAAO,CAAC;IAAE,IAAI,EAAC,MAAM,CAAC;IAAC,IAAI,EAAC,MAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAwC5D"}

package/types/serve/framing/stdio.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @param {import("../daemon.js").Daemon} daemon
+ * @param {{ onShutdown?:()=>void }} [opts]
+ * @returns {{ stop:()=>void }}
+ */
+export function startStdioFraming(daemon: import("../daemon.js").Daemon, { onShutdown }?: {
+    onShutdown?: () => void;
+}): {
+    stop: () => void;
+};
+//# sourceMappingURL=stdio.d.ts.map

package/types/serve/framing/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../../src/serve/framing/stdio.js"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,0CAJW,OAAO,cAAc,EAAE,MAAM,mBAC7B;IAAE,UAAU,CAAC,EAAC,MAAI,IAAI,CAAA;CAAE,GACtB;IAAE,IAAI,EAAC,MAAI,IAAI,CAAA;CAAE,CAkB7B"}

package/types/serve/framing/token.d.ts

@@ -0,0 +1,11 @@
+/** 32byte hex のランダム token。 */
+export function generateToken(): string;
+/** 定数時間比較。長さ不一致は false。 */
+export function tokenMatches(provided: any, expected: any): boolean;
+/**
+ * HTTP リクエストから token を取り出す。**通常は `Authorization: Bearer` ヘッダ**を使うこと。
+ * `?token=` クエリは **ブラウザ専用のフォールバック** (EventSource/WebSocket がヘッダを送れないため)。
+ * クエリに載せると proxy ログ/履歴に残るので、ヘッダを送れるクライアントは必ずヘッダを使う。
+ */
+export function extractToken(req: any): string;
+//# sourceMappingURL=token.d.ts.map

package/types/serve/framing/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../src/serve/framing/token.js"],"names":[],"mappings":"AAKA,8BAA8B;AAC9B,wCAEC;AAED,2BAA2B;AAC3B,oEAQC;AAED;;;;GAIG;AACH,+CASC"}