@gandalan/weblibs 1.5.19 → 1.5.21

package/JSDOC.md

@@ -243,6 +243,52 @@ Why:
 - The JS language service resolves explicit file extensions more consistently.
 
 
+## Rule 2a: Root DTO aliases must be generated, not hand-maintained
+
+The package root cannot rely on:
+
+```js
+export * from "./api/dtos/index.js"
+```
+
+to make JSDoc typedef aliases available through:
+
+```js
+import("@gandalan/weblibs").VorgangDTO
+```
+
+Why:
+
+- `export *` only forwards runtime exports.
+- JSDoc `@typedef` aliases are not runtime exports.
+- Root-level package imports therefore degrade to `any` unless the root module defines the aliases itself.
+
+The required pattern is:
+
+- keep `api/dtos/index.js` as the DTO alias source of truth
+- generate matching root typedef aliases into `index.js`
+- generate `index.d.ts` from the full package JSDoc source set for TypeScript consumers
+
+Do not edit the generated root DTO block manually. Regenerate it with:
+
+```bash
+npm run generate:root-dto-typedefs
+```
+
+The generator has two separate responsibilities:
+
+- `index.js`: generate the root DTO alias block for stable JSDoc imports from the package root
+- `index.d.ts`: generate root type exports for all non-trivial JSDoc-defined package types discovered in `index.js`, `api/**/*.js`, and `ui/**/*.js`
+
+For `index.d.ts`, simple local helper aliases like this are intentionally ignored:
+
+```js
+/** @typedef {import('../fluentApi.js').FluentApi} FluentApi */
+```
+
+because those are only local imports, not source type definitions. The declaration generator exports the canonical defining module instead.
+
+
 ## Rule 3: DTO files must import cross-file DTO dependencies locally
 
 If a DTO property references a type from another DTO file, that dependency must be represented in the file itself.

package/README.md

@@ -3,122 +3,70 @@
 ## Deutsch
 
 ### Zweck
-`@gandalan/weblibs` stellt Hilfsfunktionen für die Authentifizierung und API-Kommunikation mit IDAS sowie lokale API-Aufrufe bereit.
+`@gandalan/weblibs` stellt Fluent-APIs fuer IDAS und lokale REST-Aufrufe sowie das passende Auth-Handling bereit.
+
+- `fetchEnvConfig(...)` fuer Endpunktkonfiguration
+- `fluentIdasAuthManager(...)` fuer Authentifizierung
+- `idasFluentApi(...)` fuer IDAS-Business-APIs
+- `fluentApi(...)` fuer eigene oder lokale REST-Endpunkte
 
 ### Referenz
 - IDAS API (Swagger): https://api.dev.idas-cloudservices.net/swagger/
+- JSDoc-Regeln und Typing-Konventionen: [JSDOC.md](./JSDOC.md)
 
 ### Voraussetzungen
-- Browser-Umgebung (es werden `window`, `localStorage`, URL-Redirects und `fetch` verwendet)
-- Gültiger App-Token als UUID (wird auf Anfrage von Gandalan ausgegeben)
-- Kontakt für Zugangsdaten/App-Token: dev-support@gandalan.de
-- IDAS/Auth-Base-URL vorzugsweise aus `fetchEnvConfig(...)` (z. B. `envConfig.idas`)
-- Falls die URL manuell gesetzt wird: mit abschließendem Slash (z. B. `https://api.dev.idas-cloudservices.net/api/`)
+- Browser-Umgebung
+- Gueltiger App-Token im UUID-Format
+- Zugangsdaten/App-Token ueber dev-support@gandalan.de
+- IDAS-Basis-URL vorzugsweise aus `fetchEnvConfig(...)`
 
 ### Installation
 ```bash
 npm i @gandalan/weblibs
 ```
 
