sesame-kit 0.4.0

package/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.js"],"names":[],"mappings":"AA+eA,qEAAqE;AACrE,iDAEC;AAED,0CAA0C;AAC1C,iDAEC;AAhbD;IAUE,kDAEC;IAXD;;OAEG;IACH,wBAFW,MAAM,EAMhB;IAFC,mBAA4B;IAC5B,UAAgB;IAOlB,kBAAgD;IAEhD,wCAAwC;IACxC,YAwBC;IAED,2EAA2E;IAC3E,mBAUC;IAED,aAaC;IAED,8BAA8B;IAC9B,gBAKC;IAID,yDAAyD;IACzD;;;;;MAuBC;IAED,oCAYC;IAED,wCAkBC;IAED,kCAKC;IAED,6CAMC;IAID,qDAAqD;IACrD;;;MAWC;IAED,oCAcC;IAED,gCAKC;IAED,4BAMC;IAOD;;;;;;;OAOG;IACH,uFANW;QAAE,MAAM,EAAC,CAAC,CAAC,EAAC,MAAM,KAAG,OAAO,CAAC;QAAC,QAAQ,EAAC,MAAM,GAAC,MAAM,CAAC;QAAC,KAAK,CAAC,EAAC,OAAO,CAAC;QACnE,UAAU,CAAC,EAAC,CAAC,IAAI,EAAC,MAAM,KAAG,IAAI,CAAC;QAAC,YAAY,CAAC,EAAC,CAAC,IAAI,EAAC,MAAM,KAAG,OAAO,CAAA;KAAE,GAGvE;QAAC,KAAK,EAAC,MAAM,EAAE,CAAC;QAAC,OAAO,EAAC,MAAM,EAAE,CAAC;QAAC,OAAO,EAAC,MAAM,EAAE,CAAA;KAAC,CAmDhE;IAED;;;;;OAKG;IACH,oDAHW;QAAC,KAAK,CAAC,EAAC,OAAO,CAAA;KAAC,GACd;QAAC,KAAK,EAAC,MAAM,EAAE,CAAC;QAAC,OAAO,EAAC,MAAM,EAAE,CAAC;QAAC,OAAO,EAAC,MAAM,EAAE,CAAA;KAAC,CAShE;IAED;;;;;OAKG;IACH,oDAHW;QAAC,KAAK,CAAC,EAAC,OAAO,CAAA;KAAC,GACd;QAAC,KAAK,EAAC,MAAM,EAAE,CAAC;QAAC,OAAO,EAAC,MAAM,EAAE,CAAC;QAAC,OAAO,EAAC,MAAM,EAAE,CAAA;KAAC,CAShE;IAED;;;;;;;;;OASG;IACH,2CAFa;QAAC,KAAK,EAAC,MAAM,EAAE,CAAC;QAAC,OAAO,EAAC,MAAM,EAAE,CAAA;KAAC,CAqD9C;IAED;;;;;;OAMG;IACH,mDAHW,MAAM,GACJ;QAAC,KAAK,EAAC,MAAM,EAAE,CAAC;QAAC,OAAO,EAAC,MAAM,EAAE,CAAA;KAAC,CA0C9C;CACF"}

package/types/crypto.d.ts

