sesame-kit 0.4.0

package/types/access.d.ts

@@ -0,0 +1,193 @@
+/**
+ * 対象デバイスの NFC カード一覧を取得する。
+ * 応答は op='pubCardLinkedIDs' の async push で deviceUUID/page ごとに届くため、
+ * 内部で集約してから完了通知 or timeout で確定する (useManageAuthData.js:50-191)。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{deviceUUIDs:string[], timeoutMs?:number}} params
+ * @returns {Promise<{byDevice: Record<string, object[]>, items: object[]}>}
+ *   items の各要素: { cardID, nameUUID, name, cardType, subUUID, ..., uuids:string[] }
+ */
+export function getCards(client: import("./transport.js").Hub3WsClient, { deviceUUIDs, timeoutMs }: {
+    deviceUUIDs: string[];
+    timeoutMs?: number;
+}): Promise<{
+    byDevice: Record<string, object[]>;
+    items: object[];
+}>;
+/**
+ * 対象デバイスの暗証番号 (passcode) 一覧を取得する。getCards と同型。
+ * 応答データ本体は op='pubPasscodeLinkedIDs' で届く (useManageAuthData.js:189-191)。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{deviceUUIDs:string[], timeoutMs?:number}} params
+ * @returns {Promise<{byDevice: Record<string, object[]>, items: object[]}>}
+ *   items の各要素: { passwordID, keyBoardPassCode, keyBoardPassCodeNameUUID, name, nameUUID, subUUID, ..., uuids:string[] }
+ */
+export function getPasscodes(client: import("./transport.js").Hub3WsClient, { deviceUUIDs, timeoutMs }: {
+    deviceUUIDs: string[];
+    timeoutMs?: number;
+}): Promise<{
+    byDevice: Record<string, object[]>;
+    items: object[];
+}>;
+/**
+ * カードをサーバ DB に登録する (postCards)。
+ *
+ * ⚠️ getCards/clearCards と異なり obj でラップせず、deviceUUID と list を
+ *    トップレベルに置く非対称構造 (useManageAuthData.js:379-394)。混同しないこと。
+ * ⚠️ これは「DB への登録」のみ。実ファームウェア書き込みは別途 BLE(iotCmd) で行う 2 段構造。
+ *    list.length < 1 なら何もしない (biz3:381)。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{deviceUUID:string, list:object[], timeoutMs?:number}} params
+ *   list 要素: { cardID, nameUUID, name, cardType, memberID? } 等 (cards/index.js:268-286)
+ * @returns {Promise<object|null>} 応答メッセージ。list 空のときは null。
+ */
+export function postCards(client: import("./transport.js").Hub3WsClient, { deviceUUID, list, timeoutMs }: {
+    deviceUUID: string;
+    list: object[];
+    timeoutMs?: number;
+}): Promise<object | null>;
+/**
+ * パスコードをサーバ DB に登録する (postPasscodes)。postCards と同型 (useManageAuthData.js:396-411)。
+ * obj ラップ無し、deviceUUID と list をトップレベルに置く。list.length < 1 なら何もしない。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{deviceUUID:string, list:object[], timeoutMs?:number}} params
+ *   list 要素の正確なフィールドは biz3 のこのファイル内では未確認 (UI 由来)。getPasscodes 応答 item
+ *   (passwordID 等) と対応すると推測される。**未確認: 実機検証要**。
+ * @returns {Promise<object|null>}
+ */
+export function postPasscodes(client: import("./transport.js").Hub3WsClient, { deviceUUID, list, timeoutMs }: {
+    deviceUUID: string;
+    list: object[];
+    timeoutMs?: number;
+}): Promise<object | null>;
+/**
+ * カードをサーバ DB から削除する (delCards)。
+ *
+ * ⚠️ obj/deviceUUID ラップ無し、items 配列をトップレベルに置く (useManageAuthData.js:355-365)。
+ *    items 要素は { deviceID, cardID } (deviceUUID ではなく deviceID)。
+ * ⚠️ これは「BLE 削除 ack 後の DB 後始末」。実削除は BLE iotCmd 経由で行う 2 段構造。
+ *    !items.length なら何もしない (biz3:356)。
+ * ⚠️ biz3 では delCards に応答ハンドラもコールバック登録も無い (useManageAuthData.js:265-267)。
+ *    サーバは応答 op を返さないため、request で待つと必ず timeout する。biz3 と同じく
+ *    **fire-and-forget (send)** にする。!items.length なら何もしない。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{items:Array<{deviceID:string, cardID:string}>}} params
+ * @returns {boolean} 送信したら true、items 空で何もしなければ false
+ */
+export function delCards(client: import("./transport.js").Hub3WsClient, { items }: {
+    items: Array<{
+        deviceID: string;
+        cardID: string;
+    }>;
+}): boolean;
+/**
+ * パスコードをサーバ DB から削除する (delPasscodes)。delCards と同型 (useManageAuthData.js:367-377)。
+ * items 要素は { deviceID, passwordID }。!items.length なら何もしない。
+ *
+ * ⚠️ biz3 では delPasscodes の応答ハンドラに専用 case が無く default に落ちる (272-273)。
+ *    = 専用応答を期待していない。delCards と同様 **fire-and-forget (send)** にする
+ *    (request で待つと応答 op が来ず timeout する)。!items.length なら何もしない。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{items:Array<{deviceID:string, passwordID:string}>}} params
+ * @returns {boolean} 送信したら true、items 空で何もしなければ false
+ */
+export function delPasscodes(client: import("./transport.js").Hub3WsClient, { items }: {
+    items: Array<{
+        deviceID: string;
+        passwordID: string;
+    }>;
+}): boolean;
+/**
+ * 指定デバイスのカードを全削除する (clearCards)。
+ *
+ * ⚠️ obj.devices は **単一 deviceUUID 文字列** (getCards のようなカンマ連結ではない:
+ *    useManageAuthData.js:295-311)。!deviceUUID なら何もしない。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{deviceUUID:string, timeoutMs?:number}} params
+ * @returns {Promise<object|null>}
+ */
+export function clearCards(client: import("./transport.js").Hub3WsClient, { deviceUUID, timeoutMs }: {
+    deviceUUID: string;
+    timeoutMs?: number;
+}): Promise<object | null>;
+/**
+ * 指定デバイスのパスコードを全削除する (clearPasscodes)。clearCards と同型。
+ * obj.devices は単一 deviceUUID 文字列 (useManageAuthData.js:313-329)。
+ * 注: biz3 の関数名は clearPasswords だが op は 'clearPasscodes'。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{deviceUUID:string, timeoutMs?:number}} params
+ * @returns {Promise<object|null>}
+ */
+export function clearPasscodes(client: import("./transport.js").Hub3WsClient, { deviceUUID, timeoutMs }: {
+    deviceUUID: string;
+    timeoutMs?: number;
+}): Promise<object | null>;
+/**
+ * カード名 (と nameUUID) を更新する (updateCardName)。
+ *
+ * biz3 handlePutCardName (useManageAuthData.js:331-344) は { action, obj:{...item}, op } を送る。
+ * item には { cardID, name, cardNameUUID, timestamp, cardType, stpDeviceUUID } を入れる
+ * (carddetails.js:79-87,177-184)。応答は reqContext に送ったフィールドが echo back される
+ * (useManageAuthData.js:192-234)。
+ *
+ * ⚠️ biz3 の updateItemName (438-471) は **cardNameUUID が UUIDv4 形式でない場合**、
+ *    WS を直接投げず先に BLE (SSM_OS3_CARD_CHANGE=107) で nameUUID を v4 化する分岐がある。
+ *    その BLE payload 構築は別モジュール (iotCmd) の責務。
+ *    本関数は **WS の updateCardName 送信のみ** を行う。CLI で BLE 前段を回避するには、
+ *    呼び出し側が cardNameUUID に v4 UUID を渡すこと (crypto.generateUUID() で生成可)。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{item:object, timeoutMs?:number}} params
+ *   item: { cardID, name, cardNameUUID, timestamp?, cardType?, stpDeviceUUID }
+ * @returns {Promise<object>} 応答メッセージ (reqContext 含む)
+ */
+export function updateCardName(client: import("./transport.js").Hub3WsClient, { item, timeoutMs }: {
+    item: object;
+    timeoutMs?: number;
+}): Promise<object>;
+/**
+ * パスコード名 (と nameUUID) を更新する (updatePasscodeName)。updateCardName と同型。
+ * item には { stpDeviceUUID, keyBoardPassCode, keyBoardPassCodeNameUUID, name } を入れる
+ * (useManageAuthData.js:201-210,331-344)。
+ *
+ * ⚠️ keyBoardPassCodeNameUUID が UUIDv4 形式でない場合、biz3 は先に BLE
+ *    (SSM_OS3_PASSCODE_CHANGE=123) で v4 化する分岐がある (別モジュール責務)。
+ *    本関数は WS 送信のみ。v4 UUID を渡せば BLE 前段を回避できる。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{item:object, timeoutMs?:number}} params
+ *   item: { stpDeviceUUID, keyBoardPassCode, keyBoardPassCodeNameUUID, name }
+ * @returns {Promise<object>}
+ */
+export function updatePasscodeName(client: import("./transport.js").Hub3WsClient, { item, timeoutMs }: {
+    item: object;
+    timeoutMs?: number;
+}): Promise<object>;
+/**
+ * カードの所有者 (メンバー) を割り当てる (updateCardOwner)。これは WS のみで完結 (BLE 不要)。
+ *
+ * biz3 (useManageAuthData.js:346-353) は 'ownerSubUUID' in item の時だけ送る。
+ * ownerSubUUID は割り当てるメンバーの subUUID。空文字 '' でも送信 = 未割当解除。
+ * frame は { action, obj:{ cardID, ownerSubUUID }, op:'updateCardOwner' }。
+ * 応答は reqContext:{ cardID, ownerSubUUID } を echo back (235-259)。
+ *
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{cardID:string, ownerSubUUID:string, timeoutMs?:number}} params
+ *   ownerSubUUID は省略 (undefined) すると送信しない (null 相当)。'' は送信して未割当解除。
+ * @returns {Promise<object|null>} ownerSubUUID 未指定なら null。
+ */
+export function updateCardOwner(client: import("./transport.js").Hub3WsClient, { cardID, ownerSubUUID, timeoutMs }: {
+    cardID: string;
+    ownerSubUUID: string;
+    timeoutMs?: number;
+}): Promise<object | null>;
+export const NAMESPACE_OPS: string[];
+//# sourceMappingURL=access.d.ts.map

