WebView SDK Manager Reference

WebViewSdkManager({
  Environment environment = Environment.DEV,
  @Deprecated('Basic auth removed in v1.1.0 — use Firebase custom tokens')
  String? basicAuthUser,
  @Deprecated('Basic auth removed in v1.1.0 — use Firebase custom tokens')
  String? basicAuthPass,
  void Function(String, dynamic)? updateCallback,
})

bool get isInitialized

Future<WebViewSdkManager> init({
  required String clientId,
  required String clientSecret,
  required String clientUserId,
  Environment? environment,
  String? membershipTier,
  @Deprecated('Basic auth removed in v1.1.0')
  String? basicAuthUser,
  @Deprecated('Basic auth removed in v1.1.0')
  String? basicAuthPass,
  void Function(String, dynamic)? updateCallback,
})

// Example events (see specific integration guides for complete lists):
'START_MSK_ASSESSMENT'
'FINISH_ASSESSMENT_SURVEY'
// ... and more

// Initialize
final webViewSdkManager = WebViewSdkManager(
  environment: Environment.UAT,
  updateCallback: (event, data) {
    // Handle events based on your integration
    print('Event received: $event');
    print('Event data: $data');

    // For MSK Assessment events, see the MSK Integration Guide
    // at ../msk-integration.md for detailed event handling
  },
);

// Register as singleton
if (!GetIt.I.isRegistered<WebViewSdkManager>()) {
  GetIt.I.registerSingleton<WebViewSdkManager>(webViewSdkManager);
}

// Initialize with credentials
await webViewSdkManager.init(
  clientId: 'your-client-id',
  clientSecret: 'your-client-secret',
  clientUserId: 'user-id',
  environment: Environment.UAT,
);

// Check if initialized
if (webViewSdkManager.isInitialized) {
  // Ready to use
}

import 'package:get_it/get_it.dart';

if (!GetIt.I.isRegistered<WebViewSdkManager>()) {
  final webViewSdkManager = WebViewSdkManager(
    environment: environment,
    updateCallback: webViewSdkUpdateCallback,
  );
  GetIt.I.registerSingleton<WebViewSdkManager>(webViewSdkManager);
}

final webViewSdkManager = GetIt.I<WebViewSdkManager>();

if (GetIt.I.isRegistered<WebViewSdkManager>()) {
  GetIt.I.unregister<WebViewSdkManager>();
}

try {
  await webViewSdkManager.init(
    clientId: clientId,
    clientSecret: clientSecret,
    clientUserId: clientUserId,
    environment: environment,
  );
} catch (e) {
  if (e is AuthenticationException) {
    // Handle authentication errors
    showAuthenticationError();
  } else if (e is NetworkException) {
    // Handle network errors
    showNetworkError();
  } else {
    // Handle other errors
    showGenericError(e.toString());
  }
}

// ✅ Correct: Use singleton
if (!GetIt.I.isRegistered<WebViewSdkManager>()) {
  GetIt.I.registerSingleton<WebViewSdkManager>(webViewSdkManager);
}

// ❌ Incorrect: Create multiple instances
final manager1 = WebViewSdkManager(...);
final manager2 = WebViewSdkManager(...);

// ✅ Correct: Check before use
if (!webViewSdkManager.isInitialized) {
  await webViewSdkManager.init(...);
}

// ❌ Incorrect: Assume it's initialized
webViewSdkManager.someMethod(); // May fail

// ✅ Correct: Handle all error cases
try {
  await webViewSdkManager.init(...);
} catch (e) {
  handleInitializationError(e);
}

// ❌ Incorrect: No error handling
webViewSdkManager.init(...); // May fail silently

// ✅ Correct: Provide callback for events
WebViewSdkManager(
  updateCallback: (event, data) {
    // Handle events appropriately
    handleWebViewEvent(event, data);
  },
);

// ❌ Incorrect: No callback
WebViewSdkManager(); // Missing important events