@@ -0,0 +1,61 @@
+/**
+ * v4 UUID を生成。biz3 biz3utils.generateUUID:269-280 と一致させる。
+ * 学習リモコンのキーは **クライアントが keyUUID を発番**してサーバに渡す
+ * (learn/index.js:222)。サーバ発番ではない。
+ *
+ * ★重要: biz3 は `randomUUID().toUpperCase()` で **大文字** UUID を返す。
+ *   Node の randomUUID は既定で小文字なので toUpperCase() で揃える。
+ *   (biz3 アプリと同一アカウント併用時に keyUUID 形式を一致させるため)
+ */
+export function generateUUID(): string;
+/**
+ * 時刻ベースの CMAC 署名。
+ * biz3 Cmac.cmacTime() と同じ:
+ *   1. UNIX 秒を 4B LE にパック
+ *   2. 上位 3B (index 1-3) だけを取る → 256 秒粒度の時刻
+ *   3. AES-CMAC(secretKey, message) → 16B MAC
+ *   4. hex 化して先頭 8 文字 (= 4B) を返す
+ *
+ * `node-aes-cmac` は RFC 4493 標準実装。RFC 4493 §4 の Test Vector 2
+ * (key=2b7e1516..., msg=6bc1bee2..., expected=070a16b4...) で動作検証済み
+ * (リポルートで `node _crypto_test.mjs` 実行時 PASS。biz3 Cmac.js も同じ
+ * RFC 4493 標準を Web Crypto 上で自前実装しているため出力は一致する)。
+ *
+ * @param {string} hexKey 16B (32hex) の secretKey
+ * @returns {string} 4B hex (8 文字)
+ */
+export function cmacTime(hexKey: string): string;
+/**
+ * UUID (32hex with hyphens) → 18B base64 (prefix '000c' 付き)。
+ * biz3 utils.uuidBuffer() と同じ。`biz3TriggerLocker` の `history` フィールドに乗せる。
+ *
+ * @param {string} uuid 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX' or 32hex
+ * @param {string} prefix デフォルト '000c'
+ * @returns {string} base64 (24 文字)
+ */
+export function uuidToHistoryBase64(uuid: string, prefix?: string): string;
+/**
+ * irType を文字列エイリアス (ac/tv/...) または数値文字列から数値に解決する。
+ * @param {string|number} v "ac" | "49152" | 0xc000 等
+ * @returns {number}
+ */
+export function parseIrType(v: string | number): number;
+export function productTypeFromModelName(modelName: any): number;
+export { ITEM_CODES as CMD } from "./itemcodes.js";
+export const IR_TYPE: Readonly<{
+    ac: 49152;
+    tv: 8192;
+    light: 57344;
+    fan: 32768;
+    learn: 65024;
+}>;
+/**
+ * irType が不明な場合の保険値。
+ * このツールは自己学習リモコン (learnEmit) を主対象とするため learn (0xFE00) を既定とする。
+ * (フォールバックが実際に使われるのは server が type を報告しない異常時のみ)
+ */
+export const DEFAULT_IR_TYPE: 65024;
+export const PRODUCT_TYPE: Readonly<{
+    [k: string]: number;
+}>;
+//# sourceMappingURL=crypto.d.ts.map

package/types/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../src/crypto.js"],"names":[],"mappings":"AAmBA;;;;;;;;GAQG;AACH,uCAEC;AAID;;;;;;;;;;;;;;;GAeG;AACH,iCAHW,MAAM,GACJ,MAAM,CAoBlB;AAID;;;;;;;GAOG;AACH,0CAJW,MAAM,WACN,MAAM,GACJ,MAAM,CASlB;AA6CD;;;;GAIG;AACH,+BAHW,MAAM,GAAC,MAAM,GACX,MAAM,CAWlB;AAaD,iEAEC;;AA5CD;;;;;;GAMG;AAEH;;;;GAIG;AACH,oCAA6C;AAuB7C;;GAIE"}

package/types/devices.d.ts