package/types/access.d.ts.map

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

package/types/account.d.ts

@@ -0,0 +1,13 @@
+/**
+ * ログインユーザの customerInfo / quotas を取得する。
+ * @param {import("./transport.js").Hub3WsClient} client
+ * @param {{email:string}} params  login に使った email (tokenStore の username)
+ * @returns {Promise<{customerInfo: object|null, quotas: object|null}>}
+ */
+export function getLoginUser(client: import("./transport.js").Hub3WsClient, { email }: {
+    email: string;
+}): Promise<{
+    customerInfo: object | null;
+    quotas: object | null;
+}>;
+//# sourceMappingURL=account.d.ts.map

package/types/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../src/account.js"],"names":[],"mappings":"AAmBA;;;;;GAKG;AACH,qCAJW,OAAO,gBAAgB,EAAE,YAAY,aACrC;IAAC,KAAK,EAAC,MAAM,CAAA;CAAC,GACZ,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,GAAC,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAC,IAAI,CAAA;CAAC,CAAC,CAYrE"}

package/types/auth.d.ts

@@ -0,0 +1,80 @@
+/**
+ * idToken の `sub` claim (= Cognito user UUID) を返す。
+ * biz3 が `gStripe.customerInfo.subUUID` として使っている値と同じで、
+ * `biz3TriggerLocker` の `history` フィールドに乗せる必要がある。
+ */
+export function jwtSub(token: any): any;
+/**
+ * 失効していない idToken を返す。必要なら refresh する。
+ * 失効まで `marginSec` 以下なら早期 refresh する (デフォルト 60秒)。
+ *
+ * @param {{load:Function, save:Function}} store
+ */
+export function getValidIdToken(store: {
+    load: Function;
+    save: Function;
+}, { marginSec }?: {
+    marginSec?: number;
+}): Promise<any>;
+/**
+ * Step 1: CUSTOM_AUTH を開始。Cognito が email に確認コードを送る。
+ * 新規ユーザーの場合は SignUp してから retry。
+ *
+ * @param {{savePending:Function}} store
+ */
+export function loginInitiate(store: {
+    savePending: Function;
+}, username: any, { clientId }?: {
+    clientId?: string;
+}): Promise<{
+    challenge: "CUSTOM_CHALLENGE";
+    params: Record<string, string>;
+}>;
+/**
+ * Step 2: email で受け取ったコードで CUSTOM_CHALLENGE を回答。
+ * 成功するとトークンを保存し、pending 状態を消す。
+ *
+ * @param {{loadPending:Function, save:Function, clearPending:Function}} store
+ */
+export function loginVerify(store: {
+    loadPending: Function;
+    save: Function;
+    clearPending: Function;
+}, code: any): Promise<{
+    clientId: any;
+    idToken: string;
+    refreshToken: string;
+    accessToken: string;
+    deviceKey: string;
+    deviceGroupKey: string;
+    username: any;
+    lastRefresh: string;
+}>;
+/**
+ * 既存の localStorage ダンプから bootstrap (互換用)。
+ *
+ * @param {{save:Function}} store
+ */
+export function bootstrap(store: {
+    save: Function;
+}, values: any): {
+    clientId: any;
+    idToken: any;
+    refreshToken: any;
+    accessToken: any;
+    deviceKey: any;
+    username: any;
+    lastRefresh: string;
+};
+export const CONSUMER_CLIENT_ID: "6ialca0p8u0lsgvbmvsljfm305";
+export const BIZ_CLIENT_ID: "21u50hboia4s5q0sbk6pbdfmss";
+export namespace CONFIG_META {
+    export { COGNITO_REGION as region };
+    export { USER_POOL_ID as userPoolId };
+    export { CONSUMER_CLIENT_ID as consumerClientId };
+    export { BIZ_CLIENT_ID as bizClientId };
+}
+declare const COGNITO_REGION: "ap-northeast-1";
+declare const USER_POOL_ID: "ap-northeast-1_bY2byhlCa";
+export {};
+//# sourceMappingURL=auth.d.ts.map

