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 a root file like index.js before calling AppRegistry.registerComponent.

import {initPensa} from 'pensa-sdk-react-native';

initPensa({
  clientId: 'YOUR_CLIENT_ID',
  clientSecret: 'YOUR_CLIENT_SECRET',
  isLoggingEnabled: true,
})
  .then(() => {
    console.log('[Pensa] SDK init success');
  })
  .catch((error) => {
    console.log('[Pensa] SDK init error:', error);
  });

• 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)

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:

// hooks/usePensaListeners.ts
import {useEffect} from 'react';
import {PensaEvents} from 'pensa-sdk-react-native';

export const usePensaListeners = () => {
  useEffect(() => {
    const unsubscribeProgress = PensaEvents.addListener(
      'onScanUploadProgressUpdate',
      (e) => {
        console.log('[Pensa] Progress', e.progress, e.tdlinxId, e.scanAreaId);
      },
    );

    const unsubscribeCompleted = PensaEvents.addListener(
      'onScanUploadCompleted',
      (e) => {
        console.log('[Pensa] Completed', e.tdlinxId, e.scanAreaId);
      },
    );

    const unsubscribeFailed = PensaEvents.addListener(
      'onScanUploadFailed',
      (e) => {
        console.log('[Pensa] Failed', e.error, e.tdlinxId, e.scanAreaId);
      },
    );

    const unsubscribeCantScan = PensaEvents.addListener(
      'onCantScanReported',
      (e) => {
        console.log('[Pensa] CantScan', e.reason, e.tdlinxId, e.scanAreaId);
      },
    );

    return () => {
      unsubscribeProgress();
      unsubscribeCompleted();
      unsubscribeFailed();
      unsubscribeCantScan();
    };
  }, []);
};

Then call the hook in your component:

import {usePensaListeners} from './hooks/usePensaListeners';
...
usePensaListeners();

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.