sesame-kit 0.4.0

package/types/client.d.ts

@@ -0,0 +1,463 @@
+export class SesameHub3 {
+    /**
+     * 既定の設定ディレクトリ (~/.config/sesame-hub3 等) から読み込んで構築。
+     * CLI 内部はこのファクトリを使う。
+     * @param {{ configDir?: string, debug?: boolean }} [opts]
+     */
+    static fromConfig(opts?: {
+        configDir?: string;
+        debug?: boolean;
+    }): Promise<SesameHub3>;
+    /**
+     * 自動 connect/close ヘルパ。boilerplate 削減用。
+     *
+     *   await SesameHub3.use(async (hub) => { await hub.unlock("front"); });
+     *   await SesameHub3.use({ configDir: "/tmp/cfg" }, async (hub) => { ... });
+     *   await SesameHub3.use({ tokenStore: myStore, config: {...} }, async (hub) => { ... });
+     *
+     * config / tokenStore を opts で渡せば fromConfig をスキップ (他プロジェクト埋込み用)。
+     *
+     * @param {((hub:SesameHub3) => Promise<any>) | object} fnOrOpts
+     * @param {(hub:SesameHub3) => Promise<any>} [maybeFn]
+     */
+    static use(fnOrOpts: ((hub: SesameHub3) => Promise<any>) | object, maybeFn?: (hub: SesameHub3) => Promise<any>): Promise<any>;
+    /**
+     * @param {{
+     *   config: object,
+     *   tokenStore: TokenStore,
+     *   configStore?: ConfigStore,
+     *   debug?: boolean,
+     * }} args
+     */
+    constructor({ config, tokenStore, configStore, debug }: {
+        config: object;
+        tokenStore: TokenStore;
+        configStore?: ConfigStore;
+        debug?: boolean;
+    });
+    _config: any;
+    _configStore: ConfigStore;
+    _tokenStore: TokenStore;
+    _debug: boolean;
+    /** @type {Hub3WsClient | null} */
+    _ws: Hub3WsClient | null;
+    _subUUID: any;
+    /**
+     * close() 時に await したい async cleanup 関数の集合 (2nd-pass M-1)。
+     * `onIRLearned` 等の戻り値 unsubscribe は呼び出し側の await 忘れで Hub3 が
+     * REGISTER モードに残るリスクがあるため、ここに登録しておくと close() で確実に走る。
+     */
+    _pendingCleanups: Set<any>;
+    /** WS 再接続 (初回以外の OPEN) で呼ぶコールバック集合。購読者の再 subscribe 用。 */
+    _reconnectCbs: Set<any>;
+    /**
+     * WS 再接続時に呼ばれるコールバックを登録する。戻り値で解除。
+     * デーモン等、再接続後にサーバ購読 (subscribe frame) を張り直したい用途向け。
+     * @param {() => void} cb
+     * @returns {() => void} unsubscribe
+     */
+    onReconnect(cb: () => void): () => void;
+    /** 登録済み再接続コールバックを発火する (transport の onReopen から呼ばれる)。 */
+    _fireReconnect(): void;
+    get config(): any;
+    get configStore(): ConfigStore;
+    get tokenStore(): TokenStore;
+    get connected(): boolean;
+    /**
+     * remote 名 (省略時は default) から remote 定義と親 hub3 をまとめて取得。
+     */
+    resolveRemote(name: any): {
+        name: any;
+        remote: any;
+        hub3Name: any;
+        hub3: any;
+    };
+    /** WS 接続を確立。既に接続済みなら何もしない。 */
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    _ensureConnected(): void;
+    _bindNs(mod: any): {};
+    /** スケジュール (biz3Schedule)。 */
+    get schedule(): {};
+    /** 組織管理 (employee/group/role/device-group/employee-device)。 */
+    get org(): {};
+    /** 会社 (biz3ManageCompany)。 */
+    get company(): {};
+    /** 認証データ (NFC カード/パスコードの WS op)。 */
+    get access(): {};
+    /** IoT cmd (biz3OperateIoT: DFU/LED/リレー/Sesame item)。 */
+    get iot(): {};
+    /** プリセットリモコン command 生成 (remoteEmit, HXD)。 */
+    get presetir(): {};
+    /**
+     * IR 発射 (name-based)。`keyOrUUID` が UUID 形式ならそのまま command として、
+     * そうでなければ remote.keys から名前解決する。
+     * config を介さない版は {@link SesameHub3#sendIRDirect}。
+     *
+     * @param {string|null} remoteName リモコン名 (null で default.remote)
+     * @param {string} keyOrUUID キー名 or keyUUID
+     * @returns {Promise<object>} sendIR の応答 (success / data.message 等)
+     */
+    send(remoteName: string | null, keyOrUUID: string): Promise<object>;
+    /**
+     * リモコンに登録されている IR キー一覧をサーバから取得 (name-based)。
+     * config を介さない版は {@link SesameHub3#getIRCodesDirect}。
+     *
+     * @param {string|null} remoteName リモコン名 (null で default.remote)
+     * @returns {Promise<Array<{name:string, keyUUID:string}>>}
+     */
+    listKeys(remoteName: string | null): Promise<Array<{
+        name: string;
+        keyUUID: string;
+    }>>;
+    /**
+     * 接続疎通確認: biz3KeepAlive を 1 往復して ack を待つ。
+     * 失敗時は throw。
+     */
+    ping(): Promise<boolean>;
+    /**
+     * ログインユーザの customerInfo / quotas を取得 (biz3GetLoginUser)。
+     * email は tokenStore の username (login に使った値) を使う。
+     * @returns {Promise<{customerInfo: object|null, quotas: object|null}>}
+     */
+    getLoginUser(): Promise<{
+        customerInfo: object | null;
+        quotas: object | null;
+    }>;
+    /**
+     * biz3GetLoginUser で実 companyID / subUUID を取得し、config と内部状態に反映する。
+     * companyID は従来デフォルト (ch_CandyhouseMobile) を置いていたが、これで実値に上書きできる。
+     * @returns {Promise<object|null>} customerInfo
+     */
+    refreshAccount(): Promise<object | null>;
+    /**
+     * 全 SESAME デバイス (Hub3 含む) のリストを取得。
+     * biz3ManageDevice/getCompanyDevice → PubedCompanyDevice の応答を待つ。
+     */
+    listDevices({ timeoutMs }?: {
+        timeoutMs?: number;
+    }): Promise<any>;
+    _requireConfigStore(op: any): void;
+    /**
+     * 全 SESAME デバイスを引いてロックを config に取り込む。
+     * @param {{prune?:boolean}} [opts]
+     * @returns {Promise<{added:string[], updated:string[], removed:string[]}>}
+     */
+    syncLocksFromDevices(opts?: {
+        prune?: boolean;
+    }): Promise<{
+        added: string[];
+        updated: string[];
+        removed: string[];
+    }>;
+    /**
+     * 全 SESAME デバイスを引いて Hub3 を config に取り込む。
+     * @param {{prune?:boolean}} [opts]
+     * @returns {Promise<{added:string[], updated:string[], removed:string[]}>}
+     */
+    syncHub3sFromDevices(opts?: {
+        prune?: boolean;
+    }): Promise<{
+        added: string[];
+        updated: string[];
+        removed: string[];
+    }>;
+    /**
+     * `devices` 応答だけからリモコンを config に取り込む (引数不要)。
+     * 内部で Hub3 を自動登録してから、各 Hub3 の stateInfo.remoteList を展開する。
+     * irType はリモコン側が持っているのでユーザー指定不要。
+     * @returns {Promise<{hub3:{added,updated,removed}, remotes:{added,updated}}>}
+     */
+    syncRemotesFromDevices(): Promise<{
+        hub3: {
+            added: any;
+            updated: any;
+            removed: any;
+        };
+        remotes: {
+            added: any;
+            updated: any;
+        };
+    }>;
+    /**
+     * devices から「Hub3 とその配下リモコン」をフラットに取得 (登録せず一覧だけ)。
+     * 対話 add で候補を見せる用途。
+     * @returns {Promise<Array<{hub3DeviceUUID:string, hub3Name:string, uuid:string, type:number, alias:string|null}>>}
+     */
+    listRemotesFromDevices(): Promise<Array<{
+        hub3DeviceUUID: string;
+        hub3Name: string;
+        uuid: string;
+        type: number;
+        alias: string | null;
+    }>>;
+    /**
+     * server 側 (getRemoteList) のリモコンを config に取り込む (上級/代替経路)。
+     * 通常は syncRemotesFromDevices で足りる。
+     * @param {string} hub3Name これらのリモコンが属する Hub3 の config 名
+     * @param {number} irType 取得するリモコンの irType (例 49152=エアコン)
+     * @returns {Promise<{added:string[], updated:string[]}>}
+     */
+    syncRemotesFromServer(hub3Name: string, irType: number): Promise<{
+        added: string[];
+        updated: string[];
+    }>;
+    /**
+     * 指定 remote のキー一覧を server から取得して config に書き戻す。
+     * @param {string|null} remoteName
+     * @returns {Promise<{name:string, keyCount:number}>}
+     */
+    syncRemoteKeys(remoteName: string | null): Promise<{
+        name: string;
+        keyCount: number;
+    }>;
+    /**
+     * lock 設定を name から解決。name 省略時は default.lock、
+     * 無ければ locks が 1 つだけならそれ。
+     */
+    resolveLock(name: any): {
+        name: any;
+        lock: any;
+    };
+    _lockParams(name: any): {
+        deviceId: any;
+        secretKey: any;
+        subUUID: any;
+    };
+    /**
+     * ロック施錠 (name-based, cmd=82)。config を介さない版は {@link SesameHub3#lockDevice}。
+     * @param {string|null} [name] ロック名 (null で default.lock)
+     * @returns {Promise<object>} pubDeviceStateChange の応答
+     */
+    lock(name?: string | null): Promise<object>;
+    /**
+     * ロック解錠 (name-based, cmd=83)。config を介さない版は {@link SesameHub3#unlockDevice}。
+     * @param {string|null} [name] ロック名 (null で default.lock)
+     * @returns {Promise<object>} pubDeviceStateChange の応答
+     */
+    unlock(name?: string | null): Promise<object>;
+    /**
+     * トグル (name-based, cmd=88, cloud のみの合成命令)。
+     * @param {string|null} [name] ロック名 (null で default.lock)
+     * @returns {Promise<object>}
+     */
+    toggle(name?: string | null): Promise<object>;
+    /**
+     * SESAME Bot クリック (name-based, cmd=89)。
+     * 注: lock.js の低レベル関数 `botClick(client, params)` とは別物 (こちらは name で解決)。
+     * @param {string|null} [name] ロック名 (null で default.lock)
+     * @returns {Promise<object>}
+     */
+    botClick(name?: string | null): Promise<object>;
+    /**
+     * デバッグ用: WS の全受信メッセージを購読する (戻り値で unsubscribe)。
+     * fire-and-forget な op (autolock 等) のサーバ応答を観測するのに使う。
+     * @param {(msg:object)=>void} fn
+     * @returns {()=>void} unsubscribe
+     */
+    onAnyMessage(fn: (msg: object) => void): () => void;
+    /** 任意 cmd 直指定 (上級用)。 */
+    triggerLockRaw(name: any, cmd: any): Promise<any>;
+    /**
+     * オートロック設定 (name-based)。解錠 N 秒後に自動施錠。`seconds=0` で無効。
+     *
+     * ⚠️ 実験的 / 実機未検証: クラウド中継 (Hub3) が autolock(ItemCode 11) を通すかは前例が無い。
+     *    公式アプリは BLE で送っている。fire-and-forget (応答待ちしない)。
+     *
+     * @param {string|null} name ロック名 (null で default.lock)
+     * @param {number} seconds 0..65535 (0=無効)
+     * @param {number} [timeoutMs] ack 待ちタイムアウト
+     * @returns {Promise<{ack:any, cmd:number, seconds:number}>}
+     */
+    setAutolock(name: string | null, seconds: number, timeoutMs?: number): Promise<{
+        ack: any;
+        cmd: number;
+        seconds: number;
+    }>;
+    get subUUID(): any;
+    /** Hub3 を学習モードに入れ、物理リモコンの 1 ボタンを学習して remote にキー登録。 */
+    learnIR(remoteName: any, keyName: any, { timeoutMs, onPrompt }?: {
+        timeoutMs?: number;
+    }): Promise<{
+        keyUUID: string;
+        captured: any;
+        saved: any;
+    }>;
+    listIRRemotes(type: any, { page, pageSize }?: {}): Promise<any>;
+    searchPresetIRRemotes(type: any, searchTerm: any): Promise<any>;
+    addIRRemoteServer(remoteObj: any): Promise<any>;
+    deleteIRRemoteServer(remoteName: any): Promise<any>;
+    renameIRRemote(remoteName: any, alias: any): Promise<any>;
+    deleteIRKey(remoteName: any, keyOrUUID: any): Promise<any>;
+    renameIRKey(remoteName: any, keyOrUUID: any, newName: any): Promise<any>;
+    getIRMode(hub3Name: any): Promise<any>;
+    setIRMode(hub3Name: any, mode: any): Promise<any>;
+    matchIRRemote({ irData, irType, brandName }: {
+        irData: any;
+        irType: any;
+        brandName: any;
+    }): Promise<any>;
+    _resolveHub3(name: any): any;
+    /** 個人ユーザのデバイス一覧 (会社 vs 個人で別 op)。 */
+    listUserDevices(): Promise<any>;
+    getDeviceStatus(deviceUUID: any): Promise<any>;
+    renameDevice(deviceUUID: any, deviceName: any): Promise<any>;
+    /** company から指定 UUID のデバイスを削除。 */
+    deleteDevice(deviceUUID: any): Promise<any>;
+    /**
+     * @deprecated `onDeviceUpdate(items, fn)` を使ってください (on* イベント命名に統一)。
+     * 後方互換のため残置。内部実装は onDeviceUpdate と同一。
+     */
+    subscribeDeviceUpdates(deviceInfos: any, onUpdate: any): any;
+    /** ロック開閉履歴を取得。`list` はデバイス指定の配列。 */
+    getDeviceHistory(list: any, pageSize: any): Promise<any>;
+    /** 電池履歴を取得 (1ページ)。lastEvaluatedKey でページング。 */
+    getDeviceBattery(deviceUUID: any, { lastEvaluatedKey, pageSize }?: {
+        lastEvaluatedKey?: any;
+        pageSize?: number;
+    }): Promise<any>;
+    listFirmware(): Promise<any>;
+    /** WebAPI proxy 経由で REST API を叩く。apiKeyId は config 側に保存。 */
+    invokeWebAPI({ func, query, body, apiKeyId }: {
+        func: any;
+        query: any;
+        body: any;
+        apiKeyId: any;
+    }): Promise<any>;
+    /**
+     * 直接 lock 制御 (config を介さない, 任意 cmd)。`unlockDevice`/`lockDevice` 等の基底。
+     * @param {{deviceUUID:string, secretKey:string, cmd:number, timeoutMs?:number}} p
+     *   deviceUUID: ロックの UUID / secretKey: 32hex 共通鍵 (devices で取得) /
+     *   cmd: 82=LOCK 83=UNLOCK 88=TOGGLE 89=CLICK
+     * @returns {Promise<object>} pubDeviceStateChange の応答
+     */
+    triggerLockDevice({ deviceUUID, secretKey, cmd, timeoutMs }: {
+        deviceUUID: string;
+        secretKey: string;
+        cmd: number;
+        timeoutMs?: number;
+    }): Promise<object>;
+    /**
+     * 直接 解錠 (config を介さない, cmd=83)。
+     * @param {{deviceUUID:string, secretKey:string, timeoutMs?:number}} p
+     * @returns {Promise<object>} pubDeviceStateChange の応答
+     */
+    unlockDevice(p: {
+        deviceUUID: string;
+        secretKey: string;
+        timeoutMs?: number;
+    }): Promise<object>;
+    /**
+     * 直接 施錠 (config を介さない, cmd=82)。
+     * @param {{deviceUUID:string, secretKey:string, timeoutMs?:number}} p
+     * @returns {Promise<object>}
+     */
+    lockDevice(p: {
+        deviceUUID: string;
+        secretKey: string;
+        timeoutMs?: number;
+    }): Promise<object>;
+    /**
+     * 直接 トグル (config を介さない, cmd=88)。
+     * @param {{deviceUUID:string, secretKey:string, timeoutMs?:number}} p
+     * @returns {Promise<object>}
+     */
+    toggleDevice(p: {
+        deviceUUID: string;
+        secretKey: string;
+        timeoutMs?: number;
+    }): Promise<object>;
+    /**
+     * 直接 Bot クリック (config を介さない, cmd=89)。
+     * @param {{deviceUUID:string, secretKey:string, timeoutMs?:number}} p
+     * @returns {Promise<object>}
+     */
+    botClickDevice(p: {
+        deviceUUID: string;
+        secretKey: string;
+        timeoutMs?: number;
+    }): Promise<object>;
+    /**
+     * 直接 IR 発射 (config を介さない)。
+     * @param {{hub3DeviceId:string, irDeviceUUID:string, irType:number, command:string, operation?:string}} p
+     *   hub3DeviceId: Hub3 UUID / irDeviceUUID: リモコン UUID / irType: 例 49152 /
+     *   command: keyUUID か 16byte hex / operation: "learnEmit" (default) | "remoteEmit"
+     * @returns {Promise<object>} sendIR の応答
+     */
+    sendIRDirect({ hub3DeviceId, irDeviceUUID, irType, command, operation }: {
+        hub3DeviceId: string;
+        irDeviceUUID: string;
+        irType: number;
+        command: string;
+        operation?: string;
+    }): Promise<object>;
+    /**
+     * 直接 IR キー一覧取得 (config を介さない)。
+     * @param {{hub3DeviceId:string, irDeviceUUID:string}} p
+     * @returns {Promise<Array<{name:string, keyUUID:string}>>}
+     */
+    getIRCodesDirect({ hub3DeviceId, irDeviceUUID }: {
+        hub3DeviceId: string;
+        irDeviceUUID: string;
+    }): Promise<Array<{
+        name: string;
+        keyUUID: string;
+    }>>;
+    /** name で指定したロックの state change push を購読。戻り値は unsubscribe。 */
+    onLockStateChange(name: any, fn: any): () => void;
+    /** UUID 直指定で state change を購読。 */
+    onLockStateChangeDevice(deviceUUID: any, fn: any): () => void;
+    /**
+     * IR 学習データの購読 (受け取った波形を fn に流す)。
+     * 内部で setIRMode(REGISTER) → subscribeIRData を発行する。
+     *
+     * **重要**: 戻り値の async unsubscribe 関数は **必ず `await` してください**。
+     * await 忘れで親プロセスが先に終了すると、Hub3 が REGISTER モードに残ります
+     * (Review M-1)。`hub.close()` を呼んでも Hub3 側のモードは元に戻りません。
+     *
+     * 戻り値: async () => Promise<void>  — subscribe 解除 + setIRMode(CONTROL) 復帰
+     */
+    onIRLearned(hub3Name: any, fn: any): Promise<() => Promise<void>>;
+    /**
+     * デバイス state push の購読 (複数デバイスまとめて)。
+     * @param {{deviceUUID:string, deviceModel?:string}[]} items
+     * @param {(msg:any) => void} fn
+     */
+    onDeviceUpdate(items: {
+        deviceUUID: string;
+        deviceModel?: string;
+    }[], fn: (msg: any) => void): any;
+}
+/**
+ * トークン永続化インターフェース。FileTokenStore がデフォルト実装。
+ * 独自実装 (keychain / DB / メモリ) を渡す場合は下記 6 メソッドすべて必須。
+ */
+export type TokenStore = {
+    /**
+     * 保存済みトークン {idToken, refreshToken, clientId, accessToken?, deviceKey?} を返す。無ければ null
+     */
+    load: () => (object | null);
+    /**
+     * トークンを永続化 (refresh 時に呼ばれる)
+     */
+    save: (tokens: object) => void;
+    /**
+     * トークンを破棄
+     */
+    clear: () => void;
+    /**
+     * sign-in 進行中の一時状態を返す。無ければ null
+     */
+    loadPending: () => (object | null);
+    /**
+     * sign-in 進行中の一時状態を保存
+     */
+    savePending: (state: object) => void;
+    /**
+     * sign-in 一時状態を破棄
+     */
+    clearPending: () => void;
+};
+import { ConfigStore } from "./config.js";
+import { Hub3WsClient } from "./transport.js";
+//# sourceMappingURL=client.d.ts.map