package/types/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.js"],"names":[],"mappings":"AAiEA;;;;GAIG;AACH,wCAQC;AAED;;;;;GAKG;AACH,uCAFW;IAAC,IAAI,WAAU;IAAC,IAAI,WAAS;CAAC;;iBAyCxC;AAED;;;;;GAKG;AACH,qCAFW;IAAC,WAAW,WAAS;CAAC;;;;;GAyChC;AAED;;;;;GAKG;AACH,mCAFW;IAAC,WAAW,WAAU;IAAC,IAAI,WAAU;IAAC,YAAY,WAAS;CAAC;;;;;;;;;GAwCtE;AAED;;;;GAIG;AACH,iCAFW;IAAC,IAAI,WAAS;CAAC;;;;;;;;EAiBzB;AAjND,iCAAkC,4BAA4B,CAAC;AAI/D,4BAA6B,4BAA4B,CAAC;;;;;;;AAR1D,8BAAuB,gBAAgB,CAAC;AACxC,4BAAqB,0BAA0B,CAAC"}

package/types/ble/devicemodel.d.ts

@@ -0,0 +1,212 @@
+/**
+ * model 文字列から kind を返す。
+ *   - model 未指定 (null/空) → lock5 (SesameBle の config-less 利用 & 既存ロック config の後方互換。
+ *     config.locks は同期時にロック機種のみ whitelist + model 保存なので、ここに来るのは実質ロック)。
+ *   - model 文字列がテーブルに無い → **UNKNOWN (操作なし)**。未知機種を勝手にロック扱いして解錠等を
+ *     捏造しない (Hub3 が解錠を出していた類のバグを構造的に防ぐ)。
+ * @param {string|null|undefined} model
+ * @returns {string} KIND
+ */
+export function kindForModel(model: string | null | undefined): string;
+/**
+ * model 文字列から能力定義を返す。
+ *   - cloud / ble : 各経路で操作可能な op
+ *   - ops         : 和集合 (UI で見せる操作・提示順)
+ *   - bleSupported: BLE 制御を実装しているか (= ble.length>0)
+ * @param {string|null|undefined} model
+ * @returns {{kind:string, os:number, cloud:string[], ble:string[], ops:string[], mechKind:string|null, bleSupported:boolean, label:string}}
+ */
+export function capabilitiesForModel(model: string | null | undefined): {
+    kind: string;
+    os: number;
+    cloud: string[];
+    ble: string[];
+    ops: string[];
+    mechKind: string | null;
+    bleSupported: boolean;
+    label: string;
+};
+/** その model が op を (いずれかの経路で) 操作できるか。 */
+export function supportsOp(model: any, op: any): boolean;
+/** その model が (いずれかの経路で) 何か操作できるか。session の対象判定に使う。 */
+export function isOperable(model: any): boolean;
+/**
+ * その model の op を運べる transport 一覧 (型×経路の能力テーブルから導出)。
+ * 例: lock5 の autolock は ["ble"]、lock は ["ble","cloud"]、hub3 の ir は ["cloud"]。
+ * @param {string|null|undefined} model
+ * @param {string} op
+ * @returns {string[]} ("ble" / "cloud" の部分集合)
+ */
+export function transportsForOp(model: string | null | undefined, op: string): string[];
+/**
+ * BLE 上の「デバイス種別 (kind)」。productType→実装クラスの多対一を、能力の単位でまとめたもの。
+ * - lock5     : Sesame5/5Pro/6/6Pro/US/miwa, BLE Connector (OS3 ロック)
+ * - bot2      : SESAME Bot2/Bot3 (OS3) — click のみ
+ * - bike2     : SESAME Bike2/Bike3 (OS3) — unlock のみ
+ * - sesame2   : Sesame2/3/4 (OS2 ロック) — BLE は別プロトコル (未実装)
+ * - botOs2    : SESAME Bot1 (OS2) — BLE 未実装
+ * - bikeOs2   : Bike1 (OS2) — BLE 未実装
+ * - biometric : Touch/Face/OpenSensor/Remote (鍵束デバイス。施錠操作なし)
+ * - hub3      : Hub3/Hub3 LTE (IoT 中継。BLE 施錠操作なし)
+ * - wifi      : WifiModule2
+ */
+export const KIND: Readonly<{
+    LOCK5: "lock5";
+    BOT2: "bot2";
+    BIKE2: "bike2";
+    SESAME2: "sesame2";
+    BOT_OS2: "botOs2";
+    BIKE_OS2: "bikeOs2";
+    BIOMETRIC: "biometric";
+    HUB3: "hub3";
+    WIFI: "wifi";
+    UNKNOWN: "unknown";
+}>;
+/**
+ * productType (整数) → { model, kind }。
+ * 値は CHProductModel enum (CHDeivceProtocols.kt:28-252) と deviceFactory() の生成クラスに準拠。
+ * pType 12 は SDK でも欠番。
+ */
+export const PRODUCT_TYPES: Readonly<{
+    0: {
+        model: string;
+        kind: "sesame2";
+    };
+    1: {
+        model: string;
+        kind: "wifi";
+    };
+    2: {
+        model: string;
+        kind: "botOs2";
+    };
+    3: {
+        model: string;
+        kind: "bikeOs2";
+    };
+    4: {
+        model: string;
+        kind: "sesame2";
+    };
+    5: {
+        model: string;
+        kind: "lock5";
+    };
+    6: {
+        model: string;
+        kind: "bike2";
+    };
+    7: {
+        model: string;
+        kind: "lock5";
+    };
+    8: {
+        model: string;
+        kind: "biometric";
+    };
+    9: {
+        model: string;
+        kind: "biometric";
+    };
+    10: {
+        model: string;
+        kind: "biometric";
+    };
+    11: {
+        model: string;
+        kind: "lock5";
+    };
+    13: {
+        model: string;
+        kind: "hub3";
+    };
+    14: {
+        model: string;
+        kind: "biometric";
+    };
+    15: {
+        model: string;
+        kind: "biometric";
+    };
+    16: {
+        model: string;
+        kind: "lock5";
+    };
+    17: {
+        model: string;
+        kind: "bot2";
+    };
+    18: {
+        model: string;
+        kind: "biometric";
+    };
+    19: {
+        model: string;
+        kind: "biometric";
+    };
+    20: {
+        model: string;
+        kind: "lock5";
+    };
+    21: {
+        model: string;
+        kind: "lock5";
+    };
+    22: {
+        model: string;
+        kind: "biometric";
+    };
+    23: {
+        model: string;
+        kind: "biometric";
+    };
+    24: {
+        model: string;
+        kind: "biometric";
+    };
+    25: {
+        model: string;
+        kind: "biometric";
+    };
+    26: {
+        model: string;
+        kind: "biometric";
+    };
+    27: {
+        model: string;
+        kind: "biometric";
+    };
+    28: {
+        model: string;
+        kind: "biometric";
+    };
+    29: {
+        model: string;
+        kind: "lock5";
+    };
+    30: {
+        model: string;
+        kind: "biometric";
+    };
+    31: {
+        model: string;
+        kind: "biometric";
+    };
+    32: {
+        model: string;
+        kind: "lock5";
+    };
+    33: {
+        model: string;
+        kind: "bike2";
+    };
+    35: {
+        model: string;
+        kind: "bot2";
+    };
+    36: {
+        model: string;
+        kind: "hub3";
+    };
+}>;
+//# sourceMappingURL=devicemodel.d.ts.map

