init method

Future<void> init({ bool enableCache = false, })

Initialize the secure storage Must be called before using any storage operations

Automatically detects app reinstallation and clears old secure storage data

enableCache - Enable in-memory caching for frequently accessed data

Throws SecureStorageException if initialization fails

Implementation

Future<void> init({bool enableCache = false}) async {
  if (_initialized) return;

  await _withLock(() async {
    if (_initialized) return; // Double-check after acquiring lock

    try {
      // Check if app was reinstalled and clear old secure storage data
      await _checkAndClearOnReinstall();

      // Get or create encryption key
      String? savedKey = await _secureStorage.read(key: _keyIdentifier);

      if (savedKey == null) {
        // Generate new key on first launch
        _key = encrypt.Key.fromSecureRandom(32);
        savedKey = base64Url.encode(_key.bytes);
        await _secureStorage.write(key: _keyIdentifier, value: savedKey);

        // Set initial version
        await _secureStorage.write(
          key: _versionKey,
          value: _currentVersion.toString(),
        );
      } else {
        // Load existing key
        final keyBytes = base64Url.decode(savedKey);
        _key = encrypt.Key(keyBytes);

        // Check version and migrate if needed
        await _checkAndMigrateVersion();
      }

      _initialized = true;
    } catch (e) {
      throw SecureStorageException(
        'Failed to initialize SecureStorageUtil',
        e,
      );
    }
  });
}