npm.io
0.2.0 • Published 18h ago

mostajs-orm-validator

Licence
AGPL-3.0-or-later
Version
0.2.0
Deps
2
Size
24 kB
Vulns
0
Weekly
0
SummaryDependencyVersions

@mostajs/orm — ORMConceptValidator (VSCode Extension)

v0.1.0 — Plug-in VSCode pour le ORMConceptValidator de @mostajs/orm. Détecte 18 anomalies conceptuelles dans vos EntitySchema avec squiggles inline et quick-fix.

Auteur : Dr Hamid MADANI drmdh@msn.com

Installation

Depuis le Marketplace (quand publié)

ext install apolocine.mostajs-orm-validator
Depuis source (développement)
git clone https://github.com/apolocine/mosta-orm-vscode
cd mosta-orm-vscode
npm install
npm run compile
# Ouvrir le dossier dans VSCode, F5 pour lancer un Extension Development Host

Pré-requis

Le workspace doit avoir :

  • @mostajs/orm@^1.15.0 (le validator CLI doit être accessible via npx mostajs-orm-validator)
  • Un dossier de schémas (default ./schemas, configurable)

Configuration

Paramètres dans VSCode (File > Preferences > Settings, chercher "mostajs orm") :

Paramètre Default Description
mostajsOrmValidator.enabled true Active/désactive l'extension pour le workspace
mostajsOrmValidator.schemasDir ./schemas Dossier des fichiers *.schema.ts
mostajsOrmValidator.sourceRoot ./lib Dossier source pour règles cross-file (R005, R007, R008, R011, R012, R014, R015)
mostajsOrmValidator.ignore [] Règles à ignorer (ex: ["R015", "R017"])
mostajsOrmValidator.runOnSave true Relancer à chaque save d'un *.schema.ts

Commandes (Ctrl+Shift+P)

Commande Description
ORMValidator: Validate current workspace Lance le validator sur tout le workspace
ORMValidator: Apply all auto-fixes Applique --fix pour toutes les règles fixables (V3-A V2)
ORMValidator: Rollback last --fix (restore .bak) Restaure les .bak du dernier --fix

Fonctionnement

À l'ouverture d'un fichier TypeScript, l'extension :

  1. Lance npx mostajs-orm-validator <schemasDir> --src <sourceRoot> --format json
  2. Parse les findings JSON
  3. Affiche chaque finding comme un Diagnostic VSCode (squiggle inline) :
    • error → squiggle rouge
    • warning → squiggle jaune
    • info → squiggle bleu
    • hint → soulignement gris
  4. Le code de la règle (ex: R001-EMPTY-RELATIONS) apparaît dans le tooltip + dans la barre Problems
  5. Sur sauvegarde (si runOnSave: true), relance la validation

Quick-fix V3-C V1 (limité)

V0.1.0 propose des suggestions textuelles dans les tooltips. Les quick-fix automatiques (via VSCode Code Actions) arrivent en V3-C V2 — pour l'instant utiliser le CLI :

npx mostajs-orm-validator ./schemas --src ./lib --fix-dry-run    # preview
npx mostajs-orm-validator ./schemas --src ./lib --fix             # apply
npx mostajs-orm-validator ./schemas --rollback-fix                # undo

Limites V0.1.0

  • Quick-fix VSCode Code Action : non implémenté (V3-C V2) — utiliser CLI pour appliquer
  • LSP server dédié : pas encore (V3-C V3, performance optimale) — utilise le CLI via spawn
  • Marketplace publish : pas encore (décision utilisateur — nécessite PAT Azure DevOps)

Roadmap

  • V3-C V2 : LSP server natif (perf, sans spawn CLI) + Code Actions VSCode pour les quick-fix
  • V3-C V3 : Publish sur VSCode Marketplace + JetBrains Marketplace (IntelliJ/WebStorm)
  • V4 : Intégration GitHub Actions / preview dans PR

Licence

AGPL-3.0-or-later

Keywords

ormvalidatorlintermostajsschema