-### Schnellstart (Fluent API + Auth)
+### Schnellstart
 ```js
-import { fetchEnvConfig, fluentApi, fluentIdasAuthManager } from '@gandalan/weblibs';
-
-async function initializeAuthAndApi() {
-    const serviceName = 'myService';
-    const appToken = '00000000-0000-0000-0000-000000000000'; // UUID
-    const envConfig = await fetchEnvConfig('dev'); // envConfig.idas kommt aus fetchEnvConfig(...)
+import {
+    fetchEnvConfig,
+    fluentApi,
+    fluentIdasAuthManager,
+    idasFluentApi
+} from "@gandalan/weblibs";
+
+async function initializeApis() {
+    const appToken = "00000000-0000-0000-0000-000000000000";
+    const serviceName = "myService";
+    const envConfig = await fetchEnvConfig("dev");
 
     let authManager;
-    try {
-        authManager = await fluentIdasAuthManager(appToken, envConfig.idas).init();
-    } catch {
-        // init() kann auf Login umleiten und dabei eine Exception werfen.
-        // In diesem Fall Seite verlassen / später erneut starten.
-        return;
-    }
-
-    const idas = fluentApi(envConfig.idas, authManager, serviceName);
-    const api = fluentApi('/api/', authManager, serviceName);
-
-    const mandanten = await idas.get('mandanten');
-    console.log(mandanten[0]?.Name);
-
-    const localResult = await api.get('some-endpoint');
-    console.log(localResult);
-}
-```
-
-### Exportierte APIs (Kurzüberblick)
-- `fetchEnvConfig(env)` lädt Endpunktkonfiguration (z. B. `dev`, `staging`, `produktiv`)
-- `fluentIdasAuthManager(appToken, authBaseUrl)` erzeugt Auth-Manager
-- `fluentApi(baseUrl, authManager, serviceName)` erzeugt API-Client mit `get/put/post/delete`
-- `createAuthManager()`, `createApi()`, `restClient()` für manuelle Konfiguration
-- Legacy zusätzlich vorhanden: `initIDAS`, `IDASFactory`, `RESTClient`
-
-### Wichtige Hinweise
-- `init()` gibt nicht immer nur `null` zurück, sondern kann beim Redirect eine Exception auslösen.
-- Refresh-Token wird aus URL-Parameter `t` gelesen und in `localStorage` (`idas-refresh-token`) persistiert.
-- Ohne gültigen Auth-Status werden Requests ggf. intern per `ensureAuthenticated()` nachgezogen.
-
----
-
-## English
 
-### Purpose
-`@gandalan/weblibs` provides helpers for authentication and API communication with IDAS as well as local API calls.
-
-### Reference
-- IDAS API (Swagger): https://api.dev.idas-cloudservices.net/swagger/
-
-### Requirements
-- Browser environment (uses `window`, `localStorage`, URL redirects, and `fetch`)
-- Valid app token in UUID format (issued by Gandalan on request)
-- Contact for credentials/app token: dev-support@gandalan.de
-- Prefer the IDAS/auth base URL from `fetchEnvConfig(...)` (for example `envConfig.idas`)
-- If the URL is set manually, use a trailing slash (for example `https://api.dev.idas-cloudservices.net/api/`)
-
-### Installation
-```bash
-npm i @gandalan/weblibs
-```
-
-### Quick start (Fluent API + auth)
-```js
-import { fetchEnvConfig, fluentApi, fluentIdasAuthManager } from '@gandalan/weblibs';
-
-async function initializeAuthAndApi() {
-    const serviceName = 'myService';
-    const appToken = '00000000-0000-0000-0000-000000000000'; // UUID
-    const envConfig = await fetchEnvConfig('dev'); // envConfig.idas is provided by fetchEnvConfig(...)
-
-    let authManager;
     try {
         authManager = await fluentIdasAuthManager(appToken, envConfig.idas).init();
     } catch {
-        // init() may redirect to login and throw while doing so.
-        return;
+        return null;
     }
 
-    const idas = fluentApi(envConfig.idas, authManager, serviceName);
-    const api = fluentApi('/api/', authManager, serviceName);
-
-    const mandanten = await idas.get('mandanten');
-    console.log(mandanten[0]?.Name);
+    const idas = idasFluentApi(envConfig.idas, authManager, serviceName);
+    const api = fluentApi("/api/", authManager, serviceName);
 
-    const localResult = await api.get('some-endpoint');
-    console.log(localResult);
+    return { idas, api, authManager };
 }
 ```
 
