User Auth Data & Events

The User Auth drop-in uses the event bus to emit and listen to events for communication between drop-ins and external integrations.

Version: 3.0.0-beta1

Events reference

Event	Direction	Description
auth/error	Emits	Emitted when an error occurs.
auth/group-uid	Emits	Emitted when a specific condition or state change occurs.
auth/permissions	Emits	Emitted when permissions are updated.

Event details

The following sections provide detailed information about each event, including its direction, event payload, and usage examples.

auth/error (emits)

Emitted when an error occurs.

Event payload

{ source: string; type: string; error: Error | string }

Example

import { events } from '@dropins/tools/event-bus.js';

events.on('auth/error', (payload) => {
  console.log('auth/error event received:', payload);
  // Add your custom logic here
});

auth/group-uid (emits)

Emitted when a specific condition or state change occurs.

Event payload

string

Example

import { events } from '@dropins/tools/event-bus.js';

events.on('auth/group-uid', (payload) => {
  console.log('auth/group-uid event received:', payload);
  // Add your custom logic here
});

auth/permissions (emits)

Emitted when permissions are updated.

Event payload

PermissionsModel

See PermissionsModel for full type definition.

Example

import { events } from '@dropins/tools/event-bus.js';

events.on('auth/permissions', (payload) => {
  console.log('auth/permissions event received:', payload);
  // Add your custom logic here
});

Data Models

The following data models are used in event payloads for this drop-in.

PermissionsModel

Used in: auth/permissions.

interface PermissionsModel {
  all?: boolean;
  admin?: boolean;
  [key: string]: boolean;
}