Bot SDK: @castyr/bots-auth

import { CastyrBotAuth, FileTokenStore, ActivationDeniedError, ActivationExpiredError } from "@castyr/bots-auth";

const castyr = new CastyrBotAuth({
  clientId: process.env.CASTYR_CLIENT_ID,
  store: new FileTokenStore("castyr-links.json"), // survives restarts
});

try {
  await castyr.activate({
    key: memberId,                // your id for this link, e.g. a Discord user id
    platformName: "Helper Bot",   // shown to the owner when they approve
    scope: "identify",
    onCode: ({ userCode, verificationUriComplete, confirmationPhrase }) =>
      sendPrivately(memberId, `Open ${verificationUriComplete}, check the code is ${userCode}, pick "${confirmationPhrase}".`),
  });
  const { user } = await castyr.getLink(memberId);
  console.log(`Linked to @${user.preferred_username}`);
} catch (error) {
  if (error instanceof ActivationDeniedError) { /* denied, or the wrong phrase was picked */ }
  else if (error instanceof ActivationExpiredError) { /* nobody approved within 10 minutes */ }
  else throw error;
}

const token = await castyr.getAccessToken(memberId); // null if not linked
if (token) {
  const profile = await castyr.getUser(token);       // { sub, name, preferred_username, picture }
}

const castyr = new CastyrBotAuth({
  clientId: process.env.CASTYR_CLIENT_ID,
  store: new FileTokenStore("castyr-links.json"),
  onUnlinked: (memberId, { reason, user }) => notify(memberId, "You're no longer connected to Castyr."),
});
castyr.startAutoRefresh();                            // renews tokens and checks every link every 5 minutes
const stillLinked = await castyr.verifyLink(memberId); // ask Castyr right now

const store = {
  get: async (key) => revive(await db.get(`castyr:${key}`)),
  set: (key, link) => db.set(`castyr:${key}`, link),
  delete: (key) => db.delete(`castyr:${key}`),
  keys: () => db.keys("castyr:*").then((ks) => ks.map((k) => k.slice(7))),
};
// Dates come back from JSON as strings: revive link.linkedAt and link.tokens.expiresAt with new Date(...).