-### Exported APIs (short overview)
-- `fetchEnvConfig(env)` loads endpoint configuration (for example `dev`, `staging`, `produktiv`)
-- `fluentIdasAuthManager(appToken, authBaseUrl)` creates an auth manager
-- `fluentApi(baseUrl, authManager, serviceName)` creates an API client with `get/put/post/delete`
-- `createAuthManager()`, `createApi()`, `restClient()` for manual composition
-- Legacy exports still available: `initIDAS`, `IDASFactory`, `RESTClient`
+### `init()`
+- Liest Refresh-Token zuerst aus der URL, danach aus `localStorage`
+- Versucht bei vorhandenem Refresh-Token ein JWT zu erneuern
+- Kann bei fehlender gueltiger Session auf Login umleiten und dabei werfen
 
-### Important notes
-- `init()` does not only return `null`; it may throw during login redirect.
-- Refresh token can be read from URL parameter `t` and is stored in `localStorage` (`idas-refresh-token`).
-- Without valid auth state, requests may trigger `ensureAuthenticated()` internally.
+### Wichtige Exporte
+- `fetchEnvConfig(env)`
+- `fluentIdasAuthManager(appToken, authBaseUrl)`
+- `fluentApi(baseUrl, authManager, serviceName)`
+- `idasFluentApi(baseUrl, authManager, serviceName)`
+
+### Wichtige Hinweise
+- `idasFluentApi(...)` fuer IDAS-Business-Routinen verwenden
+- `fluentApi(...)` fuer generische REST-Endpunkte verwenden
+- `authManager.userInfo` und `idas.userInfo` enthalten dekodierte JWT-Claims
+- Fuer JSDoc- und DTO-Typing-Regeln siehe [JSDOC.md](./JSDOC.md)

package/api/IDAS.js

@@ -2,6 +2,8 @@ import { isInvalid, currentToken} from "./authUtils";
 import { RESTClient } from "./RESTClient";
 import { jwtDecode } from "jwt-decode";
 
+/** @typedef {import("jwt-decode").JwtPayload & import("./fluentAuthManager.js").JwtUserInfo & { id?: string }} DecodedToken */
+
 export function IDASFactory(settings)
 {
     if (!isInvalid(settings))
@@ -37,7 +39,7 @@ class IDAS
                 return [];
             }
 
-            const decoded = jwtDecode(currentToken);
+            const decoded = /** @type {DecodedToken} */ (jwtDecode(currentToken));
             if (!decoded.rights)
             {
                 return [];
@@ -52,7 +54,7 @@ class IDAS
                 return [];
             }
 
-            const decoded = jwtDecode(currentToken);
+            const decoded = /** @type {DecodedToken} */ (jwtDecode(currentToken));
             if (!decoded.role)
             {
                 return [];
@@ -75,7 +77,7 @@ class IDAS
                 return undefined;
             }
 
-            const decoded = jwtDecode(currentToken);
+            const decoded = /** @type {DecodedToken} */ (jwtDecode(currentToken));
             return decoded.id;
         },
     };

package/api/authUtils.js

@@ -29,7 +29,7 @@ export let currentRefreshToken = undefined;
  * @export
  * @async
  * @param {string} appToken, UUID v4 format
- * @returns {Settings} settings object
+ * @returns {Promise<Settings|null>} settings object
  */
 export async function initIDAS(appToken)
 {
@@ -247,5 +247,5 @@ export function redirectToLogin(settings, authPath)
     url.search = `?a=${settings.appToken}&r=${encodeURIComponent(authUrlCallback)}`;
     let jwtUrl = url.toString();
 
-    window.location = jwtUrl;
+    window.location.href = jwtUrl;
 }

package/api/business/anpassungApi.js

@@ -1,7 +1,7 @@
 /**
  * @typedef {import('../fluentApi.js').FluentApi} FluentApi
- * @typedef {import('../dtos/index.js').AnpassungDTO} AnpassungDTO
- * @typedef {import('../dtos/index.js').AnpassungVorlageDTO} AnpassungVorlageDTO
+ * @typedef {Object & { AnpassungGuid?: string, anpassungGuid?: string }} AnpassungDTO
+ * @typedef {Object & { AnpassungVorlageGuid?: string, anpassungVorlageGuid?: string }} AnpassungVorlageDTO
  */
 
 /**
@@ -22,7 +22,7 @@ export function createAnpassungApi(fluentApi) {
          * @param {AnpassungDTO} dto
          * @returns {Promise<void>}
          */
