@obsidiane/meridiane
v2.0.7
Published
Générateur de librairie Angular et modèles TypeScript (OpenAPI) pour un bridge Symfony/API Platform + Mercure.
Downloads
247
Readme
@obsidiane/meridiane
CLI pour générer un bridge Angular (runtime + models TypeScript) depuis une spec OpenAPI (API Platform + Mercure).
Documentation complète du repo : docs/guide-bridge.md.
Installation
npm i -D @obsidiane/meridianeCommandes
meridiane generate <packageName>
Génère uniquement les sources du bridge dans le workspace courant.
npx meridiane generate @acme/backend-bridge --spec ./openapi.jsonSortie par défaut : projects/<libName>/ (modifiable via --out).
meridiane dev [packageName]
Génération + build standalone + npm pack + installation locale dans node_modules.
npx meridiane dev @acme/backend-bridge --spec http://localhost:8000/api/docs.jsonSorties :
dist/<libName>/+dist/<libName>/*.tgznode_modules/<packageName>/
meridiane build <packageName>
Génération + build standalone + npm pack (artefact publiable).
npx meridiane build @acme/backend-bridge --version 1.2.3 --spec https://staging.example/api/docs.jsonSorties :
dist/<libName>/dist/<libName>/*.tgz
Options
--spec <url|file>: URL OpenAPI ou fichier JSON local (requis sauf--no-models)--formats <mimeTypes>: répétable ou liste,; défautapplication/ld+json--include <substr>/--exclude <substr>: filtres de noms de schémas (répétables, support,)--no-models: runtime only--version <semver>:buildetgenerate(défaut0.0.0)--out <dir>: uniquementgenerate--debug: logs détaillés
Notes importantes
- fallback automatique
.../api/docs.json->.../api/docs.jsonopenapisi nécessaire - mode contract-driven : uniquement les schémas atteignables via
pathspour les formats sélectionnés - modèles
*jsonMergePatch*non générés (PATCHtypéPartial<T>) - Meridiane ne publie pas : publication via
npm publishcôté CI
Spécifique à ce repo
Dans ce monorepo, meridiane dev peut être exécuté sans packageName et cible alors @obsidiane/bridge-sandbox (app apps/sandbox).
