sesame-kit 0.4.0

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../../../src/serve/framing/ws.js"],"names":[],"mappings":"AASA;;;;GAIG;AACH,uCAJW,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,MAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CA2C/C"}

package/types/serve/jsonrpc.d.ts

@@ -0,0 +1,118 @@
+/** 成功応答を組み立てる。 */
+export function makeResult(id: any, result: any): {
+    jsonrpc: string;
+    id: any;
+    result: any;
+};
+/** エラー応答を組み立てる。data は kind 等のみ。inbound params は決して入れない。 */
+export function makeError(id: any, code: any, message: any, kind: any, data?: any): {
+    jsonrpc: string;
+    id: any;
+    error: {
+        code: any;
+        message: any;
+    };
+};
+/** 任意の throw を JSON-RPC error オブジェクトへ正規化 (params は echo しない)。 */
+export function errorFromThrow(id: any, err: any): {
+    jsonrpc: string;
+    id: any;
+    error: {
+        code: any;
+        message: any;
+    };
+};
+/**
+ * 1 行 (1 メッセージ) を parse して分類する。
+ * @param {string} raw
+ * @returns {{type:"parse-error"}
+ *          | {type:"batch"}
+ *          | {type:"invalid", id:(string|number|null)}
+ *          | {type:"request", id:(string|number), method:string, params:any}
+ *          | {type:"notification", method:string, params:any}}
+ */
+export function classify(raw: string): {
+    type: "parse-error";
+} | {
+    type: "batch";
+} | {
+    type: "invalid";
+    id: (string | number | null);
+} | {
+    type: "request";
+    id: (string | number);
+    method: string;
+    params: any;
+} | {
+    type: "notification";
+    method: string;
+    params: any;
+};
+/**
+ * 1 メッセージを処理して応答オブジェクト (通知なら null) を返す。
+ * メソッド実行は `invoke(method, params)` に委譲 (Daemon が registry 解決 + 直列化 + 認可を仕込む)。
+ * この関数は throw しない。
+ *
+ * @param {string} raw 1 行の生メッセージ
+ * @param {(method:string, params:any) => Promise<any>} invoke
+ * @returns {Promise<object|null>} 応答 (通知なら null)
+ */
+export function handleMessage(raw: string, invoke: (method: string, params: any) => Promise<any>): Promise<object | null>;
+/** サーバ発のイベント通知フレームを作る (予約名 `event.<topic>`)。 */
+export function makeEvent(topic: any, payload: any): {
+    jsonrpc: string;
+    method: string;
+    params: any;
+};
+/**
+ * 機械向け契約 (RPC メソッド名/params 形/結果形/event 名/error.kind) の SemVer。
+ * **破壊的変更でだけ major を上げる** (パッケージ version とは独立。pkg は無害な変更でも上がる)。
+ * 消費者はこれを `status.contractVersion` か discover の `info["x-contractVersion"]` で読み、
+ * major 不一致なら fail-fast できる。後方互換な追加は minor、説明のみは patch。
+ *   1.0.0: 初版 (5 framing / 79 method / event.lockState・deviceUpdate / 6 kind)
+ */
+export const CONTRACT_VERSION: "1.0.0";
+/** JSON-RPC 2.0 標準エラーコード + アプリ域 (-32000)。 */
+export const RPC: Readonly<{
+    PARSE_ERROR: -32700;
+    INVALID_REQUEST: -32600;
+    METHOD_NOT_FOUND: -32601;
+    INVALID_PARAMS: -32602;
+    INTERNAL_ERROR: -32603;
+    APP_ERROR: -32000;
+}>;
+/**
+ * ドメイン/プロトコルエラー。handler はこれを throw するとそのまま JSON-RPC error になる。
+ * `kind` は機械可読な分類で、`error.data.kind` に載る (クライアントが分岐できる)。
+ * @param {string} message
+ * @param {{ code?: number, kind?: string, data?: object }} [opts]
+ */
+export class RpcError extends Error {
+    constructor(message: any, { code, kind, data }?: {
+        code?: -32000;
+        kind?: string;
+        data?: any;
+    });
+    code: -32000;
+    kind: string;
+    data: any;
+}
+/**
+ * error.data.kind の enum。**実際に emit される値だけ**を載せる (利用者が switch できるよう、
+ * 出ないものは定義しない — 出さない値を契約に書かない)。
+ *   not_authenticated : 未ログイン/トークン失効 (CLI で sesame login)
+ *   connection_lost   : クラウド WS 未接続/切断
+ *   timeout           : op がタイムアウト (transport の request timeout 由来)
+ *   bad_params        : 引数不正/parse 不能
+ *   not_implemented   : 未知メソッド
+ *   internal          : 上記以外 (ライブラリ/サーバ由来の想定外エラー。message に詳細)
+ */
+export const KIND: Readonly<{
+    NOT_AUTHENTICATED: "not_authenticated";
+    BAD_PARAMS: "bad_params";
+    TIMEOUT: "timeout";
+    CONNECTION_LOST: "connection_lost";
+    INTERNAL: "internal";
+    NOT_IMPLEMENTED: "not_implemented";
+}>;
+//# sourceMappingURL=jsonrpc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsonrpc.d.ts","sourceRoot":"","sources":["../../src/serve/jsonrpc.js"],"names":[],"mappings":"AAmEA,kBAAkB;AAClB;;;;EAEC;AAED,2DAA2D;AAC3D;;;;;;;EAOC;AAED,iEAAiE;AACjE;;;;;;;EAOC;AAED;;;;;;;;GAQG;AACH,8BAPW,MAAM,GACJ;IAAC,IAAI,EAAC,aAAa,CAAA;CAAC,GACnB;IAAC,IAAI,EAAC,OAAO,CAAA;CAAC,GACd;IAAC,IAAI,EAAC,SAAS,CAAC;IAAC,EAAE,EAAC,CAAC,MAAM,GAAC,MAAM,GAAC,IAAI,CAAC,CAAA;CAAC,GACzC;IAAC,IAAI,EAAC,SAAS,CAAC;IAAC,EAAE,EAAC,CAAC,MAAM,GAAC,MAAM,CAAC,CAAC;IAAC,MAAM,EAAC,MAAM,CAAC;IAAC,MAAM,EAAC,GAAG,CAAA;CAAC,GAC/D;IAAC,IAAI,EAAC,cAAc,CAAC;IAAC,MAAM,EAAC,MAAM,CAAC;IAAC,MAAM,EAAC,GAAG,CAAA;CAAC,CAmB7D;AAOD;;;;;;;;GAQG;AACH,mCAJW,MAAM,UACN,CAAC,MAAM,EAAC,MAAM,EAAE,MAAM,EAAC,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GACzC,OAAO,CAAC,MAAM,GAAC,IAAI,CAAC,CA0BhC;AAED,gDAAgD;AAChD;;;;EAEC;AAtJD;;;;;;GAMG;AACH,+BAAgC,OAAO,CAAC;AAExC,6CAA6C;AAC7C;;;;;;;GAOG;AAEH;;;;;GAKG;AACH;IACE;;;;OAMC;IAHC,aAAgB;IAChB,aAAgB;IAChB,UAAgB;CAEnB;AAED;;;;;;;;;GASG;AACH;;;;;;;GAOG"}

