@kreiseck/kasseneck-api 1.5.0 → 1.6.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 (90) hide show
  1. package/CHANGELOG.md +124 -0
  2. package/README.md +181 -27
  3. package/dist/cjs/client/aufrufe.d.ts +58 -4
  4. package/dist/cjs/client/aufrufe.js +185 -1
  5. package/dist/cjs/client/errors.d.ts +32 -19
  6. package/dist/cjs/client/errors.js +28 -17
  7. package/dist/cjs/client/index.d.ts +2 -2
  8. package/dist/cjs/client/index.js +2 -1
  9. package/dist/cjs/client/transport.d.ts +27 -1
  10. package/dist/cjs/client/transport.js +25 -27
  11. package/dist/cjs/index.d.ts +1 -1
  12. package/dist/cjs/index.js +3 -2
  13. package/dist/cjs/inventory/api.d.ts +10 -2
  14. package/dist/cjs/inventory/api.js +8 -1
  15. package/dist/cjs/inventory/endpunkte.d.ts +2 -1
  16. package/dist/cjs/inventory/endpunkte.js +2 -1
  17. package/dist/cjs/inventory/index.d.ts +5 -3
  18. package/dist/cjs/inventory/index.js +15 -3
  19. package/dist/cjs/inventory/lesen.d.ts +7 -1
  20. package/dist/cjs/inventory/lesen.js +75 -0
  21. package/dist/cjs/inventory/schreiben.d.ts +26 -1
  22. package/dist/cjs/inventory/schreiben.js +24 -10
  23. package/dist/cjs/inventory/typen.d.ts +156 -2
  24. package/dist/cjs/inventory/varianten.d.ts +67 -0
  25. package/dist/cjs/inventory/varianten.js +150 -0
  26. package/dist/cjs/inventory/vertrag.d.ts +40 -5
  27. package/dist/cjs/inventory/vertrag.js +51 -3
  28. package/dist/cjs/inventory/webhook.d.ts +5 -2
  29. package/dist/cjs/inventory/webhook.js +8 -2
  30. package/dist/cjs/invoice/endpunkte.d.ts +6 -0
  31. package/dist/cjs/invoice/endpunkte.js +13 -2
  32. package/dist/cjs/pos/texte.d.ts +11 -6
  33. package/dist/cjs/pos/texte.js +11 -6
  34. package/dist/cjs/stored/vokabular.d.ts +1 -1
  35. package/dist/cjs/stored/vokabular.js +1 -1
  36. package/dist/cjs/version.d.ts +1 -1
  37. package/dist/cjs/version.js +1 -1
  38. package/dist/esm/client/aufrufe.d.ts +58 -4
  39. package/dist/esm/client/aufrufe.js +183 -0
  40. package/dist/esm/client/errors.d.ts +32 -19
  41. package/dist/esm/client/errors.js +28 -17
  42. package/dist/esm/client/index.d.ts +2 -2
  43. package/dist/esm/client/index.js +1 -1
  44. package/dist/esm/client/transport.d.ts +27 -1
  45. package/dist/esm/client/transport.js +26 -28
  46. package/dist/esm/index.d.ts +1 -1
  47. package/dist/esm/index.js +1 -1
  48. package/dist/esm/inventory/api.d.ts +10 -2
  49. package/dist/esm/inventory/api.js +8 -1
  50. package/dist/esm/inventory/endpunkte.d.ts +2 -1
  51. package/dist/esm/inventory/endpunkte.js +2 -1
  52. package/dist/esm/inventory/index.d.ts +5 -3
  53. package/dist/esm/inventory/index.js +4 -2
  54. package/dist/esm/inventory/lesen.d.ts +7 -1
  55. package/dist/esm/inventory/lesen.js +74 -0
  56. package/dist/esm/inventory/schreiben.d.ts +26 -1
  57. package/dist/esm/inventory/schreiben.js +19 -11
  58. package/dist/esm/inventory/typen.d.ts +156 -2
  59. package/dist/esm/inventory/varianten.d.ts +67 -0
  60. package/dist/esm/inventory/varianten.js +142 -0
  61. package/dist/esm/inventory/vertrag.d.ts +40 -5
  62. package/dist/esm/inventory/vertrag.js +50 -2
  63. package/dist/esm/inventory/webhook.d.ts +5 -2
  64. package/dist/esm/inventory/webhook.js +9 -3
  65. package/dist/esm/invoice/endpunkte.d.ts +6 -0
  66. package/dist/esm/invoice/endpunkte.js +13 -2
  67. package/dist/esm/pos/texte.d.ts +11 -6
  68. package/dist/esm/pos/texte.js +11 -6
  69. package/dist/esm/stored/vokabular.d.ts +1 -1
  70. package/dist/esm/stored/vokabular.js +1 -1
  71. package/dist/esm/version.d.ts +1 -1
  72. package/dist/esm/version.js +1 -1
  73. package/fixtures/hobex-hps-codes.json +1 -1
  74. package/fixtures/invoice-api.schema.json +1 -1
  75. package/fixtures/invoice-texts.json +1 -1
  76. package/fixtures/pos-texts.json +1 -1
  77. package/fixtures/surface.json +85 -6
  78. package/fixtures/v3/antworten/belege.json +1 -1
  79. package/fixtures/v3/antworten/belegmail.json +1 -1
  80. package/fixtures/v3/antworten/kasse-belege.json +1 -1
  81. package/fixtures/v3/antworten/kasse.json +2 -2
  82. package/fixtures/v3/antworten/lager.json +2396 -4
  83. package/fixtures/v3/antworten/rechnungen.json +1 -1
  84. package/fixtures/v3/antworten/storno.json +1 -1
  85. package/fixtures/v3/stored/belege.json +1 -1
  86. package/fixtures/v3/stored/kasse.json +2 -2
  87. package/fixtures/v3/stored/rechnungen.json +1 -1
  88. package/fixtures/v3/v3-vokabular.json +151 -6
  89. package/fixtures/v3/zahlbetrag-faelle.json +1 -1
  90. package/package.json +1 -1
@@ -1,6 +1,7 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.POS_CALLS = exports.PUBLIC_CALLS = exports.ALL_CALLS = void 0;
3
+ exports.CALLS_WITHOUT_EFFECT = exports.UNKNOWN_OUTCOME_CALLS = exports.POS_CALLS = exports.PUBLIC_CALLS = exports.ALL_CALLS = void 0;
4
+ exports.isUnknownOutcomeCall = isUnknownOutcomeCall;
4
5
  exports.isPosCall = isPosCall;
5
6
  exports.isPosOnlyCall = isPosOnlyCall;
