@kreiseck/kasseneck-api 1.38.0 → 1.40.0

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 (87) hide show
  1. package/CHANGELOG.md +29 -2
  2. package/README.md +3 -1
  3. package/dist/cjs/client/aufrufe.d.ts +2 -2
  4. package/dist/cjs/client/aufrufe.js +12 -0
  5. package/dist/cjs/payments/hobex-hps/connect-client.d.ts +17 -0
  6. package/dist/cjs/payments/hobex-hps/connect-client.js +17 -0
  7. package/dist/cjs/payments/hobex-hps/index.d.ts +1 -1
  8. package/dist/cjs/payments/index.d.ts +1 -1
  9. package/dist/cjs/pos/client.d.ts +1 -0
  10. package/dist/cjs/pos/client.js +9 -1
  11. package/dist/cjs/pos/errors.d.ts +1 -1
  12. package/dist/cjs/pos/errors.js +1 -0
  13. package/dist/cjs/pos/index.d.ts +1 -1
  14. package/dist/cjs/pos/index.js +9 -5
  15. package/dist/cjs/pos/settings.d.ts +46 -3
  16. package/dist/cjs/pos/settings.js +51 -4
  17. package/dist/cjs/pos/texte.d.ts +534 -0
  18. package/dist/cjs/pos/texte.js +178 -0
  19. package/dist/cjs/receipt/layout.js +11 -3
  20. package/dist/cjs/register/errors.d.ts +1 -1
  21. package/dist/cjs/register/errors.js +4 -0
  22. package/dist/cjs/register/index.d.ts +1 -1
  23. package/dist/cjs/register/index.js +3 -1
  24. package/dist/cjs/register/pairing.d.ts +51 -0
  25. package/dist/cjs/register/pairing.js +59 -0
  26. package/dist/cjs/stored/einstellungen.js +5 -2
  27. package/dist/cjs/stored/vokabular.d.ts +1 -1
  28. package/dist/cjs/stored/vokabular.js +12 -2
  29. package/dist/cjs/version.d.ts +1 -1
  30. package/dist/cjs/version.js +1 -1
  31. package/dist/esm/client/aufrufe.d.ts +2 -2
  32. package/dist/esm/client/aufrufe.js +12 -0
  33. package/dist/esm/payments/hobex-hps/connect-client.d.ts +17 -0
  34. package/dist/esm/payments/hobex-hps/connect-client.js +17 -0
  35. package/dist/esm/payments/hobex-hps/index.d.ts +1 -1
  36. package/dist/esm/payments/index.d.ts +1 -1
  37. package/dist/esm/pos/client.d.ts +1 -0
  38. package/dist/esm/pos/client.js +10 -2
  39. package/dist/esm/pos/errors.d.ts +1 -1
  40. package/dist/esm/pos/errors.js +1 -0
  41. package/dist/esm/pos/index.d.ts +1 -1
  42. package/dist/esm/pos/index.js +1 -1
  43. package/dist/esm/pos/settings.d.ts +46 -3
  44. package/dist/esm/pos/settings.js +47 -3
  45. package/dist/esm/pos/texte.d.ts +534 -0
  46. package/dist/esm/pos/texte.js +178 -0
  47. package/dist/esm/receipt/layout.js +11 -3
  48. package/dist/esm/register/errors.d.ts +1 -1
  49. package/dist/esm/register/errors.js +4 -0
  50. package/dist/esm/register/index.d.ts +1 -1
  51. package/dist/esm/register/index.js +1 -1
  52. package/dist/esm/register/pairing.d.ts +51 -0
  53. package/dist/esm/register/pairing.js +57 -0
  54. package/dist/esm/stored/einstellungen.js +6 -3
  55. package/dist/esm/stored/vokabular.d.ts +1 -1
  56. package/dist/esm/stored/vokabular.js +12 -2
  57. package/dist/esm/version.d.ts +1 -1
  58. package/dist/esm/version.js +1 -1
  59. package/fixtures/hobex-hps-codes.json +1 -1
  60. package/fixtures/invoice-api.schema.json +1 -1
  61. package/fixtures/invoice-texts.json +1 -1
  62. package/fixtures/manifest.json +6 -6
  63. package/fixtures/pos-texts.json +679 -1
  64. package/fixtures/receipt-due-generated.json +1 -1
  65. package/fixtures/receipt-due-voucher-generated.json +1 -1
  66. package/fixtures/receipts/card-sumup.json +1 -1
  67. package/fixtures/receipts/split-card-card-cash.json +1 -1
  68. package/fixtures/receipts/split-one-card-tip.json +1 -1
  69. package/fixtures/receipts/split-table-round-tip.json +2 -2
  70. package/fixtures/receipts/split-tip-card.json +1 -1
  71. package/fixtures/receipts/split-two-cards-same-provider.json +2 -2
  72. package/fixtures/renames-1.0.json +4 -2
  73. package/fixtures/surface.json +20 -4
  74. package/fixtures/v3/antworten/belege.json +2 -2
  75. package/fixtures/v3/antworten/belegmail.json +2 -2
  76. package/fixtures/v3/antworten/berichte.json +2 -2
  77. package/fixtures/v3/antworten/kasse-belege.json +2 -2
  78. package/fixtures/v3/antworten/kasse.json +696 -4
  79. package/fixtures/v3/antworten/lager.json +1 -1
  80. package/fixtures/v3/antworten/rechnungen.json +2 -2
  81. package/fixtures/v3/antworten/storno.json +2 -2
  82. package/fixtures/v3/stored/belege.json +2 -2
  83. package/fixtures/v3/stored/kasse.json +210 -4
  84. package/fixtures/v3/stored/rechnungen.json +2 -2
  85. package/fixtures/v3/v3-vokabular.json +107 -6
  86. package/fixtures/v3/zahlbetrag-faelle.json +2 -2
  87. package/package.json +1 -1