-        save: (dto) => fluentApi.put(`Anpassungen/${dto.anpassungGuid}`, dto),
+        save: (dto) => fluentApi.put(`Anpassungen/${dto.AnpassungGuid ?? dto.anpassungGuid ?? ""}`, dto),
 
         /**
          * Delete adjustment
@@ -57,7 +57,7 @@ export function createAnpassungApi(fluentApi) {
              * @param {AnpassungVorlageDTO} dto
              * @returns {Promise<void>}
              */
-            save: (dto) => fluentApi.put(`AnpassungVorlagen/${dto.anpassungVorlageGuid}`, dto),
+            save: (dto) => fluentApi.put(`AnpassungVorlagen/${dto.AnpassungVorlageGuid ?? dto.anpassungVorlageGuid ?? ""}`, dto),
 
             /**
              * Delete adjustment template

package/api/business/artikelApi.js

@@ -36,14 +36,14 @@ export function createArtikelApi(fluentApi) {
      * @param {KatalogArtikelDTO} artikel
      * @returns {Promise<KatalogArtikelDTO>}
      */
-        saveArtikel: (artikel) => fluentApi.put(`Artikel/${artikel.katalogArtikelGuid}`, artikel),
+      saveArtikel: (artikel) => fluentApi.put(`Artikel/${artikel.KatalogArtikelGuid}`, artikel),
 
         /**
      * Delete article
      * @param {KatalogArtikelDTO} artikel
      * @returns {Promise<void>}
      */
-        deleteArtikel: (artikel) => fluentApi.delete(`Artikel/${artikel.katalogArtikelGuid}`),
+      deleteArtikel: (artikel) => fluentApi.delete(`Artikel/${artikel.KatalogArtikelGuid}`),
 
         // ArtikelIndiDatenWebRoutinen
         /**
@@ -63,14 +63,14 @@ export function createArtikelApi(fluentApi) {
      * @param {KatalogArtikelIndiDatenDTO} daten
      * @returns {Promise<void>}
      */
-        saveArtikelIndiDaten: (daten) => fluentApi.put(`ArtikelIndiDaten/${daten.katalogArtikelGuid}`, daten),
+      saveArtikelIndiDaten: (daten) => fluentApi.put(`ArtikelIndiDaten/${daten.KatalogArtikelGuid}`, daten),
 
         /**
      * Delete article individual data
      * @param {KatalogArtikelIndiDatenDTO} daten
      * @returns {Promise<void>}
      */
-        deleteArtikelIndiDaten: (daten) => fluentApi.delete(`ArtikelIndiDaten/${daten.katalogArtikelGuid}`),
+      deleteArtikelIndiDaten: (daten) => fluentApi.delete(`ArtikelIndiDaten/${daten.KatalogArtikelGuid}`),
 
         // WarenGruppeWebRoutinen
         /**
@@ -84,7 +84,7 @@ export function createArtikelApi(fluentApi) {
      * @param {WarenGruppeDTO} dto
      * @returns {Promise<void>}
      */
-        saveWarenGruppe: (dto) => fluentApi.put(`WarenGruppe/${dto.warenGruppeGuid}`, dto),
+      saveWarenGruppe: (dto) => fluentApi.put(`WarenGruppe/${dto.WarenGruppeGuid}`, dto),
 
         // ProduktGruppenWebRoutinen
         /**
@@ -101,7 +101,7 @@ export function createArtikelApi(fluentApi) {
      * @returns {Promise<ProduktGruppeDTO>}
      */
         saveProduktGruppe: (produktGruppe) =>
-            fluentApi.put(`ProduktGruppe/${produktGruppe.produktGruppeGuid}`, produktGruppe),
+            fluentApi.put(`ProduktGruppe/${produktGruppe.ProduktGruppeGuid}`, produktGruppe),
 
         // ProduktFamilienWebRoutinen
         /**
@@ -118,7 +118,7 @@ export function createArtikelApi(fluentApi) {
      * @returns {Promise<ProduktFamilieDTO>}
      */
         saveProduktFamilie: (produktFamilie) =>