@@ -0,0 +1,116 @@
+/** 個人ユーザのデバイス一覧。companyID 不要。 */
+export function getUserDevices(client: any, { timeoutMs }?: {
+    timeoutMs?: number;
+}): Promise<any>;
+/** 単機の現在状態 (ロック開閉、電池等)。biz3 では isFromApp=true 限定だが CLI でも投げてみる価値あり。 */
+export function getDeviceStatus(client: any, { deviceUUID }: {
+    deviceUUID: any;
+}): Promise<any>;
+/** デバイス名変更。subUUID は呼び出し側 (client.js) が持つ。 */
+export function updateDeviceName(client: any, { subUUID, deviceUUID, deviceName }: {
+    subUUID: any;
+    deviceUUID: any;
+    deviceName: any;
+}): Promise<any>;
+/** デバイスを company から削除。items=[{deviceUUID,...}] */
+export function deleteDevices(client: any, { companyID, items }: {
+    companyID: any;
+    items: any;
+}): Promise<any>;
+/**
+ * デバイス state push を購読。subscribeDevicesUpdate (biz3ManageDevice) を投げて購読要求し、
+ * 実際の state push は **`biz3TriggerLocker:pubDeviceStateChange`** で届く。
+ *
+ * 注 (監査で修正): 購読要求の op は biz3ManageDevice/subscribeDevicesUpdate
+ * (useManageDevice.js:325) だが、**応答の push は別 action/op** で来る:
+ * biz3 は `biz3TriggerLocker` action の `pubDeviceStateChange` (小文字, useIotCtrl.js:11,21)
+ * として state 変化を流す。push 本体は `data = {deviceUUID, stateInfo}`。
+ * 旧実装は `biz3ManageDevice:PubedDeviceStateChange` (大文字 P・別 action) を購読しており
+ * push を1件も受信できなかった。
+ *
+ * **既知の制限**: biz3 プロトコルに `unsubscribeDevicesUpdate` op は無いため、
+ * unsubscribe()/close() 後もサーバ側 push は止まらない (ローカルで無視するだけ)。
+ */
+export function subscribeDevicesUpdate(client: any, { companyID, items, onUpdate }: {
+    companyID: any;
+    items: any;
+    onUpdate: any;
+}): any;
+/**
+ * ロックの開閉履歴を取得。`list` はデバイス指定の配列。
+ * @param {{companyID:string, list:any[], pageSize?:number}} p
+ */
+export function getDeviceHistory(client: any, { companyID, list, pageSize }: {
+    companyID: any;
+    list: any;
+    pageSize?: any;
+}): Promise<any>;
+/**
+ * 開閉履歴の1エントリを非表示化 (論理削除)。
+ * biz3 useManageGroup.js makeInvisibleHistory: フラット {action, deviceUUID, timestamp, op}。
+ * @param {{deviceUUID:string, timestamp:number}} p
+ */
+export function makeHistoryInvisible(client: any, { deviceUUID, timestamp }: {
+    deviceUUID: any;
+    timestamp: any;
+}): Promise<any>;
+/**
+ * 電池履歴を取得。DynamoDB の lastEvaluatedKey でページング。
+ * 1 回呼ぶごとに 1 ページ分。null → 最新ページ。
+ * 戻り値: { records: [{ts, light, heavy, lightPercentage, heavyPercentage}], lastEvaluatedKey }
+ */
+export function getBatteryRecord(client: any, { deviceUUID, lastEvaluatedKey, pageSize }: {
+    deviceUUID: any;
+    lastEvaluatedKey?: any;
+    pageSize?: number;
+}): Promise<any>;
+/**
+ * 電池履歴の1エントリを非表示化 (論理削除)。
+ * biz3 MobileBatteryChart.js makeInvisibleRecord: フラット {action, deviceUUID, timestamp_second, op}。
+ * @param {{deviceUUID:string, timestampSecond:number}} p
+ */
+export function makeBatteryRecordInvisible(client: any, { deviceUUID, timestampSecond }: {
+    deviceUUID: any;
+    timestampSecond: any;
+}): Promise<any>;
+/** 配信中ファームウェア一覧。 */
+export function listFirmware(client: any): Promise<any>;
+/**
+ * biz3InvokeWebAPIs 経由で REST WebAPI を呼ぶ。
+ * func 例: 'webapi_ssm_shadow_get', 'webapi_history_get', 'webapi_cmd_send'。
+ * apiKeyId は別途 biz3 の dev console で発行されたもの。
+ *
+ * @param {{func:string, apiKeyId:string, query?:object, body?:object}} p
+ */
+export function invokeWebAPI(client: any, { func, apiKeyId, query, body }: {
+    func: any;
+    apiKeyId: any;
+    query?: {};
+    body?: {};
+}): Promise<any>;
+/** WebAPI 経由で 単機の shadow state を取得。 */
+export function webapiDeviceState(client: any, { apiKeyId, deviceId }: {
+    apiKeyId: any;
+    deviceId: any;
+}): Promise<any>;
+/**
+ * WebAPI 経由で履歴を取得。
+ * biz3 useDeveloper.js:67-80: query = {device_id, page:0, lg:5, isBiz:true}。
+ * lg は言語コードの**数値 ID** (biz3 は 5 を渡す)。旧実装は "ja" (文字列) で誤り。
+ */
+export function webapiDeviceHistory(client: any, { apiKeyId, deviceId, page, lg, isBiz }: {
+    apiKeyId: any;
+    deviceId: any;
+    page?: number;
+    lg?: number;
+    isBiz?: boolean;
+}): Promise<any>;
+/** WebAPI 経由でロック cmd 送信 (sign/history は呼び出し側で組み立て)。 */
+export function webapiSendCmd(client: any, { apiKeyId, deviceId, cmd, sign, history }: {
+    apiKeyId: any;
+    deviceId: any;
+    cmd: any;
+    sign: any;
+    history: any;
+}): Promise<any>;
+//# sourceMappingURL=devices.d.ts.map

