@kreiseck/kasseneck-api 1.34.0 → 1.35.1

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 (36) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/README.md +11 -1
  3. package/dist/cjs/payments/hobex-hps/connect-client.d.ts +43 -1
  4. package/dist/cjs/payments/hobex-hps/connect-client.js +51 -1
  5. package/dist/cjs/payments/hobex-hps/outcome.d.ts +4 -3
  6. package/dist/cjs/payments/hobex-hps/payments.d.ts +85 -35
  7. package/dist/cjs/payments/hobex-hps/payments.js +137 -53
  8. package/dist/cjs/pos/drucker-katalog.d.ts +148 -0
  9. package/dist/cjs/pos/drucker-katalog.js +260 -0
  10. package/dist/cjs/pos/index.d.ts +1 -0
  11. package/dist/cjs/pos/index.js +8 -3
  12. package/dist/cjs/receipt/layout.js +1 -1
  13. package/dist/cjs/version.d.ts +1 -1
  14. package/dist/cjs/version.js +1 -1
  15. package/dist/esm/payments/hobex-hps/connect-client.d.ts +43 -1
  16. package/dist/esm/payments/hobex-hps/connect-client.js +50 -1
  17. package/dist/esm/payments/hobex-hps/outcome.d.ts +4 -3
  18. package/dist/esm/payments/hobex-hps/payments.d.ts +85 -35
  19. package/dist/esm/payments/hobex-hps/payments.js +138 -54
  20. package/dist/esm/pos/drucker-katalog.d.ts +148 -0
  21. package/dist/esm/pos/drucker-katalog.js +252 -0
  22. package/dist/esm/pos/index.d.ts +1 -0
  23. package/dist/esm/pos/index.js +3 -0
  24. package/dist/esm/receipt/layout.js +1 -1
  25. package/dist/esm/version.d.ts +1 -1
  26. package/dist/esm/version.js +1 -1
  27. package/fixtures/hobex-hps-cases.json +654 -0
  28. package/fixtures/hobex-hps-codes.json +1 -1
  29. package/fixtures/invoice-api.schema.json +1 -1
  30. package/fixtures/invoice-texts.json +1 -1
  31. package/fixtures/manifest.json +1 -1
  32. package/fixtures/pos-texts.json +1 -1
  33. package/fixtures/printer-catalog.json +1802 -0
  34. package/fixtures/receipts/card-hobex-hps.json +1 -1
  35. package/fixtures/surface.json +1 -1
  36. package/package.json +1 -1
@@ -1,6 +1,6 @@
1
1
  import { HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, HpsPreflightError, } from './errors.js';
2
2
  import { newHpsTransactionId } from './transaction-id.js';
3
- import { hpsCodeInfo, hpsCodeReason, isApproved, isCanceled, isConclusive, isConclusiveAsStatus, isHostUncertain, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, needsReversal, NOT_ABORTABLE_CODE, NOT_FOUND_CODE, TECHNICAL_ERROR_CODE, TRANSACTION_CANCELED_CODE, } from './transaction-response.js';
3
+ import { APPROVED_CODE, hpsCodeInfo, hpsCodeReason, isApproved, isCanceled, isConclusive, isConclusiveAsStatus, isHostUncertain, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, needsReversal, NOT_ABORTABLE_CODE, NOT_FOUND_CODE, TECHNICAL_ERROR_CODE, TRANSACTION_CANCELED_CODE, } from './transaction-response.js';
4
4
  /** Teiler, mit dem das Abbruchbudget aus [HpsPaymentsOptions.resolveBudgetMs] entsteht. */
5
5
  const ABORT_BUDGET_DIVISOR = 6;
6
6
  /**
@@ -8,6 +8,39 @@ const ABORT_BUDGET_DIVISOR = 6;
8
8
  * Vorgabe 30 s. Ein Storno geht ueber den Host und darf Sekunden brauchen.
9
9
  */
10
10
  const REVERSAL_BUDGET_DIVISOR = 3;
