Context7 Platform -- Up-to-date docs for AI agents
feat(cli): add OAuth 2.0 support with login, whoami and logout commands (#1573)
Fahreddin Özcanaacfd3165ad9
diff --git a/.changeset/purple-tigers-dance.md b/.changeset/purple-tigers-dance.mdnew file mode 100644index 00000000..7569df17--- /dev/null+++ b/.changeset/purple-tigers-dance.md@@ -0,0 +1,5 @@+---+"ctx7": minor+---++Add OAuth 2.0 authentication with login, logout, and whoami commands.diff --git a/packages/cli/package.json b/packages/cli/package.jsonindex e2039324..cf578997 100644--- a/packages/cli/package.json+++ b/packages/cli/package.json@@ -23,6 +23,7 @@"@inquirer/prompts": "^8.2.0","commander": "^13.1.0","figlet": "^1.9.4",+ "open": "^10.1.0","ora": "^9.0.0","picocolors": "^1.1.1"},diff --git a/packages/cli/src/commands/auth.ts b/packages/cli/src/commands/auth.tsnew file mode 100644index 00000000..c7d685a7--- /dev/null+++ b/packages/cli/src/commands/auth.ts@@ -0,0 +1,183 @@+import { Command } from "commander";+import pc from "picocolors";+import ora from "ora";+import open from "open";+import {+ generatePKCE,+ generateState,+ createCallbackServer,+ exchangeCodeForTokens,+ saveTokens,+ loadTokens,+ clearTokens,+ buildAuthorizationUrl,+ isTokenExpired,+} from "../utils/auth.js";++const CLI_CLIENT_ID = "2veBSofhicRBguUT";++let baseUrl = "https://context7.com";++export function setAuthBaseUrl(url: string): void {+ baseUrl = url;+}++export function registerAuthCommands(program: Command): void {+ program+ .command("login")+ .description("Log in to Context7")+ .option("--no-browser", "Don't open browser automatically")+ .action(async (options) => {+ await loginCommand(options);+ });++ program+ .command("logout")+ .description("Log out of Context7")+ .action(() => {+ logoutCommand();+ });++ program+ .command("whoami")+ .description("Show current login status")+ .action(async () => {+ await whoamiCommand();+ });+}++async function loginCommand(options: { browser: boolean }): Promise<void> {+ const existingTokens = loadTokens();+ if (existingTokens) {+ const expired = isTokenExpired(existingTokens);+ if (!expired || existingTokens.refresh_token) {+ console.log(pc.yellow("You are already logged in."));+ console.log(+ pc.dim("Run 'ctx7 logout' first if you want to log in with a different account.")+ );+ return;+ }+ clearTokens();+ }++ const spinner = ora("Preparing login...").start();++ try {+ const { codeVerifier, codeChallenge } = generatePKCE();+ const state = generateState();+ const callbackServer = createCallbackServer(state);+ const port = await callbackServer.port;+ const redirectUri = `http://localhost:${port}/callback`;+ const authUrl = buildAuthorizationUrl(+ baseUrl,+ CLI_CLIENT_ID,+ redirectUri,+ codeChallenge,+ state+ );++ spinner.stop();++ console.log("");+ console.log(pc.bold("Opening browser to log in..."));+ console.log("");++ if (options.browser) {+ await open(authUrl);+ console.log(pc.dim("If the browser didn't open, visit this URL:"));+ } else {+ console.log(pc.dim("Open this URL in your browser:"));+ }+ console.log(pc.cyan(authUrl));+ console.log("");++ const waitingSpinner = ora("Waiting for login...").start();++ try {+ const { code } = await callbackServer.result;+ waitingSpinner.text = "Exchanging code for tokens...";++ const tokens = await exchangeCodeForTokens(+ baseUrl,+ code,+ codeVerifier,+ redirectUri,+ CLI_CLIENT_ID+ );+ saveTokens(tokens);+ callbackServer.close();++ waitingSpinner.succeed(pc.green("Login successful!"));+ console.log("");+ console.log(pc.dim("You can now use authenticated Context7 features."));+ } catch (error) {+ callbackServer.close();+ waitingSpinner.fail(pc.red("Login failed"));+ if (error instanceof Error) {+ console.error(pc.red(error.message));+ }+ process.exit(1);+ }+ } catch (error) {+ spinner.fail(pc.red("Login failed"));+ if (error instanceof Error) {+ console.error(pc.red(error.message));+ }+ process.exit(1);+ }+}++function logoutCommand(): void {+ if (clearTokens()) {+ console.log(pc.green("Logged out successfully."));+ } else {+ console.log(pc.yellow("You are not logged in."));+ }+}++async function whoamiCommand(): Promise<void> {+ const tokens = loadTokens();++ if (!tokens) {+ console.log(pc.yellow("Not logged in."));+ console.log(pc.dim("Run 'ctx7 login' to authenticate."));+ return;+ }++ console.log(pc.green("Logged in"));++ try {+ const userInfo = await fetchUserInfo(tokens.access_token);+ if (userInfo.name) {+ console.log(`${pc.dim("Name:".padEnd(9))}${userInfo.name}`);+ }+ if (userInfo.email) {+ console.log(`${pc.dim("Email:".padEnd(9))}${userInfo.email}`);+ }+ } catch {+ if (isTokenExpired(tokens) && !tokens.refresh_token) {+ console.log(pc.dim("(Session may be expired - run 'ctx7 login' to refresh)"));+ }+ }+}++interface UserInfo {+ sub?: string;+ name?: string;+ email?: string;+ picture?: string;+}++async function fetchUserInfo(accessToken: string): Promise<UserInfo> {+ const response = await fetch("https://clerk.context7.com/oauth/userinfo", {+ headers: {+ Authorization: `Bearer ${accessToken}`,+ },+ });++ if (!response.ok) {+ throw new Error("Failed to fetch user info");+ }++ return (await response.json()) as UserInfo;+}diff --git a/packages/cli/src/index.ts b/packages/cli/src/index.tsindex 3d558550..6a1352fe 100644--- a/packages/cli/src/index.ts+++ b/packages/cli/src/index.ts@@ -2,6 +2,7 @@ import { Command } from "commander";import pc from "picocolors";import figlet from "figlet";import { registerSkillCommands, registerSkillAliases } from "./commands/skill.js";+import { registerAuthCommands, setAuthBaseUrl } from "./commands/auth.js";import { setBaseUrl } from "./utils/api.js";import { VERSION } from "./constants.js";@@ -21,6 +22,7 @@ programconst opts = thisCommand.opts();if (opts.baseUrl) {setBaseUrl(opts.baseUrl);+ setAuthBaseUrl(opts.baseUrl);}}).addHelpText(@@ -49,6 +51,7 @@ Visit ${brand.primary("https://context7.com")} to browse skillsregisterSkillCommands(program);registerSkillAliases(program);+registerAuthCommands(program);program.action(() => {console.log("");diff --git a/packages/cli/src/utils/auth.ts b/packages/cli/src/utils/auth.tsnew file mode 100644index 00000000..9db23255--- /dev/null+++ b/packages/cli/src/utils/auth.ts@@ -0,0 +1,268 @@+import * as crypto from "crypto";+import * as http from "http";+import * as fs from "fs";+import * as path from "path";+import * as os from "os";++const CONFIG_DIR = path.join(os.homedir(), ".context7");+const CREDENTIALS_FILE = path.join(CONFIG_DIR, "credentials.json");++export interface TokenData {+ access_token: string;+ refresh_token?: string;+ token_type: string;+ expires_in?: number;+ expires_at?: number;+ scope?: string;+}++export interface PKCEChallenge {+ codeVerifier: string;+ codeChallenge: string;+}++export function generatePKCE(): PKCEChallenge {+ const codeVerifier = crypto.randomBytes(32).toString("base64url");+ const codeChallenge = crypto.createHash("sha256").update(codeVerifier).digest("base64url");+ return { codeVerifier, codeChallenge };+}++export function generateState(): string {+ return crypto.randomBytes(16).toString("base64url");+}++function ensureConfigDir(): void {+ if (!fs.existsSync(CONFIG_DIR)) {+ fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });+ }+}++export function saveTokens(tokens: TokenData): void {+ ensureConfigDir();+ const data = {+ ...tokens,+ expires_at:+ tokens.expires_at ?? (tokens.expires_in ? Date.now() + tokens.expires_in * 1000 : undefined),+ };+ fs.writeFileSync(CREDENTIALS_FILE, JSON.stringify(data, null, 2), { mode: 0o600 });+}++export function loadTokens(): TokenData | null {+ if (!fs.existsSync(CREDENTIALS_FILE)) {+ return null;+ }+ try {+ const data = JSON.parse(fs.readFileSync(CREDENTIALS_FILE, "utf-8"));+ return data as TokenData;+ } catch {+ return null;+ }+}++export function clearTokens(): boolean {+ if (fs.existsSync(CREDENTIALS_FILE)) {+ fs.unlinkSync(CREDENTIALS_FILE);+ return true;+ }+ return false;+}++export function isTokenExpired(tokens: TokenData): boolean {+ if (!tokens.expires_at) {+ return false;+ }+ return Date.now() > tokens.expires_at - 60000;+}++export interface CallbackResult {+ code: string;+ state: string;+}++// Port for OAuth callback server - must match registered redirect URI+const CALLBACK_PORT = 52417;++export function createCallbackServer(expectedState: string): {+ port: Promise<number>;+ result: Promise<CallbackResult>;+ close: () => void;+} {+ let resolvePort: (port: number) => void;+ let resolveResult: (result: CallbackResult) => void;+ let rejectResult: (error: Error) => void;+ let serverInstance: http.Server | null = null;++ const portPromise = new Promise<number>((resolve) => {+ resolvePort = resolve;+ });++ const resultPromise = new Promise<CallbackResult>((resolve, reject) => {+ resolveResult = resolve;+ rejectResult = reject;+ });++ const server = http.createServer((req, res) => {+ const url = new URL(req.url || "/", `http://localhost`);++ if (url.pathname === "/callback") {+ const code = url.searchParams.get("code");+ const state = url.searchParams.get("state");+ const error = url.searchParams.get("error");+ const errorDescription = url.searchParams.get("error_description");++ res.writeHead(200, { "Content-Type": "text/html" });++ if (error) {+ res.end(errorPage(errorDescription || error));+ serverInstance?.close();+ rejectResult(new Error(errorDescription || error));+ return;+ }++ if (!code || !state) {+ res.end(errorPage("Missing authorization code or state"));+ serverInstance?.close();+ rejectResult(new Error("Missing authorization code or state"));+ return;+ }++ if (state !== expectedState) {+ res.end(errorPage("State mismatch - possible CSRF attack"));+ serverInstance?.close();+ rejectResult(new Error("State mismatch"));+ return;+ }++ res.end(successPage());+ serverInstance?.close();+ resolveResult({ code, state });+ } else {+ res.writeHead(404);+ res.end("Not found");+ }+ });++ serverInstance = server;++ server.on("error", (err) => {+ rejectResult(err as Error);+ });++ server.listen(CALLBACK_PORT, "127.0.0.1", () => {+ resolvePort(CALLBACK_PORT);+ });++ const timeout = setTimeout(+ () => {+ server.close();+ rejectResult(new Error("Login timed out after 5 minutes"));+ },+ 5 * 60 * 1000+ );++ return {+ port: portPromise,+ result: resultPromise,+ close: () => {+ clearTimeout(timeout);+ server.close();+ },+ };+}++function successPage(): string {+ return `<!DOCTYPE html>+<html>+ <head><title>Login Successful</title></head>+ <body style="font-family: system-ui; display: flex; justify-content: center; align-items: center; height: 100vh; margin: 0; background: #f9fafb;">+ <div style="text-align: center; padding: 2rem;">+ <div style="width: 64px; height: 64px; background: #16a34a; border-radius: 50%; display: flex; align-items: center; justify-content: center; margin: 0 auto 1rem;">+ <svg width="32" height="32" fill="none" stroke="white" stroke-width="3" viewBox="0 0 24 24">+ <path d="M5 13l4 4L19 7" stroke-linecap="round" stroke-linejoin="round"/>+ </svg>+ </div>+ <h1 style="color: #16a34a; margin: 0 0 0.5rem;">Login Successful!</h1>+ <p style="color: #6b7280; margin: 0;">You can close this window and return to the terminal.</p>+ </div>+ </body>+</html>`;+}++function escapeHtml(text: string): string {+ return text+ .replace(/&/g, "&")+ .replace(/</g, "<")+ .replace(/>/g, ">")+ .replace(/"/g, """)+ .replace(/'/g, "'");+}++function errorPage(message: string): string {+ const safeMessage = escapeHtml(message);+ return `<!DOCTYPE html>+<html>+ <head><title>Login Failed</title></head>+ <body style="font-family: system-ui; display: flex; justify-content: center; align-items: center; height: 100vh; margin: 0; background: #f9fafb;">+ <div style="text-align: center; padding: 2rem;">+ <div style="width: 64px; height: 64px; background: #dc2626; border-radius: 50%; display: flex; align-items: center; justify-content: center; margin: 0 auto 1rem;">+ <svg width="32" height="32" fill="none" stroke="white" stroke-width="3" viewBox="0 0 24 24">+ <path d="M6 18L18 6M6 6l12 12" stroke-linecap="round" stroke-linejoin="round"/>+ </svg>+ </div>+ <h1 style="color: #dc2626; margin: 0 0 0.5rem;">Login Failed</h1>+ <p style="color: #6b7280; margin: 0;">${safeMessage}</p>+ <p style="color: #9ca3af; margin: 1rem 0 0; font-size: 0.875rem;">You can close this window.</p>+ </div>+ </body>+</html>`;+}++interface TokenErrorResponse {+ error?: string;+ error_description?: string;+}++export async function exchangeCodeForTokens(+ baseUrl: string,+ code: string,+ codeVerifier: string,+ redirectUri: string,+ clientId: string+): Promise<TokenData> {+ const response = await fetch(`${baseUrl}/api/oauth/token`, {+ method: "POST",+ headers: { "Content-Type": "application/x-www-form-urlencoded" },+ body: new URLSearchParams({+ grant_type: "authorization_code",+ client_id: clientId,+ code,+ code_verifier: codeVerifier,+ redirect_uri: redirectUri,+ }).toString(),+ });++ if (!response.ok) {+ const err = (await response.json().catch(() => ({}))) as TokenErrorResponse;+ throw new Error(err.error_description || err.error || "Failed to exchange code for tokens");+ }++ return (await response.json()) as TokenData;+}++export function buildAuthorizationUrl(+ baseUrl: string,+ clientId: string,+ redirectUri: string,+ codeChallenge: string,+ state: string+): string {+ const url = new URL(`${baseUrl}/api/oauth/authorize`);+ url.searchParams.set("client_id", clientId);+ url.searchParams.set("redirect_uri", redirectUri);+ url.searchParams.set("code_challenge", codeChallenge);+ url.searchParams.set("code_challenge_method", "S256");+ url.searchParams.set("state", state);+ url.searchParams.set("scope", "profile email");+ url.searchParams.set("response_type", "code");+ return url.toString();+}diff --git a/pnpm-lock.yaml b/pnpm-lock.yamlindex 94e0767f..20d33370 100644--- a/pnpm-lock.yaml+++ b/pnpm-lock.yaml@@ -50,6 +50,9 @@ importers:figlet:specifier: ^1.9.4version: 1.9.4+ open:+ specifier: ^10.1.0+ version: 10.2.0ora:specifier: ^9.0.0version: 9.0.0@@ -1227,6 +1230,10 @@ packages:resolution: {integrity: sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==}engines: {node: '>=8'}+ resolution: {integrity: sha512-tjwM5exMg6BGRI+kNmTntNsvdZS1X8BFYS6tnJ2hdH0kVxM6/eVZ2xy+FqStSWvYmtfFMDLIxurorHwDKfDz5Q==}+ engines: {node: '>=18'}+resolution: {integrity: sha512-3WrrOuZiyaaZPWiEt4G3+IffISVC9HYlWueJEBWED4ZH4aIAC2PnkdnuRrR94M+w6yGWn4AglWtJtBI8YqvgoA==}engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}@@ -1353,6 +1360,18 @@ packages:resolution: {integrity: sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==}+ resolution: {integrity: sha512-x1VCxdX4t+8wVfd1so/9w+vQ4vx7lKd2Qp5tDRutErwmR85OgmfX7RlLRMWafRMY7hbEiXIbudNrjOAPa/hL8Q==}+ engines: {node: '>=18'}++ resolution: {integrity: sha512-XDuvSq38Hr1MdN47EDvYtx3U0MTqpCEn+F6ft8z2vYDzMrvQhVp0ui9oQdqW3MvK3vqUETglt1tVGgjLuJ5izg==}+ engines: {node: '>=18'}++ resolution: {integrity: sha512-N+MeXYoqr3pOgn8xfyRPREN7gHakLYjhsHhWGT3fWAiL4IkAt0iDw14QiiEm2bE30c5XX5q0FtAA3CK5f9/BUg==}+ engines: {node: '>=12'}+resolution: {integrity: sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==}engines: {node: '>= 0.8'}@@ -1705,6 +1724,11 @@ packages:resolution: {integrity: sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==}engines: {node: '>= 0.10'}+ resolution: {integrity: sha512-eljcgEDlEns/7AXFosB5K/2nCM4P7FQPkGc/DWLy5rmFEWvZayGrik1d9/QIY5nJ4f9YsVvBkA6kJpHn9rISdQ==}+ engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}+ hasBin: true+resolution: {integrity: sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==}engines: {node: '>=0.10.0'}@@ -1713,6 +1737,11 @@ packages:resolution: {integrity: sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==}engines: {node: '>=0.10.0'}+ resolution: {integrity: sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA==}+ engines: {node: '>=14.16'}+ hasBin: true+resolution: {integrity: sha512-qP1vozQRI+BMOPcjFzrjXuQvdak2pHNUMZoeG2eRbiSqyvbEf/wQtEOTOX1guk6E3t36RkaqiSt8A/6YElNxLQ==}engines: {node: '>=12'}@@ -1736,6 +1765,10 @@ packages:resolution: {integrity: sha512-eXK1UInq2bPmjyX6e3VHIzMLobc4J94i4AWn+Hpq3OU5KkrRC96OAcR3PRJ/pGu6m8TRnBHP9dkXQVsT/COVIA==}engines: {node: '>=0.10.0'}+ resolution: {integrity: sha512-UcVfVfaK4Sc4m7X3dUSoHoozQGBEFeDC+zVo06t98xe8CzHSZZBekNXH+tu0NalHolcJ/QAGqS46Hef7QXBIMw==}+ engines: {node: '>=16'}+resolution: {integrity: sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==}@@ -1904,6 +1937,10 @@ packages:resolution: {integrity: sha512-VXJjc87FScF88uafS3JllDgvAm+c/Slfz06lorj2uAY34rlUu0Nt+v8wreiImcrgAjjIHp1rXpTDlLOGw29WwQ==}engines: {node: '>=18'}+ resolution: {integrity: sha512-YgBpdJHPyQ2UE5x+hlSXcnejzAvD0b22U2OuAP+8OnlJT+PjWPxtgmGqKKc+RgTM63U9gN0YzrYc71R2WT/hTA==}+ engines: {node: '>=18'}+resolution: {integrity: sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==}engines: {node: '>= 0.8.0'}@@ -2101,6 +2138,10 @@ packages:resolution: {integrity: sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ==}engines: {node: '>= 18'}+ resolution: {integrity: sha512-DPe5pVFaAsinSaV6QjQ6gdiedWDcRCbUuiQfQa2wmWV7+xC9bGulGI8+TdRmoFkAPaBXk8CrAbnlY2ISniJ47Q==}+ engines: {node: '>=18'}+resolution: {integrity: sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==}@@ -2434,6 +2475,10 @@ packages:resolution: {integrity: sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==}+ resolution: {integrity: sha512-h3Fbisa2nKGPxCpm89Hk33lBLsnaGBvctQopaBSOW/uIs6FTe1ATyAnKFJrzVs9vpGdsTe73WF3V4lIsk4Gacw==}+ engines: {node: '>=18'}+resolution: {integrity: sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==}engines: {node: '>=10'}@@ -3471,6 +3516,10 @@ snapshots:dependencies:fill-range: 7.1.1+ dependencies:+ run-applescript: 7.1.0+dependencies:esbuild: 0.27.0@@ -3560,6 +3609,15 @@ snapshots:+ [email protected]: {}++ dependencies:+ bundle-name: 4.1.0+ default-browser-id: 5.0.1++ [email protected]: {}+@@ -3977,12 +4035,18 @@ snapshots:+ [email protected]: {}+dependencies:is-extglob: 2.1.1+ dependencies:+ is-docker: 3.0.0+@@ -3997,6 +4061,10 @@ snapshots:+ dependencies:+ is-inside-container: 1.0.0+@@ -4136,6 +4204,13 @@ snapshots:dependencies:mimic-function: 5.0.1+ dependencies:+ default-browser: 5.4.0+ define-lazy-prop: 3.0.0+ is-inside-container: 1.0.0+ wsl-utils: 0.1.0+dependencies:deep-is: 0.1.4@@ -4327,6 +4402,8 @@ snapshots:transitivePeerDependencies:- supports-color+ [email protected]: {}+dependencies:queue-microtask: 1.2.3@@ -4637,6 +4714,10 @@ snapshots:+ dependencies:+ is-wsl: 3.1.0+