PERS SDK - v2.3.26 / Exports / PersEventEmitter
• get instanceId(): number
number
core/events/event-emitter.ts:88
• get subscriberCount(): number
Get count of active subscriptions
number
core/events/event-emitter.ts:298
• new PersEventEmitter(): PersEventEmitter
core/events/event-emitter.ts:84
▸ subscribe(handler, filter?): Unsubscribe
Subscribe to events
| Name | Type | Description |
|---|---|---|
handler | EventHandler | Callback for matching events |
filter? | EventFilter | Optional filter by domain and/or level. Set replay: true to receive last auth event if missed. |
Unsubscribe function
Example
const unsub = sdk.events.subscribe((event) => {
console.log(`[${event.domain}] ${event.type}: ${event.userMessage}`);
});Example
sdk.events.subscribe((event) => {
logToSentry(event);
}, { levels: ['error'] });Example
sdk.events.subscribe((event) => {
playSuccessSound();
confetti();
}, { domains: ['transaction'], levels: ['success'] });Example
sdk.events.subscribe((event) => {
if (event.type === 'session_restored') {
const { user } = event.details;
setUser(user);
}
}, { domains: ['authentication'], replay: true });core/events/event-emitter.ts:132
▸ once(handler, filter?): Unsubscribe
Subscribe and auto-unsubscribe after first matching event
| Name | Type | Description |
|---|---|---|
handler | EventHandler | Callback for the first matching event |
filter? | EventFilter | Optional filter by domain and/or level |
Unsubscribe function
core/events/event-emitter.ts:161
▸ emitSuccess(event): SuccessEvent
Emit a success event
Domain is restricted to business domains only (Domain type). Auth events (login_success, session_restored) are cached for replay to late subscribers.
| Name | Type | Description |
|---|---|---|
event | SuccessEventInput | Success event data (id and timestamp auto-generated) |
The complete event object
Example
sdk.events.emitSuccess({
domain: 'transaction', // Only business domains allowed
type: 'transaction_confirmed',
userMessage: 'Transaction confirmed!'
});core/events/event-emitter.ts:191
▸ emitError(event): ErrorEvent
Emit an error event
Domain can be any domain including technical (ErrorDomain type).
| Name | Type | Description |
|---|---|---|
event | ErrorEventInput | Error event data (id and timestamp auto-generated) |
The complete event object
Example
sdk.events.emitError({
domain: 'validation', // Technical domains allowed
type: 'validation_failed',
userMessage: 'Please check your input'
});core/events/event-emitter.ts:231
▸ clear(): void
Remove all handlers
void