6
7
  exports.ALL_CALLS = [
@@ -104,6 +105,12 @@ exports.ALL_CALLS = [
104
105
  'releaseReservation',
105
106
  'getReservation',
106
107
  'listReservations',
108
+ // Lager-API Varianten (Stufe 5c, ./inventory)
109
+ 'createVariantGroup',
110
+ 'updateVariantGroup',
111
+ 'getVariantGroup',
112
+ 'listVariantGroups',
113
+ 'addVariant',
107
114
  ];
108
115
  /**
109
116
  * Die oeffentlichen Endpunkte unter `/v3` (`https://api.kasseneck.at/v3/<name>`),
@@ -204,6 +211,12 @@ exports.PUBLIC_CALLS = [
204
211
  'releaseReservation',
205
212
  'getReservation',
206
213
  'listReservations',
214
+ // Lager-API Varianten (Backend Stufe 5c), umhuellt in `./inventory`.
215
+ 'createVariantGroup',
216
+ 'updateVariantGroup',
217
+ 'getVariantGroup',
218
+ 'listVariantGroups',
219
+ 'addVariant',
207
220
  ];
208
221
  /**
209
222
  * Die Endpunkte des Kassenwegs (`https://kasse.kasseneck.at/api/v3/<name>`,
@@ -242,6 +255,177 @@ exports.POS_CALLS = [
242
255
  'listMyStock',
243
256
  'setMyCashregisterStockLocation',
244
257
  ];
258
+ /**
259
+ * Die Aufrufe **mit Wirkung**, alphabetisch: sie legen etwas an, aendern oder
260
+ * loeschen es, buchen, signieren, bewegen Geld oder senden etwas hinaus
261
+ * (Mail, Druckjob, Probesendung). Scheitert einer, nachdem die Anfrage
262
+ * unterwegs war (Netzfehler, Zeitlimit, HTTP 5xx, unlesbare Erfolgsantwort,
263
+ * HTML mit Kennzeichen), meldet der Transport `outcome: 'unknown'`: der
264
+ * Vorgang kann ausgefuehrt sein.
265
+ *
266
+ * Bis 1.5.0 galt das nur fuer die sechs signierenden und geldbewegenden
267
+ * Aufrufe; ein Wareneingang oder eine Rechnung nach einem Zeitlimit kam als
268
+ * `'rejected'` an, und wer das glaubte und mit NEUEM Idempotenzschluessel
269
+ * neu sendete, buchte doppelt.
270
+ *
271
+ * Geht als `unknownOutcomeCalls` in den Vertrag (`fixtures/surface.json`);
272
+ * der Dart-Zwilling prueft seine Liste dagegen. Jeder Aufruf aus
273
+ * [ALL_CALLS], [PUBLIC_CALLS] und [POS_CALLS] steht entweder hier oder in
274
+ * [CALLS_WITHOUT_EFFECT] (Waechter `test/ausgang-einordnung.test.ts`).
275
+ */
276
+ exports.UNKNOWN_OUTCOME_CALLS = [
277
+ 'activateCashregister',
278
+ 'addVariant',
279
+ 'cancelInvoice',
280
+ 'cancelReceipt',
281
+ 'changeStockCondition',
282
+ 'createArticle',
283
+ 'createCreditNote',
284
+ 'createCustomer',
285
+ 'createCustomerCashregister',
286
+ 'createInvoiceItem',
287
+ 'createPartnerCustomer',
288
+ 'createPartnerWebhook',
289
+ 'createPrintJob',
290
+ 'createReceipt',
291
+ 'createReservation',
292
+ 'createVariantGroup',
293
+ 'createWebhook',
294
+ 'deactivateArticle',
295
+ 'deletePartnerWebhook',
296
+ 'deleteWebhook',
297
+ 'extendReservation',
298
+ 'financeWebService',
299
+ 'hobexPayApi',
300
+ 'hobexRefundApi',
301
+ 'issueInvoice',
302
+ 'pairRegisterDevice',
303
+ 'receiveGoods',
304
+ 'recordInvoicePayment',
305
+ 'recordStockLoss',
306
+ 'releaseReservation',
307
+ 'reportCustomerContract',
308
+ 'requestCustomerSignature',
309
+ 'reverseStockMovement',
310
+ 'revokeCustomerMandate',
311
+ 'rotatePartnerWebhookSecret',
312
+ 'rotateWebhookSecret',
313
+ 'sendPartnerCustomerFonLink',
314
+ 'sendPartnerWebhookTest',
315
+ 'sendReceiptEmail',
316
+ 'sendWebhookTest',
317
+ 'setCustomerMandate',
318
+ 'setMyCashregisterStockLocation',
319
+ 'setMyKasseLogo',
320
+ 'setMyKasseSettings',
321
+ 'setMyRegisterDeviceSettings',
322
+ 'stripeCaptureIntent',
323
+ 'transferStock',
324
+ 'unpairRegisterDevice',
325
+ 'updateArticle',
326
+ 'updateCustomer',
327
+ 'updateInvoiceItem',
328
+ 'updatePartnerWebhook',
329
+ 'updateVariantGroup',
330
+ 'updateWebhook',
331
+ 'withdrawInvoiceItem',
332
+ ];
333
+ /**
334
+ * Die Aufrufe **ohne Wirkung**, je mit Grund. Bei ihnen bleibt es bei
335
+ * `outcome: 'rejected'`, auch nach Zeitlimit, Netzfehler oder HTTP 5xx; eine
336
+ * Wiederholung bucht nichts doppelt:
337
+ *
338
+ * - `read`: reines Lesen (auch Berichte, Dateien, `generateFullReceiptId`,
339
+ * das nur einen Link-Schluessel ableitet, und `getCustomerCredentials`,
340
+ * dessen Abruf das Backend nur mitschreibt).
341
+ * - `repeatable`: legt etwas an, das ohne die verlorene Antwort niemand
342
+ * erreicht und das von selbst verfaellt, und bucht nichts. Die Sitzung der
343
+ * Kassen-Anmeldung (anmelden, verlaengern, abmelden: eine Wiederholung legt
344
+ * hoechstens eine weitere kurzlebige Sitzung an bzw. verlaengert oder
345
+ * beendet dieselbe noch einmal) und der Stripe-Zahlungslink
346
+ * (`createPaymentLinkStripe`: den Link kennt nur die Antwort, ein nie
347
+ * zugestellter Link wird nie bezahlt; Geld bewegt erst die Zahlung bzw.
348
+ * `stripeCaptureIntent`).
349
+ *
350
+ * Probelaeufe (`previewGoodsReceipt`, `previewInvoice`) teilen den Namen mit
351
+ * dem echten Aufruf und stehen darum nicht hier; die Huellen setzen fuer sie
352
+ * `hasEffect: false` beim Aufruf, das nur zusammen mit `dryRun: true` gilt
353
+ * (siehe `TransportCallOptions`).
354
+ *
355
+ * Paketintern; nicht Teil der Paketoberflaeche.
356
+ */
357
+ exports.CALLS_WITHOUT_EFFECT = Object.freeze({
358
+ checkPartnerCustomerEmail: 'read',
359
+ downloadDailyReport: 'read',
360
+ downloadReceipt: 'read',
361
+ downloadReport: 'read',
362
+ createPaymentLinkStripe: 'repeatable',
363
+ endRegisterSession: 'repeatable',
364
+ generateFullReceiptId: 'read',
365
+ getArticle: 'read',
366
+ getCustomer: 'read',
367
+ getCustomerCredentials: 'read',
368
+ getCustomerSignatureStatus: 'read',
369
+ getFirstReceiptDate: 'read',
370
+ getInvoice: 'read',
371
+ getInvoiceItem: 'read',
372
+ getInvoicePdf: 'read',
373
+ getInvoiceSetupStatus: 'read',
374
+ getInvoiceXml: 'read',
375
+ getKasseSettings: 'read',
376
+ getPartnerBilling: 'read',
377
+ getPartnerBillingMonth: 'read',
378
+ getPartnerCustomer: 'read',
379
+ getPartnerInfo: 'read',
380
+ getPrintJob: 'read',
381
+ getReceipt: 'read',
382
+ getReportV2: 'read',
383
+ getReservation: 'read',
384
+ getStock: 'read',
385
+ getVariantGroup: 'read',
386
+ hobexGetStatus: 'read',
387
+ listArticles: 'read',
388
+ listBrands: 'read',
389
+ listCustomerCashregisters: 'read',
390
+ listInvoiceItems: 'read',
391
+ listInvoices: 'read',
392
+ listLocations: 'read',
393
+ listMyArticleGroups: 'read',
394
+ listMyArticles: 'read',
395
+ listMyCashregisters: 'read',
396
+ listMyPrinters: 'read',
397
+ listMyReceipts: 'read',
398
+ listMyStock: 'read',
399
+ listMyStockLocations: 'read',
400
+ listMyTipRecipients: 'read',
401
+ listPartnerCustomers: 'read',
402
+ listPartnerWebhookDeliveries: 'read',
403
+ listPartnerWebhooks: 'read',
404
+ listRegisterSessionsForDevice: 'read',
405
+ listRegisterUsersForDevice: 'read',
406
+ listReservations: 'read',
407
+ listStock: 'read',
408
+ listStockMovements: 'read',
409
+ listVariantGroups: 'read',
410
+ listWebhookDeliveries: 'read',
411
+ listWebhooks: 'read',
412
+ lookupArticleByCode: 'read',
413
+ registerPinLogin: 'repeatable',
414
+ registerUserLogin: 'repeatable',
415
+ renewRegisterSession: 'repeatable',
416
+ searchCustomers: 'read',
417
+ });
418
+ const MIT_WIRKUNG = new Set(exports.UNKNOWN_OUTCOME_CALLS);
419
+ /**
420
+ * Hat dieser Aufruf Wirkung, ist sein Ausgang nach Zeitlimit, Netzfehler,
421
+ * HTTP 5xx oder unlesbarer Erfolgsantwort also unklar? `financeWebService`
422
+ * zaehlt mit jedem Vorgang. Ein Name, den dieses Paket nicht kennt (der
423
+ * offene Transport nimmt jeden), ist `false`; wer so einen Aufruf mit Wirkung
424
+ * absetzt, sagt es mit `hasEffect: true`.
425
+ */
426
+ function isUnknownOutcomeCall(name) {
427
+ return MIT_WIRKUNG.has(name);
428
+ }
245
429
  const OEFFENTLICH = new Set(exports.PUBLIC_CALLS);
246
430
  const KASSENWEG = new Set(exports.POS_CALLS);
247
431
  const NUR_KASSE = new Set(exports.POS_CALLS.filter((name) => !OEFFENTLICH.has(name)));
@@ -25,20 +25,27 @@
25
25
  * **Entscheidend ist `outcome`:** `'rejected'` heisst abgelehnt, nichts
26
26
  * geschehen, Wiederholen hilft nicht. `'unknown'` heisst: der Vorgang kann
27
27
  * ausgefuehrt sein (bei `createReceipt` ein signierter Beleg). Dann **nie
28
- * wiederholen**, sondern das Ergebnis nachlesen (Belegliste, `getReceipt`).
28
+ * blind wiederholen**: Belege, Stornos und Zahlungen nachlesen
29
+ * (Belegliste, `getReceipt`, Terminal-Beleg); ein Aufruf mit
30
+ * `idempotencyKey` (Lager schreiben, Rechnung, Partner-Betrieb mit
31
+ * Schluessel) darf mit **demselben** Schluessel erneut gesendet werden und
32
+ * wirkt genau einmal, nie mit einem neuen. `createInvoiceItem` erkennt die
33
+ * Wiederholung an `source` + `reference` (dieselben Werte erneut senden);
34
+ * Posten aendern oder zurueckziehen und Mandate haben keinen Schluessel:
35
+ * erst nachlesen.
29
36
  * - `KasseneckHttpError` — die Antwort war **keine** verwertbare Huelle:
30
37
  * HTTP 500/404 ohne Huelle, leerer Rumpf oder Text statt JSON. Beim
31
38
  * Bericht-Download gelten dieselben Gruende fuer alles, was kein PDF ist.
32
39
  * `reason` trennt die Faelle maschinenlesbar. Auf einem Aufruf mit
33
- * Wirkung (signierend oder geldbewegend) hat HTTP 5xx
40
+ * Wirkung (`UNKNOWN_OUTCOME_CALLS` in aufrufe.ts) hat HTTP 5xx
34
41
  * `outcome: 'unknown'`, ebenso HTTP 200 mit Kennzeichen, aber leerem oder
35
42
  * unlesbarem Rumpf.
36
43
  * - `KasseneckNetworkError` — die Antwort kam gar nicht: Netz weg, DNS,
37
44
  * abgebrochene Verbindung oder Zeitueberschreitung (`timedOut`). Auch hier
38
45
  * gilt `outcome`: war die Anfrage schon unterwegs und ist der Aufruf einer
39
- * mit Wirkung (signierend: `createReceipt`, `cancelReceipt`,
40
- * `financeWebService`; geldbewegend: `hobexPayApi`, `hobexRefundApi`,
41
- * `stripeCaptureIntent`), ist er `'unknown'`.
46
+ * mit Wirkung (signieren, Geld bewegen, buchen, ausstellen, anlegen,
47
+ * aendern, loeschen, senden; die Liste `UNKNOWN_OUTCOME_CALLS`), ist er
48
+ * `'unknown'`. Lesen und Probelauf bleiben `'rejected'`.
42
49
  * - `KasseneckAuthError` — es kam nicht einmal zur Anfrage, weil die Anmeldung
43
50
  * scheiterte (fehlende Zugangsdaten, oder der Token-/Sitzungsgeber warf).
44
51
  * In der Browser-Kasse mit ihrer 90-Sekunden-Sitzung ist das Alltag, kein
@@ -106,8 +113,10 @@ export declare function causeDigest(ursache: unknown, geheimnisse: readonly stri
106
113
  export declare function fehlerDetails(daten: unknown, geheimnisse: readonly string[]): Record<string, unknown>;
107
114
  /**
108
115
  * Ausgang eines gescheiterten Aufrufs. `'rejected'`: nichts geschehen.
109
- * `'unknown'`: der Vorgang kann ausgefuehrt sein; nie wiederholen, sondern
110
- * das Ergebnis nachlesen.
116
+ * `'unknown'`: der Vorgang kann ausgefuehrt sein; nie blind wiederholen.
117
+ * Belege, Stornos und Zahlungen nachlesen; ein Aufruf mit `idempotencyKey`
118
+ * nur mit **demselben** Schluessel erneut senden (wirkt genau einmal); ohne
119
+ * Schluessel erst nachlesen.
111
120
  */
112
121
  export type ErrorOutcome = 'unknown' | 'rejected';
113
122
  /**
@@ -195,12 +204,12 @@ export declare class KasseneckHttpError extends Error {
195
204
  /** Maschinenlesbarer Grund — trennt den Rewrite-Fall vom 500er ohne Textparsen. */
196
205
  readonly reason: HttpFailureReason;
197
206
  /**
198
- * `'unknown'` auf einem Aufruf mit Wirkung (`createReceipt`,
199
- * `cancelReceipt`, `financeWebService`, `hobexPayApi`, `hobexRefundApi`,
200
- * `stripeCaptureIntent`) bei HTTP 5xx und bei HTTP 200 mit
201
- * Kennzeichen, aber unlesbarem Rumpf (`empty-body`, `not-json` auch bei
202
- * `text/html`, `missing-status`): der Handler kann gelaufen sein, nie wiederholen,
203
- * sondern nachlesen. Sonst `'rejected'` (auch 4xx).
207
+ * `'unknown'` auf einem Aufruf mit Wirkung (`UNKNOWN_OUTCOME_CALLS`:
208
+ * signieren, Geld bewegen, buchen, ausstellen, anlegen, aendern, loeschen,
209
+ * senden) bei HTTP 5xx und bei HTTP 200 mit Kennzeichen, aber unlesbarem
210
+ * Rumpf (`empty-body`, `not-json` auch bei `text/html`, `missing-status`):
211
+ * der Handler kann gelaufen sein, nie blind wiederholen (siehe
212
+ * [ErrorOutcome]). Sonst `'rejected'` (auch 4xx, Lesen und Probelauf).
204
213
  */
205
214
  readonly outcome: ErrorOutcome;
206
215
  constructor(functionName: string, statusCode: number, contentType: string | undefined, reason: HttpFailureReason, outcome?: ErrorOutcome);
@@ -218,9 +227,10 @@ export declare class KasseneckNetworkError extends Error {
218
227
  /** Code der zugrunde liegenden Ursache, sofern unbedenklich (z. B. `ECONNREFUSED`). */
219
228
  readonly causeCode: string | undefined;
220
229
  /**
221
- * `'unknown'`, wenn die Anfrage schon unterwegs war und der Aufruf signiert
222
- * (`createReceipt`, `cancelReceipt`, `financeWebService`): dann nie
223
- * wiederholen, sondern nachlesen. Sonst `'rejected'`.
230
+ * `'unknown'`, wenn die Anfrage schon unterwegs war und der Aufruf Wirkung
231
+ * hat (`UNKNOWN_OUTCOME_CALLS`): dann nie blind wiederholen (siehe
232
+ * [ErrorOutcome]). Sonst `'rejected'`, auch bei Lesen und Probelauf und
233
+ * wenn schon die Anmeldung das Zeitlimit verbrauchte.
224
234
  */
225
235
  readonly outcome: ErrorOutcome;
226
236
  constructor(functionName: string, timedOut: boolean, timeoutMs: number, cause?: CauseDigest, outcome?: ErrorOutcome);
@@ -273,9 +283,12 @@ export declare class KasseneckValidationError extends Error {
273
283
  export type KasseneckError = KasseneckApiError | KasseneckHttpError | KasseneckNetworkError | KasseneckAuthError | KasseneckValidationError;
274
284
  /**
275
285
  * Ist der Ausgang dieses Fehlers unklar (`outcome === 'unknown'`)? Dann den
276
- * Aufruf **nicht wiederholen**, sondern das Ergebnis nachlesen. Gilt fuer
277
- * jede Fehlerart; nur [KasseneckApiError], [KasseneckHttpError] und
278
- * [KasseneckNetworkError] koennen `'unknown'` sein.
286
+ * Aufruf **nicht blind wiederholen**: Belege, Stornos und Zahlungen
287
+ * nachlesen; einen Aufruf mit `idempotencyKey` nur mit **demselben**
288
+ * Schluessel erneut senden (wirkt genau einmal, ein neuer buchte doppelt);
289
+ * ohne Schluessel erst nachlesen. Gilt fuer jede Fehlerart; nur
290
+ * [KasseneckApiError], [KasseneckHttpError] und [KasseneckNetworkError]
291
+ * koennen `'unknown'` sein.
279
292
  */
280
293
  export declare function isOutcomeUnknown(error: unknown): boolean;
281
294
  export declare function isKasseneckApiError(error: unknown): error is KasseneckApiError;
@@ -26,20 +26,27 @@
26
26
  * **Entscheidend ist `outcome`:** `'rejected'` heisst abgelehnt, nichts
27
27
  * geschehen, Wiederholen hilft nicht. `'unknown'` heisst: der Vorgang kann
28
28
  * ausgefuehrt sein (bei `createReceipt` ein signierter Beleg). Dann **nie
29
- * wiederholen**, sondern das Ergebnis nachlesen (Belegliste, `getReceipt`).
29
+ * blind wiederholen**: Belege, Stornos und Zahlungen nachlesen
30
+ * (Belegliste, `getReceipt`, Terminal-Beleg); ein Aufruf mit
31
+ * `idempotencyKey` (Lager schreiben, Rechnung, Partner-Betrieb mit
32
+ * Schluessel) darf mit **demselben** Schluessel erneut gesendet werden und
33
+ * wirkt genau einmal, nie mit einem neuen. `createInvoiceItem` erkennt die
34
+ * Wiederholung an `source` + `reference` (dieselben Werte erneut senden);
35
+ * Posten aendern oder zurueckziehen und Mandate haben keinen Schluessel:
36
+ * erst nachlesen.
30
37
  * - `KasseneckHttpError` — die Antwort war **keine** verwertbare Huelle:
31
38
  * HTTP 500/404 ohne Huelle, leerer Rumpf oder Text statt JSON. Beim
32
39
  * Bericht-Download gelten dieselben Gruende fuer alles, was kein PDF ist.
33
40
  * `reason` trennt die Faelle maschinenlesbar. Auf einem Aufruf mit
34
- * Wirkung (signierend oder geldbewegend) hat HTTP 5xx
41
+ * Wirkung (`UNKNOWN_OUTCOME_CALLS` in aufrufe.ts) hat HTTP 5xx
35
42
  * `outcome: 'unknown'`, ebenso HTTP 200 mit Kennzeichen, aber leerem oder
36
43
  * unlesbarem Rumpf.
37
44
  * - `KasseneckNetworkError` — die Antwort kam gar nicht: Netz weg, DNS,
38
45
  * abgebrochene Verbindung oder Zeitueberschreitung (`timedOut`). Auch hier
39
46
  * gilt `outcome`: war die Anfrage schon unterwegs und ist der Aufruf einer
40
- * mit Wirkung (signierend: `createReceipt`, `cancelReceipt`,
41
- * `financeWebService`; geldbewegend: `hobexPayApi`, `hobexRefundApi`,
42
- * `stripeCaptureIntent`), ist er `'unknown'`.
47
+ * mit Wirkung (signieren, Geld bewegen, buchen, ausstellen, anlegen,
48
+ * aendern, loeschen, senden; die Liste `UNKNOWN_OUTCOME_CALLS`), ist er
49
+ * `'unknown'`. Lesen und Probelauf bleiben `'rejected'`.
43
50
  * - `KasseneckAuthError` — es kam nicht einmal zur Anfrage, weil die Anmeldung
44
51
  * scheiterte (fehlende Zugangsdaten, oder der Token-/Sitzungsgeber warf).
45
52
  * In der Browser-Kasse mit ihrer 90-Sekunden-Sitzung ist das Alltag, kein
@@ -378,12 +385,12 @@ class KasseneckHttpError extends Error {
378
385
  /** Maschinenlesbarer Grund — trennt den Rewrite-Fall vom 500er ohne Textparsen. */
379
386
  reason;
380
387
  /**
381
- * `'unknown'` auf einem Aufruf mit Wirkung (`createReceipt`,
382
- * `cancelReceipt`, `financeWebService`, `hobexPayApi`, `hobexRefundApi`,
383
- * `stripeCaptureIntent`) bei HTTP 5xx und bei HTTP 200 mit
384
- * Kennzeichen, aber unlesbarem Rumpf (`empty-body`, `not-json` auch bei
385
- * `text/html`, `missing-status`): der Handler kann gelaufen sein, nie wiederholen,
386
- * sondern nachlesen. Sonst `'rejected'` (auch 4xx).
388
+ * `'unknown'` auf einem Aufruf mit Wirkung (`UNKNOWN_OUTCOME_CALLS`:
389
+ * signieren, Geld bewegen, buchen, ausstellen, anlegen, aendern, loeschen,
390
+ * senden) bei HTTP 5xx und bei HTTP 200 mit Kennzeichen, aber unlesbarem
391
+ * Rumpf (`empty-body`, `not-json` auch bei `text/html`, `missing-status`):
392
+ * der Handler kann gelaufen sein, nie blind wiederholen (siehe
393
+ * [ErrorOutcome]). Sonst `'rejected'` (auch 4xx, Lesen und Probelauf).
387
394
  */
388
395
  outcome;
389
396
  constructor(functionName, statusCode, contentType, reason, outcome = 'rejected') {
@@ -410,9 +417,10 @@ class KasseneckNetworkError extends Error {
410
417
  /** Code der zugrunde liegenden Ursache, sofern unbedenklich (z. B. `ECONNREFUSED`). */
411
418
  causeCode;
412
419
  /**
413
- * `'unknown'`, wenn die Anfrage schon unterwegs war und der Aufruf signiert
414
- * (`createReceipt`, `cancelReceipt`, `financeWebService`): dann nie
415
- * wiederholen, sondern nachlesen. Sonst `'rejected'`.
420
+ * `'unknown'`, wenn die Anfrage schon unterwegs war und der Aufruf Wirkung
421
+ * hat (`UNKNOWN_OUTCOME_CALLS`): dann nie blind wiederholen (siehe
422
+ * [ErrorOutcome]). Sonst `'rejected'`, auch bei Lesen und Probelauf und
423
+ * wenn schon die Anmeldung das Zeitlimit verbrauchte.
416
424
  */
417
425
  outcome;
418
426
  constructor(functionName, timedOut, timeoutMs, cause = {}, outcome = 'rejected') {
@@ -481,9 +489,12 @@ class KasseneckValidationError extends Error {
481
489
  exports.KasseneckValidationError = KasseneckValidationError;
482
490
  /**
483
491
  * Ist der Ausgang dieses Fehlers unklar (`outcome === 'unknown'`)? Dann den
484
- * Aufruf **nicht wiederholen**, sondern das Ergebnis nachlesen. Gilt fuer
485
- * jede Fehlerart; nur [KasseneckApiError], [KasseneckHttpError] und
486
- * [KasseneckNetworkError] koennen `'unknown'` sein.
492
+ * Aufruf **nicht blind wiederholen**: Belege, Stornos und Zahlungen
493
+ * nachlesen; einen Aufruf mit `idempotencyKey` nur mit **demselben**
494
+ * Schluessel erneut senden (wirkt genau einmal, ein neuer buchte doppelt);
495
+ * ohne Schluessel erst nachlesen. Gilt fuer jede Fehlerart; nur
496
+ * [KasseneckApiError], [KasseneckHttpError] und [KasseneckNetworkError]
497
+ * koennen `'unknown'` sein.
487
498
  */
488
499
  function isOutcomeUnknown(error) {
489
500
  return ((error instanceof KasseneckApiError || error instanceof KasseneckHttpError || error instanceof KasseneckNetworkError)
@@ -1,6 +1,6 @@
1
1
  export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, } from './auth.js';
2
- export { DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type KasseneckTransport, type KasseneckBinaryTransport, createTransport, createBinaryTransport, } from './transport.js';
3
- export { ALL_CALLS, type ApiCall, PUBLIC_CALLS, POS_CALLS, type PublicCall, type PosCall, } from './aufrufe.js';
2
+ export { DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type TransportCallOptions, type KasseneckTransport, type KasseneckBinaryTransport, createTransport, createBinaryTransport, } from './transport.js';
3
+ export { ALL_CALLS, type ApiCall, PUBLIC_CALLS, POS_CALLS, UNKNOWN_OUTCOME_CALLS, type PublicCall, type PosCall, } from './aufrufe.js';
4
4
  export { KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, type ErrorOutcome, CLIENT_ERROR_CODES, type ClientErrorCode, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, isOutcomeUnknown, } from './errors.js';
5
5
  export { type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, type CancelReceiptResult, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, checkVoucherCombinationError, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, } from './receipts.js';
6
6
  export { listMyCashregisters } from './cashregisters.js';
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.getReportV2 = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.listMyCashregisters = exports.sendReceiptEmail = exports.checkVoucherCombinationError = exports.listMyReceipts = exports.getFirstReceiptDate = exports.generateFullReceiptId = exports.getReceiptWithCompany = exports.getReceipt = exports.zeroReceipt = exports.cancelReceipt = exports.receiptLayoutFromResult = exports.cardRefundReference = exports.paymentsExpectedCents = exports.sellReceiptWithCompany = exports.sellReceipt = exports.isOutcomeUnknown = exports.isKasseneckValidationError = exports.isKasseneckNetworkError = exports.isKasseneckHttpError = exports.isKasseneckAuthError = exports.isKasseneckApiError = exports.CLIENT_ERROR_CODES = exports.KasseneckValidationError = exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckAuthError = exports.KasseneckApiError = exports.POS_CALLS = exports.PUBLIC_CALLS = exports.ALL_CALLS = exports.createBinaryTransport = exports.createTransport = exports.DEFAULT_TIMEOUT_MS = exports.POS_BASE_URL = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = void 0;
3
+ exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.getReportV2 = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.listMyCashregisters = exports.sendReceiptEmail = exports.checkVoucherCombinationError = exports.listMyReceipts = exports.getFirstReceiptDate = exports.generateFullReceiptId = exports.getReceiptWithCompany = exports.getReceipt = exports.zeroReceipt = exports.cancelReceipt = exports.receiptLayoutFromResult = exports.cardRefundReference = exports.paymentsExpectedCents = exports.sellReceiptWithCompany = exports.sellReceipt = exports.isOutcomeUnknown = exports.isKasseneckValidationError = exports.isKasseneckNetworkError = exports.isKasseneckHttpError = exports.isKasseneckAuthError = exports.isKasseneckApiError = exports.CLIENT_ERROR_CODES = exports.KasseneckValidationError = exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckAuthError = exports.KasseneckApiError = exports.UNKNOWN_OUTCOME_CALLS = exports.POS_CALLS = exports.PUBLIC_CALLS = exports.ALL_CALLS = exports.createBinaryTransport = exports.createTransport = exports.DEFAULT_TIMEOUT_MS = exports.POS_BASE_URL = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = void 0;
4
4
  var auth_js_1 = require("./auth.js");
5
5
  Object.defineProperty(exports, "apiKeyAuth", { enumerable: true, get: function () { return auth_js_1.apiKeyAuth; } });
6
6
  Object.defineProperty(exports, "registerUserAuth", { enumerable: true, get: function () { return auth_js_1.registerUserAuth; } });
@@ -14,6 +14,7 @@ var aufrufe_js_1 = require("./aufrufe.js");
14
14
  Object.defineProperty(exports, "ALL_CALLS", { enumerable: true, get: function () { return aufrufe_js_1.ALL_CALLS; } });
15
15
  Object.defineProperty(exports, "PUBLIC_CALLS", { enumerable: true, get: function () { return aufrufe_js_1.PUBLIC_CALLS; } });
16
16
  Object.defineProperty(exports, "POS_CALLS", { enumerable: true, get: function () { return aufrufe_js_1.POS_CALLS; } });
17
+ Object.defineProperty(exports, "UNKNOWN_OUTCOME_CALLS", { enumerable: true, get: function () { return aufrufe_js_1.UNKNOWN_OUTCOME_CALLS; } });
17
18
  var errors_js_1 = require("./errors.js");
18
19
  Object.defineProperty(exports, "KasseneckApiError", { enumerable: true, get: function () { return errors_js_1.KasseneckApiError; } });
19
20
  Object.defineProperty(exports, "KasseneckAuthError", { enumerable: true, get: function () { return errors_js_1.KasseneckAuthError; } });
@@ -33,6 +33,12 @@ import { type KasseneckAuth } from './auth.js';
33
33
  * **Kein Wiederholen fehlgeschlagener Aufrufe.** Ein Beleg ist nicht folgenlos
34
34
  * wiederholbar; ohne entschiedene Idempotenz waere ein automatischer zweiter
35
35
  * Versuch ein zweiter Beleg.
36
+ *
37
+ * **Ausgang je Aufruf.** Ob ein Scheitern nach dem Senden `outcome: 'unknown'`
38
+ * traegt, haengt am Aufruf: mit Wirkung ([UNKNOWN_OUTCOME_CALLS] in
39
+ * aufrufe.ts) ja, Lesen und Probelauf nein. Ein Probelauf traegt denselben
40
+ * Namen wie der echte Aufruf; die Huelle sagt es darum beim Aufruf
41
+ * (`hasEffect: false`, [TransportCallOptions]).
36
42
  */
37
43
  /** Basis-URL der oeffentlichen API (Produktion). */
38
44
  export declare const DEFAULT_BASE_URL = "https://api.kasseneck.at/v3";
@@ -151,7 +157,27 @@ export interface TransportBodyFields {
151
157
  /** Vorgangsart von `financeWebService` (z. B. `status_cashbox`). */
152
158
  method?: string;
153
159
  }
154
- export type KasseneckTransport = <T = unknown>(functionName: string, params?: Record<string, unknown>, extraBodyFields?: TransportBodyFields, secretParams?: readonly string[]) => Promise<T>;
160
+ /**
161
+ * Einstellungen fuer **einen** Aufruf, die nicht mitgesendet werden.
162
+ */
163
+ export interface TransportCallOptions {
164
+ /**
165
+ * Hat dieser Aufruf Wirkung? Entscheidet den Ausgang, wenn er scheitert,
166
+ * nachdem die Anfrage unterwegs war (Netzfehler, Zeitlimit, HTTP 5xx,
167
+ * unlesbare Erfolgsantwort, HTML mit Kennzeichen): `true` ergibt
168
+ * `outcome: 'unknown'`. Ohne Angabe gilt die Liste des Pakets
169
+ * (`UNKNOWN_OUTCOME_CALLS`); ein Name, den sie nicht kennt, gilt dann als
170
+ * ohne Wirkung.
171
+ *
172
+ * `true` fuer einen Aufruf mit Wirkung, den dieses Paket nicht kennt.
173
+ * `false` gilt **nur zusammen mit `params.dryRun === true`** (Probelauf
174
+ * unter dem Namen des echten Aufrufs, schreibt nichts) und ergibt dann
175
+ * `'rejected'`; ohne `dryRun: true` bleibt ein Aufruf aus der Liste
176
+ * `'unknown'`, was immer hier steht.
177
+ */
178
+ hasEffect?: boolean;
179
+ }
180
+ export type KasseneckTransport = <T = unknown>(functionName: string, params?: Record<string, unknown>, extraBodyFields?: TransportBodyFields, secretParams?: readonly string[], options?: TransportCallOptions) => Promise<T>;
155
181
  /**
156
182
  * Ruft eine Backend-Funktion auf, die **Binaerdaten** liefert (die beiden
157
183
  * Bericht-PDFs), und gibt sie als `Uint8Array` zurueck.
@@ -41,6 +41,12 @@ const errors_js_1 = require("./errors.js");
41
41
  * **Kein Wiederholen fehlgeschlagener Aufrufe.** Ein Beleg ist nicht folgenlos
42
42
  * wiederholbar; ohne entschiedene Idempotenz waere ein automatischer zweiter
43
43
  * Versuch ein zweiter Beleg.
44
+ *
45
+ * **Ausgang je Aufruf.** Ob ein Scheitern nach dem Senden `outcome: 'unknown'`
46
+ * traegt, haengt am Aufruf: mit Wirkung ([UNKNOWN_OUTCOME_CALLS] in
47
+ * aufrufe.ts) ja, Lesen und Probelauf nein. Ein Probelauf traegt denselben
48
+ * Namen wie der echte Aufruf; die Huelle sagt es darum beim Aufruf
49
+ * (`hasEffect: false`, [TransportCallOptions]).
44
50
  */
45
51
  /** Basis-URL der oeffentlichen API (Produktion). */
46
52
  exports.DEFAULT_BASE_URL = 'https://api.kasseneck.at/v3';
@@ -61,23 +67,6 @@ const VERSION_WERT = 'v3';
61
67
  const KASSENECK_HOSTS = new Set(['api.kasseneck.at', 'kasse.kasseneck.at']);
62
68
  /** Die 1.x-Linie spricht nur `/v3`: jede Basis endet so (`/v3` oder `/api/v3`). */
63
69
  const V3_ENDE = /\/v3$/;
64
- /**
65
- * Aufrufe mit Wirkung, die nie blind wiederholt werden duerfen: sie signieren
66
- * (`createReceipt`, `cancelReceipt`), loesen bei FinanzOnline etwas aus
67
- * (`financeWebService`) oder bewegen Geld (`hobexPayApi` belastet eine Karte,
68
- * `hobexRefundApi` erstattet, `stripeCaptureIntent` zieht eine vorgemerkte
69
- * Zahlung ein). Scheitert einer, nachdem die Anfrage unterwegs war (Netz,
70
- * Zeitlimit, HTTP 5xx, unlesbare Erfolgsantwort, HTML mit Kennzeichen), ist
71
- * sein Ausgang offen.
72
- */
73
- const UNKNOWN_OUTCOME_CALLS = new Set([
74
- 'createReceipt',
75
- 'cancelReceipt',
76
- 'financeWebService',
77
- 'hobexPayApi',
78
- 'hobexRefundApi',
79
- 'stripeCaptureIntent',
80
- ]);
81
70
  /**
82
71
  * Produkte, die das Backend in `Kasseneck-Client` zaehlt (Positivliste,
83
72
  * Nachtrag §6); alles andere zaehlte dort als `ungueltig`. Das Paket weist
@@ -94,7 +83,7 @@ const CLIENT_MAX = 64;
94
83
  exports.DEFAULT_TIMEOUT_MS = 30_000;
95
84
  function createTransport(options) {
96
85
  const kern = createCore(options);
97
- return (functionName, params, extraBodyFields, secretParams) => kern(functionName, params, extraBodyFields, secretParams, alsText, jsonAuswerten);
86
+ return (functionName, params, extraBodyFields, secretParams, callOptions) => kern(functionName, params, extraBodyFields, secretParams, callOptions, alsText, jsonAuswerten);
98
87
  }
99
88
  /**
100
89
  * Zweiter Einstiegspunkt fuer die Bericht-Downloads. Er liest die Antwort als
@@ -106,7 +95,7 @@ function createTransport(options) {
106
95
  */
107
96
  function createBinaryTransport(options) {
108
97
  const kern = createCore(options);
109
- return (functionName, params) => kern(functionName, params, undefined, undefined, alsBytes, pdfAuswerten);
98
+ return (functionName, params) => kern(functionName, params, undefined, undefined, undefined, alsBytes, pdfAuswerten);
110
99
  }
111
100
  /**
112
101
  * Gemeinsamer Kern beider Einstiegspunkte: Anmeldung, Zeitlimit, Anfrage und
@@ -130,12 +119,21 @@ function createCore(options) {
130
119
  * (Berichte, Zahlungen, FinanzOnline), geht an die oeffentliche Basis.
131
120
  */
132
121
  const basisFuer = (functionName) => (0, aufrufe_js_1.isPosOnlyCall)(functionName) || (kassenweg && (0, aufrufe_js_1.isPosCall)(functionName)) ? kassenBasis : oeffentlicheBasis;
133
- return async function aufrufen(functionName, params = {}, extraBodyFields, secretParams, lesen, auswerten) {
122
+ return async function aufrufen(functionName, params = {}, extraBodyFields, secretParams, callOptions, lesen, auswerten) {
134
123
  // Die URL nennt die Backend-Funktion, die Fehler nennen den **Vorgang**:
135
124
  // `financeWebService` fuehrt ein Dutzend verschiedener Vorgaenge unter einem
136
125
  // Endpunkt, und ein Fehler, der nur "financeWebService" sagt, verschweigt
137
126
  // dem Aufrufer, welcher davon scheiterte.
138
127
  const fehlerName = extraBodyFields?.method ? `${functionName}/${extraBodyFields.method}` : functionName;
128
+ // Ausgang eines Scheiterns nach dem Senden: offen, wenn der Aufruf Wirkung
129
+ // hat. `hasEffect: true` hebt einen fremden Aufruf auf `unknown`.
130
+ // `hasEffect: false` senkt einen Aufruf mit Wirkung nur, wenn er wirklich
131
+ // ein Probelauf ist (`dryRun === true`, so streng prueft auch das
132
+ // Backend): sonst liefe ein echter Beleg oder eine Buchung nach einem
133
+ // Zeitlimit als `rejected`, und genau das fuehrt zur Doppelbuchung.
134
+ const probelauf = callOptions?.hasEffect === false && params['dryRun'] === true;
135
+ const wirkung = callOptions?.hasEffect === true || ((0, aufrufe_js_1.isUnknownOutcomeCall)(functionName) && !probelauf);
136
+ const nachDemSenden = wirkung ? 'unknown' : 'rejected';
139
137
  // Das Zeitlimit laeuft ab HIER — es deckt die Anmeldung mit ab. Haengt die
140
138
  // Token-Erneuerung auf flauem Netz, haette der Aufruf sonst weder Ergebnis
141
139
  // noch Fehler, und die Kasse stuende still.
@@ -175,8 +173,9 @@ function createCore(options) {
175
173
  }
176
174
  // Bis hierher kam keine verwertbare Antwort: Netz weg oder Zeitlimit.
177
175
  // Die Anfrage war schon unterwegs: bei einem Aufruf mit Wirkung kann
178
- // der Beleg bzw. die Zahlung entstanden sein (Ausgang unklar, nachlesen).
179
- return new errors_js_1.KasseneckNetworkError(fehlerName, abbruch.signal.aborted, zeitlimitMs, (0, errors_js_1.causeDigest)(ursache, geheimnisse), UNKNOWN_OUTCOME_CALLS.has(functionName) ? 'unknown' : 'rejected');
176
+ // der Vorgang ausgefuehrt sein (Beleg, Zahlung, Buchung, Rechnung;
177
+ // Ausgang unklar).
178
+ return new errors_js_1.KasseneckNetworkError(fehlerName, abbruch.signal.aborted, zeitlimitMs, (0, errors_js_1.causeDigest)(ursache, geheimnisse), nachDemSenden);
180
179
  };
181
180
  const basis = basisFuer(functionName);
182
181
  const url = `${basis}/${encodeURIComponent(functionName)}`;
@@ -230,7 +229,7 @@ function createCore(options) {
230
229
  throw fehler;
231
230
  }
232
231
  // 5xx auf einem Aufruf mit Wirkung: der Handler kann gelaufen sein.
233
- const ausgang = antwort.status >= 500 && UNKNOWN_OUTCOME_CALLS.has(functionName) ? 'unknown' : 'rejected';
232
+ const ausgang = antwort.status >= 500 ? nachDemSenden : 'rejected';
234
233
  throw new errors_js_1.KasseneckHttpError(fehlerName, antwort.status, inhaltstyp, 'server-error', ausgang);
235
234
  }
236
235
  // HTTP 200 mit HTML: die Auffangregel der Single-Page-App hat den Aufruf
@@ -238,9 +237,9 @@ function createCore(options) {
238
237
  if (inhaltstyp !== undefined && /^\s*text\/html\b/i.test(inhaltstyp)) {
239
238
  // Mit Kennzeichen hat der `/v3`-Rand den Aufruf gesehen (etwa ein
240
239
  // Proxy, der nur den Inhaltstyp umschreibt). Bei einem Aufruf mit
241
- // Wirkung kann der Beleg bzw. die Zahlung dann entstanden sein: unlesbarer Rumpf,
240
+ // Wirkung kann der Vorgang dann ausgefuehrt sein: unlesbarer Rumpf,
242
241
  // Ausgang unklar, statt `route_missing`.
243
- if (UNKNOWN_OUTCOME_CALLS.has(functionName) && traegtKennzeichen(antwort)) {
242
+ if (nachDemSenden === 'unknown' && traegtKennzeichen(antwort)) {
244
243
  throw new errors_js_1.KasseneckHttpError(fehlerName, antwort.status, inhaltstyp, 'not-json', 'unknown');
245
244
  }
246
245
  throw new errors_js_1.KasseneckApiError(fehlerName, 'Route fehlt: die Antwort ist eine HTML-Seite statt des Backends', {}, 'route_missing');
@@ -258,8 +257,7 @@ function createCore(options) {
258
257
  // Ab hier kam HTTP 200 mit Kennzeichen: der `/v3`-Rand hat den Aufruf
259
258
  // gesehen. Ist der Rumpf dann unlesbar (gekuerzt von einem Proxy,
260
259
  // abgebrochene Verbindung), kann ein Handler mit Wirkung gelaufen sein.
261
- const unlesbar = UNKNOWN_OUTCOME_CALLS.has(functionName) ? 'unknown' : 'rejected';
262
- return auswerten(koerper, fehlerName, antwort.status, inhaltstyp, geheimnisse, unlesbar);
260
+ return auswerten(koerper, fehlerName, antwort.status, inhaltstyp, geheimnisse, nachDemSenden);
263
261
  }
264
262
  finally {
265
263
  // Ohne Abraeumen haelt der Wecker den Node-Prozess bis zum Zeitlimit wach.
@@ -1,6 +1,6 @@
1
1
  export { ReceiptType, type ReceiptTypeKey, VatRate, type VatRateKey, KeckPaymentMethod, type KeckPaymentMethodKey, CreditCardProvider, type CreditCardProviderKey, VoucherType, type VoucherTypeKey, VoucherAction, type VoucherActionKey, StripeLinkMode, type StripeLinkModeKey, } from './enums/index.js';
2
2
  export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, type Receipt, type RegistrationInfo, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, type CancellationStatus, type ReturnDisposition, RETURN_DISPOSITIONS, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isReturnDisposition, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, type CancellationFieldError, type ReceiptPayment, type ReceiptPaymentPayload, type ReceiptPaymentInput, fromReceiptPaymentPayload, toReceiptPaymentPayload, type PaymentErrorCode, PAYMENT_ERROR_CODES, isPaymentErrorCode, paymentErrorCode, isPaymentError, paymentFieldErrors, type PaymentFieldError, type ReceiptEmailErrorCode, type ReceiptEmailVia, RECEIPT_EMAIL_ERROR_CODES, RECEIPT_EMAIL_SEND_ERROR_CODES, type ReceiptEmailSendErrorCode, RECEIPT_EMAIL_VIAS, isReceiptEmailErrorCode, receiptEmailErrorCode, isReceiptEmailError, receiptEmailFieldErrors, type ReceiptEmailFieldError, type ReceiptErrorCode, type ReceiptFieldError, RECEIPT_ERROR_CODES, isReceiptErrorCode, receiptErrorCode, isReceiptError, receiptFieldErrors, remainingQuantities, type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, fromCashregisterPayload, type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, isZeroKind, type ReportMonth, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, type StripeUrlSession, type StripeUrlSessionPayload, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, type HobexReceipt, type HobexReceiptPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
3
- export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type KasseneckTransport, type KasseneckBinaryTransport, ALL_CALLS, type ApiCall, PUBLIC_CALLS, POS_CALLS, type PublicCall, type PosCall, createTransport, createBinaryTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, type ErrorOutcome, CLIENT_ERROR_CODES, type ClientErrorCode, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, isOutcomeUnknown, type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CancelReceiptResult, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, listMyCashregisters, checkVoucherCombinationError, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, downloadDailyReport, downloadMonthlyReport, getReportV2, type ReportV2, type ReportV2Metadata, type ReportV2Options, type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, type KasseneckApi, createKasseneckApi, } from './client/index.js';
3
+ export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type TransportCallOptions, type KasseneckTransport, type KasseneckBinaryTransport, ALL_CALLS, type ApiCall, PUBLIC_CALLS, POS_CALLS, UNKNOWN_OUTCOME_CALLS, type PublicCall, type PosCall, createTransport, createBinaryTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, type ErrorOutcome, CLIENT_ERROR_CODES, type ClientErrorCode, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, isOutcomeUnknown, type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CancelReceiptResult, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, listMyCashregisters, checkVoucherCombinationError, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, downloadDailyReport, downloadMonthlyReport, getReportV2, type ReportV2, type ReportV2Metadata, type ReportV2Options, type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, type KasseneckApi, createKasseneckApi, } from './client/index.js';
4
4
  export { type ReceiptDueTip, type ReceiptDueTipRecipient, type ReceiptDueOptions, type ReceiptDueBuckets, type ReceiptDueBreakdown, type ReceiptDueErrorReason, receiptDueCents, receiptDueBreakdown, ReceiptDueError, RECEIPT_DUE_ERROR_REASONS, isReceiptDueError, } from './receipt/due.js';
5
5
  export { parseServerTimeStamp, toViennaWallClock, type ViennaWallClock } from './vienna-time.js';
6
6
  export { type PosBusinessSettings, type PosDeviceSettings, type PosSettings, type ArticleGroup, type PosArticle, POS_BUSINESS_DEFAULTS, POS_DEVICE_DEFAULTS, mergePosSettings, fromArticleGroupPayload, fromPosArticlePayload, listMyArticleGroups, listMyArticles, getPosSettings, setMyPosSettings, setMyRegisterDeviceSettings, distributeDiscount, cancelScopeOf, receiptsScopeOf, stockViewOf, } from './pos/index.js';
package/dist/cjs/index.js CHANGED
@@ -1,8 +1,8 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.receiptFieldErrors = exports.isReceiptError = exports.receiptErrorCode = exports.isReceiptErrorCode = exports.RECEIPT_ERROR_CODES = exports.receiptEmailFieldErrors = exports.isReceiptEmailError = exports.receiptEmailErrorCode = exports.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_VIAS = exports.RECEIPT_EMAIL_SEND_ERROR_CODES = exports.RECEIPT_EMAIL_ERROR_CODES = exports.paymentFieldErrors = exports.isPaymentError = exports.paymentErrorCode = exports.isPaymentErrorCode = exports.PAYMENT_ERROR_CODES = exports.toReceiptPaymentPayload = exports.fromReceiptPaymentPayload = exports.cancellationFieldErrors = exports.isCancellationError = exports.cancellationErrorCode = exports.isCancellationErrorCode = exports.isReturnDisposition = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_STATUSES = exports.CANCELLATION_REASONS = exports.RETURN_DISPOSITIONS = exports.receiptSumCents = exports.receiptSubSumCents = exports.fromReceiptPayload = exports.toReceiptPayload = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = exports.StripeLinkMode = exports.VoucherAction = exports.VoucherType = exports.CreditCardProvider = exports.KeckPaymentMethod = exports.VatRate = exports.ReceiptType = void 0;
4
- exports.generateFullReceiptId = exports.getReceiptWithCompany = exports.getReceipt = exports.zeroReceipt = exports.cancelReceipt = exports.receiptLayoutFromResult = exports.cardRefundReference = exports.paymentsExpectedCents = exports.sellReceiptWithCompany = exports.sellReceipt = exports.isOutcomeUnknown = exports.isKasseneckValidationError = exports.isKasseneckNetworkError = exports.isKasseneckHttpError = exports.isKasseneckAuthError = exports.isKasseneckApiError = exports.CLIENT_ERROR_CODES = exports.KasseneckValidationError = exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckAuthError = exports.KasseneckApiError = exports.createBinaryTransport = exports.createTransport = exports.POS_CALLS = exports.PUBLIC_CALLS = exports.ALL_CALLS = exports.DEFAULT_TIMEOUT_MS = exports.POS_BASE_URL = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.isZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.remainingQuantities = void 0;
5
- exports.stockViewOf = exports.receiptsScopeOf = exports.cancelScopeOf = exports.distributeDiscount = exports.setMyRegisterDeviceSettings = exports.setMyPosSettings = exports.getPosSettings = exports.listMyArticles = exports.listMyArticleGroups = exports.fromPosArticlePayload = exports.fromArticleGroupPayload = exports.mergePosSettings = exports.POS_DEVICE_DEFAULTS = exports.POS_BUSINESS_DEFAULTS = exports.toViennaWallClock = exports.parseServerTimeStamp = exports.isReceiptDueError = exports.RECEIPT_DUE_ERROR_REASONS = exports.ReceiptDueError = exports.receiptDueBreakdown = exports.receiptDueCents = exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.getReportV2 = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.sendReceiptEmail = exports.checkVoucherCombinationError = exports.listMyCashregisters = exports.listMyReceipts = exports.getFirstReceiptDate = void 0;
4
+ exports.getReceiptWithCompany = exports.getReceipt = exports.zeroReceipt = exports.cancelReceipt = exports.receiptLayoutFromResult = exports.cardRefundReference = exports.paymentsExpectedCents = exports.sellReceiptWithCompany = exports.sellReceipt = exports.isOutcomeUnknown = exports.isKasseneckValidationError = exports.isKasseneckNetworkError = exports.isKasseneckHttpError = exports.isKasseneckAuthError = exports.isKasseneckApiError = exports.CLIENT_ERROR_CODES = exports.KasseneckValidationError = exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckAuthError = exports.KasseneckApiError = exports.createBinaryTransport = exports.createTransport = exports.UNKNOWN_OUTCOME_CALLS = exports.POS_CALLS = exports.PUBLIC_CALLS = exports.ALL_CALLS = exports.DEFAULT_TIMEOUT_MS = exports.POS_BASE_URL = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.isZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.remainingQuantities = void 0;
5
+ exports.stockViewOf = exports.receiptsScopeOf = exports.cancelScopeOf = exports.distributeDiscount = exports.setMyRegisterDeviceSettings = exports.setMyPosSettings = exports.getPosSettings = exports.listMyArticles = exports.listMyArticleGroups = exports.fromPosArticlePayload = exports.fromArticleGroupPayload = exports.mergePosSettings = exports.POS_DEVICE_DEFAULTS = exports.POS_BUSINESS_DEFAULTS = exports.toViennaWallClock = exports.parseServerTimeStamp = exports.isReceiptDueError = exports.RECEIPT_DUE_ERROR_REASONS = exports.ReceiptDueError = exports.receiptDueBreakdown = exports.receiptDueCents = exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.getReportV2 = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.sendReceiptEmail = exports.checkVoucherCombinationError = exports.listMyCashregisters = exports.listMyReceipts = exports.getFirstReceiptDate = exports.generateFullReceiptId = void 0;
6
6
  var index_js_1 = require("./enums/index.js");
7
7
  Object.defineProperty(exports, "ReceiptType", { enumerable: true, get: function () { return index_js_1.ReceiptType; } });
8
8
  Object.defineProperty(exports, "VatRate", { enumerable: true, get: function () { return index_js_1.VatRate; } });
@@ -82,6 +82,7 @@ Object.defineProperty(exports, "DEFAULT_TIMEOUT_MS", { enumerable: true, get: fu
82
82
  Object.defineProperty(exports, "ALL_CALLS", { enumerable: true, get: function () { return index_js_3.ALL_CALLS; } });
83
83
  Object.defineProperty(exports, "PUBLIC_CALLS", { enumerable: true, get: function () { return index_js_3.PUBLIC_CALLS; } });
84
84
  Object.defineProperty(exports, "POS_CALLS", { enumerable: true, get: function () { return index_js_3.POS_CALLS; } });
85
+ Object.defineProperty(exports, "UNKNOWN_OUTCOME_CALLS", { enumerable: true, get: function () { return index_js_3.UNKNOWN_OUTCOME_CALLS; } });
85
86
  Object.defineProperty(exports, "createTransport", { enumerable: true, get: function () { return index_js_3.createTransport; } });
86
87
  Object.defineProperty(exports, "createBinaryTransport", { enumerable: true, get: function () { return index_js_3.createBinaryTransport; } });
87
88
  Object.defineProperty(exports, "KasseneckApiError", { enumerable: true, get: function () { return index_js_3.KasseneckApiError; } });