@nannier/sdk in your TypeScript app

npm install @nannier/sdk
# or
bun add @nannier/sdk

import { IonizeClient } from "@nannier/sdk";

export const ionize = new IonizeClient({
  publicUrl: process.env.IONIZE_PUBLIC_URL!,     // https://ciam.your-domain
  adminUrl: process.env.IONIZE_ADMIN_URL,        // backend-only; omit for browser
  clientId: process.env.IONIZE_CLIENT_ID!,
  clientSecret: process.env.IONIZE_CLIENT_SECRET, // confidential clients only
});

const session = await ionize.toSession();
// throws if no session; .traits, .identity_id, .aal available

const url = await ionize.buildAuthorizationUrl({
  scope: ["openid", "offline_access", "profile", "email"],
  redirectUri: "/callback",
  pkce: true,
});
window.location.href = url;

const { accessToken, idToken, refreshToken } = await ionize.exchangeCodeForTokens(code);
// PKCE verifier is auto-managed in sessionStorage

const refreshed = await ionize.refreshToken();
// Stored access_token / refresh_token rotated

const intro = await ionize.introspect(accessToken);
// intro.active, .sub, .scope, .client_id, ...

const identities = await ionize.admin.identities.list({
  page: 1,
  perPage: 50,
  filter: 'traits.email eq "alice@example.com"',
});

const identity = await ionize.admin.identities.create({
  schema_id: "default",
  traits: { email: "alice@example.com", first_name: "Alice" },
  credentials: {
    password: { config: { password: "RandomTempPass123!" } }
  },
  state: "active",
});

const link = await ionize.admin.identities.createRecoveryLink({
  identity_id: identityId,
  expires_in: "1h",
});
// Email this link to the user

import type { Session, Identity, AdminIdentitiesListResponse } from "@nannier/sdk";

function describe(id: Identity) {
  return `${id.traits.first_name} ${id.traits.last_name}`;
}

import { IonizeError, NotFoundError, ValidationError } from "@nannier/sdk";

try {
  await ionize.toSession();
} catch (err) {
  if (err instanceof NotFoundError) {
    // not logged in
  } else if (err instanceof IonizeError) {
    // other Ionize error
  } else {
    throw err;
  }
}

npm install @nannier/sdk-react

import { IonizeProvider, useSession, useLogin } from "@nannier/sdk-react";

function App() {
  return (
    <IonizeProvider client={ionize}>
      <Profile />
    </IonizeProvider>
  );
}

function Profile() {
  const { session, loading } = useSession();
  if (loading) return <Spinner />;
  if (!session) return <a href="/login">Sign in</a>;
  return <p>Hi {session.identity.traits.first_name}</p>;
}

// server.ts
export const ionizeServer = new IonizeClient({ /* with admin */ });

// client.ts
export const ionizeBrowser = new IonizeClient({ /* without admin */ });

// app/api/whoami/route.ts
import { ionizeServer } from "@/lib/ionize";
import { cookies } from "next/headers";

export async function GET() {
  const session = await ionizeServer.toSession(cookies().toString());
  return Response.json(session);
}

app.use(ionize.middleware());  // sets req.session