Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

cursor-sdk auth.md: non-null assertion described as a runtime missing-variable check

Ouverte Adaptée aux débutants
  • Quelque chose ne va pas ?
#473 1 commentaire 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

@lab1207 y travaille déjà.

Depuis le 2/10/2026.

  • #488 par @lab1207 — ouverte

Évaluation

Difficulté
1/5
Temps estimé
Moins d'une heure
Accessibilité débutants
92/100
Type d'issue
Documentation
Clarté
Clairement spécifiée
Activité
Active
Stack technique
typescript
Domaine
documentation

Piste de recherche

Ouvrez cursor-sdk/skills/cursor-sdk/references/auth.md à la ligne référencée et relisez le paragraphe décrivant apiKey: process.env.CURSOR_API_KEY!. Comparez-le avec la vérification explicite d’une clé manquante présentée quelques lignes plus bas. Mettez à jour l’explication afin qu’elle distingue correctement l’assertion à la compilation de TypeScript de la validation à l’exécution, puis vérifiez que la documentation ne prétend plus que ! vérifie la variable d’environnement.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

Observed at commit 2eb7ed4613cfc8f098dfe464a23680ea44d84c5e: cursor-sdk/skills/cursor-sdk/references/auth.md line 45.

The text reads:

The non-null assertion (!) is a readable way to say "fail loudly if the env var is missing" — otherwise the SDK will throw an auth error later and the stack trace won't point at the env var.

for the example apiKey: process.env.CURSOR_API_KEY!.

Problem

In TypeScript the postfix ! is a compile-time-only assertion; it is erased in emitted JavaScript and performs no runtime check. If CURSOR_API_KEY is unset, undefined is passed through and the failure appears later in the SDK, exactly the outcome the sentence says ! avoids.

Suggested fix

Reword to say that ! only silences the type error and does no check, and lead with the explicit check that is already shown a few lines below:

const apiKey = process.env.CURSOR_API_KEY;
if (!apiKey) {
  console.error("Missing CURSOR_API_KEY. ...");
  process.exit(1);
}
Langage dominant
TypeScript
Étoiles
12.5k
Forks
1.2k
Merge moyen
10 h 48 min
PR mergées (30 j)
128

Préparer son environnement

Ce projet ne fournit ni conteneur de développement, ni Dockerfile, ni guide de contribution : l'installation est à votre charge. Commencez par son README, et consultez notre guide de la première contribution pour les étapes générales.

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de cursor/plugins

Toutes les issues de cursor/plugins

Issues similaires

Plus d'issues TypeScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.