@mintlify/cli 4.0.1466 → 4.0.1468

package/src/status.tsx

@@ -30,6 +30,30 @@ export async function getCliStatus(
   }
 }
 
+export type CliStatusResult =
+  | { ok: true; status: z.infer<typeof StatusResponseSchema> }
+  | { ok: false; reason: 'unauthenticated' | 'unreachable' | 'invalid'; detail?: string };
+
+/**
+ * Like getCliStatus, but refreshes an expired session and says why it failed, so commands can
+ * tell "log in again" apart from "the server is down" and from "not allowed".
+ */
+export async function fetchCliStatus(): Promise<CliStatusResult> {
+  let res: Response;
+  try {
+    res = await authenticatedFetch(`${API_URL}/api/cli/status`);
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    if (/not authenticated/i.test(detail)) return { ok: false, reason: 'unauthenticated' };
+    return { ok: false, reason: 'unreachable', detail };
+  }
+  if (res.status === 401 || res.status === 403) return { ok: false, reason: 'unauthenticated' };
+  if (!res.ok) return { ok: false, reason: 'unreachable', detail: `HTTP ${res.status}` };
+  const parsed = StatusResponseSchema.safeParse(await res.json().catch(() => null));
+  if (!parsed.success) return { ok: false, reason: 'invalid' };
+  return { ok: true, status: parsed.data };
+}
+
 export async function getCliSubdomains(accessToken: string): Promise<string[]> {
   const status = await getCliStatus(accessToken);
   return status?.subdomains ?? [];