mobile-invue-live-lock-sdk-rn

A cross-platform React Native SDK for integrating and managing Live Lock based smart locks via Bluetooth Low Energy (BLE), providing secure access control, device discovery, and lock management APIs

Installation

npm install mobile-invue-live-lock-sdk-rn

Usage

import liveLockModule from 'mobile-invue-live-lock-sdk-rn';

// Initialize customer certificate (returns { success, error?, errorMessage? })
const certResult = await liveLockModule.initializeCustCertificate(customerCertificateBase64);

// unLock timeout in milliseconds (4000 = 4 sec; matches @invue sample).
// liveDoorUnlock accepts milliseconds (wrapper converts to seconds on iOS).
await liveLockModule.unLock(serialNumber, 4000);
await liveLockModule.liveDoorUnlock(macAddress, 4000);

Migration from legacy (LiveAccessSdk)

• initializeCustCertificate returns { success: boolean; error?: string; errorMessage?: string } (always resolves; use success to detect failure).
• Timeout units: unLock accepts milliseconds (4000 = 4 sec; matches @invue sample). unlockOpm uses seconds. liveDoorUnlock accepts milliseconds (wrapper converts to seconds on iOS). Defaults: unLock 4000 ms, unlockOpm 300 s, liveDoorUnlock 4000 ms.
• getLiveLockDiscoveryManagerInstance is not exposed; use getLiveLockList, getLiveLock, getLiveDoorList, etc. instead.
• LockStatusObserver is not a public API; subscribe to events (onLockStatusChange, onDoorLockStatusChange, etc.) instead.
• downloadFirmware options: url, sessionCookie, authToken, modelName, fwVersion; response is parsed (data.data.data byte array) like legacy.
• CCC field alias: LiveLock device field is ccc. A legacy alias CCC is included in JS wrappers for compatibility.
• getLiveLock not found: iOS now resolves null (legacy returned {}).

Contributing

• Development workflow
• Sending a pull request
• Code of conduct

License

MIT

Made with create-react-native-library