package/types/client.d.ts.map

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

package/types/company.d.ts

@@ -0,0 +1,94 @@
+/**
+ * ログインセッションのユーザに紐づく全 company の一覧を取得する。
+ *
+ * biz3 getCompanies (useStripeInfo.js:73-82): フレームは {action, op:'get'} のみで
+ * companyID も email も送らない (obj ラップ無し)。応答は handleCompaniesResponse の
+ * 'get' case (useStripeInfo.js:161-165) で message.success のとき message.data が
+ * company オブジェクトの配列。各要素の確認済みフィールド:
+ *   companyID, name, feeLevel{subscriptionId, isRootUser:bool, level:number},
+ *   tag (配列。tag[0]==='オーナー' で isOwner 判定), isSesameApp:bool,
+ *   employeeEmail, subUUID  (useStripeInfo.js:41-71, 277 で読み出しを確認)。
+ *
+ * 注: 応答は配列であって obj ラップではない。companyID は他 op
+ * (updateName/getPaymentConfig) が要求する priorityCompanyId の一次データ。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{timeoutMs?:number}} [params]
+ * @returns {Promise<object[]>} company オブジェクトの配列
+ */
+export function getCompanies(client: import("./transport.js").Hub3WsClient, { timeoutMs }?: {
+    timeoutMs?: number;
+}): Promise<object[]>;
+/**
+ * 会社名を変更する。
+ *
+ * biz3 updateCompanyName (useStripeInfo.js:293-305): フレームは
+ * {action, obj:{companyID, name}, op:'updateName'} で、companyID/name は必ず obj の
+ * 内側に入れる (トップレベルに companyID を置かない)。companyID は priorityCompanyId
+ * (= get 応答から決まる優先会社の companyID)。
+ *
+ * 応答 (useStripeInfo.js:166-174): message.success のとき message.data === {companyID, name}
+ * (更新後の値。配列ではない)。biz3 はこの companyID 一致の company の name を差し替える。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{companyID:string, name:string, timeoutMs?:number}} params
+ * @returns {Promise<{companyID:string, name:string}>} 更新後の {companyID, name}
+ */
+export function updateCompanyName(client: import("./transport.js").Hub3WsClient, { companyID, name, timeoutMs }: {
+    companyID: string;
+    name: string;
+    timeoutMs?: number;
+}): Promise<{
+    companyID: string;
+    name: string;
+}>;
+/**
+ * 会社を新規登録する。
+ *
+ * biz3 addCompany (useStripeInfo.js:307-320): フレームは
+ * {action, name, employeeEmail, subUUID, op:'add'} とフラット展開 (obj ラップ無し)。
+ * companyID は送らない (新規作成のため)。呼び出し元 (layout/index.js:300-309) では
+ * name=入力会社名, employeeEmail=customerInfo.employeeEmail, subUUID=customerInfo.subUUID
+ * を渡す。employeeEmail / subUUID はログインユーザの customerInfo (biz3GetLoginUser 応答)
+ * 由来であり、CLI では既ログインユーザ情報から補完する必要がある。
+ *
+ * 応答 (useStripeInfo.js:175-179): message.success のとき message.data が新規 company
+ * 1件で、biz3 は companies 配列に push する (setCompanies(prev => [...prev, message.data]))。
+ * data は get の配列要素と同型 (companyID, name 等) と推定されるが、add 応答 data の
+ * 個別フィールドは biz3 で読み出されておらず詳細は未確認 (push のみ)。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{name:string, employeeEmail:string, subUUID:string, timeoutMs?:number}} params
+ * @returns {Promise<object>} 新規 company オブジェクト (応答 data)
+ */
+export function addCompany(client: import("./transport.js").Hub3WsClient, { name, employeeEmail, subUUID, timeoutMs }: {
+    name: string;
+    employeeEmail: string;
+    subUUID: string;
+    timeoutMs?: number;
+}): Promise<object>;
+/**
+ * 課金レベル設定 (料金プラン設定) を取得する。
+ *
+ * biz3 getLevelConfig (useStripeInfo.js:322-334): フレームは
+ * {action, companyID:<priorityCompanyId>, op:'getPaymentConfig'} で companyID は
+ * トップレベルに直接置く (obj ラップ無し)。companyID は priorityCompanyId
+ * (get 応答由来の優先会社 ID)。
+ *
+ * 応答: biz3 では handleCompaniesResponse の switch に getPaymentConfig case が無く、
+ * invokeCallbacks(message) (useStripeInfo.js:159) で op 単位コールバックへ委譲される。
+ * よって応答 data の構造はこのファイルからは未確認 (呼び出し側 cb 依存)。
+ * action='biz3ManageCompany' + op='getPaymentConfig' で返る点のみ確定。
+ *
+ * 未確認: 応答 data のフィールド集合 (実機検証要)。本実装は resp.data をそのまま返す。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{companyID:string, timeoutMs?:number}} params
+ * @returns {Promise<*>} 課金レベル設定 (応答 data。構造未確認)
+ */
+export function getPaymentConfig(client: import("./transport.js").Hub3WsClient, { companyID, timeoutMs }: {
+    companyID: string;
+    timeoutMs?: number;
+}): Promise<any>;
+export const NAMESPACE_OPS: string[];
+//# sourceMappingURL=company.d.ts.map