package/types/ble/devicemodel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devicemodel.d.ts","sourceRoot":"","sources":["../../src/ble/devicemodel.js"],"names":[],"mappings":"AAgHA;;;;;;;;GAQG;AACH,oCAHW,MAAM,GAAC,IAAI,GAAC,SAAS,GACnB,MAAM,CAKlB;AAED;;;;;;;GAOG;AACH,4CAHW,MAAM,GAAC,IAAI,GAAC,SAAS,GACnB;IAAC,IAAI,EAAC,MAAM,CAAC;IAAC,EAAE,EAAC,MAAM,CAAC;IAAC,KAAK,EAAC,MAAM,EAAE,CAAC;IAAC,GAAG,EAAC,MAAM,EAAE,CAAC;IAAC,GAAG,EAAC,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAC,MAAM,GAAC,IAAI,CAAC;IAAC,YAAY,EAAC,OAAO,CAAC;IAAC,KAAK,EAAC,MAAM,CAAA;CAAC,CAM1I;AAED,yCAAyC;AACzC,yDAEC;AAED,uDAAuD;AACvD,gDAEC;AAED;;;;;;GAMG;AACH,uCAJW,MAAM,GAAC,IAAI,GAAC,SAAS,MACrB,MAAM,GACJ,MAAM,EAAE,CAQpB;AAzJD;;;;;;;;;;;GAWG;AACH;;;;;;;;;;;GAKG;AAqCH;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG"}

