@xrmforge/typegen 0.8.3 → 0.8.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/LICENSE +21 -21
  2. package/MIGRATION.md +194 -194
  3. package/dist/index.js +4 -4
  4. package/dist/index.js.map +1 -1
  5. package/docs/architecture/00-README.md +26 -26
  6. package/docs/architecture/01-executive-summary.md +11 -11
  7. package/docs/architecture/02-packages.md +110 -110
  8. package/docs/architecture/03-generated-types.md +172 -172
  9. package/docs/architecture/04-cli.md +58 -58
  10. package/docs/architecture/05-build.md +50 -50
  11. package/docs/architecture/06-incremental.md +42 -42
  12. package/docs/architecture/07-http-client.md +59 -59
  13. package/docs/architecture/08-authentication.md +18 -18
  14. package/docs/architecture/09-testing.md +55 -55
  15. package/docs/architecture/10-eslint-plugin.md +82 -82
  16. package/docs/architecture/11-agent-md.md +38 -38
  17. package/docs/architecture/12-xrm-pitfalls.md +14 -14
  18. package/docs/architecture/13-helpers.md +50 -50
  19. package/docs/architecture/14-showcases.md +21 -21
  20. package/docs/architecture/15-ci-cd.md +49 -49
  21. package/docs/architecture/16-technical-debt.md +17 -17
  22. package/docs/architecture/17-roadmap.md +25 -25
  23. package/docs/architecture/18-design-principles.md +22 -22
  24. package/docs/architektur/00-README.md +26 -26
  25. package/docs/architektur/01-zusammenfassung.md +11 -11
  26. package/docs/architektur/02-packages.md +110 -110
  27. package/docs/architektur/03-generierte-typen.md +172 -172
  28. package/docs/architektur/04-cli.md +58 -58
  29. package/docs/architektur/05-build.md +50 -50
  30. package/docs/architektur/06-inkrementell.md +42 -42
  31. package/docs/architektur/07-http-client.md +59 -59
  32. package/docs/architektur/08-authentifizierung.md +18 -18
  33. package/docs/architektur/09-testing.md +55 -55
  34. package/docs/architektur/10-eslint-plugin.md +82 -82
  35. package/docs/architektur/11-agent-md.md +38 -38
  36. package/docs/architektur/12-xrm-fallstricke.md +14 -14
  37. package/docs/architektur/13-helpers.md +50 -50
  38. package/docs/architektur/14-showcases.md +21 -21
  39. package/docs/architektur/15-ci-cd.md +49 -49
  40. package/docs/architektur/16-technische-schulden.md +17 -17
  41. package/docs/architektur/17-roadmap.md +25 -25
  42. package/docs/architektur/18-designprinzipien.md +22 -22
  43. package/package.json +1 -1