-            fluentApi.put(`ProduktFamilie/${produktFamilie.produktFamilieGuid}`, produktFamilie),
+            fluentApi.put(`ProduktFamilie/${produktFamilie.ProduktFamilieGuid}`, produktFamilie),
 
         // KomponentenWebRoutinen
         /**
@@ -174,7 +174,7 @@ export function createArtikelApi(fluentApi) {
      * @param {VarianteDTO} variante
      * @returns {Promise<VarianteDTO>}
      */
-        saveVariante: (variante) => fluentApi.put(`Variante/${variante.varianteGuid}`, variante),
+      saveVariante: (variante) => fluentApi.put(`Variante/${variante.VarianteGuid}`, variante),
 
         /**
      * Trigger variant cache web job

package/api/business/avApi.js

@@ -6,8 +6,8 @@
  * @typedef {import('../dtos/produktion.js').ProduktionsDatenDTO} ProduktionsDatenDTO
  * @typedef {import('../dtos/index.js').AVReserviertItemDTO} AVReserviertItemDTO
  * @typedef {import('../dtos/belege.js').CalculationInfoDTO} CalculationInfoDTO
- * @typedef {import('../dtos/produktion.js').AvReportVorgangRequestDto} AvReportVorgangRequestDto
- * @typedef {import('../dtos/produktion.js').AvReportVorgangDto} AvReportVorgangDto
+ * @typedef {Object} AvReportVorgangRequestDto
+ * @typedef {Object} AvReportVorgangDto
  * @typedef {import('../dtos/produktion.js').SaegeDatenHistorieDTO} SaegeDatenHistorieDTO
  * @typedef {import('../dtos/produktion.js').SaegeDatenResultDTO} SaegeDatenResultDTO
  * @typedef {import('../dtos/index.js').MaterialBearbeitungsMethodeDTO} MaterialBearbeitungsMethodeDTO

package/api/business/belegApi.js

@@ -10,7 +10,7 @@
  * @typedef {import('../dtos/belege.js').VorgangHistorienDTO} VorgangHistorienDTO
  * @typedef {import('../dtos/belege.js').BelegHistorienDTO} BelegHistorienDTO
  * @typedef {import('../dtos/belege.js').BelegPositionHistorienDTO} BelegPositionHistorienDTO
- * @typedef {import('../dtos/produktion.js').SerieHistorieDTO} SerieHistorieDTO
+ * @typedef {import('../dtos/av.js').SerieHistorieDTO} SerieHistorieDTO
  * @typedef {import('../dtos/belege.js').VorgangHistorieDTO} VorgangHistorieDTO
  * @typedef {import('../dtos/belege.js').BelegHistorieDTO} BelegHistorieDTO
  * @typedef {import('../dtos/belege.js').BelegPositionHistorieDTO} BelegPositionHistorieDTO

package/api/business/farbeApi.js

@@ -27,7 +27,7 @@ export function createFarbeApi(fluentApi) {
          * @param {FarbeDTO} dto
          * @returns {Promise<void>}
          */
-        saveFarbe: (dto) => fluentApi.put(`Farben/${dto.farbItemGuid}`, dto),
+        saveFarbe: (dto) => fluentApi.put(`Farben/${dto.FarbItemGuid}`, dto),
 
         // OberflaechenWebRoutinen
         /**
@@ -41,7 +41,7 @@ export function createFarbeApi(fluentApi) {
          * @param {OberflaecheDTO} dto
          * @returns {Promise<void>}
          */
-        saveOberflaeche: (dto) => fluentApi.put(`Oberflaeche/${dto.oberflaecheGuid}`, dto),
+        saveOberflaeche: (dto) => fluentApi.put(`Oberflaeche/${dto.OberflaecheGuid}`, dto),
 
         // FarbGruppenWebRoutinen
         /**
@@ -55,7 +55,7 @@ export function createFarbeApi(fluentApi) {
          * @param {FarbGruppeDTO} dto
          * @returns {Promise<void>}
          */
-        saveFarbGruppe: (dto) => fluentApi.put(`FarbGruppen/${dto.farbItemGroupGuid}`, dto),
+        saveFarbGruppe: (dto) => fluentApi.put(`FarbGruppen/${dto.FarbItemGroupGuid}`, dto),
 
         // FarbKuerzelWebRoutinen
         /**
@@ -69,7 +69,7 @@ export function createFarbeApi(fluentApi) {
          * @param {FarbKuerzelDTO} dto
          * @returns {Promise<void>}
          */
