Context7 Platform -- Up-to-date docs for AI agents
CTX7-2681: Clarify CLI login recovery and share the API URL (#3200)
Enes Gules4416fb855b8f
diff --git a/.changeset/clear-login-recovery.md b/.changeset/clear-login-recovery.mdnew file mode 100644index 00000000..81de933a--- /dev/null+++ b/.changeset/clear-login-recovery.md@@ -0,0 +1,7 @@+---+"ctx7": patch+---++Use the shared API URL for login and explain how to sign in again when the server rejects a saved session.++Recommend logout and login only when the server returns HTTP 401. Report other identity-check failures without asking users to discard saved credentials.diff --git a/packages/cli/src/__tests__/auth-commands.test.ts b/packages/cli/src/__tests__/auth-commands.test.tsindex 7b526edd..dddcd162 100644--- a/packages/cli/src/__tests__/auth-commands.test.ts+++ b/packages/cli/src/__tests__/auth-commands.test.ts@@ -164,18 +164,49 @@ describe("whoami command", () => {expect(fetchMock).not.toHaveBeenCalled();});- test("shows session expired hint when fetch fails", async () => {+ test("shows logout before login when the server rejects a saved session", async () => {mockGetValidAccessToken.mockResolvedValue("valid-token");vi.stubGlobal("fetch",vi.fn().mockResolvedValue({ok: false,+ status: 401,json: () => Promise.reject(new Error("fail")),}));await runCommand("whoami");- expect(logOutput.some((l) => l.includes("Session may be expired"))).toBe(true);+ expect(logOutput.join("\n")).toMatch(/ctx7 logout.*ctx7 login/);+ });++ test.each([403, 500])("does not recommend logout for HTTP %i", async (status) => {+ mockGetValidAccessToken.mockResolvedValue("valid-token");+ vi.stubGlobal("fetch", vi.fn().mockResolvedValue(new Response(null, { status })));++ await runCommand("whoami");++ expect(logOutput.join("\n")).toContain("Could not verify your session");+ expect(logOutput.join("\n")).not.toMatch(/ctx7 logout|ctx7 login/);+ });++ test("does not recommend logout when the identity request fails", async () => {+ mockGetValidAccessToken.mockResolvedValue("valid-token");+ vi.stubGlobal("fetch", vi.fn().mockRejectedValue(new TypeError("fetch failed")));++ await runCommand("whoami");++ expect(logOutput.join("\n")).toContain("Could not verify your session");+ expect(logOutput.join("\n")).not.toMatch(/ctx7 logout|ctx7 login/);+ });++ test("does not recommend logout for an invalid identity response", async () => {+ mockGetValidAccessToken.mockResolvedValue("valid-token");+ vi.stubGlobal("fetch", vi.fn().mockResolvedValue(new Response("{")));++ await runCommand("whoami");++ expect(logOutput.join("\n")).toContain("Could not verify your session");+ expect(logOutput.join("\n")).not.toMatch(/ctx7 logout|ctx7 login/);});test("tracks whoami event", async () => {diff --git a/packages/cli/src/commands/auth.ts b/packages/cli/src/commands/auth.tsindex d1271eb0..948cadd1 100644--- a/packages/cli/src/commands/auth.ts+++ b/packages/cli/src/commands/auth.ts@@ -17,12 +17,6 @@ import { trackEvent } from "../utils/tracking.js";import { CLI_CLIENT_ID } from "../constants.js";import { getBaseUrl } from "../utils/api.js";-let baseUrl = "https://context7.com";--export function setAuthBaseUrl(url: string): void {- baseUrl = url;-}-export function registerAuthCommands(program: Command): void {program.command("login")@@ -112,6 +106,7 @@ async function announceIdentity(accessToken: string): Promise<string> {}export async function performLogin(openBrowser = true): Promise<string | null> {+ const baseUrl = getBaseUrl();const spinner = ora("Preparing login...").start();let authorization;@@ -246,8 +241,14 @@ async function whoamiCommand(): Promise<void> {if (whoami.teamspace) {console.log(`${pc.dim("Teamspace:".padEnd(13))}${whoami.teamspace.name}`);}- } catch {- console.log(pc.dim("(Session may be expired - run 'ctx7 login' to refresh)"));+ } catch (error) {+ console.log(+ pc.dim(+ error instanceof SessionRejectedError+ ? "Session was rejected by the server. Run 'ctx7 logout', then 'ctx7 login' to sign in again."+ : "Could not verify your session. Try again later."+ )+ );}}@@ -258,6 +259,8 @@ interface WhoamiResponse {teamspace: { id: string; name: string } | null;}+class SessionRejectedError extends Error {}+async function fetchWhoami(accessToken: string): Promise<WhoamiResponse> {const response = await fetch(`${getBaseUrl()}/api/dashboard/whoami`, {headers: {@@ -265,6 +268,9 @@ async function fetchWhoami(accessToken: string): Promise<WhoamiResponse> {},});+ if (response.status === 401) {+ throw new SessionRejectedError("Session was rejected by the server");+ }if (!response.ok) {throw new Error("Failed to fetch user info");}diff --git a/packages/cli/src/index.ts b/packages/cli/src/index.tsindex ab5339dc..77604871 100644--- a/packages/cli/src/index.ts+++ b/packages/cli/src/index.ts@@ -2,7 +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 { registerAuthCommands } from "./commands/auth.js";import { registerSetupCommand } from "./commands/setup.js";import { registerRemoveCommand } from "./commands/remove.js";import { registerDocsCommands } from "./commands/docs.js";@@ -26,7 +26,6 @@ programconst opts = thisCommand.opts();if (opts.baseUrl) {setBaseUrl(opts.baseUrl);- setAuthBaseUrl(opts.baseUrl);}}).hook("preAction", async (_thisCommand, actionCommand) => {