@ray-js/lock-sdk 1.2.0-beta.3 → 1.2.0-beta.30

package/lib/feature/fit/log.js

@@ -0,0 +1,123 @@
+import { getFitRecordListApi } from "../../api/log";
+import { closeTypes, dpIdsForUsernameToUnlockName, unlockDp2Type, } from "../log/log";
+import dpCodes from "../../config/dp-code";
+import base64ToHex from "../../utils/base64-to-hex";
+import { handleLocalOperation } from "../../utils/log";
+import { getCurrentUserForRuntime } from "../user/current-user";
+const fitRecordDps = [
+    dpCodes.bluetoothUnlockKit,
+    dpCodes.unlockPasswordKit,
+    dpCodes.unlockCardKit,
+    dpCodes.unlockFingerprintKit,
+    dpCodes.unlockFaceKit,
+    dpCodes.unlockEyeKit,
+    dpCodes.unlockHandKit,
+    dpCodes.unlockFingerVeinKit,
+    dpCodes.unlockTemporaryKit,
+    dpCodes.unlockDoubleKit,
+    dpCodes.unlockOfflinePd,
+    dpCodes.unlockDynamic,
+    dpCodes.lockRecord,
+];
+function parseFitRecord(cfg, raw, currentUserId) {
+    const historyId = raw.historyId ?? raw.id;
+    const time = raw.gmtCreate ?? Number(raw.time);
+    const dpId = typeof raw.dpId === "string" ? Number(raw.dpId) : raw.dpId;
+    let closeValue = undefined;
+    let dpValue = raw.dpValue;
+    const dpCode = cfg.codesById[dpId];
+    let type = dpCode === dpCodes.lockRecord ? "close_record" : "unlock_record";
+    const dpSchema = cfg.dpSchema[dpCode];
+    if (dpSchema?.type === "raw" && typeof dpValue === "string") {
+        try {
+            dpValue = base64ToHex(dpValue);
+        }
+        catch {
+        }
+    }
+    if (type === "close_record") {
+        const rawCloseValue = typeof dpValue === "string" ? dpValue : "";
+        const closeType = parseInt(rawCloseValue.slice(0, 2), 16);
+        closeValue = closeTypes[closeType] || closeTypes[0];
+    }
+    if (dpCode === dpCodes.lockLocalRecord) {
+        type = "local_operation";
+    }
+    let userName = raw.userName;
+    let unlockName = raw.unlockName;
+    if (dpIdsForUsernameToUnlockName.includes(dpId)) {
+        unlockName = raw.userName;
+        userName = "";
+    }
+    const log = {
+        type,
+        logId: String(historyId),
+        userId: raw.userId,
+        dpId,
+        data: dpValue,
+        dpCode,
+        userName: userName || "",
+        unlockName: unlockName || "",
+        avatarUrl: raw.avatarUrl,
+        relateDevName: raw.relateDevName,
+        mediaInfo: raw.mediaInfoList?.map?.((item) => {
+            return {
+                mediaPath: item.mediaPath,
+                fileKey: item.fileKey,
+                fileUrl: item.fileUrl,
+                mediaBucket: item.mediaBucket,
+                mediaKey: item.mediaKey,
+                width: item.positionWidth,
+                height: item.positionHeight,
+                angle: item.positionAngle,
+                isVR: !!item.positionVr,
+                position: item.position,
+            };
+        }),
+        unionUnlockInfo: raw.unionUnlockInfo?.map((item) => ({
+            userId: item.userId,
+            userName: item.userName,
+            unlockName: item.unlockName,
+            sn: item.sn,
+            type: unlockDp2Type[item.opMode],
+        })),
+        closeValue,
+        time,
+        currentUser: +raw.userId === +currentUserId,
+        bindable: raw.memberBindableFlag === 1,
+        unlockMethod: type === "unlock_record" ? unlockDp2Type[dpCode] : undefined,
+        localRecord: handleLocalOperation(raw.localOperateRecordInfo, dpValue),
+    };
+    if (raw.matterRecordInfo) {
+        log.matterRecord = {
+            sn: raw.matterRecordInfo.matterSn,
+            type: raw.matterRecordInfo.matterType,
+            source: raw.matterRecordInfo.matterSource,
+        };
+    }
+    return log;
+}
+export async function getFitLogsForRuntime(rt, params) {
+    const cfg = rt.config;
+    const { page = 1, pageSize = 50 } = params || {};
+    const currentUser = await getCurrentUserForRuntime(rt);
+    const data = await getFitRecordListApi({
+        devId: cfg.devInfo.devId,
+        dpIds: fitRecordDps.reduce((res, item) => {
+            if (cfg.idsByCode[item]) {
+                res.push(cfg.idsByCode[item]);
+            }
+            return res;
+        }, []),
+        offset: (page - 1) * pageSize,
+        limit: pageSize,
+    });
+    if (!data?.datas?.length) {
+        return { list: [], hasMore: false, total: 0 };
+    }
+    return {
+        list: data.datas.map((raw) => parseFitRecord(cfg, raw, currentUser.userId)),
+        hasMore: data.hasNext,
+        total: data.totalCount,
+    };
+}

