saveDevice method

Future<PosDeviceSettings> saveDevice(
  1. Map<String, dynamic> patch
)

Einstellungen dieses Geräts schreiben (Recht layout). shortcuts nur als ganze Karte aller bekannten Aktionen (posSettingsChanges liefert sie bei jeder Tastenänderung); sie wird vorab auf Doppelbelegung geprüft.

Implementation

Future<PosDeviceSettings> saveDevice(Map<String, dynamic> patch) async {
  const name = Aufrufe.setMyRegisterDeviceSettings;
  if (deviceId.trim().isEmpty) {
    throw const KasseneckValidationError(name, 'deviceId fehlt', 'request');
  }
  // Die optionale Lade getrennt: `null` heisst hier „Zuordnung entfernen“ und
  // geht hinaus, waehrend `_pruefeTeil` Nullwerte als „nicht geaendert“ faellt.
  final mitLade = patch.containsKey('drawerId');
  final lade = patch['drawerId'];
  if (mitLade && lade != null && !isPosOptionalId(lade)) {
    throw const KasseneckValidationError(
        name, 'device.drawerId: keine Kennung (1-64 Zeichen aus A-Z a-z 0-9 _ -, oder null zum Entfernen)', 'request');
  }
  // Die optionalen Schalter (`printerHint`): nur Wahrheitswert, `null` ist hier ein Fehler (wie im npm-Paket).
  final schalter = <String, Object?>{
    for (final k in posDeviceOptionalSwitches)
      if (patch.containsKey(k)) k: patch[k],
  };
  for (final e in schalter.entries) {
    if (e.value is! bool) {
      throw KasseneckValidationError(name, 'device.${e.key}: true oder false erwartet', 'request');
    }
  }
  final rest = {...patch}..removeWhere((k, _) => k == 'drawerId' || schalter.containsKey(k));
  final gesendet = rest.isEmpty && (mitLade || schalter.isNotEmpty)
      ? <String, dynamic>{}
      : _pruefeTeil(name, 'device', rest, const PosDeviceSettings().toJson(), posDeviceValues,
          wahlfelder: posDeviceOptionalChoices);
  gesendet.addAll(schalter);
  if (mitLade) gesendet['drawerId'] = lade;
  if (gesendet.containsKey('shortcuts')) {
    final karte = gesendet['shortcuts'];
    if (karte is! Map) {
      throw const KasseneckValidationError(name, 'device.shortcuts: keine Tastenkarte', 'request');
    }
    final tasten = <String, Object?>{};
    for (final e in karte.entries) {
      if (e.value == null) continue;
      final aktion = e.key.toString();
      if (!posShortcutActions.contains(aktion)) {
        throw KasseneckValidationError(name, 'device.shortcuts.$aktion: unbekannte Aktion', 'request');
      }
      tasten[aktion] = e.value;
    }
    // Nur die ganze Karte: der Server prüft Doppelbelegungen nur in der
    // gesendeten Karte, eine halbe (`{cash: ['Mod+K']}`) ließe eine
    // Doppelbelegung mit einer gespeicherten Taste durch.
    final fehlt = posShortcutActions.where((a) => !tasten.containsKey(a)).toList();
    if (fehlt.isNotEmpty) {
      throw KasseneckValidationError(
          name,
          'device.shortcuts: ganze Karte senden (posSettingsChanges), es fehlen ${fehlt.join(', ')}',
          'request');
    }
    // Doppelbelegung in der ganzen Karte, also in der ganzen Belegung.
    final konflikt = posShortcutConflict(tasten);
    if (konflikt != null) {
      throw KasseneckValidationError(
          name,
          'device.shortcuts.${konflikt.action}: Taste ${konflikt.key} schon belegt (${konflikt.heldBy})',
          'request');
    }
    gesendet['shortcuts'] = tasten;
  }
  final daten = await transport.call(name, params: {'deviceId': deviceId, 'device': gesendet});
  return PosDeviceSettings.fromJson(_stand(name, daten, 'device'));
}