package/types/serve/registry.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 全エントリを {name → entry} で構築する。
+ * @returns {Map<string, {summary:string, params:any[], result:string, handler:Function, namespace?:string}>}
+ */
+export function buildRegistry(): Map<string, {
+    summary: string;
+    params: any[];
+    result: string;
+    handler: Function;
+    namespace?: string;
+}>;
+/**
+ * OpenRPC 文書を組み立てる (rpc.discover 応答)。param スキーマは初期は粗いが
+ * 「何の op が在るか」は完全網羅する。secretKey 等の実値 example は載せない。
+ */
+export function buildOpenRpcDoc(reg: any, version: any): {
+    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=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/serve/registry.js"],"names":[],"mappings":"AA2JA;;;GAGG;AACH,iCAFa,GAAG,CAAC,MAAM,EAAE;IAAC,OAAO,EAAC,MAAM,CAAC;IAAC,MAAM,EAAC,GAAG,EAAE,CAAC;IAAC,MAAM,EAAC,MAAM,CAAC;IAAC,OAAO,WAAU;IAAC,SAAS,CAAC,EAAC,MAAM,CAAA;CAAC,CAAC,CA+B3G;AAED;;;GAGG;AACH;;;;;;;;;;;;;;;;;;;;;;;;EA+BC"}

package/types/session-ui.d.ts

@@ -0,0 +1,36 @@
+/**
+ * セッション UI を起動し、ユーザーが終了するまで待つ。
+ * @param {{
+ *   devices: Map<string, {entry:object, ble:object|null}>,
+ *   hasCloud: boolean,                       // クラウド経路が使えるか (タグ表示用)
+ *   bus: import("node:events").EventEmitter, // "update" で再描画
+ *   exec: (op:string, device:object, seconds?:number)=>Promise<string>, // 1 操作を実行し結果文字列を返す
+ *   actionsFor: (device:object)=>Array<{label:string, value:string}>,   // 型の能力に応じた操作 (status 含む)
+ *   fmtState: (device:object)=>string,       // ヘッダの状態表示
+ * }} props
+ */
+export function runSessionUI(props: {
+    devices: Map<string, {
+        entry: object;
+        ble: object | null;
+    }>;
+    hasCloud: boolean;
+    bus: import("node:events").EventEmitter;
+    exec: (op: string, device: object, seconds?: number) => Promise<string>;
+    actionsFor: (device: object) => Array<{
+        label: string;
+        value: string;
+    }>;
+    fmtState: (device: object) => string;
+}): Promise<void>;
+export function SessionApp({ devices, hasCloud, bus, exec, actionsFor, fmtState, hub3RemotesFor, listKeysFor }: {
+    devices: any;
+    hasCloud: any;
+    bus: any;
+    exec: any;
+    actionsFor: any;
+    fmtState: any;
+    hub3RemotesFor: any;
+    listKeysFor: any;
+}): any;
+//# sourceMappingURL=session-ui.d.ts.map

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

@@ -0,0 +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"}

package/types/sharekey.d.ts

@@ -0,0 +1,35 @@
+/**
+ * デバイス鍵から共有 URL (`ssm://UI?...`) を組み立てる。biz3 generateInviteGuestQRCodeByInfo の 1:1 移植。
+ *
+ * @param {object} deviceKey デバイス鍵。devices 一覧 (listDevices) の 1 要素や getDeviceStatus 応答。
+ *   必須: deviceModel, sesame2PublicKey(hex), keyIndex(hex), deviceUUID。
+ *   secretKey は guestKeyId 未指定時に必須。
+ * @param {object} opts
+ * @param {number|string} opts.keyLevel 0=owner / 1=manager / 2=guest (URL の l=)
+ * @param {string} [opts.guestKeyId] ゲスト共有時に secretKey 位置へ差し込む値 (generateGuestQR 応答)
+ * @param {string} [opts.name] 表示名 (URL の n=)。省略時 deviceKey.deviceName。
+ * @returns {string} `ssm://UI?t=sk&sk=<base64>&l=<lv>&n=<urlenc>`
+ */
+export function buildShareKeyUrl(deviceKey: object, { keyLevel, guestKeyId, name }?: {
+    keyLevel: number | string;
+    guestKeyId?: string;
+    name?: string;
+}): string;
+/**
+ * 共有 URL (`ssm://UI?...` 文字列) を解析して鍵情報に戻す。biz3 readQrcode の URL 解析部の移植
+ * (画像スキャン部 = Decoder/DOM 依存は除外。URL 文字列を直接受ける)。
+ *
+ * @param {string} url `ssm://UI?t=sk&sk=...&l=...&n=...`
+ * @returns {{secretKey:string, keyIndex:string, sesame2PublicKey:string, keyLevel:number|null,
+ *           deviceModel:string|null, deviceName:string|null, deviceUUID:string}}
+ */
+export function parseShareKeyUrl(url: string): {
+    secretKey: string;
+    keyIndex: string;
+    sesame2PublicKey: string;
+    keyLevel: number | null;
+    deviceModel: string | null;
+    deviceName: string | null;
+    deviceUUID: string;
+};
+//# sourceMappingURL=sharekey.d.ts.map

package/types/sharekey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharekey.d.ts","sourceRoot":"","sources":["../src/sharekey.js"],"names":[],"mappings":"AA0BA;;;;;;;;;;;GAWG;AACH,4CATW,MAAM,mCAId;IAA4B,QAAQ,EAA5B,MAAM,GAAC,MAAM;IACC,UAAU,GAAxB,MAAM;IACQ,IAAI,GAAlB,MAAM;CACd,GAAU,MAAM,CA2ClB;AAED;;;;;;;GAOG;AACH,sCAJW,MAAM,GACJ;IAAC,SAAS,EAAC,MAAM,CAAC;IAAC,QAAQ,EAAC,MAAM,CAAC;IAAC,gBAAgB,EAAC,MAAM,CAAC;IAAC,QAAQ,EAAC,MAAM,GAAC,IAAI,CAAC;IAClF,WAAW,EAAC,MAAM,GAAC,IAAI,CAAC;IAAC,UAAU,EAAC,MAAM,GAAC,IAAI,CAAC;IAAC,UAAU,EAAC,MAAM,CAAA;CAAC,CA0C/E"}

package/types/tokens.d.ts

@@ -0,0 +1,20 @@
+export class FileTokenStore {
+    /** 既定の設定ディレクトリから組み立てる。CLI 内部はこれを使う。 */
+    static fromConfigDir(configDir: any): FileTokenStore;
+    /**
+     * @param {{ tokensPath: string, loginStatePath: string }} paths
+     */
+    constructor({ tokensPath, loginStatePath }: {
+        tokensPath: string;
+        loginStatePath: string;
+    });
+    tokensPath: string;
+    loginStatePath: string;
+    load(): any;
+    save(t: any): void;
+    clear(): void;
+    loadPending(): any;
+    savePending(s: any): void;
+    clearPending(): void;
+}
+//# sourceMappingURL=tokens.d.ts.map

package/types/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.js"],"names":[],"mappings":"AA4BA;IAWE,uCAAuC;IACvC,qDAGC;IAdD;;OAEG;IACH,4CAFW;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,EAOxD;IAFC,mBAA4B;IAC5B,uBAAoC;IAStC,YAAkD;IAClD,mBAA0C;IAC1C,cAA4C;IAE5C,mBAA6D;IAC7D,0BAAqD;IACrD,qBAAuD;CACxD"}

package/types/transport.d.ts

@@ -0,0 +1,138 @@
+/**
+ * SESAME Hub3 から IR を発射する。
+ *
+ * @param {Hub3WsClient} client
+ * @param {{
+ *   deviceId: string,         // Hub3 UUID (大文字)
+ *   irDeviceUUID: string,     // remote.uuid
+ *   irType: number,           // remote.type (例: 49152)
+ *   command: string,          // 自己学習なら keyUUID、プリセットなら 16byte hex
+ *   operation: "learnEmit"|"remoteEmit",
+ *   companyID: string,
+ * }} params
+ */
+export function sendIR(client: Hub3WsClient, params: {
+    deviceId: string;
+    irDeviceUUID: string;
+    irType: number;
+    command: string;
+    operation: "learnEmit" | "remoteEmit";
+    companyID: string;
+}): Promise<any>;
+/**
+ * 指定 IR デバイス (リモコン) の登録キー一覧を取得。
+ *
+ * 注: このエンドポイントだけ Hub3 UUID のフィールド名が `deviceId` ではなく
+ *     `hub3DeviceId`。これは公式 biz3 の意図的な命名差 (useRemoteCtrl.js:820-826)。
+ *
+ * @param {Hub3WsClient} client
+ * @param {{deviceId:string, irDeviceUUID:string, companyID:string}} params
+ */
+export function getIRCodes(client: Hub3WsClient, params: {
+    deviceId: string;
+    irDeviceUUID: string;
+    companyID: string;
+}): Promise<any>;
+export const TRANSPORT_ERR: Readonly<{
+    TIMEOUT: "TRANSPORT_TIMEOUT";
+    CLOSED: "TRANSPORT_CLOSED";
+}>;
+export class Hub3WsClient {
+    /**
+     * @param {{
+     *   wsUrl: string,
+     *   idToken: string,
+     *   lang?: string,
+     *   debug?: boolean,
+     *   autoReconnect?: boolean,              // default true
+     *   onTokenRefreshNeeded?: (oldToken: string) => Promise<string|null>,
+     *     // retry が MAX_RETRIES_BEFORE_TOKEN_CHECK に達した時に呼ばれる。
+     *     // 新 token を返すと idToken を差し替えて retryCount をリセットして再接続継続。
+     *     // null を返すと諦めず exponential backoff を続行 (token は古いまま)。
+     * }} cfg
+     */
+    constructor(cfg: any);
+    cfg: any;
+    idToken: any;
+    onTokenRefreshNeeded: any;
+    onReopen: any;
+    _everConnected: boolean;
+    /** @type {import("ws").WebSocket | null} */
+    ws: any | null;
+    status: "disconnected";
+    /** @type {Map<string, ((msg:any|Error)=>void)[]>} action+op → FIFO の resolver 配列 */
+    pending: Map<string, ((msg: any | Error) => void)[]>;
+    /** @type {((msg:any)=>void)[]} 任意メッセージのリスナ */
+    listeners: ((msg: any) => void)[];
+    /** @type {Map<string, Set<(msg:any)=>void>>} action+op → 永続購読 fn 集合 (biz3 の pub* 系イベント受信用) */
+    subscribers: Map<string, Set<(msg: any) => void>>;
+    /** @type {any[]} 未接続中の送信をバッファ */
+    messageQueue: any[];
+    retryCount: number;
+    closedByUser: boolean;
+    lastActiveTime: number;
+    lastTickTime: number;
+    _refreshedThisCycle: boolean;
+    keepaliveTimer: NodeJS.Timeout;
+    pongTimer: NodeJS.Timeout;
+    connectTimer: any;
+    reconnectTimer: any;
+    sleepDetectorTimer: NodeJS.Timeout;
+    _connectPromise: Promise<any>;
+    _initialConnectResolve: (value: any) => void;
+    _initialConnectReject: (reason?: any) => void;
+    log(...args: any[]): void;
+    /**
+     * WS 接続を確立。失敗時は reject。成功後の切断は auto-reconnect される。
+     */
+    connect(): Promise<any>;
+    /** 明示的にクローズ。auto-reconnect は抑止される。 */
+    close(): void;
+    /**
+     * リクエスト送信。応答 (action+op 一致) を1個待つ。FIFO。
+     * 未接続中は messageQueue に積まれ、接続復帰後 flush される。
+     */
+    request(payload: any, timeoutMs?: number): Promise<any>;
+    /** 応答を期待しない fire-and-forget 送信。 */
+    send(payload: any): void;
+    onMessage(fn: any): () => void;
+    /**
+     * 特定 action+op の永続購読。biz3 の `pubDeviceStateChange` などの async push を受ける。
+     *
+     * @param {string} key `"<action>:<op>"` 形式。op が無い場合は `"<action>:"`
+     * @param {(msg:any)=>void} fn
+     * @returns {()=>void} unsubscribe
+     */
+    subscribe(key: string, fn: (msg: any) => void): () => void;
+    /**
+     * keepalive 1往復で接続を実検証する。timeout で reject。
+     * 注: biz3 の keepalive ack は `success` ではなく `connectionId` を返す
+     * (WebSocketManager.ts:72-83)。なので応答が**届いたこと自体**を生存判定とし、
+     * success フィールドの有無には依存しない (旧実装は !!resp.success で常に false の恐れ)。
+     */
+    ping(timeoutMs?: number): Promise<boolean>;
+    /** 接続状態 (デバッグ・テスト用)。 */
+    getStatus(): "disconnected";
+    _initWebSocket(): void;
+    _onOpen(): void;
+    _onClose(code: any, reason: any): void;
+    _onError(err: any): void;
+    /** 受動的再接続 (close を契機)。exponential backoff。 */
+    _handleReconnect(): void;
+    /** 能動的再接続 (pong timeout / sleep wake / idle 検知)。delay なし。 */
+    _reconnect(): void;
+    _onMessage(raw: any): void;
+    _registerPending(key: any, resolver: any): void;
+    _unregisterPending(key: any, resolver: any): void;
+    _rejectAllPending(err: any): void;
+    _sendOrQueue(payload: any): void;
+    _flushMessageQueue(): void;
+    _startKeepalive(): void;
+    _triggerHeartbeatCheck(): void;
+    _clearKeepalive(): void;
+    _startSleepDetector(): void;
+    _stopSleepDetector(): void;
+    _wakeUpConnection(): void;
+    _clearAllTimers(): void;
+}
+//# sourceMappingURL=transport.d.ts.map

package/types/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.js"],"names":[],"mappings":"AAokBA;;;;;;;;;;;;GAYG;AACH,+BAVW,YAAY,UACZ;IACN,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,WAAW,GAAC,YAAY,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB,gBAkBH;AAED;;;;;;;;GAQG;AACH,mCAHW,YAAY,UACZ;IAAC,QAAQ,EAAC,MAAM,CAAC;IAAC,YAAY,EAAC,MAAM,CAAC;IAAC,SAAS,EAAC,MAAM,CAAA;CAAC,gBAelE;AAzkBD;;;GAAyG;AAIzG;IACE;;;;;;;;;;;;OAYG;IACH,sBAyCC;IAtCC,SAAoE;IACpE,aAA0B;IAC1B,0BAA4D;IAG5D,cAAoC;IACpC,wBAA2B;IAE3B,4CAA4C;IAC5C,IADW,GAAsB,GAAG,IAAI,CAC1B;IACd,uBAAiC;IAEjC,oFAAoF;IACpF,SADW,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,EAAC,GAAG,GAAC,KAAK,KAAG,IAAI,CAAC,EAAE,CAAC,CACzB;IACxB,8CAA8C;IAC9C,WADW,CAAC,CAAC,GAAG,EAAC,GAAG,KAAG,IAAI,CAAC,EAAE,CACX;IACnB,8FAA8F;IAC9F,aADW,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,EAAC,GAAG,KAAG,IAAI,CAAC,CAAC,CAChB;IAC5B,iCAAiC;IACjC,cADW,GAAG,EAAE,CACM;IAEtB,mBAAmB;IACnB,sBAAyB;IACzB,uBAAgC;IAChC,qBAA8B;IAC9B,6BAAgC;IAGhC,+BAA0B;IAC1B,0BAAqB;IACrB,kBAAwB;IACxB,oBAA0B;IAC1B,mCAA8B;IAG9B,8BAA2B;IAC3B,6CAAkC;IAClC,8CAAiC;IAGnC,0BAEC;IAID;;OAEG;IACH,wBAoBC;IAED,sCAAsC;IACtC,cA2BC;IAED;;;OAGG;IACH,wDAeC;IAED,mCAAmC;IACnC,yBAEC;IAED,+BAOC;IAED;;;;;;OAMG;IACH,eAJW,MAAM,MACN,CAAC,GAAG,EAAC,GAAG,KAAG,IAAI,GACb,MAAI,IAAI,CAYpB;IAED;;;;;OAKG;IACH,2CAGC;IAED,wBAAwB;IACxB,4BAEC;IAID,uBA2BC;IAED,gBAuBC;IAED,uCA4BC;IAED,yBAGC;IAID,8CAA8C;IAC9C,yBAoCC;IAED,6DAA6D;IAC7D,mBAgBC;IAID,2BAsCC;IAED,gDAIC;IAED,kDAMC;IAED,kCAOC;IAID,iCAaC;IAED,2BAqBC;IAID,wBAiBC;IAED,+BAYC;IAED,wBAGC;IAID,4BAaC;IAED,2BAEC;IAED,0BAQC;IAID,wBAIC;CACF"}

package/types/util.d.ts

@@ -0,0 +1,20 @@
+/**
+ * WS op の応答 `resp` を検査し、失敗していれば例外を投げる。成功なら resp を返す。
+ *
+ * biz3 の応答には 2 系統あり、本ライブラリも両方を扱う:
+ *   - lenient (既定): `success` フィールドが**明示的に false** の時だけ失敗扱い。
+ *     `success` を持たない応答 (data だけ返る op、push 集約の完了通知など) は成功とみなす。
+ *   - strict: `success === true` を要求し、欠落していても失敗扱い
+ *     (常に success を返すと分かっている op 用)。
+ *
+ * @template T
+ * @param {T} resp           WS 応答メッセージ
+ * @param {string} op        失敗時メッセージに使う op ラベル
+ * @param {{strict?:boolean}} [opts]
+ * @returns {T} 成功時はそのまま resp を返す (呼び出し側で resp.data 等を取り出せる)
+ * @throws {Error} 失敗時 (`<op> failed: <message|JSON>`)
+ */
+export function assertSuccess<T>(resp: T, op: string, { strict }?: {
+    strict?: boolean;
+}): T;
+//# sourceMappingURL=util.d.ts.map

package/types/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AACH,8BAPa,CAAC,QACH,CAAC,MACD,MAAM,eACN;IAAC,MAAM,CAAC,EAAC,OAAO,CAAA;CAAC,GACf,CAAC,CASb"}

package/vendor/biz3/README.md

@@ -0,0 +1,37 @@
+# vendor/biz3 — 公式 biz3 由来の純定数 (原文ママ)
+
+CANDY-HOUSE/biz.candyhouse.co (通称 "biz3", MIT) の **React 非依存・import ゼロの純定数ファイル**を原文のまま
+コピーしたもの。当実装はこれらを **直接 import** して single source of truth とする
+(手書きで写すと推測ミス＝定数のズレが入るため。実際 irType/productType 等で過去に発生)。
+
+| ファイル | biz3 の元パス | 当実装での用途 |
+|---|---|---|
+| `constants/sesameDeviceModel.js` | `src/constants/sesameDeviceModel.js` | `crypto.js` の PRODUCT_TYPE / model 名 |
+| `constants/messageConstants.js` | `src/constants/messageConstants.js` | ACTION 文字列 / WS_HEARTBEAT_INTERVAL_MS |
+| `constants/cmdCode.js` | `src/constants/cmdCode.js` | item code 参照 |
+
+## 更新方法
+
+biz3 が定数を変えたら、元リポ (references) から再コピーするだけ:
+
+```
+cp <biz3>/src/constants/{sesameDeviceModel,messageConstants,cmdCode}.js vendor/biz3/constants/
+```
+
+`package.json` の `{"type":"module"}` は Node が ESM として解釈するために置いている
+(biz3 本体は CRA で type 未指定のため、ここだけ補う)。
+
+## 取り込んでいないもの (構造的に直接 import 不可)
+
+- **irType** (`src/pages/personal/devices/wifi-module/ir/ir-type-list/index.js`): MUI/JSX
+  コンポーネントのため import 不可。ただし中身は **5 種のみ** (air 0xc000 / tv 0x2000 /
+  light 0xe000 / fan 0x8000 / learn) で、`src/crypto.js` の `IR_TYPE` に出所コメント付きで全て保持済み。
+  **重要**: `learn` は ir-type-list の UI 値 `0xfeff` ではなく **実 type `0xfe00`** が正
+  (`.../ir/learn/index.js:142` で保存時 `type: 0xfe00` を確認)。JSX をそのまま写すと learn が
+  バグるため、手書き保持が結果的に正しい。
+- **lockModelDevices** (`gUtils.js`): gConfig 等に依存するため import 不可。
+  `src/config.js` の `LOCK_MODELS` に biz3 の14機種をコメント付きで手書き保持。
+- **wsUrl** (`env_config.js`): biz3 は `/public` だが元実装が実機で疎通したのは
+  `/production`。対立があり直接採用しないため取り込まない (config.js のコメント参照)。
+
+ライセンスは CANDY HOUSE MIT (リポルートの `LICENSE.biz3`)。

package/vendor/biz3/constants/cmdCode.d.ts

@@ -0,0 +1,48 @@
+export namespace cmdCode {
+    let ssmOSUpdate: number;
+    let cardPut: number;
+    let cardDelete: number;
+    let cardSet: number;
+    let cardSetFinish: number;
+    let fingerPut: number;
+    let fingerDelete: number;
+    let fingerSet: number;
+    let fingerSetFinish: number;
+    let passwordPut: number;
+    let passwordDelete: number;
+    let passwordSet: number;
+    let passwordSetFinish: number;
+    let SSM2_ITEM_CODE_MECH_STATUS: number;
+    let HUB3_ITEM_CODE_LED_DUTY: number;
+    let SSM3_ITEM_ADD_SESAME: number;
+    let SSM3_ITEM_PUB_KEY_SESAME: number;
+    let SSM3_ITEM_REMOVE_SESAME: number;
+    let SSM_OS3_CARD_CHANGE: number;
+    let SSM_OS3_CARD_DELETE: number;
+    let SSM_OS3_CARD_GET: number;
+    let SSM_OS3_CARD_NOTIFY: number;
+    let SSM_OS3_CARD_LAST: number;
+    let SSM_OS3_CARD_FIRST: number;
+    let SSM_OS3_CARD_MODE_GET: number;
+    let SSM_OS3_CARD_MODE_SET: number;
+    let HUB3_MATTER_PAIRING_CODE: number;
+    let SSM_OS3_CARD_ADD: number;
+    let HUB3_MATTER_PAIRING_WINDOW: number;
+    let STP_ITEM_CODE_CARDS_ADD: number;
+    let STP_ITEM_CODE_CARDS_DELETE: number;
+    let STP_ITEM_CODE_PASSCODES_ADD: number;
+    let STP_ITEM_CODE_PASSCODES_DELETE: number;
+    let STP_ITEM_CODE_PASSCODE_CHANGE_VALUE: number;
+    let SSM_OS3_PASSCODE_CHANGE: number;
+    let SSM_OS3_PASSCODE_DELETE: number;
+    let SSM_OS3_PASSCODE_GET: number;
+    let SSM_OS3_PASSCODE_NOTIFY: number;
+    let SSM_OS3_PASSCODE_LAST: number;
+    let SSM_OS3_PASSCODE_FIRST: number;
+    let SSM_OS3_PASSCODE_MODE_GET: number;
+    let SSM_OS3_PASSCODE_MODE_SET: number;
+    let SSM_OS3_PASSCODE_ADD: number;
+    let HUB3_ITEM_CODE_RELAY_SWITCH: number;
+    let HUB3_ITEM_CODE_CLEAR_WIFI_SSID: number;
+}
+//# sourceMappingURL=cmdCode.d.ts.map

package/vendor/biz3/constants/cmdCode.d.ts.map

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

package/vendor/biz3/constants/cmdCode.js

@@ -0,0 +1,92 @@
+/*  旧版 biz 的部分代码：
+    - Sesame5 操作
+        - 01 添加sesame设备 - 從STP發送到IoT
+        - 02 删除sesame设备 - 從STP發送到IoT
+        - 03 stp login sesame - 從STP發送到IoT
+        { "op": "01", "s": "UUID( 36 bytes )" }
+    - 卡片操作
+        - 11: 上報卡片 - 從刷卡機添加（from STP to IoT）
+        - 12: 上報刪除卡片 - 從刷卡機刪除（from STP to IoT）
+        - 13: 修改卡片 - 從IoT發送到STP
+        - 14: 插入卡片 - 從IoT發送到STP
+        - 15: 刪除卡片 - 從IoT發送到STP
+        - 18: 進入卡片錄入模式
+        - 19: 進入卡片驗證模式
+        - 6D: get cards list (from IoT to STP)  SSM_OS3_CARD_GET      = 109,  // 0x6D
+        - B6: put cards list (from IoT to STP)  STP_ITEM_CODE_CARDS_ADD = 182,  // 0xB6
+
+    - 指纹
+        - 21 上报指纹  (刷卡机添加 from STP to IoT)
+        - 22 删除指纹  (from STP to IoT)
+        // - 23 修改指纹name  (only for name)
+        // - 24 插入指纹 (from IoT to STP) do not support
+        - 25 删除指纹 (from IoT to STP)
+        - 28 進入指纹錄入模式  (from IoT to STP)
+        - 29 進入指纹驗證模式  (from IoT to STP)
+
+    - 密碼操作
+        - 31: 上報密碼       - 從STP發送到IoT V
+        - 32: 上報刪除密碼    - 從STP發送到IoT V
+        - 33: 修改密碼       - 從IoT發送到STP
+        - 34: 插入密碼       - 從IoT發送到STP V
+        - 35: 刪除密碼       - 從IoT發送到STP V
+        - 38: 進入密碼錄入模式    - 從IoT發送到STP V
+        - 39: 進入密碼驗證模式    - 從IoT發送到STP V
+        - 7D: get cards list (from IoT to STP)  SSM_OS3_PASSCODE_GET = 125, // 0x7D
+
+    - 機械狀態
+        - m: 上報機械狀態 - 從STP發送到IoT
+        {"m":"c70c"}
+        c70c: 3271 mV
+    - Sesame Touch Pro Status
+        - 183: 上報STP狀態 - 從STP發送到IoT
+
+    Biz3: 尽量靠拢刷卡机的 BLE 代码 https://github.com/CANDY-HOUSE/SesameOS3_OM6621_2933/blob/master/external/candy/candy.h#L85
+*/
+export const cmdCode = {
+  ssmOSUpdate: 0x03,
+  cardPut: 14,
+  cardDelete: 15,
+  cardSet: 18,
+  cardSetFinish: 19,
+  fingerPut: 24,
+  fingerDelete: 25,
+  fingerSet: 28,
+  fingerSetFinish: 29,
+  passwordPut: 34,
+  passwordDelete: 35,
+  passwordSet: 38,
+  passwordSetFinish: 39,
+  SSM2_ITEM_CODE_MECH_STATUS: 81,
+  HUB3_ITEM_CODE_LED_DUTY: 92,
+  SSM3_ITEM_ADD_SESAME: 101,
+  SSM3_ITEM_PUB_KEY_SESAME: 102,
+  SSM3_ITEM_REMOVE_SESAME: 103,
+  SSM_OS3_CARD_CHANGE: 107,
+  SSM_OS3_CARD_DELETE: 108,
+  SSM_OS3_CARD_GET: 109,
+  SSM_OS3_CARD_NOTIFY: 110,
+  SSM_OS3_CARD_LAST: 111,
+  SSM_OS3_CARD_FIRST: 112,
+  SSM_OS3_CARD_MODE_GET: 113,
+  SSM_OS3_CARD_MODE_SET: 114,
+  HUB3_MATTER_PAIRING_CODE: 137,
+  SSM_OS3_CARD_ADD: 140,
+  HUB3_MATTER_PAIRING_WINDOW: 153,
+  STP_ITEM_CODE_CARDS_ADD: 182, // 0xB6
+  STP_ITEM_CODE_CARDS_DELETE: 183, // 0xB7
+  STP_ITEM_CODE_PASSCODES_ADD: 184,
+  STP_ITEM_CODE_PASSCODES_DELETE: 185,
+  STP_ITEM_CODE_PASSCODE_CHANGE_VALUE: 137,
+  SSM_OS3_PASSCODE_CHANGE: 123,
+  SSM_OS3_PASSCODE_DELETE: 124,
+  SSM_OS3_PASSCODE_GET: 125,
+  SSM_OS3_PASSCODE_NOTIFY: 126,
+  SSM_OS3_PASSCODE_LAST: 127,
+  SSM_OS3_PASSCODE_FIRST: 128,
+  SSM_OS3_PASSCODE_MODE_GET: 129,
+  SSM_OS3_PASSCODE_MODE_SET: 130,
+  SSM_OS3_PASSCODE_ADD: 138,
+  HUB3_ITEM_CODE_RELAY_SWITCH: 208,
+  HUB3_ITEM_CODE_CLEAR_WIFI_SSID: 210,
+};