package/types/devices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices.d.ts","sourceRoot":"","sources":["../src/devices.js"],"names":[],"mappings":"AAyBA,iCAAiC;AACjC;;iBAoBC;AAED,uEAAuE;AACvE;;iBAOC;AAED,8CAA8C;AAC9C;;;;iBAWC;AAED,kDAAkD;AAClD;;;iBAOC;AAED;;;;;;;;;;;;;GAaG;AACH;;;;QAKC;AAID;;;GAGG;AACH;;;;iBAOC;AAED;;;;GAIG;AACH;;;iBAOC;AAID;;;;GAIG;AACH;;;;iBAOC;AAED;;;;GAIG;AACH;;;iBAOC;AAID,oBAAoB;AACpB,wDAWC;AAID;;;;;;GAMG;AACH;;;;;iBAOC;AAID,uCAAuC;AACvC;;;iBAMC;AAED;;;;GAIG;AACH;;;;;;iBAMC;AAED,uDAAuD;AACvD;;;;;;iBAMC"}

package/types/index.d.ts

@@ -0,0 +1,23 @@
+export { SesameHub3 } from "./client.js";
+export { FileTokenStore } from "./tokens.js";
+export { ConfigStore } from "./config.js";
+export * as auth from "./auth.js";
+export * as crypto from "./crypto.js";
+export * as ir from "./ir.js";
+export * as devices from "./devices.js";
+export * as account from "./account.js";
+export * as schedule from "./schedule.js";
+export * as org from "./org.js";
+export * as company from "./company.js";
+export * as access from "./access.js";
+export * as iot from "./iot.js";
+export * as presetir from "./presetir.js";
+export * as sharekey from "./sharekey.js";
+export * as lock from "./lock.js";
+export * as ble from "./ble/index.js";
+export { SesameBle } from "./ble/index.js";
+export { assertSuccess } from "./util.js";
+export { Hub3WsClient, sendIR, getIRCodes } from "./transport.js";
+export { configPaths, resolveConfigDir } from "./paths.js";
+export { triggerLock, lockLock, lockUnlock, lockToggle, botClick, triggerItemCommand, setAutolock } from "./lock.js";
+//# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":""}

package/types/iot.d.ts