-        saveFarbKuerzel: (dto) => fluentApi.put(`FarbKuerzel/${dto.farbKuerzelGuid}`, dto),
+        saveFarbKuerzel: (dto) => fluentApi.put(`FarbKuerzel/${dto.FarbKuerzelGuid}`, dto),
 
         // FarbKuerzelGruppenWebRoutinen
         /**
@@ -112,7 +112,7 @@ export function createFarbeApi(fluentApi) {
          * @returns {Promise<void>}
          */
         saveProduzentenFarbGruppe: (dto) =>
-            fluentApi.put(`ProduzentenFarbGruppen/${dto.produzentenFarbGruppeGuid}`, dto),
+            fluentApi.put(`ProduzentenFarbGruppen/${dto.ProduzentenFarbGruppeGuid}`, dto),
 
         /**
          * Delete producer color group

package/api/business/fileApi.js

@@ -1,6 +1,6 @@
 /**
  * @typedef {import('../fluentApi.js').FluentApi} FluentApi
- * @typedef {import('../dtos/index.js').FileInfoDTO} FileInfoDTO
+ * @typedef {Object} FileInfoDTO
  */
 
 /**

package/api/business/index.js

@@ -1,63 +1,61 @@
 // Business Routines API Exports
-// Auto-generated from C# Gandalan.IDAS.WebApi.Client BusinessRoutinen
+// Auto-generated from ./api/business leaf files
+// Do not modify manually - changes will be overwritten
 
-export { createVorgangApi } from "./vorgangApi.js";
-export { createKontaktApi } from "./kontaktApi.js";
-export { createBelegPositionenApi } from "./belegPositionenApi.js";
-export { createMaterialApi } from "./materialApi.js";
-export { createSerienApi } from "./serienApi.js";
-export { createBenutzerApi } from "./benutzerApi.js";
+export { createAblageApi } from "./ablageApi.js";
+export { createAnpassungApi } from "./anpassungApi.js";
 export { createArtikelApi } from "./artikelApi.js";
+export { createAuthApi } from "./authApi.js";
+export { createAvApi } from "./avApi.js";
 export { createBelegApi } from "./belegApi.js";
-export { createProduktionApi } from "./produktionApi.js";
+export { createBelegPositionenApi } from "./belegPositionenApi.js";
+export { createBenutzerApi } from "./benutzerApi.js";
 export { createFakturaApi } from "./fakturaApi.js";
-export { createSettingsApi } from "./settingsApi.js";
-export { createUiApi } from "./uiApi.js";
-export { createUtilityApi } from "./utilityApi.js";
-
-// New API exports
-export { createAblageApi } from "./ablageApi.js";
-export { createAvApi } from "./avApi.js";
 export { createFarbeApi } from "./farbeApi.js";
+export { createFileApi } from "./fileApi.js";
+export { createHistorieApi } from "./historieApi.js";
+export { createKontaktApi } from "./kontaktApi.js";
 export { createLagerApi } from "./lagerApi.js";
 export { createLieferungApi } from "./lieferungApi.js";
+export { createMailApi } from "./mailApi.js";
 export { createMandantApi } from "./mandantApi.js";
+export { createMaterialApi } from "./materialApi.js";
 export { createPrintApi } from "./printApi.js";
-export { createHistorieApi } from "./historieApi.js";
-export { createSystemApi } from "./systemApi.js";
-export { createFileApi } from "./fileApi.js";
-export { createMailApi } from "./mailApi.js";
-export { createAnpassungApi } from "./anpassungApi.js";
-export { createAuthApi } from "./authApi.js";
+export { createProduktionApi } from "./produktionApi.js";
 export { createRechnungApi } from "./rechnungApi.js";
+export { createSerienApi } from "./serienApi.js";
+export { createSettingsApi } from "./settingsApi.js";
+export { createSystemApi } from "./systemApi.js";
+export { createUiApi } from "./uiApi.js";
+export { createUtilityApi } from "./utilityApi.js";
+export { createVorgangApi } from "./vorgangApi.js";
 
 // Type exports for JSDoc
-/** @typedef {import('./vorgangApi.js').VorgangApi} VorgangApi */
-/** @typedef {import('./kontaktApi.js').KontaktApi} KontaktApi */
-/** @typedef {import('./belegPositionenApi.js').BelegPositionenApi} BelegPositionenApi */
-/** @typedef {import('./materialApi.js').MaterialApi} MaterialApi */
-/** @typedef {import('./serienApi.js').SerienApi} SerienApi */
-/** @typedef {import('./benutzerApi.js').BenutzerApi} BenutzerApi */
-/** @typedef {import('./artikelApi.js').ArtikelApi} ArtikelApi */
-/** @typedef {import('./belegApi.js').BelegApi} BelegApi */
-/** @typedef {import('./produktionApi.js').ProduktionApi} ProduktionApi */
-/** @typedef {import('./fakturaApi.js').FakturaApi} FakturaApi */
-/** @typedef {import('./settingsApi.js').SettingsApi} SettingsApi */
-/** @typedef {import('./uiApi.js').UiApi} UiApi */
-/** @typedef {import('./utilityApi.js').UtilityApi} UtilityApi */
-/** @typedef {import('./ablageApi.js').AblageApi} AblageApi */
-/** @typedef {import('./avApi.js').AvApi} AvApi */
-/** @typedef {import('./farbeApi.js').FarbeApi} FarbeApi */
-/** @typedef {import('./lagerApi.js').LagerApi} LagerApi */
-/** @typedef {import('./lieferungApi.js').LieferungApi} LieferungApi */
-/** @typedef {import('./mandantApi.js').MandantApi} MandantApi */
-/** @typedef {import('./printApi.js').PrintApi} PrintApi */
-/** @typedef {import('./historieApi.js').HistorieApi} HistorieApi */
-/** @typedef {import('./systemApi.js').SystemApi} SystemApi */
-/** @typedef {import('./fileApi.js').FileApi} FileApi */
-/** @typedef {import('./mailApi.js').MailApi} MailApi */
-/** @typedef {import('./anpassungApi.js').AnpassungApi} AnpassungApi */
-/** @typedef {import('./authApi.js').AuthApi} AuthApi */
-/** @typedef {import('./rechnungApi.js').RechnungApi} RechnungApi */
+/** @typedef {import("./ablageApi.js").AblageApi} AblageApi */
+/** @typedef {import("./anpassungApi.js").AnpassungApi} AnpassungApi */
+/** @typedef {import("./artikelApi.js").ArtikelApi} ArtikelApi */
+/** @typedef {import("./authApi.js").AuthApi} AuthApi */
+/** @typedef {import("./avApi.js").AvApi} AvApi */
+/** @typedef {import("./belegApi.js").BelegApi} BelegApi */
+/** @typedef {import("./belegPositionenApi.js").BelegPositionenApi} BelegPositionenApi */
+/** @typedef {import("./benutzerApi.js").BenutzerApi} BenutzerApi */
+/** @typedef {import("./fakturaApi.js").FakturaApi} FakturaApi */
+/** @typedef {import("./farbeApi.js").FarbeApi} FarbeApi */
+/** @typedef {import("./fileApi.js").FileApi} FileApi */
+/** @typedef {import("./historieApi.js").HistorieApi} HistorieApi */
+/** @typedef {import("./kontaktApi.js").KontaktApi} KontaktApi */
+/** @typedef {import("./lagerApi.js").LagerApi} LagerApi */
+/** @typedef {import("./lieferungApi.js").LieferungApi} LieferungApi */
+/** @typedef {import("./mailApi.js").MailApi} MailApi */
+/** @typedef {import("./mandantApi.js").MandantApi} MandantApi */
+/** @typedef {import("./materialApi.js").MaterialApi} MaterialApi */
+/** @typedef {import("./printApi.js").PrintApi} PrintApi */
+/** @typedef {import("./produktionApi.js").ProduktionApi} ProduktionApi */
+/** @typedef {import("./rechnungApi.js").RechnungApi} RechnungApi */
+/** @typedef {import("./serienApi.js").SerienApi} SerienApi */
+/** @typedef {import("./settingsApi.js").SettingsApi} SettingsApi */
+/** @typedef {import("./systemApi.js").SystemApi} SystemApi */
+/** @typedef {import("./uiApi.js").UiApi} UiApi */
+/** @typedef {import("./utilityApi.js").UtilityApi} UtilityApi */
+/** @typedef {import("./vorgangApi.js").VorgangApi} VorgangApi */
 