11
+ /**
12
+ * Gruende, die ein Storno als NICHT ausgefuehrt ausweisen -- Teil der
13
+ * Positivliste in [stornoAbgewiesen], jeder Eintrag einzeln begruendet:
14
+ * - `cancelDenied` (`9023` "Cancel Denied, TX already cleared", `9222`
15
+ * "Offline Tx Cancellation Denied"): TECS lehnt genau diese Aufhebung ab.
16
+ * - `amountInvalid` (`9003`, `100019` gemessen an Zahlungen, `9012`, `9026`,
17
+ * `13`, `64`, `87`, `3031` dokumentiert): der Vorgang ueber diesen Betrag
18
+ * wird abgewiesen und nicht ausgefuehrt.
19
+ */
20
+ const STORNO_ABGEWIESEN_GRUENDE = new Set(['cancelDenied', 'amountInvalid']);
21
+ /**
22
+ * `true` nur, wenn die Antwort auf das Storno nach einer AUSDRUECKLICHEN
23
+ * Positivliste sagt, dass es nicht ausgefuehrt wurde:
24
+ *
25
+ * - jeder schluessige Code mit `rejectsRequest` -- die Anfrage selbst wurde
26
+ * abgewiesen (Form, TID, Vorgangstyp, Geraetezustand, `100998`/`8014`
27
+ * "beschaeftigt"), bevor etwas geschah. Gemessen ist davon `9002` "Invalid
28
+ * Transaction" auf eine unbekannte Kennung (27.08.2026); die uebrigen stehen
29
+ * so in der Codeliste von hobex bzw. TECS.
30
+ * - jeder Code mit einem Grund aus [STORNO_ABGEWIESEN_GRUENDE].
31
+ *
32
+ * Alles andere kann gewirkt haben, ausdruecklich auch ein Code, der selbst
33
+ * "storniert" oder "aufgehoben" heisst (`8009` "Technical cancellation",
34
+ * `100029`, `3053`-`3063` "Reversed internally", `9032` "reversed
35
+ * automatically", `9011`), ein Abbruch-Code (`100002`, `17`, `8004`), eine
36
+ * Host-Ablehnung (etwa `05`) und jeder unbekannte Code.
37
+ */
38
+ function stornoAbgewiesen(res) {
39
+ const info = hpsCodeInfo(res.responseCode);
40
+ if (info === undefined || !info.conclusive || info.code === APPROVED_CODE)
41
+ return false;
42
+ return info.rejectsRequest || STORNO_ABGEWIESEN_GRUENDE.has(info.reason);
43
+ }
11
44
  export function createHpsPayments(client, target, options = {}) {
12
45
  const resolveBudgetMs = options.resolveBudgetMs ?? 90_000;
13
46
  const maxBackoffMs = options.maxBackoffMs ?? 10_000;
@@ -318,9 +351,10 @@ export function createHpsPayments(client, target, options = {}) {
318
351
  return doubled > maxBackoffMs ? maxBackoffMs : doubled;
319
352
  }
320
353
  /**
321
- * Versucht den Abbruch GENAU EINMAL. Liefert ein Ergebnis nur im einen
322
- * beweisbaren Fall: Connect quittiert den Abbruch mit `responseCode === '0'`.
323
- * In jedem anderen Fall `null` -- der Aufrufer pollt dann weiter.
354
+ * Schickt den Abbruch GENAU EINMAL und haelt im Nachweis fest, was das
355
+ * Terminal darauf sagt. Entscheidet NIE ueber den Ausgang -- auch nicht mit
356
+ * `'0'`, siehe Klassendoku, "Ein quittierter Abbruch ist keine Aussage". Der
357
+ * Aufrufer fragt danach immer den Status ab.
324
358
  */
325
359
  async function tryAbort(id, steps, elapsedMs) {
326
360
  let res;
@@ -335,32 +369,42 @@ export function createHpsPayments(client, target, options = {}) {
335
369
  + 'oder den Abbruch-Endpunkt nicht; beides sagt nichts ueber die Zahlung, Ausgang wird abgefragt'
336
370
  : `Abbruch nicht bestaetigt (${describe(e)}) -- ob er wirkte, ist offen, Ausgang wird abgefragt`);
337
371
  noteUnexpected(e, id);
338
- return null;
372
+ return;
339
373
  }
374
+ steps.push(abbruchQuittung(res));
375
+ }
376
+ /** Nachweistext zur Antwort auf den Abbruch -- keiner davon schliesst auf den Ausgang. */
377
+ function abbruchQuittung(res) {
340
378
  if (res.responseCode === undefined) {
341
- steps.push('Abbruch ohne Ergebniscode quittiert -- das beweist nichts, Ausgang wird abgefragt');
342
- return null;
379
+ return 'Abbruch ohne Ergebniscode quittiert -- das beweist nichts, Ausgang wird abgefragt';
343
380
  }
344
- if (res.responseCode !== '0') {
345
- steps.push(isNotAbortable(res)
346
- ? `Abbruch abgelehnt (${NOT_ABORTABLE_CODE}) -- der Vorgang ist nicht mehr abbrechbar, Ausgang wird abgefragt`
347
- : `Abbruch abgelehnt (${res.responseCode}) -- Grund unbekannt, Ausgang wird abgefragt`);
348
- return null;
381
+ if (isApproved(res)) {
382
+ return `Abbruch angenommen (${APPROVED_CODE}) -- das sagt nicht, ob belastet wurde (am 10.11.2026 `
383
+ + 'endete eine Zahlung nach angenommenem Abbruch genehmigt), Ausgang wird abgefragt';
349
384
  }
350
- steps.push('Abbruch bestaetigt -- der Vorgang war noch abbrechbar, es ist nichts belastet');
351
- emit('resolved', steps[steps.length - 1], id);
352
- return { outcome: 'declined', transactionId: id, response: res, reason: 'aborted', steps: [...steps] };
385
+ if (isNotAbortable(res)) {
386
+ return `Abbruch abgelehnt (${NOT_ABORTABLE_CODE}) -- der Vorgang ist nicht mehr abbrechbar, Ausgang wird abgefragt`;
387
+ }
388
+ return `Abbruch abgelehnt (${res.responseCode}) -- Grund unbekannt, Ausgang wird abgefragt`;
353
389
  }
354
390
  /**
355
391
  * Schickt zu einer Zahlung, deren Host-Antwort ausblieb ([anlass] traegt
356
- * `sendReversal`), GENAU EINMAL ein Storno nach. Ergebnis nur, wenn das
357
- * Terminal es mit `'0'` quittiert; sonst `null`. Ohne [amountCents]
358
- * (Gutschrift) wird nichts gesendet.
392
+ * `sendReversal`), GENAU EINMAL ein Storno ueber [amountCents] nach
393
+ * (Betrag samt Trinkgeld) und haelt im Nachweis fest, was das Terminal
394
+ * darauf sagt. Entscheidet NIE ueber den Ausgang, siehe Klassendoku,
395
+ * "Storno nach ausbleibender Host-Antwort".
396
+ *
397
+ * Liefert, was das Storno bewirkt haben kann ([StornoAusgang]).
398
+ * `nichtGesendet` bei einem [HpsPreflightError]: Connect hat es vor jedem
399
+ * Terminal-Kontakt abgewiesen, beweisbar ist nichts hinausgegangen (siehe
400
+ * `errors.ts`). `abgewiesen` bei HTTP 409: das Terminal nimmt waehrend
401
+ * eines anderen Vorgangs keine Anfrage an (gemessen, ohne Spur; dieselbe
402
+ * Lesart wie fuer die erzeugende Anfrage in [fromTerminalBusy]).
359
403
  */
360
404
  async function sendReversal(id, steps, elapsedMs, amountCents, anlass) {
361
405
  if (amountCents === undefined) {
362
406
  steps.push('Kein Storno nachgeschickt -- die Aufhebung einer Gutschrift laesst TECS nicht zu');
363
- return null;
407
+ return 'nichtGesendet';
364
408
  }
365
409
  emit('resolving', `Storno wird nachgeschickt (${anlass.responseCode})`, id);
366
410
  let res;
@@ -368,19 +412,33 @@ export function createHpsPayments(client, target, options = {}) {
368
412
  res = await withinBudget(elapsedMs, () => client.cancel({ ...target, transactionId: id, amountCents }), reversalBudgetMs);
369
413
  }
370
414
  catch (e) {
415
+ if (e instanceof HpsPreflightError) {
416
+ steps.push(`Storno nicht gesendet (${describe(e)}) -- Kasseneck Connect hat es vor dem Terminal abgewiesen, `
417
+ + 'es kann nicht gewirkt haben, Ausgang wird abgefragt');
418
+ return 'nichtGesendet';
419
+ }
420
+ if (e instanceof HpsConnectTerminalError && e.isTerminalBusy) {
421
+ steps.push('Storno nicht angenommen (HTTP 409) -- das Terminal war beschaeftigt, es kann nicht gewirkt haben, '
422
+ + 'Ausgang wird abgefragt');
423
+ return 'abgewiesen';
424
+ }
371
425
  steps.push(`Storno nachgeschickt, aber nicht bestaetigt (${describe(e)}) -- ob es wirkte, ist offen, Ausgang wird abgefragt`);
372
426
  noteUnexpected(e, id);
373
- return null;
427
+ return 'kannGewirkt';
374
428
  }
375
- if (!isApproved(res)) {
376
- const titel = hpsCodeInfo(res.responseCode)?.title;
377
- steps.push(`Storno nachgeschickt, nicht bestaetigt (${res.responseCode ?? 'ohne Ergebniscode'}`
378
- + `${titel === undefined ? '' : ` "${titel}"`}) -- Ausgang wird abgefragt`);
379
- return null;
429
+ if (isApproved(res)) {
430
+ steps.push(`Storno nachgeschickt und quittiert (${APPROVED_CODE}) -- das allein beweist nicht, dass die Zahlung `
431
+ + 'aufgehoben ist, Ausgang wird abgefragt');
432
+ return 'kannGewirkt';
380
433
  }
381
- steps.push('Storno nachgeschickt und bestaetigt -- die Zahlung ist aufgehoben, es ist nichts belastet');
382
- emit('resolved', steps[steps.length - 1], id);
383
- return { outcome: 'declined', transactionId: id, response: res, reason: 'voidedAfterHostFault', steps: [...steps] };
434
+ const titel = hpsCodeInfo(res.responseCode)?.title;
435
+ const code = `${res.responseCode ?? 'ohne Ergebniscode'}${titel === undefined ? '' : ` "${titel}"`}`;
436
+ if (stornoAbgewiesen(res)) {
437
+ steps.push(`Storno abgewiesen (${code}) -- es wurde nicht ausgefuehrt, Ausgang wird abgefragt`);
438
+ return 'abgewiesen';
439
+ }
440
+ steps.push(`Storno nachgeschickt, nicht bestaetigt (${code}) -- ob es wirkte, ist offen, Ausgang wird abgefragt`);
441
+ return 'kannGewirkt';
384
442
  }
385
443
  /**
386
444
  * Klaert einen offenen Ausgang: erst abbrechen, dann abfragen -- bis das
@@ -393,6 +451,10 @@ export function createHpsPayments(client, target, options = {}) {
393
451
  * [ausGeschlossenerAntwort]. Meldet sie eine Stoerung beim Host
394
452
  * ([isHostUncertain]), bekommt `9027` diesen Aussagewert gerade NICHT --
395
453
  * siehe Klassendoku, "Stoerung beim Host".
454
+ *
455
+ * [stornoCents] ist, was ein nachgeschicktes Storno aufheben muss: Betrag
456
+ * samt Trinkgeld der Zahlung. Nur [pay] setzt ihn; ohne ihn wird kein
457
+ * Storno gesendet.
396
458
  */
397
459
  async function resolve(id, steps, antwort, stornoCents) {
398
460
  emit('resolving', 'Ausgang offen, Klaerung laeuft', id);
@@ -403,25 +465,26 @@ export function createHpsPayments(client, target, options = {}) {
403
465
  // Statusabfrage sie nennt und danach 9027 kommt.
404
466
  let stoerungsAntwort = antwort && isHostUncertain(antwort) ? antwort : undefined;
405
467
  let letzteAntwort = antwort;
406
- // Das Storno wird hoechstens einmal erwogen; gesendet ist es nur mit Betrag.
468
+ // Das Storno wird hoechstens einmal erwogen; versucht wird es nur mit
469
+ // Betrag, also nur fuer eine Zahlung.
407
470
  let stornoErwogen = false;
408
- let stornoGesendet = false;
471
+ let stornoVersucht = false;
472
+ // Was das Storno bewirkt haben kann; `kannGewirkt` nimmt auch einer
473
+ // Genehmigung in der Statusabfrage die Aussage.
474
+ let storno;
409
475
  if (stoerungsAntwort === undefined) {
410
- const aborted = await tryAbort(id, steps, elapsedMs);
411
- if (aborted)
412
- return aborted;
476
+ // Entscheidet nichts, beendet nur einen noch wartenden Kartenfluss.
477
+ await tryAbort(id, steps, elapsedMs);
413
478
  }
414
479
  else {
415
480
  // Der Vorgang ist am Terminal schon beendet -- mit einer Stoerung beim
416
- // Host. Ein quittierter Abbruch bewiese nur, dass am Terminal nichts mehr
417
- // laeuft, nicht, dass der Host nichts belastet hat.
481
+ // Host. Es gibt nichts mehr abzubrechen, und eine Quittung saehe
482
+ // ohnehin nur das Terminal, nicht den Host.
418
483
  steps.push('Kein Abbruchversuch -- das Terminal hat den Vorgang mit einer Stoerung beim hobex-Host beendet');
419
484
  if (needsReversal(stoerungsAntwort)) {
420
485
  stornoErwogen = true;
421
- stornoGesendet = stornoCents !== undefined;
422
- const storniert = await sendReversal(id, steps, elapsedMs, stornoCents, stoerungsAntwort);
423
- if (storniert)
424
- return storniert;
486
+ stornoVersucht = stornoCents !== undefined;
487
+ storno = await sendReversal(id, steps, elapsedMs, stornoCents, stoerungsAntwort);
425
488
  }
426
489
  }
427
490
  let wait = 0;
@@ -457,30 +520,46 @@ export function createHpsPayments(client, target, options = {}) {
457
520
  if (isHostUncertain(status))
458
521
  stoerungsAntwort ??= status;
459
522
  const hostUngewiss = stoerungsAntwort !== undefined;
460
- if (stornoGesendet && isCanceled(status)) {
461
- steps.push(`Status: Zahlung aufgehoben (${TRANSACTION_CANCELED_CODE}) -- das nachgeschickte Storno hat gegriffen, `
462
- + 'es ist nichts belastet');
523
+ if (stornoVersucht && isCanceled(status)) {
524
+ // Aufgehoben ist aufgehoben. Wer es war, behauptet der Nachweis nur so
525
+ // weit, wie es feststeht: hat das Storno nachweislich nicht gewirkt,
526
+ // war es ein anderer Vorgang, und der Grund ist `canceled`.
527
+ const durchsStorno = storno === 'kannGewirkt';
528
+ steps.push(durchsStorno
529
+ ? `Status: Zahlung aufgehoben (${TRANSACTION_CANCELED_CODE}) nach dem nachgeschickten Storno -- `
530
+ + 'es ist nichts belastet'
531
+ : `Status: Zahlung aufgehoben (${TRANSACTION_CANCELED_CODE}), obwohl das nachgeschickte Storno nicht `
532
+ + 'ausgefuehrt wurde -- es ist nichts belastet');
463
533
  emit('resolved', steps[steps.length - 1], id);
464
- return { outcome: 'declined', transactionId: id, response: status, reason: 'voidedAfterHostFault', steps: [...steps] };
534
+ return {
535
+ outcome: 'declined',
536
+ transactionId: id,
537
+ response: status,
538
+ reason: durchsStorno ? 'voidedAfterHostFault' : 'canceled',
539
+ steps: [...steps],
540
+ };
465
541
  }
466
542
  if (!stornoErwogen && needsReversal(status)) {
467
543
  // Die Zahlung selbst kam ohne Antwort zurueck, erst die Statusabfrage
468
544
  // nennt die ausgebliebene Host-Antwort -- dasselbe Storno wie oben.
469
545
  steps.push(statusOhneErgebnis(status));
470
546
  stornoErwogen = true;
471
- stornoGesendet = stornoCents !== undefined;
472
- const storniert = await sendReversal(id, steps, elapsedMs, stornoCents, status);
473
- if (storniert)
474
- return storniert;
547
+ stornoVersucht = stornoCents !== undefined;
548
+ storno = await sendReversal(id, steps, elapsedMs, stornoCents, status);
475
549
  wait = nextWait(wait);
476
550
  continue;
477
551
  }
552
+ // Nach einem Storno, das gewirkt haben kann, sagt auch '0' nichts: das
553
+ // Storno kann noch unterwegs sein oder nicht gegriffen haben. Es zaehlt
554
+ // unten als "nichts Neues" -- siehe Klassendoku, "Storno nach
555
+ // ausbleibender Host-Antwort".
556
+ const genehmigtTrotzStorno = storno === 'kannGewirkt' && isApproved(status);
478
557
  // Auf die Statusabfrage entscheidet nur ein Code, der den gesuchten
479
558
  // Vorgang beschreibt -- nicht einer, der diese Abfrage abweist
480
559
  // ([isConclusiveAsStatus]). Nach einer Stoerung beim Host entscheidet nur
481
560
  // noch eine Genehmigung: jede andere Aussage des Terminals betrifft seinen
482
561
  // Speicher, nicht den des Hosts.
483
- if (hostUngewiss ? isApproved(status) : isConclusiveAsStatus(status)) {
562
+ if (!genehmigtTrotzStorno && (hostUngewiss ? isApproved(status) : isConclusiveAsStatus(status))) {
484
563
  const settled = fromResponse(status, id, steps);
485
564
  if (settled)
486
565
  return settled;
@@ -497,9 +576,12 @@ export function createHpsPayments(client, target, options = {}) {
497
576
  ohneAuskunft = 0;
498
577
  }
499
578
  // Nach einer Stoerung ist jede Antwort ausser '0' (die oben schon
500
- // entschieden hat) "nichts Neues".
579
+ // entschieden hat) "nichts Neues" -- nach einem Storno auch '0'.
501
580
  stoerungOhneNeues = hostUngewiss ? stoerungOhneNeues + 1 : 0;
502
- steps.push(statusOhneErgebnis(status) ?? 'Status: noch kein Ergebniscode');
581
+ steps.push(genehmigtTrotzStorno
582
+ ? `Status: Zahlung steht unveraendert (${APPROVED_CODE}) -- das nachgeschickte Storno kann noch `
583
+ + 'unterwegs sein oder nicht gegriffen haben, keine Aussage'
584
+ : statusOhneErgebnis(status) ?? 'Status: noch kein Ergebniscode');
503
585
  if (stoerungOhneNeues >= 2) {
504
586
  // Siehe Klassendoku, "Stoerung beim Host": das Terminal weiss es
505
587
  // nicht, und es wird es auch nicht wissen, wenn wir weiterfragen.
@@ -525,7 +607,7 @@ export function createHpsPayments(client, target, options = {}) {
525
607
  * wurde uns gerade geantwortet. Uebrig bleibt "beendet und nicht genehmigt".
526
608
  *
527
609
  * **Gegenprobe** (28.08.2026, TID 3600335, jeweils nach abgeschlossenem
528
- * Vorgang): genehmigt (Beleg 408811) -> Statusabfrage `0`, dreimal
610
+ * Vorgang): genehmigt -> Statusabfrage `0`, dreimal
529
611
  * wiederholt; abgelehnt mit `100003` -> `9027`, zweimal; abgelehnt mit
530
612
  * `9003` -> `9027`. Eine genehmigte Zahlung antwortet also nicht `9027`.
531
613
  *
@@ -676,7 +758,8 @@ export function createHpsPayments(client, target, options = {}) {
676
758
  return settled;
677
759
  steps.push(offeneAntwort(res));
678
760
  }
679
- return resolve(id, steps, res, paymentOptions.amountCents);
761
+ // Ein Storno hebt auf, was das Terminal belastet hat: Betrag UND Trinkgeld.
762
+ return resolve(id, steps, res, paymentOptions.amountCents + (paymentOptions.tipCents ?? 0));
680
763
  }
681
764
  /**
682
765
  * Gutschrift mit geklaertem Ausgang -- EXAKT derselbe Klaerweg wie [pay]
@@ -718,8 +801,9 @@ export function createHpsPayments(client, target, options = {}) {
718
801
  steps.push(offeneAntwort(res));
719
802
  }
720
803
  // Dieselbe Klaerfunktion wie [pay]: die Kennung ist die des NEUEN
721
- // Vorgangs, eine Statusabfrage darauf liefert also genau dessen Ausgang,
722
- // und der Abbruch ist derselbe Diskriminator wie bei einer Zahlung.
804
+ // Vorgangs, eine Statusabfrage darauf liefert also genau dessen Ausgang.
805
+ // Der Abbruch entscheidet hier so wenig wie bei einer Zahlung, und ohne
806
+ // Betrag schickt die Klaerung kein Storno nach.
723
807
  return resolve(id, steps, res);
724
808
  }
725
809
  /**
@@ -0,0 +1,148 @@
1
+ import { type PosCodePage, type PosPaperSize } from './settings.js';
2
+ /**
3
+ * Schnitt eines Eintrags: nur, was die Kasse unter „Papier abschneiden“ anbietet (Teilschnitt oder keiner). Die
4
+ * Einstellung kennt auch `full`, Bondrucker schneiden aber nie ganz durch; ein Katalogwert, den die Kasse nicht
5
+ * anzeigt, waere fuer den Chef nicht pruefbar.
6
+ */
7
+ export declare const PRINTER_CATALOG_CUTS: readonly ["partial", "none"];
8
+ export type PrinterCatalogCut = typeof PRINTER_CATALOG_CUTS[number];
9
+ /** QR-Weg eines Eintrags. `auto` heisst „noch niemand hat entschieden“ und ist darum keine Aussage ueber ein Modell. */
10
+ export declare const PRINTER_CATALOG_QR_MODES: readonly ["escpos", "raster"];
11
+ export type PrinterCatalogQrMode = typeof PRINTER_CATALOG_QR_MODES[number];
12
+ /** Druck-Werte eines Modells mit den Namen und Werten der Geraete-Einstellungen unter /v3. */
13
+ export interface PrinterCatalogValues {
14
+ /** Werkseinstellung der Papierbreite; welche Breiten das Modell sonst kann, steht in `paperSizes`. */
15
+ readonly paperSize: PosPaperSize;
16
+ /**
17
+ * Zeichen je Zeile bei der Werkseinstellung, im Geraetetest bestaetigt. Keine Einstellung: die Kasse leitet sie aus
18
+ * `paperSize` ab (CHARS_PER_PAPER_SIZE). Der Eintrag haelt fest, dass beides an diesem Drucker zusammenpasst; ein
19
+ * Drucker mit anderer Zeichenzahl braeuchte erst eine neue Einstellung.
20
+ */
21
+ readonly charsPerLine: number;
22
+ readonly cut: PrinterCatalogCut;
23
+ /** Ladenanschluss, der auf den Impuls der Kasse (ESC p 0 25 250) oeffnet. */
24
+ readonly drawerKick: boolean;
25
+ readonly qrMode: PrinterCatalogQrMode;
26
+ readonly codePage: PosCodePage;
27
+ }
28
+ /** Ein Wertfeld eines Eintrags; der Geraetetest nennt, welche am Geraet geprueft sind. */
29
+ export type PrinterCatalogValueField = keyof PrinterCatalogValues;
30
+ /** Alle Wertfelder, in der Reihenfolge von [PrinterCatalogValues]; ein Test haelt sie vollstaendig. */
31
+ export declare const PRINTER_CATALOG_VALUE_FIELDS: readonly ["paperSize", "charsPerLine", "cut", "drawerKick", "qrMode", "codePage"];
32
+ /** Protokoll des Geraetetests, der einen Eintrag freigibt. */
33
+ export interface PrinterDeviceTest {
34
+ /** Tag des Tests, `JJJJ-MM-TT` (Wiener Tag). */
35
+ readonly date: string;
36
+ /** Version von Kasseneck Connect, mit der geprueft wurde. */
37
+ readonly connectVersion: string;
38
+ /** Firmware des geprueften Druckers. */
39
+ readonly firmware: string;
40
+ /** Wer geprueft hat: Kuerzel, kein voller Name (die Datei reist im Paket mit). */
41
+ readonly testedBy: string;
42
+ /**
43
+ * Die am Geraet geprueften Wertfelder (`codePage` heisst: € und Umlaute stehen richtig am Bon). Vollstaendig ist der
44
+ * Test erst mit jedem Feld aus `values`: eine Freigabe soll nichts behaupten, was niemand gesehen hat.
45
+ */
46
+ readonly checked: readonly PrinterCatalogValueField[];
47
+ /** Die Papierbreiten, mit denen am Geraet gedruckt wurde; jede aus `paperSizes` muss dabei sein. */
48
+ readonly checkedPaperSizes: readonly PosPaperSize[];
49
+ }
50
+ /** Freigabe eines Eintrags. Nur `approved: true` wirkt; ohne vollstaendigen Geraetetest gibt es keine Freigabe. */
51
+ export interface PrinterCatalogApproval {
52
+ readonly approved: boolean;
53
+ readonly deviceTest: PrinterDeviceTest | null;
54
+ }
55
+ export interface PrinterCatalogEntry {
56
+ /** Feste Kennung `<hersteller>-<modell>`, klein. */
57
+ readonly id: string;
58
+ readonly manufacturer: string;
59
+ /** Modellname zum Anzeigen, so geschrieben wie vom Hersteller. */
60
+ readonly model: string;
61
+ /** Normierte Modellnamen (aus mDNS und `GS I`), an denen der Eintrag erkannt wird. */
62
+ readonly matchNames: readonly string[];
63
+ /**
64
+ * Die Einstellungen der Papierbreite, die an diesem Modell passen (fuer eine andere Rolle mit Papierfuehrung und
65
+ * Einstellung am Drucker), in der Reihenfolge von PAPER_SIZE. Mehr als eine heisst: die Werkseinstellung in `values`
66
+ * kann am Geraet anders stehen.
67
+ */
68
+ readonly paperSizes: readonly PosPaperSize[];
69
+ /**
70
+ * Zeichen je Zeile, die der Drucker in seiner Werkseinstellung mit Schrift A selbst druckt (Datenblatt). Keine
71
+ * Breite aus `paperSizes` darf mehr Zeichen setzen; ist es mehr als `values.charsPerLine`, nutzt die Kasse bewusst
72
+ * ihr schmaleres Layout, bis es eine Einstellung mit dieser Zeichenzahl gibt.
73
+ */
74
+ readonly nativeCharsPerLine: number;
75
+ readonly values: PrinterCatalogValues;
76
+ readonly approval: PrinterCatalogApproval;
77
+ }
78
+ /** Der Teil der Geraete-Einstellungen, den ein bekanntes Modell beim ersten Einrichten vorschlaegt. */
79
+ export interface PrinterCatalogDeviceSettings {
80
+ readonly paperSize: PosPaperSize;
81
+ readonly codePage: PosCodePage;
82
+ readonly cut: PrinterCatalogCut;
83
+ readonly qrMode: PrinterCatalogQrMode;
84
+ /**
85
+ * Aus `drawerKick`: nur ein Vorschlag fuer das erste Einrichten. Hat der Chef die Lade bewusst ausgeschaltet, bleibt
86
+ * sie aus; die Kasse ueberschreibt eine getroffene Wahl nie.
87
+ */
88
+ readonly drawerEnabled: boolean;
89
+ }
90
+ /** Was ein Eintrag beim Einrichten vorschlaegt. */
91
+ export interface PrinterCatalogSettings {
92
+ /** Unveraendert als Teil der Geraete-Einstellungen sendbar (setMyRegisterDeviceSettings). */
93
+ readonly device: PrinterCatalogDeviceSettings;
94
+ /**
95
+ * Das Modell kann mehr als eine Papierbreite: `device.paperSize` ist dann nur die Werkseinstellung, und die Kasse
96
+ * bestaetigt die Breite beim ersten Einrichten mit einem Testdruck.
97
+ */
98
+ readonly paperSizeNeedsCheck: boolean;
99
+ }
100
+ /**
101
+ * Startbestand laut Spec connect-betrieb (Stufe 1), noch ohne Geraetetest und darum nicht freigegeben. Je Eintrag
102
+ * stehen die Werte ausgeschrieben, auch wo sie gleich sind: jeder ist eine eigene Aussage ueber ein Modell und wird
103
+ * einzeln freigegeben.
104
+ *
105
+ * Papierbreiten laut Epson-Datenblatt: TM-m30III, TM-m30II und TM-T20III lassen sich mit der beiliegenden
106
+ * Papierfuehrung auf 58 mm umstellen (dann 420 Punkte, Schrift A 35 Spalten; die Kasse setzt 32 Zeichen), der TM-m10
107
+ * kann nur 58 mm. Bestaetigt ist das erst mit dem Geraetetest.
108
+ *
109
+ * TM-T88VI und TM-T88VII drucken mit 180 dpi (512 Punkte auf 80 mm, Schrift A 42 Spalten); 48 Zeichen passen nicht.
110
+ * Sie bekommen darum das 58-mm-Layout der Kasse (32 Zeichen, die 384 Punkte von `GS W` passen in ihre 512), auch mit
111
+ * 80-mm-Papier, bis es eine Einstellung mit 42 Zeichen gibt.
112
+ */
113
+ export declare const PRINTER_CATALOG: readonly PrinterCatalogEntry[];
114
+ /**
115
+ * Normierter Modellname, die Hersteller aus `catalog`. `EPSON TM-m30III`, `TM-M30III` und `tm m30iii` ergeben
116
+ * `TM-M30III`; der Hersteller allein (`EPSON`) bleibt stehen.
117
+ */
118
+ export declare function normalizePrinterModel(model: string | null | undefined, catalog?: readonly PrinterCatalogEntry[]): string | null;
119
+ /**
120
+ * Der freigegebene Eintrag aus `catalog`, an dem `model` erkannt wird, sonst `null`. Ein nicht freigegebener Eintrag
121
+ * verhaelt sich wie ein unbekanntes Modell. Das Ergebnis ist eindeutig, weil kein Name in zwei Eintraegen steht
122
+ * (Prueffall `match_name_ambiguous`).
123
+ */
124
+ export declare function findPrinterCatalogEntry(catalog: readonly PrinterCatalogEntry[], model: string | null | undefined): PrinterCatalogEntry | null;
125
+ /**
126
+ * Der freigegebene Katalogeintrag zu einem Modellnamen, wie Connect ihn meldet (mDNS, `GS I`), oder `null` fuer ein
127
+ * unbekanntes Modell. Gross- und Kleinschreibung, ein vorangestelltes `EPSON` und die Art der Trenner zaehlen nicht.
128
+ * `undefined` ist erlaubt, weil Connect `model` im Fund weglaesst, wenn es keines kennt.
129
+ */
130
+ export declare function printerCatalogEntry(model: string | null | undefined): PrinterCatalogEntry | null;
131
+ /** Was ein Eintrag beim Einrichten vorschlaegt; `drawerKick` wird zu `drawerEnabled`. */
132
+ export declare function printerCatalogSettings(entry: PrinterCatalogEntry): PrinterCatalogSettings;
133
+ /**
134
+ * Was an einem Katalog nicht stimmt. Jeder Grund gehoert zu genau einem Feld des Eintrags, darum traegt ein Fund kein
135
+ * eigenes Feld. Reihenfolge = Reihenfolge der Pruefung je Eintrag.
136
+ */
137
+ export declare const PRINTER_CATALOG_PROBLEM_REASONS: readonly ["duplicate_id", "match_names_missing", "match_name_not_normalized", "match_name_ambiguous", "model_not_matched", "paper_sizes_invalid", "paper_size_not_listed", "paper_size_too_wide", "cut_not_allowed", "qr_mode_not_allowed", "chars_per_line_mismatch", "device_test_missing", "device_test_incomplete"];
138
+ export type PrinterCatalogProblemReason = typeof PRINTER_CATALOG_PROBLEM_REASONS[number];
139
+ /** Ein Fund der Pruefung: welcher Eintrag, welcher Grund. */
140
+ export interface PrinterCatalogProblem {
141
+ readonly id: string;
142
+ readonly reason: PrinterCatalogProblemReason;
143
+ }
144
+ /**
145
+ * Alle Funde in einem Katalog; leer = gueltig. Die einzige Stelle, an der die Regeln stehen. Der Test ruft sie fuer den
146
+ * ausgelieferten Katalog und die Prueffaelle; ein Fund macht ihn rot, statt zur Laufzeit still zu wirken.
147
+ */
148
+ export declare function printerCatalogProblems(catalog: readonly PrinterCatalogEntry[]): PrinterCatalogProblem[];