@@ -1,13 +1,16 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports._ALTFORM_0X = exports.POS_DEVICE_VALUES = exports.POS_BUSINESS_VALUES = exports.POS_DEVICE_OPTIONAL_CHOICES = exports.POS_BUSINESS_OPTIONAL_LISTS = exports.POS_BUSINESS_OPTIONAL_CHOICES = exports.POS_BUSINESS_OPTIONAL_FIELDS = exports.POS_DEVICE_OPTIONAL_FIELDS = exports.POS_DEVICE_DEFAULTS = exports.POS_BUSINESS_DEFAULTS = exports.POS_SHORTCUT_SHARED_PAIRS = exports.POS_SHORTCUT_DEFAULTS = exports.POS_SHORTCUT_ACTIONS = exports.DONE_SCREEN_SECONDS = exports.WATERMARK_SCALE = exports.LOGO_SCALE = exports.WATERMARK_STRENGTH = exports.WATERMARK_SIDE = exports.DISCOUNT = exports.AUTO_LOGOUT_MINUTES = exports.TILE_STYLE = exports.SETTINGS_FONT_SIZE = exports.LOGO_SIZE = exports.QR_MODE = exports.DRAWER_AUTO_OPEN = exports.CUT = exports.CODE_PAGE = exports.PAPER_SIZE = exports.TERMINAL_TYPE = exports.TERMINAL_VIA = exports.PRINTER_TYPE = exports.TILE_HEIGHT = exports.CATEGORY_POSITION = exports.LAYOUT = exports.RECEIPT_OUTPUT = exports.CARD_PROVIDER = exports.CHECKOUT_MODE = exports.CART_WIDTH = exports.DISCOUNT_PRESET_KIND = exports.TIP_CARD_KEPT_MODE = exports.TIP_KEPT_MODE = exports.TIP_START = exports.TIP_KINDS = exports.TIP_MODE = exports.QUANTITY = exports.WATERMARK = exports.FONT_SIZE = exports.THEME = void 0;
3
+ exports._ALTFORM_0X = exports.POS_DEVICE_VALUES = exports.POS_BUSINESS_VALUES = exports.POS_DEVICE_OPTIONAL_CHOICES = exports.POS_BUSINESS_OPTIONAL_LISTS = exports.POS_BUSINESS_OPTIONAL_CHOICES = exports.POS_BUSINESS_OPTIONAL_IDS = exports.POS_BUSINESS_OPTIONAL_FIELDS = exports.POS_DEVICE_OPTIONAL_SWITCHES = exports.POS_DEVICE_OPTIONAL_FIELDS = exports.POS_DEVICE_DEFAULTS = exports.POS_BUSINESS_DEFAULTS = exports.POS_SHORTCUT_SHARED_PAIRS = exports.POS_SHORTCUT_DEFAULTS = exports.POS_SHORTCUT_ACTIONS = exports.DONE_SCREEN_SECONDS = exports.WATERMARK_SCALE = exports.LOGO_SCALE = exports.WATERMARK_STRENGTH = exports.WATERMARK_SIDE = exports.DISCOUNT = exports.AUTO_LOGOUT_MINUTES = exports.TILE_STYLE = exports.SETTINGS_FONT_SIZE = exports.LOGO_SIZE = exports.QR_MODE = exports.DRAWER_AUTO_OPEN = exports.CUT = exports.CODE_PAGE = exports.PAPER_SIZE = exports.TERMINAL_TYPE = exports.TERMINAL_VIA = exports.PRINTER_TYPE = exports.TILE_HEIGHT = exports.CATEGORY_POSITION = exports.LAYOUT = exports.RECEIPT_OUTPUT = exports.CARD_PROVIDER = exports.CHECKOUT_MODE = exports.CART_WIDTH = exports.DISCOUNT_PRESET_KIND = exports.TIP_CARD_KEPT_MODE = exports.TIP_KEPT_MODE = exports.TIP_START = exports.TIP_KINDS = exports.TIP_MODE = exports.QUANTITY = exports.WATERMARK = exports.FONT_SIZE = exports.THEME = void 0;
4
4
  exports.posShortcutConflict = posShortcutConflict;