package/lib/feature/fit/method/add-flow.js

@@ -1,6 +1,6 @@
 import dpUtils from "@ray-js/tuya-dp-transform";
 import { addFitOpenMode } from "../../../api/fit";
-import { sleep } from "../../../utils";
+import { formatCloudUnlockId, sleep } from "../../../utils";
 import { DPCHANGE } from "../../../utils/constant";
 import { getError } from "../../../utils/errors";
 import emitter from "../../../utils/event";
@@ -195,7 +195,7 @@ const handleAddReport = async (dps) => {
                     await addFitOpenMode({
                         devIdList: [addUnlockMethodData.lockDevId],
                         fittingId: rt.devId,
-                        unlockId: `${addUnlockMethodData.unlockDpId}-${result.unlockId}`,
+                        unlockId: formatCloudUnlockId(addUnlockMethodData.unlockDpId, result.unlockId),
                         unlockName: "",
                         userId: addUnlockMethodData.userId,
                         hijack: false,

package/lib/feature/fit/method/add-password.js

@@ -1,6 +1,6 @@
 import dpUtils from "@ray-js/tuya-dp-transform";
 import { addFitOpenMode } from "../../../api/fit";
-import { sleep } from "../../../utils";
+import { formatCloudUnlockId, sleep } from "../../../utils";
 import { getError, handleCloudError } from "../../../utils/errors";
 import { publishDpsForRuntime } from "../../dp/publish-dps";
 import { getFitUnlockMethodBase } from "./internal/base";
@@ -75,7 +75,7 @@ export async function fitAddPasswordForRuntime(rt, params) {
         await addFitOpenMode({
             devIdList: [lockDevId],
             fittingId,
-            unlockId: `${dpId}-${res.unlockId}`,
+            unlockId: formatCloudUnlockId(dpId, res.unlockId),
             unlockName: params.name,
             userId: params.userId,
             hijack: !!params.hijack,

package/lib/feature/fit/method/update-remove.js

@@ -1,14 +1,40 @@
 import dpUtils from "@ray-js/tuya-dp-transform";
-import { removeFitOpenMode, updateFitOpenMode } from "../../../api/fit";
+import { getFitOpenModeList, removeFitOpenMode, updateFitOpenMode, } from "../../../api/fit";
 import dpCodes from "../../../config/dp-code";
 import { fitRemove, fitReportRemove, } from "../../../config/dp-map/unlock-method-fit";
 import { isAdmin } from "../../../utils";
 import { getError, handleCloudError } from "../../../utils/errors";
 import { publishDpsForRuntime } from "../../dp/publish-dps";
-import { getUnlockMethodTypeByDpCodeForRuntime, parallelOnlyForRuntime, } from "../../utils";
-import { getUnlockMethodDetailForRuntime } from "../../unlock/method/detail";
-import { resolveSlaveId } from "../resolve-slave-id";
+import { getUnlockMethodTypeByTypeForRuntime, parallelOnlyForRuntime, } from "../../utils";
 import { sdkLog } from "../../../utils/sdk-log";
+const FIT_DELETABLE_UNLOCK_METHOD_TYPES = [
+    "card",
+    "finger",
+    "face",
+    "hand",
+    "fingerVein",
+];
+async function findFitOpenModeRawById(rt, id) {
+    for (const type of FIT_DELETABLE_UNLOCK_METHOD_TYPES) {
+        let unlockMethodConfig;
+        try {
+            unlockMethodConfig = getUnlockMethodTypeByTypeForRuntime(rt, type);
+        }
+        catch {
+            continue;
+        }
+        const dpId = rt.config.idsByCode[unlockMethodConfig.code];
+        if (!dpId) {
+            continue;
+        }
+        const raw = await getFitOpenModeList(rt.devId, dpId);
+        const hit = (raw ?? []).find((item) => item.unlockBindingId === id);
+        if (hit) {
+            return { raw: hit, unlockMethodConfig };
+        }
+    }
+    return null;
+}
 export async function fitUpdateUnlockMethodForRuntime(rt, params) {
     const startedAt = Date.now();
     sdkLog("info", "fitUnlockMethod", "updateStart", {
@@ -49,19 +75,20 @@ export const fitDeleteUnlockMethodForRuntime = parallelOnlyForRuntime(async func
         devId: rt.devId,
         data: { id, hasLockDevId: typeof lockDevId === "string" },
     });
-    const detail = await getUnlockMethodDetailForRuntime(rt, id);
-    const { lockUserId, unlockId, userType, dpId } = detail;
-    const code = cfg.codesById[dpId];
-    if (!code) {
-        const error = getError(1014);
-        sdkLog("warn", "fitUnlockMethod", "deleteMissingDpCode", {
+    const found = await findFitOpenModeRawById(rt, id);
+    if (!found) {
+        const error = getError(1040);
+        sdkLog("warn", "fitUnlockMethod", "deleteRecordNotFound", {
             devId: rt.devId,
-            data: { id, dpId },
+            data: { id },
             error,
         });
         throw error;
     }
-    const unlockMethodConfig = getUnlockMethodTypeByDpCodeForRuntime(rt, code);
+    const { raw, unlockMethodConfig } = found;
+    const lockUserId = raw.lockUserId;
+    const unlockId = raw.sn;
+    const slaveId = parseInt(raw.devUnlockId, 16);
     const removeDpCode = dpCodes.unlockMethodDel;
     if (!cfg.dpSchema[removeDpCode]) {
         const error = getError(1014);
@@ -72,12 +99,11 @@ export const fitDeleteUnlockMethodForRuntime = parallelOnlyForRuntime(async func
         });
         throw error;
     }
-    const slaveId = await resolveSlaveId(rt, lockDevId);
     const dpData = {
         slaveId,
         type: unlockMethodConfig.id,
         stage: 0,
-        admin: isAdmin(userType),
+        admin: isAdmin(raw.userType),
         memberId: lockUserId,
         unlockId,
         operation: 1,

package/lib/feature/fit/password-list.d.ts

@@ -1,3 +1,4 @@
+import { type RawFitOpenModeScheduleItem } from "../../api/fit";
 import { EffectiveConfig, UnlockMethodType } from "../../interface";
 import { LockDeviceRuntime } from "../../runtime/LockDeviceRuntime";
 export interface FitPasswordItem {
@@ -22,3 +23,39 @@ export declare const getFitPasswordListForRuntime: (runtime: LockDeviceRuntime)
     devLockId: string;
     effective: EffectiveConfig;
 }[]>;
+export interface FitOnlinePasswordItem {
+    id: number;
+    pwdId: number;
+    sn: number;
+    gmtCreate: number;
+    opModeType: number;
+    opModeSubType: number;
+    name: string;
+    userName: string;
+    mobile: string;
+    hijack: boolean;
+    operate: number;
+    effectiveTime: number;
+    invalidTime: number;
+    devNameList: string[];
+    scheduleDetails: RawFitOpenModeScheduleItem[];
+}
+export interface FitOfflinePasswordItem {
+    id: number | string;
+    pwdId: number;
+    sn: number;
+    gmtCreate: number;
+    opModeType: number;
+    opModeSubType: number;
+    pwdName: string;
+    mayExpired: boolean;
+    gmtStart: number;
+    gmtExpired: number;
+    devNameList: string[];
+    scheduleDetails: RawFitOpenModeScheduleItem[];
+    revokedPwdName: string;
+    revokedPwdEffectiveTime: number;
+    revokedPwdInvalidTime: number;
+}
+export declare const getFitOnlinePasswordListForRuntime: (runtime: LockDeviceRuntime) => Promise<FitOnlinePasswordItem[]>;
+export declare const getFitOfflinePasswordListForRuntime: (runtime: LockDeviceRuntime) => Promise<FitOfflinePasswordItem[]>;

package/lib/feature/fit/password-list.js

@@ -1,4 +1,4 @@
-import { getFitPasswordList } from "../../api/fit";
+import { getFitPasswordList, getFitOfflinePasswordList, } from "../../api/fit";
 import { parseWeek } from "../../utils";
 export const getFitPasswordListForRuntime = async (runtime) => {
     const list = await getFitPasswordList(runtime.devId);
@@ -29,3 +29,46 @@ export const getFitPasswordListForRuntime = async (runtime) => {
         };
     });
 };
+export const getFitOnlinePasswordListForRuntime = async (runtime) => {
+    const list = await getFitPasswordList(runtime.devId);
+    return (list ?? []).map((item) => ({
+        id: item.unlockBindingId,
+        pwdId: item.pwdId,
+        sn: item.sn,
+        gmtCreate: item.gmtCreate,
+        opModeType: item.opModeType,
+        opModeSubType: item.opModeSubType,
+        name: item.name,
+        userName: item.userName,
+        mobile: item.mobile,
+        hijack: item.hijack,
+        operate: item.operate,
+        effectiveTime: item.effectiveTime,
+        invalidTime: item.invalidTime,
+        devNameList: item.devNameList ?? [],
+        scheduleDetails: item.scheduleDetails ?? [],
+    }));
+};
+export const getFitOfflinePasswordListForRuntime = async (runtime) => {
+    const res = await getFitOfflinePasswordList(runtime.devId);
+    const list = Array.isArray(res)
+        ? res
+        : (res?.datas ?? []);
+    return list.map((item) => ({
+        id: item.unlockBindingId ?? item.pwdId,
+        pwdId: item.pwdId,
+        sn: item.sn,
+        gmtCreate: item.gmtCreate,
+        opModeType: item.opModeType ?? 3,
+        opModeSubType: item.opModeSubType,
+        pwdName: item.pwdName,
+        mayExpired: item.mayExpired,
+        gmtStart: item.gmtStart,
+        gmtExpired: item.gmtExpired,
+        devNameList: item.devNameList ?? [],
+        scheduleDetails: item.scheduleDetails ?? [],
+        revokedPwdName: item.revokedPwdName,
+        revokedPwdEffectiveTime: item.revokedPwdEffectiveTime,
+        revokedPwdInvalidTime: item.revokedPwdInvalidTime,
+    }));
+};

package/lib/feature/fit/security-channel.d.ts

@@ -0,0 +1,3 @@
+import type { LockDeviceRuntime } from "../../runtime/LockDeviceRuntime";
+export declare const isFitSecurityChannelEnabledForRuntime: (rt: LockDeviceRuntime) => boolean;
+export declare const getSecurityUpdatedLockIds: (fittingId: string) => Promise<string[]>;

package/lib/feature/fit/security-channel.js

@@ -0,0 +1,43 @@
+import { getDeviceProperties } from "../../api/setting";
+import { sdkLog } from "../../utils/sdk-log";
+export const isFitSecurityChannelEnabledForRuntime = (rt) => {
+    const raw = rt.config.devInfo?.meta?.["btScyChannel"];
+    if (!raw) {
+        return false;
+    }
+    try {
+        const parsed = typeof raw === "string"
+            ? JSON.parse(raw)
+            : raw;
+        return parsed?.enable === 1;
+    }
+    catch {
+        return false;
+    }
+};
+export const getSecurityUpdatedLockIds = async (fittingId) => {
+    try {
+        const props = await getDeviceProperties(fittingId, ["SECURITY_UPDATED"]);
+        const raw = props?.["SECURITY_UPDATED"];
+        if (typeof raw === "string") {
+            try {
+                return JSON.parse(raw).value || [];
+            }
+            catch {
+                return [];
+            }
+        }
+        if (raw && typeof raw === "object") {
+            return (raw.value ||
+                (Array.isArray(raw) ? raw : []));
+        }
+        return [];
+    }
+    catch (e) {
+        sdkLog("warn", "fit", "getSecurityUpdatedError", {
+            devId: fittingId,
+            error: e,
+        });
+        return [];
+    }
+};

package/lib/feature/fit/shared.d.ts

@@ -2,6 +2,14 @@ export type FitBindOperation = "bind" | "unbind";
 export declare const FIT_BIND_TIMEOUT_MS = 12000;
 export declare const FIT_OPERATION_CODE: Record<FitBindOperation, "00" | "01">;
 export declare const normalizeHex: (value: string) => string;
+export declare function markPrecautionaryUnbindPublished(fittingId: string, fit: {
+    fittingUnlockId: string;
+    randomStr: string;
+    devUnlockId: string;
+}): void;
+export declare function clearPrecautionaryUnbindSuppression(fittingId: string): void;
+export declare function shouldSuppressFitSyncReportFrame(fittingId: string, data: string): boolean;
+export declare function normalizeDevUuidHex(devUuid: string): string;
 export declare function buildTransparentData(operation: FitBindOperation, fit: {
     fittingUnlockId: string;
     randomStr: string;

package/lib/feature/fit/shared.js

@@ -7,8 +7,43 @@ export const FIT_OPERATION_CODE = {
     unbind: "01",
 };
 export const normalizeHex = (value) => value.replace(/\s/g, "");
+const PRECAUTIONARY_UNBIND_SUPPRESS_MS = 60_000;
+const pendingPrecautionaryUnbindAcks = new Map();
+const buildUnbindAckPrefix = (fit) => `01${fit.fittingUnlockId}${fit.randomStr}${fit.devUnlockId}`.toLowerCase();
+export function markPrecautionaryUnbindPublished(fittingId, fit) {
+    pendingPrecautionaryUnbindAcks.set(fittingId, {
+        prefix: buildUnbindAckPrefix(fit),
+        expiresAt: Date.now() + PRECAUTIONARY_UNBIND_SUPPRESS_MS,
+    });
+}
+export function clearPrecautionaryUnbindSuppression(fittingId) {
+    pendingPrecautionaryUnbindAcks.delete(fittingId);
+}
+export function shouldSuppressFitSyncReportFrame(fittingId, data) {
+    const entry = pendingPrecautionaryUnbindAcks.get(fittingId);
+    if (!entry) {
+        return false;
+    }
+    if (Date.now() > entry.expiresAt) {
+        pendingPrecautionaryUnbindAcks.delete(fittingId);
+        return false;
+    }
+    return normalizeHex(data).toLowerCase().startsWith(entry.prefix);
+}
+export function normalizeDevUuidHex(devUuid) {
+    if (devUuid.length >= 32 &&
+        devUuid.length % 2 === 0 &&
+        /^[0-9a-fA-F]+$/.test(devUuid)) {
+        return devUuid;
+    }
+    let hex = "";
+    for (let i = 0; i < devUuid.length; i += 1) {
+        hex += devUuid.charCodeAt(i).toString(16);
+    }
+    return hex;
+}
 export function buildTransparentData(operation, fit, loginKey) {
-    return `${FIT_OPERATION_CODE[operation]}${fit.fittingUnlockId}${fit.randomStr}${fit.devUnlockId}${fit.devUuid}${loginKey}`;
+    return `${FIT_OPERATION_CODE[operation]}${fit.fittingUnlockId}${fit.randomStr}${fit.devUnlockId}${normalizeDevUuidHex(fit.devUuid)}${loginKey}`;
 }
 export function buildLockCheckCodeTemplate(operation, fit) {
     return `ffff${fit.devUnlockId}${FIT_OPERATION_CODE[operation]}${fit.fittingUnlockId}${fit.randomStr}`;
@@ -106,8 +141,12 @@ export async function publishFitTransparentFlow(fittingId, keyDeviceId, operatio
         expectedOperation: FIT_OPERATION_CODE[operation],
     });
     if (operation === "bind") {
+        markPrecautionaryUnbindPublished(fittingId, fit);
         await publishBLETransparentData(fittingId, buildTransparentData("unbind", fit, loginKey));
     }
+    else {
+        clearPrecautionaryUnbindSuppression(fittingId);
+    }
     await publishBLETransparentData(fittingId, buildTransparentData(operation, fit, loginKey));
     await waitResult;
     sdkLog("info", "fit", "transparentFlowSuccess", {

package/lib/feature/fit/sync.d.ts

@@ -1,4 +1,6 @@
 import type { LockDeviceRuntime } from "../../runtime/LockDeviceRuntime";
+import { type SyncOpenModeRiseResult } from "../../api/fit";
 export declare function syncFitBindingsForRuntime(runtime: LockDeviceRuntime): Promise<void>;
-export declare function syncFitReportForRuntime(runtime: LockDeviceRuntime, ins: string): Promise<unknown>;
-export declare function syncOpenModeRiseForRuntime(runtime: LockDeviceRuntime, dpIds: string): Promise<unknown>;
+export declare function startFitSyncReportForRuntime(runtime: LockDeviceRuntime): void;
+export declare function stopFitSyncReportForRuntime(runtime: LockDeviceRuntime): void;
+export declare function syncOpenModeRiseForRuntime(runtime: LockDeviceRuntime, dpCodes?: string[]): Promise<SyncOpenModeRiseResult>;

package/lib/feature/fit/sync.js

@@ -1,12 +1,22 @@
 import { syncFitToLockRise, syncFitReport as syncFitReportApi, syncOpenModeRise as syncOpenModeRiseApi, } from "../../api/fit";
-import { publishBLETransparentData, subscribeBLETransparentDataReport, } from "../../platform/device";
+import { unlockMethodDpCodes } from "../utils";
+import { offBLETransparentDataReport, onBLETransparentDataReport, publishBLETransparentData, subscribeBLETransparentDataReport, } from "../../platform/device";
 import { sdkLog } from "../../utils/sdk-log";
+import { shouldSuppressFitSyncReportFrame } from "./shared";
 export async function syncFitBindingsForRuntime(runtime) {
     const startedAt = Date.now();
     const fittingId = runtime.devId;
     sdkLog("info", "fit", "syncBindingsStart", {
         devId: runtime.devId,
     });
+    if (runtime.sync.fitBindingsSyncStarted) {
+        sdkLog("info", "fit", "syncBindingsSkip", {
+            devId: runtime.devId,
+            data: { reason: "already_started" },
+        });
+        return;
+    }
+    runtime.sync.fitBindingsSyncStarted = true;
     try {
         const result = await syncFitToLockRise(fittingId);
         const instructions = Array.isArray(result.ins) ? result.ins : [];
@@ -29,6 +39,7 @@ export async function syncFitBindingsForRuntime(runtime) {
         });
     }
     catch (error) {
+        runtime.sync.fitBindingsSyncStarted = false;
         sdkLog("error", "fit", "syncBindingsFail", {
             devId: runtime.devId,
             duration: Date.now() - startedAt,
@@ -37,35 +48,65 @@ export async function syncFitBindingsForRuntime(runtime) {
         throw error;
     }
 }
-export async function syncFitReportForRuntime(runtime, ins) {
-    const startedAt = Date.now();
-    sdkLog("info", "fit", "syncReportStart", {
-        devId: runtime.devId,
-        data: { hasInstruction: !!ins },
-    });
-    try {
-        const result = await syncFitReportApi(runtime.devId, ins);
-        sdkLog("info", "fit", "syncReportSuccess", {
-            devId: runtime.devId,
-            duration: Date.now() - startedAt,
-        });
-        return result;
+export function startFitSyncReportForRuntime(runtime) {
+    if (runtime.sync.fitSyncReportHandler) {
+        return;
     }
-    catch (error) {
-        sdkLog("error", "fit", "syncReportFail", {
-            devId: runtime.devId,
-            duration: Date.now() - startedAt,
-            error,
+    const devId = runtime.devId;
+    subscribeBLETransparentDataReport(devId);
+    const handler = (params) => {
+        if (params?.deviceId !== devId || !params?.data) {
+            return;
+        }
+        if (shouldSuppressFitSyncReportFrame(devId, params.data)) {
+            sdkLog("info", "fit", "syncReportSuppressPrecautionaryUnbindAck", {
+                devId,
+            });
+            return;
+        }
+        syncFitReportApi(devId, params.data).catch((e) => {
+            sdkLog("warn", "fit", "syncReportAutoError", {
+                devId,
+                error: e,
+            });
         });
-        throw error;
+    };
+    runtime.sync.fitSyncReportHandler = handler;
+    onBLETransparentDataReport(handler);
+    sdkLog("info", "fit", "startSyncReport", { devId });
+}
+export function stopFitSyncReportForRuntime(runtime) {
+    const handler = runtime.sync.fitSyncReportHandler;
+    if (handler) {
+        offBLETransparentDataReport(handler);
+        runtime.sync.fitSyncReportHandler = null;
     }
+    runtime.sync.fitBindingsSyncStarted = false;
+    sdkLog("info", "fit", "stopSyncReport", { devId: runtime.devId });
 }
-export async function syncOpenModeRiseForRuntime(runtime, dpIds) {
+export async function syncOpenModeRiseForRuntime(runtime, dpCodes) {
     const startedAt = Date.now();
+    const codes = dpCodes?.length ? dpCodes : unlockMethodDpCodes;
+    const dpIds = [
+        ...new Set(codes.reduce((res, code) => {
+            const id = runtime.config.idsByCode[code];
+            if (id) {
+                res.push(String(id));
+            }
+            return res;
+        }, [])),
+    ];
     sdkLog("info", "fit", "syncOpenModeRiseStart", {
         devId: runtime.devId,
-        data: { hasDpIds: !!dpIds },
+        data: { isAll: !dpCodes?.length, dpIdCount: dpIds.length },
     });
+    if (!dpIds.length) {
+        sdkLog("info", "fit", "syncOpenModeRiseSkip", {
+            devId: runtime.devId,
+            data: { reason: "no_matched_dp" },
+        });
+        return { ins: "", distributed: false };
+    }
     try {
         const result = await syncOpenModeRiseApi(runtime.devId, dpIds);
         sdkLog("info", "fit", "syncOpenModeRiseSuccess", {

package/lib/feature/fit/temp-password.d.ts

@@ -25,3 +25,26 @@ export interface RenameFitTempPwdParams {
     name: string;
 }
 export declare const fitRenameTempPwdForRuntime: (runtime: LockDeviceRuntime, params: RenameFitTempPwdParams) => Promise<void>;
+export interface RenameFitOfflineTempPwdParams {
+    pwdId: number;
+    name: string;
+}
+export declare const fitRenameOfflineTempPwdForRuntime: (runtime: LockDeviceRuntime, params: RenameFitOfflineTempPwdParams) => Promise<void>;
+export interface RevokeFitOfflineTempPwdParams {
+    pwdId: number;
+    name?: string;
+}
+export interface FitOfflineClearCodeResult {
+    password: string;
+    pwdId: string;
+    name: string;
+    effectiveConfig: {
+        effectiveDate: number;
+        expiredDate: number;
+    };
+}
+export declare const fitRevokeOfflineTempPwdForRuntime: (runtime: LockDeviceRuntime, params: RevokeFitOfflineTempPwdParams) => Promise<FitOfflineClearCodeResult>;
+export interface ResendFitTempPwdParams {
+    id: number;
+}
+export declare const fitResendTempPwdForRuntime: (runtime: LockDeviceRuntime, params: ResendFitTempPwdParams) => Promise<boolean>;