@kreiseck/kasseneck-api 1.34.0 → 1.35.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.
- package/CHANGELOG.md +12 -0
- package/README.md +11 -1
- package/dist/cjs/pos/drucker-katalog.d.ts +148 -0
- package/dist/cjs/pos/drucker-katalog.js +260 -0
- package/dist/cjs/pos/index.d.ts +1 -0
- package/dist/cjs/pos/index.js +8 -3
- package/dist/cjs/version.d.ts +1 -1
- package/dist/cjs/version.js +1 -1
- package/dist/esm/pos/drucker-katalog.d.ts +148 -0
- package/dist/esm/pos/drucker-katalog.js +252 -0
- package/dist/esm/pos/index.d.ts +1 -0
- package/dist/esm/pos/index.js +3 -0
- package/dist/esm/version.d.ts +1 -1
- package/dist/esm/version.js +1 -1
- package/fixtures/hobex-hps-codes.json +1 -1
- package/fixtures/invoice-api.schema.json +1 -1
- package/fixtures/invoice-texts.json +1 -1
- package/fixtures/pos-texts.json +1 -1
- package/fixtures/printer-catalog.json +1802 -0
- package/fixtures/surface.json +1 -1
- package/package.json +1 -1
|
@@ -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[];
|
|
@@ -0,0 +1,252 @@
|
|
|
1
|
+
import { CHARS_PER_PAPER_SIZE } from '../receipt/grid.js';
|
|
2
|
+
import { PAPER_SIZE } from './settings.js';
|
|
3
|
+
/*
|
|
4
|
+
* Druckerkatalog der Kasse: bekannte Bondrucker mit den Druck-Einstellungen, die an ihnen im Geraetetest stimmen.
|
|
5
|
+
* Findet Kasseneck Connect ein bekanntes Modell, uebernimmt die Kasse diese Werte mit einem Klick; bei einem unbekannten
|
|
6
|
+
* Modell fragt sie nur die Papierbreite. Der Katalog liegt im Paket (nicht im Admin, nicht in Connect), damit Web-Kasse
|
|
7
|
+
* und Kassen-App offline dieselben Werte haben und jede Aenderung versioniert und getestet ausgeliefert wird.
|
|
8
|
+
*
|
|
9
|
+
* Vertrag ist fixtures/printer-catalog.json: dieselben Eintraege wie hier und die Prueffaelle, die der Dart-Zwilling
|
|
10
|
+
* (lib/src/kasse/drucker_katalog.dart) gegen dieselbe Datei rechnet. Die Daten unten prueft nur der Test
|
|
11
|
+
* (printerCatalogProblems); zur Laufzeit wird nichts still repariert oder verworfen.
|
|
12
|
+
*/
|
|
13
|
+
// ------------------------------------------------------------------ Wertemengen
|
|
14
|
+
/**
|
|
15
|
+
* Schnitt eines Eintrags: nur, was die Kasse unter „Papier abschneiden“ anbietet (Teilschnitt oder keiner). Die
|
|
16
|
+
* Einstellung kennt auch `full`, Bondrucker schneiden aber nie ganz durch; ein Katalogwert, den die Kasse nicht
|
|
17
|
+
* anzeigt, waere fuer den Chef nicht pruefbar.
|
|
18
|
+
*/
|
|
19
|
+
export const PRINTER_CATALOG_CUTS = ['partial', 'none'];
|
|
20
|
+
/** QR-Weg eines Eintrags. `auto` heisst „noch niemand hat entschieden“ und ist darum keine Aussage ueber ein Modell. */
|
|
21
|
+
export const PRINTER_CATALOG_QR_MODES = ['escpos', 'raster'];
|
|
22
|
+
/** Alle Wertfelder, in der Reihenfolge von [PrinterCatalogValues]; ein Test haelt sie vollstaendig. */
|
|
23
|
+
export const PRINTER_CATALOG_VALUE_FIELDS = [
|
|
24
|
+
'paperSize', 'charsPerLine', 'cut', 'drawerKick', 'qrMode', 'codePage',
|
|
25
|
+
];
|
|
26
|
+
// ------------------------------------------------------------------ Daten
|
|
27
|
+
const eingefroren = (e) => {
|
|
28
|
+
const test = e.approval.deviceTest;
|
|
29
|
+
return Object.freeze({
|
|
30
|
+
...e,
|
|
31
|
+
matchNames: Object.freeze([...e.matchNames]),
|
|
32
|
+
paperSizes: Object.freeze([...e.paperSizes]),
|
|
33
|
+
values: Object.freeze({ ...e.values }),
|
|
34
|
+
approval: Object.freeze({
|
|
35
|
+
...e.approval,
|
|
36
|
+
deviceTest: test && Object.freeze({ ...test, checked: Object.freeze([...test.checked]), checkedPaperSizes: Object.freeze([...test.checkedPaperSizes]) }),
|
|
37
|
+
}),
|
|
38
|
+
});
|
|
39
|
+
};
|
|
40
|
+
/**
|
|
41
|
+
* Startbestand laut Spec connect-betrieb (Stufe 1), noch ohne Geraetetest und darum nicht freigegeben. Je Eintrag
|
|
42
|
+
* stehen die Werte ausgeschrieben, auch wo sie gleich sind: jeder ist eine eigene Aussage ueber ein Modell und wird
|
|
43
|
+
* einzeln freigegeben.
|
|
44
|
+
*
|
|
45
|
+
* Papierbreiten laut Epson-Datenblatt: TM-m30III, TM-m30II und TM-T20III lassen sich mit der beiliegenden
|
|
46
|
+
* Papierfuehrung auf 58 mm umstellen (dann 420 Punkte, Schrift A 35 Spalten; die Kasse setzt 32 Zeichen), der TM-m10
|
|
47
|
+
* kann nur 58 mm. Bestaetigt ist das erst mit dem Geraetetest.
|
|
48
|
+
*
|
|
49
|
+
* TM-T88VI und TM-T88VII drucken mit 180 dpi (512 Punkte auf 80 mm, Schrift A 42 Spalten); 48 Zeichen passen nicht.
|
|
50
|
+
* Sie bekommen darum das 58-mm-Layout der Kasse (32 Zeichen, die 384 Punkte von `GS W` passen in ihre 512), auch mit
|
|
51
|
+
* 80-mm-Papier, bis es eine Einstellung mit 42 Zeichen gibt.
|
|
52
|
+
*/
|
|
53
|
+
export const PRINTER_CATALOG = Object.freeze([
|
|
54
|
+
{
|
|
55
|
+
id: 'epson-tm-m30iii', manufacturer: 'Epson', model: 'TM-m30III', matchNames: ['TM-M30III'],
|
|
56
|
+
paperSizes: ['mm58', 'mm80'], nativeCharsPerLine: 48,
|
|
57
|
+
values: { paperSize: 'mm80', charsPerLine: 48, cut: 'partial', drawerKick: true, qrMode: 'escpos', codePage: 'CP1252' },
|
|
58
|
+
approval: { approved: false, deviceTest: null },
|
|
59
|
+
},
|
|
60
|
+
{
|
|
61
|
+
id: 'epson-tm-m30ii', manufacturer: 'Epson', model: 'TM-m30II', matchNames: ['TM-M30II'],
|
|
62
|
+
paperSizes: ['mm58', 'mm80'], nativeCharsPerLine: 48,
|
|
63
|
+
values: { paperSize: 'mm80', charsPerLine: 48, cut: 'partial', drawerKick: true, qrMode: 'escpos', codePage: 'CP1252' },
|
|
64
|
+
approval: { approved: false, deviceTest: null },
|
|
65
|
+
},
|
|
66
|
+
{
|
|
67
|
+
id: 'epson-tm-t20iii', manufacturer: 'Epson', model: 'TM-T20III', matchNames: ['TM-T20III'],
|
|
68
|
+
paperSizes: ['mm58', 'mm80'], nativeCharsPerLine: 48,
|
|
69
|
+
values: { paperSize: 'mm80', charsPerLine: 48, cut: 'partial', drawerKick: true, qrMode: 'escpos', codePage: 'CP1252' },
|
|
70
|
+
approval: { approved: false, deviceTest: null },
|
|
71
|
+
},
|
|
72
|
+
{
|
|
73
|
+
id: 'epson-tm-t88vi', manufacturer: 'Epson', model: 'TM-T88VI', matchNames: ['TM-T88VI'],
|
|
74
|
+
paperSizes: ['mm58'], nativeCharsPerLine: 42,
|
|
75
|
+
values: { paperSize: 'mm58', charsPerLine: 32, cut: 'partial', drawerKick: true, qrMode: 'escpos', codePage: 'CP1252' },
|
|
76
|
+
approval: { approved: false, deviceTest: null },
|
|
77
|
+
},
|
|
78
|
+
{
|
|
79
|
+
id: 'epson-tm-t88vii', manufacturer: 'Epson', model: 'TM-T88VII', matchNames: ['TM-T88VII'],
|
|
80
|
+
paperSizes: ['mm58'], nativeCharsPerLine: 42,
|
|
81
|
+
values: { paperSize: 'mm58', charsPerLine: 32, cut: 'partial', drawerKick: true, qrMode: 'escpos', codePage: 'CP1252' },
|
|
82
|
+
approval: { approved: false, deviceTest: null },
|
|
83
|
+
},
|
|
84
|
+
{
|
|
85
|
+
id: 'epson-tm-m10', manufacturer: 'Epson', model: 'TM-m10', matchNames: ['TM-M10'],
|
|
86
|
+
paperSizes: ['mm58'], nativeCharsPerLine: 35,
|
|
87
|
+
values: { paperSize: 'mm58', charsPerLine: 32, cut: 'partial', drawerKick: true, qrMode: 'escpos', codePage: 'CP1252' },
|
|
88
|
+
approval: { approved: false, deviceTest: null },
|
|
89
|
+
},
|
|
90
|
+
].map(eingefroren));
|
|
91
|
+
// ------------------------------------------------------------------ Normierung
|
|
92
|
+
/** Trenner im normierten Namen. */
|
|
93
|
+
const TRENNER = '-';
|
|
94
|
+
/** Ein Zeichen ausserhalb von ASCII, das weder Satzzeichen noch Leerraum ist. */
|
|
95
|
+
const FREMDES_ZEICHEN = /[^\x00-\x7F\p{P}\p{Z}]/u;
|
|
96
|
+
/**
|
|
97
|
+
* Grossbuchstaben und Teile, oder `null` fuer einen Namen mit fremdem Zeichen.
|
|
98
|
+
*
|
|
99
|
+
* Gefaltet wird nur `a-z` zu `A-Z`: `toUpperCase` machte aus „ı“ ein I und aus „ff“ ein FF und damit aus einem fremden
|
|
100
|
+
* Namen womoeglich einen bekannten. Steht danach ein Zeichen ausserhalb von ASCII, das weder Satzzeichen noch
|
|
101
|
+
* Leerraum ist (Ï, é, ®), gilt der Name als unbekannt. Jede Folge anderer Zeichen als `A-Z`/`0-9` wird ein Trenner,
|
|
102
|
+
* am Rand keiner; Leerzeichen, Bindestrich, Unterstrich, Klammer und geschuetzter Bindestrich gelten dabei gleich,
|
|
103
|
+
* damit „tm m30iii“, „TM-m30III“ und „(EPSON TM-m30III)“ (IPP `product`) denselben Namen ergeben.
|
|
104
|
+
*
|
|
105
|
+
* Der Trenner bleibt als ein Zeichen stehen, statt zu verschwinden: TM-T20II-i ist ein eigenes Modell und darf nicht
|
|
106
|
+
* TM-T20III werden. Das traegt nur, wo der Name einen Trenner hat; „TM-T20IIi“ ohne Bindestrich ist von TM-T20III
|
|
107
|
+
* nicht zu unterscheiden (Prueffall).
|
|
108
|
+
*/
|
|
109
|
+
function inTeilen(text) {
|
|
110
|
+
const gross = text.replace(/[a-z]/g, (c) => c.toUpperCase());
|
|
111
|
+
if (FREMDES_ZEICHEN.test(gross))
|
|
112
|
+
return null;
|
|
113
|
+
return gross.split(/[^A-Z0-9]+/).filter((t) => t !== '').join(TRENNER);
|
|
114
|
+
}
|
|
115
|
+
/**
|
|
116
|
+
* Die Hersteller eines Katalogs als Vorsilben (`EPSON-`), laengste zuerst: „Star Micronics“ muss vor „Star“ greifen.
|
|
117
|
+
* Aus den Eintraegen selbst, damit ein neuer Hersteller keine zweite Liste braucht. Gleich lange Vorsilben koennen
|
|
118
|
+
* nicht beide vor demselben Namen stehen, ihre Reihenfolge ist darum gleichgueltig.
|
|
119
|
+
*/
|
|
120
|
+
function herstellerVorsilben(catalog) {
|
|
121
|
+
const vorsilben = new Set();
|
|
122
|
+
for (const e of catalog) {
|
|
123
|
+
const hersteller = inTeilen(e.manufacturer);
|
|
124
|
+
if (hersteller)
|
|
125
|
+
vorsilben.add(hersteller + TRENNER);
|
|
126
|
+
}
|
|
127
|
+
return [...vorsilben].sort((a, b) => b.length - a.length);
|
|
128
|
+
}
|
|
129
|
+
/** [inTeilen], dann ohne die erste passende Vorsilbe; `null` ohne Namen oder mit fremdem Zeichen. */
|
|
130
|
+
function normiert(model, vorsilben) {
|
|
131
|
+
if (typeof model !== 'string')
|
|
132
|
+
return null;
|
|
133
|
+
const name = inTeilen(model);
|
|
134
|
+
if (!name)
|
|
135
|
+
return null;
|
|
136
|
+
const vorsilbe = vorsilben.find((v) => name.startsWith(v));
|
|
137
|
+
return vorsilbe === undefined ? name : name.slice(vorsilbe.length);
|
|
138
|
+
}
|
|
139
|
+
/**
|
|
140
|
+
* Normierter Modellname, die Hersteller aus `catalog`. `EPSON TM-m30III`, `TM-M30III` und `tm m30iii` ergeben
|
|
141
|
+
* `TM-M30III`; der Hersteller allein (`EPSON`) bleibt stehen.
|
|
142
|
+
*/
|
|
143
|
+
export function normalizePrinterModel(model, catalog = PRINTER_CATALOG) {
|
|
144
|
+
return normiert(model, herstellerVorsilben(catalog));
|
|
145
|
+
}
|
|
146
|
+
// ------------------------------------------------------------------ Erkennen
|
|
147
|
+
/**
|
|
148
|
+
* Der freigegebene Eintrag aus `catalog`, an dem `model` erkannt wird, sonst `null`. Ein nicht freigegebener Eintrag
|
|
149
|
+
* verhaelt sich wie ein unbekanntes Modell. Das Ergebnis ist eindeutig, weil kein Name in zwei Eintraegen steht
|
|
150
|
+
* (Prueffall `match_name_ambiguous`).
|
|
151
|
+
*/
|
|
152
|
+
export function findPrinterCatalogEntry(catalog, model) {
|
|
153
|
+
const name = normalizePrinterModel(model, catalog);
|
|
154
|
+
if (name === null)
|
|
155
|
+
return null;
|
|
156
|
+
return catalog.find((e) => e.approval.approved && e.matchNames.includes(name)) ?? null;
|
|
157
|
+
}
|
|
158
|
+
/**
|
|
159
|
+
* Der freigegebene Katalogeintrag zu einem Modellnamen, wie Connect ihn meldet (mDNS, `GS I`), oder `null` fuer ein
|
|
160
|
+
* unbekanntes Modell. Gross- und Kleinschreibung, ein vorangestelltes `EPSON` und die Art der Trenner zaehlen nicht.
|
|
161
|
+
* `undefined` ist erlaubt, weil Connect `model` im Fund weglaesst, wenn es keines kennt.
|
|
162
|
+
*/
|
|
163
|
+
export function printerCatalogEntry(model) {
|
|
164
|
+
return findPrinterCatalogEntry(PRINTER_CATALOG, model);
|
|
165
|
+
}
|
|
166
|
+
/** Was ein Eintrag beim Einrichten vorschlaegt; `drawerKick` wird zu `drawerEnabled`. */
|
|
167
|
+
export function printerCatalogSettings(entry) {
|
|
168
|
+
const { paperSize, codePage, cut, qrMode, drawerKick } = entry.values;
|
|
169
|
+
return {
|
|
170
|
+
device: { paperSize, codePage, cut, qrMode, drawerEnabled: drawerKick },
|
|
171
|
+
paperSizeNeedsCheck: entry.paperSizes.some((p) => p !== paperSize),
|
|
172
|
+
};
|
|
173
|
+
}
|
|
174
|
+
// ------------------------------------------------------------------ Pruefung
|
|
175
|
+
/**
|
|
176
|
+
* Was an einem Katalog nicht stimmt. Jeder Grund gehoert zu genau einem Feld des Eintrags, darum traegt ein Fund kein
|
|
177
|
+
* eigenes Feld. Reihenfolge = Reihenfolge der Pruefung je Eintrag.
|
|
178
|
+
*/
|
|
179
|
+
export const PRINTER_CATALOG_PROBLEM_REASONS = [
|
|
180
|
+
'duplicate_id',
|
|
181
|
+
'match_names_missing',
|
|
182
|
+
'match_name_not_normalized',
|
|
183
|
+
'match_name_ambiguous',
|
|
184
|
+
'model_not_matched',
|
|
185
|
+
'paper_sizes_invalid',
|
|
186
|
+
'paper_size_not_listed',
|
|
187
|
+
'paper_size_too_wide',
|
|
188
|
+
'cut_not_allowed',
|
|
189
|
+
'qr_mode_not_allowed',
|
|
190
|
+
'chars_per_line_mismatch',
|
|
191
|
+
'device_test_missing',
|
|
192
|
+
'device_test_incomplete',
|
|
193
|
+
];
|
|
194
|
+
/** Tag im Format `JJJJ-MM-TT`. */
|
|
195
|
+
const TAG = /^\d{4}-\d{2}-\d{2}$/;
|
|
196
|
+
/** Ein Geraetetest belegt den Eintrag ganz: Kopf ausgefuellt, jedes Wertfeld und jede Breite geprueft. */
|
|
197
|
+
const vollstaendig = (t, e) => TAG.test(t.date) && t.connectVersion !== '' && t.firmware !== '' && t.testedBy !== ''
|
|
198
|
+
&& PRINTER_CATALOG_VALUE_FIELDS.every((f) => t.checked.includes(f))
|
|
199
|
+
&& e.paperSizes.every((p) => t.checkedPaperSizes.includes(p));
|
|
200
|
+
/**
|
|
201
|
+
* Alle Funde in einem Katalog; leer = gueltig. Die einzige Stelle, an der die Regeln stehen. Der Test ruft sie fuer den
|
|
202
|
+
* ausgelieferten Katalog und die Prueffaelle; ein Fund macht ihn rot, statt zur Laufzeit still zu wirken.
|
|
203
|
+
*/
|
|
204
|
+
export function printerCatalogProblems(catalog) {
|
|
205
|
+
const probleme = [];
|
|
206
|
+
const vorsilben = herstellerVorsilben(catalog);
|
|
207
|
+
const ids = new Set();
|
|
208
|
+
/** Name -> Index des Eintrags, der ihn zuerst fuehrt. */
|
|
209
|
+
const namen = new Map();
|
|
210
|
+
catalog.forEach((e, index) => {
|
|
211
|
+
const melde = (reason) => { probleme.push({ id: e.id, reason }); };
|
|
212
|
+
if (ids.has(e.id))
|
|
213
|
+
melde('duplicate_id');
|
|
214
|
+
ids.add(e.id);
|
|
215
|
+
if (e.matchNames.length === 0)
|
|
216
|
+
melde('match_names_missing');
|
|
217
|
+
for (const name of e.matchNames) {
|
|
218
|
+
if (normiert(name, vorsilben) !== name)
|
|
219
|
+
melde('match_name_not_normalized');
|
|
220
|
+
const erster = namen.get(name);
|
|
221
|
+
if (erster === undefined)
|
|
222
|
+
namen.set(name, index);
|
|
223
|
+
else if (erster !== index)
|
|
224
|
+
melde('match_name_ambiguous');
|
|
225
|
+
}
|
|
226
|
+
// Der eigene Modellname muss den Eintrag finden; sonst passen Anzeige und Erkennung nicht zusammen (Tippfehler).
|
|
227
|
+
const eigenerName = normiert(e.model, vorsilben);
|
|
228
|
+
if (eigenerName === null || !e.matchNames.includes(eigenerName))
|
|
229
|
+
melde('model_not_matched');
|
|
230
|
+
// Eine feste Reihenfolge ohne Doppel haelt Vertrag und Vergleich eindeutig.
|
|
231
|
+
if (e.paperSizes.join() !== PAPER_SIZE.filter((p) => e.paperSizes.includes(p)).join())
|
|
232
|
+
melde('paper_sizes_invalid');
|
|
233
|
+
if (!e.paperSizes.includes(e.values.paperSize))
|
|
234
|
+
melde('paper_size_not_listed');
|
|
235
|
+
// Eine Breite, deren Layout mehr Zeichen setzt, als der Drucker hat, bricht jede Zeile um (TM-T88: 48 auf 42).
|
|
236
|
+
if (e.paperSizes.some((p) => CHARS_PER_PAPER_SIZE[p] > e.nativeCharsPerLine))
|
|
237
|
+
melde('paper_size_too_wide');
|
|
238
|
+
// Die Typen schliessen beides schon aus; die Pruefung gilt Daten, die als JSON kommen (Prueffaelle des Vertrags).
|
|
239
|
+
if (!PRINTER_CATALOG_CUTS.includes(e.values.cut))
|
|
240
|
+
melde('cut_not_allowed');
|
|
241
|
+
if (!PRINTER_CATALOG_QR_MODES.includes(e.values.qrMode))
|
|
242
|
+
melde('qr_mode_not_allowed');
|
|
243
|
+
if (CHARS_PER_PAPER_SIZE[e.values.paperSize] !== e.values.charsPerLine)
|
|
244
|
+
melde('chars_per_line_mismatch');
|
|
245
|
+
const test = e.approval.deviceTest;
|
|
246
|
+
if (e.approval.approved && test === null)
|
|
247
|
+
melde('device_test_missing');
|
|
248
|
+
if (test !== null && !vollstaendig(test, e))
|
|
249
|
+
melde('device_test_incomplete');
|
|
250
|
+
});
|
|
251
|
+
return probleme;
|
|
252
|
+
}
|
package/dist/esm/pos/index.d.ts
CHANGED
|
@@ -18,6 +18,7 @@ export { POS_ERROR_CODES, type PosErrorCode, isPosErrorCode, posErrorCode, isPos
|
|
|
18
18
|
export { distributeDiscount } from '../receipt/discount.js';
|
|
19
19
|
export { cancelScopeOf, receiptsScopeOf, stockViewOf, voucherPermsOf, depositReturnOf, type VoucherPerms, type RegisterScope, type RegisterUserPerms } from '../register/pairing.js';
|
|
20
20
|
export { type NetworkPrinter, type PrintJob, type PrintJobStatus, PRINT_JOB_STATUSES, type PrintJobSource, PRINT_JOB_SOURCES, isPrintJobFinished, type CreatePrintJobOptions, listMyPrinters, createPrintJob, getPrintJob, } from './drucker.js';
|
|
21
|
+
export { type PrinterCatalogEntry, type PrinterCatalogValues, type PrinterCatalogValueField, type PrinterCatalogApproval, type PrinterDeviceTest, type PrinterCatalogSettings, type PrinterCatalogDeviceSettings, type PrinterCatalogCut, type PrinterCatalogQrMode, printerCatalogEntry, printerCatalogSettings, } from './drucker-katalog.js';
|
|
21
22
|
export { listMyTipRecipients } from './trinkgeld.js';
|
|
22
23
|
export { posDiscountPresets, discountPresetChipText, discountChipsFromPresets, checkDiscountPresets, discountBlockLines, INVALID_DISCOUNT_PRESET, DISCOUNT_PRESETS_MAX, DISCOUNT_PRESET_NAME_MAX, DISCOUNT_PRESET_PERCENT_BP, DISCOUNT_PRESET_AMOUNT_CENTS, DISCOUNT_PRESET_MESSAGES, type DiscountPresetReason, type DiscountPresetError, type DiscountPresetsCheck, type DiscountBlockLine, type DiscountTotal, } from './rabatt-vorlagen.js';
|
|
23
24
|
export { depFolderName } from './dep.js';
|
package/dist/esm/pos/index.js
CHANGED
|
@@ -23,6 +23,9 @@ export { distributeDiscount } from '../receipt/discount.js';
|
|
|
23
23
|
// Register-Unterpfad: dessen Exportnamen sind 1:1 Function-Namen (Rewrites).
|
|
24
24
|
export { cancelScopeOf, receiptsScopeOf, stockViewOf, voucherPermsOf, depositReturnOf } from '../register/pairing.js';
|
|
25
25
|
export { PRINT_JOB_STATUSES, PRINT_JOB_SOURCES, isPrintJobFinished, listMyPrinters, createPrintJob, getPrintJob, } from './drucker.js';
|
|
26
|
+
// Druckerkatalog (Connect-Einrichtung mit einem Klick): Normierung, Pruefung und der Katalog selbst bleiben im Modul,
|
|
27
|
+
// nach aussen gehen nur das Erkennen und die vorgeschlagenen Einstellungen.
|
|
28
|
+
export { printerCatalogEntry, printerCatalogSettings, } from './drucker-katalog.js';
|
|
26
29
|
export { listMyTipRecipients } from './trinkgeld.js';
|
|
27
30
|
export { posDiscountPresets, discountPresetChipText, discountChipsFromPresets, checkDiscountPresets, discountBlockLines, INVALID_DISCOUNT_PRESET, DISCOUNT_PRESETS_MAX, DISCOUNT_PRESET_NAME_MAX, DISCOUNT_PRESET_PERCENT_BP, DISCOUNT_PRESET_AMOUNT_CENTS, DISCOUNT_PRESET_MESSAGES, } from './rabatt-vorlagen.js';
|
|
28
31
|
// Prüfung (DEP) an der Kasse: Ordner auf dem USB-Stick (gleich in Web-Kasse und Kassen-App).
|
package/dist/esm/version.d.ts
CHANGED
package/dist/esm/version.js
CHANGED
package/fixtures/pos-texts.json
CHANGED