5
+ exports.posCardTerminalFromWire = posCardTerminalFromWire;
5
6
  exports._optionalerWert = _optionalerWert;
7
+ exports._optionaleBetriebsKennung = _optionaleBetriebsKennung;
6
8
  exports._vorlagenLesen = _vorlagenLesen;
7
9
  exports._optionalerWahlwert = _optionalerWahlwert;
8
10
  exports.posTipKinds = posTipKinds;
9
11
  exports.posTipStart = posTipStart;
10
12
  exports.posCartWidth = posCartWidth;
13
+ exports.posPrinterHint = posPrinterHint;
11
14
  exports.posTipKeptByDefault = posTipKeptByDefault;
12
15
  exports.posCustomDiscountAllowed = posCustomDiscountAllowed;
13
16
  exports.posTipKeptMode = posTipKeptMode;
@@ -71,8 +74,11 @@ exports.DISCOUNT_PRESET_KIND = ['percent', 'amount'];
71
74
  /** Breite der rechten Spalte (Korb) an diesem Geraet (`device.cartWidth`); in der schmalen Ansicht ohne Wirkung. */
72
75
  exports.CART_WIDTH = ['narrow', 'medium', 'wide'];
73
76
  exports.CHECKOUT_MODE = ['page', 'panel'];
74
- /** Kartenanbieter: Karte gibt es erst mit eingerichtetem Anbieter; 'external' = eigenes Terminal ohne Anbindung. */
75
- exports.CARD_PROVIDER = ['none', 'external', 'gptom', 'hobex', 'mypos', 'stripe'];
77
+ /**
78
+ * Kartenanbieter: Karte gibt es erst mit eingerichtetem Anbieter; 'external' = eigenes Terminal ohne Anbindung.
79
+ * 'sumup' bindet nur die Kassen-App auf Android an (SumUp-SDK); Browser-Kasse und iOS kassieren damit wie 'external'.
80
+ */
81
+ exports.CARD_PROVIDER = ['none', 'external', 'gptom', 'hobex', 'mypos', 'stripe', 'sumup'];
76
82
  exports.RECEIPT_OUTPUT = ['qr', 'print', 'email', 'sms', 'ask'];
77
83
  exports.LAYOUT = ['right', 'left', 'fullscreen'];