-export {};

package/api/business/mandantApi.js

@@ -1,6 +1,6 @@
 /**
  * @typedef {import('../fluentApi.js').FluentApi} FluentApi
- * @typedef {import('../dtos/settings.js').MandantDTO} MandantDTO
+ * @typedef {import('../dtos/mandanten.js').MandantDTO} MandantDTO
  * @typedef {import('../dtos/index.js').BenutzerDTO} BenutzerDTO
  * @typedef {import('../dtos/index.js').AppActivationStatusDTO} AppActivationStatusDTO
  */
@@ -15,7 +15,7 @@ export function createMandantApi(fluentApi) {
         /**
          * Sync mandanten list
          * @param {MandantDTO[]} list
-         * @returns {Promise<void>}
+         * @returns {Promise<MandantDTO[]>}
          */
         abgleichen: (list) =>
             Promise.all(list.map(m => fluentApi.put("Mandanten", m))),
@@ -119,7 +119,7 @@ export function createMandantApi(fluentApi) {
              * @returns {Promise<void>}
              */
             deleteBenutzer: (kundeGuid, data) =>
-                fluentApi.delete(`AppBenutzer/?kundeGuid=${kundeGuid}&benutzerGuid=${data.benutzerGuid}`),
+                fluentApi.delete(`AppBenutzer/?kundeGuid=${kundeGuid}&benutzerGuid=${data.BenutzerGuid}`),
 
             /**
              * Activate mandant

package/api/business/materialApi.js

@@ -23,7 +23,10 @@
  * @returns {MaterialApi}
  */
 export function createMaterialApi(fluentApi) {
-    const api = fluentApi.withBaseUrl("ModellDaten");
+    const api = {
+        get: (url) => fluentApi.get(`ModellDaten/${url}`),
+        put: (url, payload) => fluentApi.put(`ModellDaten/${url}`, payload)
+    };
 
     return {
         async getAll() {

package/api/business/settingsApi.js

@@ -81,7 +81,7 @@ export function createSettingsApi(fluentApi) {
      * @param {WerteListeDTO} dto
      * @returns {Promise<void>}
      */
-        saveWerteliste: (dto) => fluentApi.put(`WerteListe/${dto.werteListeGuid}`, dto),
+      saveWerteliste: (dto) => fluentApi.put(`WerteListe/${dto.WerteListeGuid}`, dto),
 
         // ContractWebRoutinen
         /**
@@ -102,7 +102,7 @@ export function createSettingsApi(fluentApi) {
      * @param {ContractDTO} dto
      * @returns {Promise<void>}
      */
-        deleteContract: (dto) => fluentApi.delete(`Contracts/${dto.contractGuid}`),
+      deleteContract: (dto) => fluentApi.delete(`Contracts/${dto.ContractGuid}`, dto),
 
         // TemplateWebRoutinen
         /**
@@ -123,7 +123,7 @@ export function createSettingsApi(fluentApi) {
      * @param {TemplateDTO} dto
      * @returns {Promise<void>}
      */
-        saveTemplate: (dto) => fluentApi.put(`Template/${dto.templateGuid}`, dto),
+      saveTemplate: (dto) => fluentApi.put(`Template/${dto.TemplateGuid}`, dto),
 
         /**
      * Delete template

package/api/business/systemApi.js

@@ -3,7 +3,7 @@
  * @typedef {import('../dtos/index.js').ChangeDTO} ChangeDTO
  * @typedef {import('../dtos/index.js').TagInfoDTO} TagInfoDTO
  * @typedef {import('../dtos/index.js').TagVorlageDTO} TagVorlageDTO
- * @typedef {import('../dtos/index.js').FilterItemDTO} FilterItemDTO
+ * @typedef {Object} FilterItemDTO
  * @typedef {import('../dtos/index.js').ChangeInfoDTO} ChangeInfoDTO
  * @typedef {import('../dtos/index.js').UpdateInfoDTO} UpdateInfoDTO
  */