package/types/ble/index.d.ts

@@ -0,0 +1,160 @@
+export * as protocol from "./protocol.js";
+export * as devicemodel from "./devicemodel.js";
+/**
+ * 登録済み SESAME を BLE で直接操作する高レベルファサード。
+ */
+export class SesameBle {
+    /**
+     * connect → fn → close を自動で行うヘルパー。
+     * @param {object} opts コンストラクタ opts
+     * @param {(lock:SesameBle)=>Promise<any>} fn
+     */
+    static use(opts: object, fn: (lock: SesameBle) => Promise<any>): Promise<any>;
+    /**
+     * 複数ロックに**1 回のスキャン**で同時接続する (逐次スキャンを避ける正攻法)。
+     * 近接していないロックは結果に現れず即スキップ (per-device の scan timeout を払わない)。
+     * 見つかったロックへは**並行接続** (login まで)。
+     *
+     * @param {Array<{name:string, deviceUUID:string, secretKey:string, model?:string}>} entries
+     * @param {{debug?:boolean, scanTimeoutMs?:number}} [opts]
+     * @returns {Promise<{connected: Map<string, SesameBle>, unreachable: string[], failed: Array<{name:string, error:Error}>}>}
+     */
+    static connectMany(entries: Array<{
+        name: string;
+        deviceUUID: string;
+        secretKey: string;
+        model?: string;
+    }>, { debug, scanTimeoutMs }?: {
+        debug?: boolean;
+        scanTimeoutMs?: number;
+    }): Promise<{
+        connected: Map<string, SesameBle>;
+        unreachable: string[];
+        failed: Array<{
+            name: string;
+            error: Error;
+        }>;
+    }>;
+    /**
+     * @param {{
+     *   secretKey: string|Buffer,   // 32hex のロック共通鍵 (cloud の `sesame devices` で取得済み)
+     *   deviceUUID?: string,        // 対象識別 (advertise 照合)。複数 SESAME が近接する環境で必須
+     *   address?: string,           // BLE アドレスで識別する代替
+     *   debug?: boolean,
+     *   transport?: object,         // 独自トランスポート (省略時 noble)
+     * }} opts
+     */
+    constructor({ secretKey, deviceUUID, address, model, debug, scanTimeoutMs, transport }?: {
+        secretKey: string | Buffer;
+        deviceUUID?: string;
+        address?: string;
+        debug?: boolean;
+        transport?: object;
+    });
+    _transport: any;
+    _session: SesameBleSession;
+    _model: any;
+    _caps: {
+        kind: string;
+        os: number;
+        cloud: string[];
+        ble: string[];
+        ops: string[];
+        mechKind: string | null;
+        bleSupported: boolean;
+        label: string;
+    };
+    /** デバイスの model 文字列 (例 "sesame_5" / "bot_2")。未指定なら null。 */
+    get model(): any;
+    /** 型ごとの能力 { kind, os, ops, mechKind, bleSupported, label }。 */
+    get capabilities(): {
+        kind: string;
+        os: number;
+        cloud: string[];
+        ble: string[];
+        ops: string[];
+        mechKind: string | null;
+        bleSupported: boolean;
+        label: string;
+    };
+    /** この操作を BLE で送れるか (このファサードは BLE 専用なので ble 能力で判定)。 */
+    supports(op: any): boolean;
+    /** BLE で送れない操作を弾く。SDK では型ごとに能力が非対称 (Bot は click のみ等)。 */
+    _assertOp(op: any): void;
+    /** mechStatus publish を購読 (戻り値 unsubscribe)。 */
+    onStatus(fn: any): () => boolean;
+    /** 最後に受信した mechStatus。 */
+    get lastStatus(): {
+        state: string;
+        isInLockRange: boolean;
+        target: number | null;
+        position: number | null;
+        isStop: boolean;
+        isCritical: boolean;
+        isBatteryCritical: boolean;
+        batteryRaw: number;
+        flags: number;
+    };
+    get isConnected(): boolean;
+    /** 接続 + login。 */
+    connect(): Promise<this>;
+    /** 切断。 */
+    close(): Promise<void>;
+    /**
+     * 施錠 (BLE item=82)。tag は履歴に残す任意ラベル。
+     * @returns {Promise<{resultCode:number, payload:Buffer}>}
+     */
+    lock(tag: any): Promise<{
+        resultCode: number;
+        payload: Buffer;
+    }>;
+    /** 解錠 (BLE item=83)。Sesame5/6 ロックと Bike2 が対応。 */
+    unlock(tag: any): Promise<{
+        resultCode: number;
+        payload: Buffer;
+    }>;
+    /**
+     * SESAME Bot のクリック (BLE item=89)。Bot2/Bot3 のみ。
+     * @param {Buffer} [tag] 履歴タグ (UUID バイト列)
+     */
+    click(tag?: Buffer): Promise<{
+        resultCode: number;
+        payload: Buffer;
+    }>;
+    /**
+     * トグル (Sesame5/6 ロックのみ)。直近の mechStatus が無ければ status() を取得してから判定。
+     * locked → unlock、それ以外 → lock (CHSesame5Device.kt:128-145 準拠)。
+     */
+    toggle(tag: any): Promise<{
+        resultCode: number;
+        payload: Buffer;
+    }>;
+    /**
+     * オートロック設定 (BLE item=11、2byte LE 秒数。0=無効)。Sesame5/6 ロックのみ。
+     * **BLE 経由なら実機に反映される** (クラウドの biz3TriggerLocker では ack のみで未反映だった機能)。
+     * @param {number} seconds 0..65535
+     */
+    autolock(seconds: number): Promise<{
+        resultCode: number;
+        payload: Buffer;
+    }>;
+    /**
+     * 現在の mechStatus を返す。未受信なら publish を待つ (timeout 付き)。
+     * @param {{timeoutMs?:number}} [opts]
+     * @returns {Promise<object>} parseMechStatus の結果
+     */
+    status({ timeoutMs }?: {
+        timeoutMs?: number;
+    }): Promise<object>;
+    /**
+     * 履歴を 1 バッチ取得 (BLE item=4)。payload の解析は呼び出し側 (生バイト返し)。
+     * @returns {Promise<Buffer>}
+     */
+    history(): Promise<Buffer>;
+}
+import { Buffer } from "node:buffer";
+export { SesameBleSession, BleResultError } from "./session.js";
+export { RESULT as SESAME_RESULT_CODES, resultName } from "./protocol.js";
+export { NobleTransport, createBleTransport, advToDeviceUUID, scanSesames } from "./transport.js";
+export { capabilitiesForModel, kindForModel, supportsOp, isOperable, transportsForOp, KIND, PRODUCT_TYPES } from "./devicemodel.js";
+//# sourceMappingURL=index.d.ts.map