@@ -0,0 +1,312 @@
+/**
+ * hub3_id から MQTT cmd topic を構築する (useIotCtrl.js:112-116)。
+ * hub3_id 未指定なら device_id を流用 (WiFi モデルは自身が Hub3)。
+ * 大文字小文字変換は一切しない。
+ * @param {string} hub3Id 親 Hub3 (または自身) の UUID (ハイフン付き小文字想定)
+ * @returns {string} `wm2{末尾セグメント}cmd`
+ */
+export function buildIotTopic(hub3Id: string): string;
+/**
+ * iot cmd の payload バイト列を構築し base64 文字列を返す (useIotCtrl.js:120-222)。
+ * 連結順: signArray(4B) ++ cmd(1B) ++ device_id UTF8 ++ extra(任意)。
+ *
+ * @param {{
+ *   cmd: number,            // cmdCode (下位8bit のみ採用)
+ *   deviceId: string,       // 対象デバイスの UUID 文字列 (UTF8 バイト化される)
+ *   secretKey: string,      // 32hex。署名に使う device の secretKey
+ *   extra?: Uint8Array,     // cmd 別追加バイト (無ければ無し)
+ * }} p
+ * @returns {string} base64 payload
+ */
+export function buildIotPayload({ cmd, deviceId, secretKey, extra }: {
+    cmd: number;
+    deviceId: string;
+    secretKey: string;
+    extra?: Uint8Array;
+}): string;
+/**
+ * 既に組み上げた topic / base64 payload で iot cmd を送る (useOperateIoT.js:54-61)。
+ * 送信は fire-and-forget。応答 (op=数値cmdCode) を待ちたい場合は
+ * subscribeIotResponse を併用するか、send 前後で購読すること。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{ topic: string, payload: string, op?: string }} p op は既定 'cmd'
+ * @returns {void}
+ */
+export function sendIotCmd(client: import("./transport.js").Hub3WsClient, { topic, payload, op }: {
+    topic: string;
+    payload: string;
+    op?: string;
+}): void;
+/**
+ * iot cmd の応答 push を購読する (useOperateIoT.js:6-43)。
+ * 購読キーは `biz3OperateIoT:<cmdCode>` (応答の message.op は数値 cmdCode の echo)。
+ * 戻り値の unsubscribe を必ず呼ぶこと。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {number} cmd 待ち受ける cmdCode (応答 op と一致)
+ * @param {(msg:any)=>void} fn 応答コールバック (msg 全体を渡す)
+ * @returns {()=>void} unsubscribe
+ */
+export function subscribeIotResponse(client: import("./transport.js").Hub3WsClient, cmd: number, fn: (msg: any) => void): () => void;
+/**
+ * iot cmd を送信し、対象デバイスからの応答 push (op=cmd) を 1 件待つ共通ヘルパー。
+ *
+ * 応答 push は op=数値cmdCode で届き、device 特定は message.UUID || message.touch_id
+ * (useOperateIoT.js:9-18)。deviceId 指定時はそれと一致する push のみ採用する。
+ *
+ * 注意 (未確認): RELAY_SWITCH(208) / CLEAR_WIFI_SSID(210) など、biz3 web 側に専用
+ * コールバック登録が無い cmd は応答 push が来ない可能性がある。それらは
+ * sendIotCmd (fire-and-forget) を使うこと。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{
+ *   topic: string,
+ *   payload: string,
+ *   cmd: number,                // 応答 op と照合する cmdCode
+ *   deviceId?: string,          // 応答の UUID/touch_id と照合 (省略時は最初の応答を採用)
+ *   timeoutMs?: number,
+ * }} p
+ * @returns {Promise<any>} 応答 message (data があれば message 全体を返す。data 抽出は呼び出し側)
+ */
+export function sendIotCmdAwait(client: import("./transport.js").Hub3WsClient, { topic, payload, cmd, deviceId, timeoutMs }: {
+    topic: string;
+    payload: string;
+    cmd: number;
+    deviceId?: string;
+    timeoutMs?: number;
+}): Promise<any>;
+/**
+ * Hub3 (WiFi) 本体 LED の調光を設定/取得する (cmdCode=92 / 0x5C, useIotCtrl.js:163-190,
+ * MobileWifiModule.js:129-172)。
+ * payload extra = [op(1B), duty(1B)]。op は set=0x01 / get=0x02。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{
+ *   deviceId: string,          // Hub3 の deviceUUID
+ *   secretKey: string,         // Hub3 の secretKey (32hex)
+ *   hub3Id?: string,           // topic 用。省略時 deviceId
+ *   op: number,                // 0x01=set / 0x02=get (0..255)
+ *   duty: number,              // 0..255 (set 時の輝度。get 時もダミー必須)
+ *   timeoutMs?: number,
+ * }} p
+ * @returns {Promise<{ ledDuty: number|undefined, message: any }>} data.ledDuty (0..255)
+ */
+export function setHub3LedDuty(client: import("./transport.js").Hub3WsClient, p: {
+    deviceId: string;
+    secretKey: string;
+    hub3Id?: string;
+    op: number;
+    duty: number;
+    timeoutMs?: number;
+}): Promise<{
+    ledDuty: number | undefined;
+    message: any;
+}>;
+/**
+ * Hub3 LTE リレー (継電器) を開閉する (cmdCode=208 / 0xD0, useIotCtrl.js:192-213,
+ * VIotSwitch.js:56-71)。
+ * payload extra = [op(1B)] (省略時 op=0x01 = 開閉操作)。
+ *
+ * 応答 push は biz3 web に専用コールバック登録が無いため未確認 (spec responseShape:
+ * useIotCtrl.js:192-213)。本ラッパは fire-and-forget で送信する (応答は待たない)。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{
+ *   deviceId: string,          // Hub3 LTE の deviceUUID
+ *   secretKey: string,         // 32hex
+ *   hub3Id?: string,           // topic 用。省略時 deviceId
+ *   op?: number,               // 既定 0x01
+ * }} p
+ * @returns {void}
+ */
+export function hub3RelaySwitch(client: import("./transport.js").Hub3WsClient, p: {
+    deviceId: string;
+    secretKey: string;
+    hub3Id?: string;
+    op?: number;
+}): void;
+/**
+ * Hub3 にぶら下がり Sesame を追加する (cmdCode=101 / 0x65, useIotCtrl.js:53-107/159-161,
+ * MobileBindDevice.js:70-97)。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{
+ *   hub3Id: string,            // 親 Hub3 の deviceUUID (= device_id として payload に入る + topic)
+ *   secretKey: string,         // 親 Hub3 の secretKey (32hex)。署名に使う
+ *   sesameId: string,          // 追加する Sesame の UUID
+ *   ssmSecKa: string,          // Sesame の secretKey (32hex)
+ *   nickName?: string,
+ *   deviceModel: string,       // 例 'sesame_5' (productType/matterProductType 導出に必要)
+ *   timeoutMs?: number,
+ * }} p
+ * @returns {Promise<{ ssks: any, message: any }>} data.ssks (ぶら下がりリスト状態)
+ */
+export function addSesameToHub3(client: import("./transport.js").Hub3WsClient, p: {
+    hub3Id: string;
+    secretKey: string;
+    sesameId: string;
+    ssmSecKa: string;
+    nickName?: string;
+    deviceModel: string;
+    timeoutMs?: number;
+}): Promise<{
+    ssks: any;
+    message: any;
+}>;
+/**
+ * Hub3 からぶら下がり Sesame を削除する (cmdCode=103 / 0x67, useIotCtrl.js:155-158)。
+ * payload packing は ADD と完全同形 (handleSesameItemOperation を共用)。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {Parameters<typeof addSesameToHub3>[1]} p addSesameToHub3 と同じ
+ * @returns {Promise<{ ssks: any, message: any }>}
+ */
+export function removeSesameFromHub3(client: import("./transport.js").Hub3WsClient, p: Parameters<typeof addSesameToHub3>[1]): Promise<{
+    ssks: any;
+    message: any;
+}>;
+/**
+ * ファームウェア更新 (DFU) をトリガする (cmdCode=0x03, useIotCtrl.js:110-111/153,
+ * UpgradeFirmware.js:98-120)。
+ * iotPayload なし。payload = [sign, cmd=0x03, device_id]。
+ *
+ * 進捗は長時間にわたり複数回 push で届く (data={progress, versionTag, UUID})。
+ * versionTag があれば完了。よって応答は subscribeIotResponse で複数回受ける設計とし、
+ * 本関数は送信のみ + 購読 unsubscribe を返す。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{
+ *   deviceId: string,          // 更新対象の UUID (payload の device_id)
+ *   hub3Id?: string,           // topic 用 (親 Hub3。WiFi モデルは自身)。省略時 deviceId
+ *   secretKey: string,         // 32hex
+ *   onProgress?: (data:{progress?:number, versionTag?:string, UUID?:string})=>void,
+ * }} p
+ * @returns {()=>void} unsubscribe (進捗購読の解除)
+ */
+export function startFirmwareUpdate(client: import("./transport.js").Hub3WsClient, p: {
+    deviceId: string;
+    hub3Id?: string;
+    secretKey: string;
+    onProgress?: (data: {
+        progress?: number;
+        versionTag?: string;
+        UUID?: string;
+    }) => void;
+}): () => void;
+/**
+ * Hub3 の保存 WiFi 設定をクリアする (cmdCode=210 / 0xD2, useIotCtrl.js:214-215,
+ * MobileWifiModule.js:146-153)。追加バイト無し。
+ *
+ * 応答 push は専用コールバック登録が無く未確認のため fire-and-forget。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{ deviceId: string, secretKey: string, hub3Id?: string }} p
+ * @returns {void}
+ */
+export function clearHub3WifiSsid(client: import("./transport.js").Hub3WsClient, { deviceId, secretKey, hub3Id }: {
+    deviceId: string;
+    secretKey: string;
+    hub3Id?: string;
+}): void;
+/**
+ * Matter ペアリングコード (QR/手動コード) を取得する (cmdCode=137 / 0x89,
+ * MobileWifiModule.js:82-96)。iotPayload なし。
+ *
+ * 注意: cmdCode 137 は STP_ITEM_CODE_PASSCODE_CHANGE_VALUE とも重複定義 (cmdCode.js:73,80)。
+ * Hub3 文脈で使うこと。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{ deviceId: string, secretKey: string, hub3Id?: string, timeoutMs?: number }} p
+ * @returns {Promise<{ qrCode: string|undefined, manualCode: string|undefined, message: any }>}
+ */
+export function getMatterPairingCode(client: import("./transport.js").Hub3WsClient, p: {
+    deviceId: string;
+    secretKey: string;
+    hub3Id?: string;
+    timeoutMs?: number;
+}): Promise<{
+    qrCode: string | undefined;
+    manualCode: string | undefined;
+    message: any;
+}>;
+/**
+ * Matter ペアリング窓を開く (cmdCode=153 / 0x99, MobileWifiModule.js:97-126)。iotPayload なし。
+ * data={statusCode}。statusCode===0 で成功。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{ deviceId: string, secretKey: string, hub3Id?: string, timeoutMs?: number }} p
+ * @returns {Promise<{ statusCode: number|undefined, message: any }>}
+ */
+export function openMatterPairingWindow(client: import("./transport.js").Hub3WsClient, p: {
+    deviceId: string;
+    secretKey: string;
+    hub3Id?: string;
+    timeoutMs?: number;
+}): Promise<{
+    statusCode: number | undefined;
+    message: any;
+}>;
+export namespace __internal {
+    export { hexStringToUint8Array };
+    export { stringToUint8Array };
+    export { getProductTypeFromModelName };
+    export { getMatterProductTypeFromModelName };
+    export { buildSesameItemExtra };
+    export { concatBytes };
+}
+/**
+ * namespace (hub.iot.*) に露出する client op の allowlist。
+ * buildIotTopic / buildIotPayload / __internal は client を取らない内部ヘルパー
+ * なので namespace に出さない (低レベル用途は index.js から直接 import)。
+ */
+export const NAMESPACE_OPS: string[];
+/**
+ * hex 文字列を Uint8Array に変換 (biz3utils.js:221-235)。
+ * null/undefined は空配列 (biz3utils と同挙動)。奇数長は例外。
+ * @param {string|null|undefined} hexString
+ * @returns {Uint8Array}
+ */
+declare function hexStringToUint8Array(hexString: string | null | undefined): Uint8Array;
+/**
+ * 文字列を UTF8 バイト列に変換 (biz3utils.js:240-243 stringToUint8Array)。
+ * @param {string} str
+ * @returns {Uint8Array}
+ */
+declare function stringToUint8Array(str: string): Uint8Array;
+/**
+ * deviceModel 名 → productType の数値 (biz3utils.js:53-56)。
+ * vendor の modelNameByProductType を逆引き。未知は null。
+ * @param {string} modelName
+ * @returns {number|null}
+ */
+declare function getProductTypeFromModelName(modelName: string): number | null;
+/**
+ * deviceModel 名 → matter product type (biz3utils.js:58-101)。
+ * productType が不明なら null。map に無ければ undefined。
+ * @param {string} modelName
+ * @returns {number|null|undefined}
+ */
+declare function getMatterProductTypeFromModelName(modelName: string): number | null | undefined;
+/**
+ * ADD/REMOVE_SESAME の追加バイトを構築する (handleSesameItemOperation, useIotCtrl.js:53-107)。
+ * 連結順: sesameId(16B) ++ secretKey(16B) ++ nickNameLen(1B) ++ nickNameUTF8 ++
+ *         productType(1B) ++ matterProductType(1B)。
+ *
+ * @param {{ sesameId: string, ssmSecKa: string, nickName?: string, deviceModel: string }} iotPayload
+ * @returns {Uint8Array}
+ */
+declare function buildSesameItemExtra(iotPayload: {
+    sesameId: string;
+    ssmSecKa: string;
+    nickName?: string;
+    deviceModel: string;
+}): Uint8Array;
+/**
+ * Uint8Array を連結する小ヘルパー (biz3 の手動 offset 連結を簡潔化)。
+ * @param  {...Uint8Array} arrays
+ * @returns {Uint8Array}
+ */
+declare function concatBytes(...arrays: Uint8Array[]): Uint8Array;
+export {};
+//# sourceMappingURL=iot.d.ts.map

package/types/iot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iot.d.ts","sourceRoot":"","sources":["../src/iot.js"],"names":[],"mappings":"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"}