Misar IO Docs

TypeScript SDK

Install and use the @misar/io TypeScript SDK for MisarIO SSO and account APIs

Installation

npm install @misar/io
# or
pnpm add @misar/io

Quick Start

import { MisarIOClient } from '@misar/io';

const client = new MisarIOClient(process.env.MISARIO_API_KEY!);

const session = await client.ssoCheck({ redirect_url: 'https://misar.dev/dashboard' });

if (session.authenticated) {
  console.log('User:', session.user_id);
} else {
  const init = await client.ssoInit({ redirect_url: 'https://misar.dev/dashboard' });
  window.location.href = init.redirect_url;
}

Methods

| Method | Description | |--------|-------------| | ssoCheck(params) | Check if user has active SSO session | | ssoInit(params) | Initiate SSO login flow, returns redirect URL | | ssoVerify(token) | Verify an SSO token on the target domain | | ssoLogout(params?) | Log out the current user | | sessionCheck() | Check local session validity | | accountDelete() | Delete the authenticated user's account | | accountExport() | Export the authenticated user's data |

Error Handling

import { MisarIOError, MisarIONetworkError } from '@misar/io';

try {
  await client.ssoVerify('bad-token');
} catch (err) {
  if (err instanceof MisarIOError) {
    console.error(err.status, err.message);
  }
}