78
84
  exports.CATEGORY_POSITION = ['top', 'left'];
@@ -197,6 +203,13 @@ function posShortcutConflict(shortcuts) {
197
203
  }
198
204
  return null;
199
205
  }
206
+ /** `cardTerminal` aus einer Antwort lesen; unbrauchbar oder ohne Inhalt → `null`. */
207
+ function posCardTerminalFromWire(value) {
208
+ const block = value !== null && typeof value === 'object' && !Array.isArray(value) ? value : null;
209
+ const sumup = block && block.sumup !== null && typeof block.sumup === 'object' ? block.sumup : null;
210
+ const key = sumup && typeof sumup.affiliateKey === 'string' ? sumup.affiliateKey : '';
211
+ return key ? { sumup: { affiliateKey: key } } : null;
212
+ }
200
213
  exports.POS_BUSINESS_DEFAULTS = Object.freeze({
201
214
  // Das Petrol der Marke: die Aktionsfarbe des Design-Systems (Rolle `brand`).
202
215
  logoText: 'K', logoEnabled: true, logoSize: 'M', watermark: 'login', color: '#136B6B',
@@ -239,6 +252,13 @@ function _optionalerWert(wert, schreiben) {
239
252
  return (schreiben && wert === null) || (typeof wert === 'string' && OPTIONALE_KENNUNG.test(wert));
240
253
  }
241
254
  const OPTIONALE = new Set(exports.POS_DEVICE_OPTIONAL_FIELDS);
255
+ /**
256
+ * Optionale Geraete-Schalter: ohne Standardwert, der Server sendet sie nur, wenn sie gespeichert sind (Backend
257
+ * `GERAET_OPTIONAL`, Wahrheitswert). [mergePosSettings] uebernimmt sie nur als Wahrheitswert; der Schreibweg nimmt nur
258
+ * `true`/`false`.
259
+ */
260
+ exports.POS_DEVICE_OPTIONAL_SWITCHES = Object.freeze(['printerHint']);
261
+ const OPTIONALE_GERAETE_SCHALTER = new Set(exports.POS_DEVICE_OPTIONAL_SWITCHES);
242
262
  /**
243
263
  * Optionale Betriebs-Einstellungen (Schalter): ohne Standardwert, der Server
244
264
  * sendet sie nur, wenn sie gespeichert sind (Backend `BETRIEB_OPTIONAL`).
@@ -247,6 +267,19 @@ const OPTIONALE = new Set(exports.POS_DEVICE_OPTIONAL_FIELDS);
247
267
  */
248
268
  exports.POS_BUSINESS_OPTIONAL_FIELDS = Object.freeze(['tipKeptByDefault', 'customDiscountAllowed', 'tipCardKeptByDefault', 'tipSelfPayout']);
249
269
  const OPTIONALE_SCHALTER = new Set(exports.POS_BUSINESS_OPTIONAL_FIELDS);
270
+ /**
271
+ * Optionale Betriebs-Kennungen (Backend `BETRIEB_OPTIONAL`, z. B. `sumupHaendler`): ohne Standardwert, der Server sendet
272
+ * sie nur, wenn sie gesetzt sind. [mergePosSettings] uebernimmt eine gueltige Nummer; der Schreibweg nimmt sie oder
273
+ * `null` (loesen).
274
+ */
275
+ exports.POS_BUSINESS_OPTIONAL_IDS = Object.freeze(['sumupMerchantCode']);
276
+ /** Form der SumUp-Haendlernummer (Backend `sumup-kasse-core.HAENDLER_MUSTER`, dort gross geschrieben). */
277
+ const SUMUP_HAENDLER = /^[A-Za-z0-9]{4,20}$/;
278
+ /** Gilt dieser Wert fuer eine optionale Betriebs-Kennung? Lesen: nur eine Nummer; Schreiben: auch `null`. */
279
+ function _optionaleBetriebsKennung(wert, schreiben) {
280
+ return (schreiben && wert === null) || (typeof wert === 'string' && SUMUP_HAENDLER.test(wert));
281
+ }
282
+ const OPTIONALE_BETRIEBS_KENNUNGEN = new Set(exports.POS_BUSINESS_OPTIONAL_IDS);
250
283
  /**
251
284
  * Optionale Betriebs-Einstellungen mit Wertemenge (Backend `BETRIEB_OPTIONAL`, Katalog
252
285
  * `KASSE_BETRIEB_WERTE.tipKinds[]`, `.tipStart` und `.tipKeptMode`): ohne Standardwert, der Server sendet sie nur,
@@ -306,6 +339,10 @@ function posCartWidth(device) {
306
339
  const w = device?.cartWidth;
307
340
  return typeof w === 'string' && w !== '' ? w : 'narrow';
308
341
  }
342
+ /** Hinweis „Drucker antwortet nicht“ an den Druckknoepfen an? Fehlt die Einstellung, gilt ja. */
343
+ function posPrinterHint(device) {
344
+ return device?.printerHint !== false;
345
+ }
309
346
  /** Bar-Trinkgeld „gleich behalten“ vorbelegt? Fehlt die Einstellung, gilt aus. */
310
347
  function posTipKeptByDefault(business) {
311
348
  return !!business && business.tipKeptByDefault === true;
@@ -420,7 +457,7 @@ exports._ALTFORM_0X = Object.freeze({ werte: ALTWERTE_0X, aktionen: [...ALTAKTIO
420
457
  * Schluessel, die der Standard nicht fuehrt, bleiben draussen, ausser einer
421
458
  * optionalen Geraete-Einstellung ([POS_DEVICE_OPTIONAL_FIELDS]) mit gueltiger
422
459
  * Kennung und einem optionalen Betriebs-Schalter
423
- * ([POS_BUSINESS_OPTIONAL_FIELDS]) als Wahrheitswert.
460
+ * ([POS_BUSINESS_OPTIONAL_FIELDS]) oder Geraete-Schalter ([POS_DEVICE_OPTIONAL_SWITCHES]) als Wahrheitswert.
424
461
  *
425
462
  * **Immer** (unabhaengig davon, welches Standard-Objekt uebergeben wird, auch
426
463
  * eine Kopie oder das einer zweiten Paketkopie) faellt ein Wert der inneren
@@ -441,6 +478,10 @@ function mergePosSettings(standard, stored) {
441
478
  out[key] = wert;
442
479
  if (OPTIONALE_SCHALTER.has(key) && typeof wert === 'boolean')
443
480
  out[key] = wert;
481
+ if (OPTIONALE_BETRIEBS_KENNUNGEN.has(key) && _optionaleBetriebsKennung(wert, false))
482
+ out[key] = wert;
483
+ if (OPTIONALE_GERAETE_SCHALTER.has(key) && typeof wert === 'boolean')
484
+ out[key] = wert;
444
485
  if (OPTIONALE_WAHL.has(key) && _optionalerWahlwert(key, wert))
445
486
  out[key] = Array.isArray(wert) ? [...wert] : wert;
446
487
  if (key === 'discountPresets') {
@@ -496,8 +537,14 @@ function sanitizePosSettings(stored) {
496
537
  device: mergePosSettings(exports.POS_DEVICE_DEFAULTS, teil('device')),
497
538
  vouchers: (0, gutschein_js_1.posVoucherSettingsFromWire)(eigen(roh, 'vouchers') ? roh['vouchers'] : undefined),
498
539
  ...pfandBlock(eigen(roh, 'deposit') ? roh['deposit'] : undefined),
540
+ ...kartenterminalBlock(eigen(roh, 'cardTerminal') ? roh['cardTerminal'] : undefined),
499
541
  };
500
542
  }
543
+ /** `{ cardTerminal }`, wenn der Block lesbar ist, sonst nichts. */
544
+ function kartenterminalBlock(wert) {
545
+ const cardTerminal = posCardTerminalFromWire(wert);
546
+ return cardTerminal ? { cardTerminal } : {};
547
+ }
501
548
  /**
502
549
  * Die Felder, deren Wert dieses Paket nicht kennt (neuer Wert des Servers),
503
550
  * als Pfade (`business.theme`, `device.printerType`). Die Oberflaeche kann sie