SDK Initialization

Initializing the Pensa SDK is straightforward. Follow the steps below to set up the SDK with your credentials and start using its features.

1- Initializing PensaSdk

Call initPensa() at the startup of your app, preferably in the initState of your root widget.

import 'package:pensa_flutter_sdk/pensa_flutter_sdk.dart';

final pensa = PensaFlutterSdk();

await pensa.initPensa(
  clientId: 'YOUR_CLIENT_ID',
  clientSecret: 'YOUR_CLIENT_SECRET',
  isLoggingEnabled: true,
);
```

• clientId and clientSecret are required.

• If clientId or clientSecret is missing, initialization will fail.

• isLoggingEnabled is optional. When true, internal SDK logs will be printed to console.

2- Add Listeners (Optional)

Each event delivered by the pensa_flutter_sdk_events channel includes two parts:

• event: The event name (one of the supported values).

• payload: A map containing the event-specific data.

Event Name	Payload Fields
onScanUploadProgressUpdate	tdlinxId, scanAreaId, progress
onScanUploadCompleted	tdlinxId, scanAreaId
onScanUploadFailed	tdlinxId, scanAreaId, error
onCantScanReported	tdlinxId, scanAreaId, reason

To listen to SDK events such as upload progress, success, or failure, you can create a helper hook like below:

import 'package:flutter/services.dart';

const eventChannel = EventChannel('pensa_flutter_sdk_events');

void startListeningPensaEvents() {
  eventChannel.receiveBroadcastStream().listen((event) {
    final map = Map<String, dynamic>.from(event);
    final eventName = map['event'];
    final payload = Map<String, dynamic>.from(map['payload'] ?? {});

    print("[Pensa Event] $eventName -> $payload");
  });
}

You should call usePensaListeners() before initPensa(). Calling it after may result in missing early events emitted during SDK initialization.

This will automatically register and clean up all supported event listeners.

Once initialized, you can use any of the SDK methods like showShelfScans, showStoresScreen, or showScanArea.