package/docs/architektur/18-designprinzipien.md CHANGED
@@ -1,22 +1,22 @@
1
- # 18. Designprinzipien
2
-
3
- Die 18 Designprinzipien, die die gesamte XrmForge-Entwicklung bestimmen:
4
-
5
- 1. **Erweitern, nicht ersetzen** - Typen bauen auf @types/xrm auf, überschreiben sie nie.
6
- 2. **TypeScript durchgängig** - 100% TypeScript-nativ. Kein .NET, kein ADAL.
7
- 3. **Code muss bauen** - Jeder Arbeitsschritt endet mit grünem Build + Tests.
8
- 4. **Recherche vor Geschwindigkeit** - Untersuchen, vergleichen, entscheiden, dann implementieren. Niemals raten.
9
- 5. **Kein Modul ohne Grundlagen** - Fehlerbehandlung, Logging, Unit-Tests, JSDoc auf allen öffentlichen APIs.
10
- 6. **Monorepo-Disziplin** - Jedes Package eigenständig, keine zirkulären Abhängigkeiten, Barrel-Exports.
11
- 7. **Enterprise-Resilienz** - Retry + exponentielles Backoff, Rate-Limit-Erkennung, Token-Caching, Read-only als Standard.
12
- 8. **esbuild-first, webpack-kompatibel** - Standard: esbuild (schnell). webpack bleibt unterstützt. IIFE-Output für D365.
13
- 9. **Nur MSAL-Authentifizierung** - Ausschliesslich @azure/identity (kein Legacy-ADAL). Drei Flows: Client Credentials, Browser, Device Code.
14
- 10. **Review erforderlich** - Nach jedem Schritt sofortiges kritisches Review (6 Dimensionen). Nicht fragen, ob Review gewünscht ist.
15
- 11. **Session-State erforderlich** - session-state.md aktualisiert, Changelog geschrieben, offene Fragen erfasst.
16
- 12. **Keine halben Sachen** - Jeder Schritt vollständig abgeschlossen: grüner Build + Tests + Review vor dem nächsten Schritt.
17
- 13. **Fundierte Architekturentscheidungen** - Recherchieren, vergleichen, mit Pro/Contra empfehlen, Entscheidung einholen, persistieren.
18
- 14. **Abstraktion statt Vendor-Lock-in** - Externe Abhängigkeiten hinter Interfaces (Parser, Auth, Bundler).
19
- 15. **Zweisprachige Labels** - Primärsprache (1033/Englisch) für Bezeichner, Sekundärsprache in JSDoc. Deutsche Umlaute transliteriert.
20
- 16. **Review mit Recherche und Live-Verifikation** - Internetrecherche, Live-D365-Verifikation, Produktionscode-Prüfungen, Quellen zitieren.
21
- 17. **Aufschub hinterfragen** - "Später"-Check: Wird es schwieriger? API-Vertrag? Echter Aufwand? Technische Gründe?
22
- 18. **Read-only als Standard für Dataverse-Zugriff** - DataverseHttpClient ist standardmässig readOnly: true. Schreibzugriff ist ein explizites Opt-in.
1
+ # 18. Designprinzipien
2
+
3
+ Die 18 Designprinzipien, die die gesamte XrmForge-Entwicklung bestimmen:
4
+
5
+ 1. **Erweitern, nicht ersetzen** - Typen bauen auf @types/xrm auf, überschreiben sie nie.
6
+ 2. **TypeScript durchgängig** - 100% TypeScript-nativ. Kein .NET, kein ADAL.
7
+ 3. **Code muss bauen** - Jeder Arbeitsschritt endet mit grünem Build + Tests.
8
+ 4. **Recherche vor Geschwindigkeit** - Untersuchen, vergleichen, entscheiden, dann implementieren. Niemals raten.
9
+ 5. **Kein Modul ohne Grundlagen** - Fehlerbehandlung, Logging, Unit-Tests, JSDoc auf allen öffentlichen APIs.
10
+ 6. **Monorepo-Disziplin** - Jedes Package eigenständig, keine zirkulären Abhängigkeiten, Barrel-Exports.
11
+ 7. **Enterprise-Resilienz** - Retry + exponentielles Backoff, Rate-Limit-Erkennung, Token-Caching, Read-only als Standard.
12
+ 8. **esbuild-first, webpack-kompatibel** - Standard: esbuild (schnell). webpack bleibt unterstützt. IIFE-Output für D365.
13
+ 9. **Nur MSAL-Authentifizierung** - Ausschliesslich @azure/identity (kein Legacy-ADAL). Drei Flows: Client Credentials, Browser, Device Code.
14
+ 10. **Review erforderlich** - Nach jedem Schritt sofortiges kritisches Review (6 Dimensionen). Nicht fragen, ob Review gewünscht ist.
15
+ 11. **Session-State erforderlich** - session-state.md aktualisiert, Changelog geschrieben, offene Fragen erfasst.
16
+ 12. **Keine halben Sachen** - Jeder Schritt vollständig abgeschlossen: grüner Build + Tests + Review vor dem nächsten Schritt.
17
+ 13. **Fundierte Architekturentscheidungen** - Recherchieren, vergleichen, mit Pro/Contra empfehlen, Entscheidung einholen, persistieren.
18
+ 14. **Abstraktion statt Vendor-Lock-in** - Externe Abhängigkeiten hinter Interfaces (Parser, Auth, Bundler).
19
+ 15. **Zweisprachige Labels** - Primärsprache (1033/Englisch) für Bezeichner, Sekundärsprache in JSDoc. Deutsche Umlaute transliteriert.
20
+ 16. **Review mit Recherche und Live-Verifikation** - Internetrecherche, Live-D365-Verifikation, Produktionscode-Prüfungen, Quellen zitieren.
21
+ 17. **Aufschub hinterfragen** - "Später"-Check: Wird es schwieriger? API-Vertrag? Echter Aufwand? Technische Gründe?
22
+ 18. **Read-only als Standard für Dataverse-Zugriff** - DataverseHttpClient ist standardmässig readOnly: true. Schreibzugriff ist ein explizites Opt-in.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xrmforge/typegen",
3
- "version": "0.8.3",
3
+ "version": "0.8.5",
4
4
  "description": "TypeScript declaration generator for Dynamics 365 / Dataverse",
5
5
  "keywords": [
6
6
  "dynamics-365",