package/types/company.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"company.d.ts","sourceRoot":"","sources":["../src/company.js"],"names":[],"mappings":"AAiCA;;;;;;;;;;;;;;;;;GAiBG;AACH,qCAJW,OAAO,gBAAgB,EAAE,YAAY,kBACrC;IAAC,SAAS,CAAC,EAAC,MAAM,CAAA;CAAC,GACjB,OAAO,CAAC,MAAM,EAAE,CAAC,CAO7B;AAED;;;;;;;;;;;;;;GAcG;AACH,0CAJW,OAAO,gBAAgB,EAAE,YAAY,kCACrC;IAAC,SAAS,EAAC,MAAM,CAAC;IAAC,IAAI,EAAC,MAAM,CAAC;IAAC,SAAS,CAAC,EAAC,MAAM,CAAA;CAAC,GAChD,OAAO,CAAC;IAAC,SAAS,EAAC,MAAM,CAAC;IAAC,IAAI,EAAC,MAAM,CAAA;CAAC,CAAC,CAYpD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,mCAJW,OAAO,gBAAgB,EAAE,YAAY,+CACrC;IAAC,IAAI,EAAC,MAAM,CAAC;IAAC,aAAa,EAAC,MAAM,CAAC;IAAC,OAAO,EAAC,MAAM,CAAC;IAAC,SAAS,CAAC,EAAC,MAAM,CAAA;CAAC,GACpE,OAAO,CAAC,MAAM,CAAC,CAY3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,yCAJW,OAAO,gBAAgB,EAAE,YAAY,4BACrC;IAAC,SAAS,EAAC,MAAM,CAAC;IAAC,SAAS,CAAC,EAAC,MAAM,CAAA;CAAC,GACnC,OAAO,CAAC,GAAC,CAAC,CAUtB;AAGD,qCAAqG"}

