Events

EPIS.on('ready', function (data: { mount: EpisBoxMount }) {
  console.log('EPIS is ready');
});

EPIS.on('auth', function (data: {
  user: {
    id:    string;   // PastpaperLM user UUID
    name:  string;   // Display name
    email: string;   // Email address
    tier:  string;   // 'free' | 'basic' | 'flash' | 'pro' | 'max' | 'ultimate'
  }
}) {
  // Update your own UI
  document.getElementById('user-name').textContent = data.user.name;
  document.getElementById('user-section').style.display = 'flex';
});

EPIS.on('auth-error', function (data: {
  code:    string;
  message: string;
}) {
  if (data.code === 'popup_blocked') {
    showBanner('Please allow popups for this site to sign in with PastpaperLM.');
  } else if (data.code === 'cancelled') {
    // User closed the popup — no action needed
  } else {
    console.error('Auth error:', data.code, data.message);
  }
});

EPIS.on('message', function (data: {
  role:      'assistant';
  content:   string;      // full response text (not streaming chunks)
  sessionId: string;      // UUID of the chat session
}) {
  // Log activity, track engagement
  analytics.track('epis_response', {
    session: data.sessionId,
    length:  data.content.length,
  });
});

EPIS.on('error', function (data: {
  code:        string;
  message:     string;
  recoverable: boolean;  // if false, the embed may need remounting
}) {
  if (!data.recoverable) {
    // EPIS embed is in a broken state — remount
    EPIS.unmount('#epis-chat');
    EPIS.mountChat('#epis-chat');
  } else {
    // transient error, EPIS will retry automatically
    console.warn('EPIS transient error:', data.code);
  }
});

EPIS.on('unmount', function (data: {
  selector: string;  // the selector that was unmounted
}) {
  console.log('Unmounted:', data.selector);
});

function handleAuth(data) {
  greetUser(data.user.name);
}

EPIS.on('auth', handleAuth);

// Later:
EPIS.off('auth', handleAuth);

const onMessage = (data) => logActivity(data.content);

EPIS.on('message', onMessage);
EPIS.off('message', onMessage);  // works — same reference

// ❌ This listener cannot be removed — no reference to pass to off()
EPIS.on('message', (data) => logActivity(data.content));