package/types/ble/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ble/index.js"],"names":[],"mappings":";;AAuCA;;GAEG;AACH;IAoGE;;;;OAIG;IACH,iBAHW,MAAM,MACN,CAAC,IAAI,EAAC,SAAS,KAAG,OAAO,CAAC,GAAG,CAAC,gBAOxC;IAED;;;;;;;;OAQG;IACH,4BAJW,KAAK,CAAC;QAAC,IAAI,EAAC,MAAM,CAAC;QAAC,UAAU,EAAC,MAAM,CAAC;QAAC,SAAS,EAAC,MAAM,CAAC;QAAC,KAAK,CAAC,EAAC,MAAM,CAAA;KAAC,CAAC,6BACxE;QAAC,KAAK,CAAC,EAAC,OAAO,CAAC;QAAC,aAAa,CAAC,EAAC,MAAM,CAAA;KAAC,GACrC,OAAO,CAAC;QAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAAC,WAAW,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,KAAK,CAAC;YAAC,IAAI,EAAC,MAAM,CAAC;YAAC,KAAK,EAAC,KAAK,CAAA;SAAC,CAAC,CAAA;KAAC,CAAC,CAsB1H;IA5ID;;;;;;;;OAQG;IACH,yFARW;QACN,SAAS,EAAE,MAAM,GAAC,MAAM,CAAC;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,EAQH;IAJC,gBAAgG;IAChG,2BAAsF;IACtF,YAAmB;IACnB;;;;;;;;;MAAwC;IAG1C,2DAA2D;IAC3D,iBAAmC;IACnC,+DAA+D;IAC/D;;;;;;;;;MAAyC;IACzC,sDAAsD;IACtD,2BAAoD;IAEpD,yDAAyD;IACzD,yBAKC;IAED,gDAAgD;IAChD,iCAAmD;IACnD,0BAA0B;IAC1B;;;;;;;;;;MAAqD;IACrD,2BAAsD;IAEtD,kBAAkB;IAClB,yBAA+D;IAC/D,UAAU;IACV,uBAAmD;IAEnD;;;OAGG;IACH,gBAFa,OAAO,CAAC;QAAC,UAAU,EAAC,MAAM,CAAC;QAAC,OAAO,EAAC,MAAM,CAAA;KAAC,CAAC,CAEyC;IAElG,iDAAiD;IACjD;;;OAAwG;IAExG;;;OAGG;IACH,YAFW,MAAM;;;OAEoF;IAErG;;;OAGG;IACH;;;OAMC;IAED;;;;OAIG;IACH,kBAFW,MAAM;;;OAEoG;IAErH;;;;OAIG;IACH,uBAHW;QAAC,SAAS,CAAC,EAAC,MAAM,CAAA;KAAC,GACjB,OAAO,CAAC,MAAM,CAAC,CAQ3B;IAED;;;OAGG;IACH,WAFa,OAAO,CAAC,MAAM,CAAC,CAK3B;CA4CF;uBAxKsB,aAAa"}