package/types/config.d.ts

@@ -0,0 +1,111 @@
+/** ロック系 model か (biz3 lockModelDevices と完全一致, gUtils.js:279-294)。 */
+export function isLockModel(model: any): boolean;
+/** Hub3 系 model か (hub_3 / hub_3_lte)。 */
+export function isHub3Model(model: any): boolean;
+export class ConfigStore {
+    static fromConfigDir(configDir: any): ConfigStore;
+    /**
+     * @param {string} configPath 絶対パス
+     */
+    constructor(configPath: string);
+    configPath: string;
+    data: any;
+    exists(): boolean;
+    /** ファイル不在時はメモリ上で空オブジェクトを返す (保存はしない)。 */
+    load(): any;
+    /** devices{} から locks{}/hub3s{} の派生 view (旧 shape) を都度組み立てる。reader 互換用。 */
+    _reproject(): void;
+    save(): void;
+    /** 空スケルトンを書き出す。既存があれば触らない。 */
+    init(): boolean;
+    /** name 省略時は default.remote、無ければ remotes が 1 つだけならそれ。 */
+    resolveRemote(name: any): {
+        name: any;
+        remote: any;
+        hub3Name: any;
+        hub3: any;
+    };
+    addHub3(name: any, hub3: any): void;
+    addRemote(name: any, remote: any): void;
+    setDefaultRemote(name: any): void;
+    updateRemoteKeys(name: any, keys: any): void;
+    /** name 省略時は default.lock、無ければ locks が 1 つだけならそれ。 */
+    resolveLock(name: any): {
+        name: any;
+        lock: any;
+    };
+    addLock(name: any, lock: any): void;
+    setDefaultLock(name: any): void;
+    removeLock(name: any): void;
+    /**
+     * @param {Array} deviceList
+     * @param {{ accept:(d:object)=>boolean, category:"lock"|"hub3", prune?:boolean,
+     *           onFirstAdd?:(name:string)=>void, pruneProtect?:(name:string)=>boolean }} opts
+     *   accept  受理条件 (取り込む incoming device の判定)
+     *   category この sync が司る view。prune はこの view に属する device だけを対象にする
+     * @returns {{added:string[], updated:string[], removed:string[]}}
+     */
+    _syncDevices(deviceList: any[], { accept, category, prune, onFirstAdd, pruneProtect }: {
+        accept: (d: object) => boolean;
+        category: "lock" | "hub3";
+        prune?: boolean;
+        onFirstAdd?: (name: string) => void;
+        pruneProtect?: (name: string) => boolean;
+    }): {
+        added: string[];
+        updated: string[];
+        removed: string[];
+    };
+    /**
+     * `devices` (getCompanyDevice 等) の結果からロックを取り込む (devices{} に丸ごと格納)。
+     * @param {Array} deviceList
+     * @param {{prune?:boolean}} [opts]
+     * @returns {{added:string[], updated:string[], removed:string[]}}
+     */
+    syncLocksFromDevices(deviceList: any[], { prune }?: {
+        prune?: boolean;
+    }): {
+        added: string[];
+        updated: string[];
+        removed: string[];
+    };
+    /**
+     * `devices` の結果から Hub3 を取り込む (deviceModel が hub_3 / hub_3_lte。devices{} に丸ごと格納)。
+     * @param {Array} deviceList
+     * @param {{prune?:boolean}} [opts]
+     * @returns {{added:string[], updated:string[], removed:string[]}}
+     */
+    syncHub3sFromDevices(deviceList: any[], { prune }?: {
+        prune?: boolean;
+    }): {
+        added: string[];
+        updated: string[];
+        removed: string[];
+    };
+    /**
+     * `devices` の応答だけからリモコンを取り込む (引数 irType 不要)。
+     *
+     * 各 Hub3 デバイスは `stateInfo.remoteList` に配下リモコンを
+     * `{uuid, type, alias?}` 付きで持っているので、それを直接展開する。
+     * 先に hub3s が登録済みである必要がある (syncHub3sFromDevices を先に呼ぶ)。
+     *
+     * @param {Array} deviceList  getCompanyDevice / getUserDevice の応答
+     * @returns {{added:string[], updated:string[]}}
+     */
+    syncRemotesFromDevices(deviceList: any[]): {
+        added: string[];
+        updated: string[];
+    };
+    /**
+     * server 側 (getRemoteList) のリモコン一覧から remote 定義を取り込む (上級/代替経路)。
+     * 通常は syncRemotesFromDevices で足りる。company 横断の一覧が欲しい場合のみ。
+     * @param {Array} remoteList  getRemoteList の応答 (irDeviceUUID/uuid, type, alias/name 等)
+     * @param {string} hub3Name   これらのリモコンが属する Hub3 の config 名
+     * @returns {{added:string[], updated:string[]}}
+     */
+    syncRemotesFromServer(remoteList: any[], hub3Name: string): {
+        added: string[];
+        updated: string[];
+    };
+}
+//# sourceMappingURL=config.d.ts.map