@kreiseck/kasseneck-api 0.13.2 → 0.15.0

package/dist/cjs/rechnung/vertrag.js

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * Der Vertrag der Rechnungs-API — als Daten, nicht als Prosa.
+ *
+ * Aus dieser Datei entstehen drei Dinge, damit sie nicht auseinanderlaufen
+ * koennen:
+ *
+ * 1. `fixtures/rechnung-api.schema.json` (`npm run fixtures:rechnung`) — das
+ *    Backend liest es aus dem vendorierten Paket und vergleicht es in beide
+ *    Richtungen mit seiner eigenen Pruefung; der Dart-Zwilling zieht es byteweise.
+ * 2. Die Listen unter `rechnung` in `fixtures/oberflaeche.json` (Codes, Gruende,
+ *    Enums) — ueber denselben Namensraum-Scan wie der Partner-Teil.
+ * 3. Die TypeScript-Typen in `typen.ts`.
+ *
+ * Nach aussen spricht die Schnittstelle Englisch: Feldnamen, Codes, Gruende.
+ * Deutsch bleibt, was ein Mensch liest (`message`, der Aufdruck eines Grundes).
+ *
+ * Beschrieben wird die Anfrage. Was der Server daraus macht — Rechnungsdatum,
+ * Nummer, Summen — ist bewusst **nicht** setzbar.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RECHNUNG_MINDESTENS_EINS = exports.RECHNUNG_GENAU_EINS = exports.RECHNUNG_ANFRAGEN = exports.POSITION_FELDER = exports.KUNDE_FELDER = exports.EINVOICE_FORMATS = exports.DOC_TYPES = exports.INVOICE_LIST_STATUS = exports.CUSTOMER_TYPES = exports.VAT_RATES = exports.PRICE_MODES = exports.TAX_SCHEMES = exports.CREDIT_NOTE_REASONS = exports.INVOICE_ERROR_CODES = exports.RECHNUNG_AUFRUFE = exports.RECHNUNG_VERTRAG_VERSION = void 0;
+exports.RECHNUNG_VERTRAG_VERSION = 1;
+exports.RECHNUNG_AUFRUFE = [
+    'createCustomer',
+    'getCustomer',
+    'updateCustomer',
+    'searchCustomers',
+    'issueInvoice',
+    'cancelInvoice',
+    'createCreditNote',
+    'getInvoice',
+    'listInvoices',
+    'getInvoicePdf',
+    'getInvoiceXml',
+];
+/**
+ * Stabile Fehlercodes. Das Fremdsystem verzweigt am Code, der Text darf sich
+ * aendern. `validation` traegt zusaetzlich `errors: [{ field, message }]`.
+ */
+exports.INVOICE_ERROR_CODES = [
+    'validation',
+    'idempotency_conflict',
+    'module_inactive',
+    'customer_not_found',
+    'customer_exists',
+    'short_code_taken',
+    'short_code_immutable',
+    'recipient_required',
+    'invoice_requirements_missing',
+    'invoice_not_found',
+    'invoice_ambiguous',
+    'not_cancellable',
+    'partial_credit_exists',
+    'credit_exceeds_invoice',
+    'einvoice_incomplete',
+];
+/** Gruende einer Gutschrift. Der Server druckt den deutschen Anzeigetext. */
+exports.CREDIT_NOTE_REASONS = [
+    'cancellation',
+    'price_reduction',
+    'return',
+    'incorrect_invoice',
+    'other',
+];
+exports.TAX_SCHEMES = ['normal', 'smallBusiness', 'reverseCharge', 'igLieferung', 'exportThirdCountry'];
+exports.PRICE_MODES = ['net', 'gross'];
+exports.VAT_RATES = [0, 10, 13, 20];
+exports.CUSTOMER_TYPES = ['private', 'company'];
+exports.INVOICE_LIST_STATUS = ['final', 'paid', 'cancelled', 'open', 'overdue'];
+exports.DOC_TYPES = ['RE', 'GU'];
+exports.EINVOICE_FORMATS = ['ubl', 'cii'];
+const text = (max, pflicht = false, extra = {}) => ({ typ: 'string', pflicht, max, ...(pflicht && extra.min === undefined ? { min: 1 } : {}), ...extra });
+const idempotencyKey = (pflicht) => ({ typ: 'string', pflicht, min: 1, max: 120 });
+const id = { typ: 'string', pflicht: false, min: 1, max: 128 };
+const idPflicht = { typ: 'string', pflicht: true, min: 1, max: 128 };
+const datum = (pflicht = false) => ({ typ: 'string', pflicht, min: 10, max: 10, format: 'date' });
+const limit = { typ: 'integer', pflicht: false, min: 1, max: 100 };
+const cursor = { typ: 'string', pflicht: false, min: 1, max: 500 };
+/** Kunde, wie das Fremdsystem ihn schickt. `vatId` ist die UID-Nummer. */
+exports.KUNDE_FELDER = Object.freeze({
+    type: { typ: 'enum', pflicht: true, werte: exports.CUSTOMER_TYPES },
+    name: text(200, true),
+    legalForm: text(40),
+    email: text(254, false, { format: 'email' }),
+    phone: text(40, false, { format: 'phone' }),
+    street: text(200),
+    houseNumber: text(20),
+    zip: text(10),
+    city: text(100),
+    country: text(2, true, { min: 2, format: 'country' }),
+    vatId: text(20, false, { format: 'vatId' }),
+    shortCode: text(8, false, { format: 'shortCode' }),
+    isAuthority: { typ: 'boolean', pflicht: false },
+    note: text(1000),
+    externalId: { typ: 'string', pflicht: false, min: 1, max: 120 },
+});
+/** Beim Aendern ist jedes Kundenfeld optional. */
+const KUNDE_PATCH = Object.freeze(Object.fromEntries(Object.entries(exports.KUNDE_FELDER).map(([name, feld]) => [name, { ...feld, pflicht: false }])));
+/** Eine Rechnungs- oder Gutschriftsposition. Preise in ganzen Cent. */
+exports.POSITION_FELDER = Object.freeze({
+    description: text(300, true),
+    subtitle: text(1000),
+    quantity: { typ: 'number', pflicht: true, min: 0, exklusivMin: true, max: 1_000_000, nachkomma: 3 },
+    unit: text(20),
+    unitPriceCents: { typ: 'integer', pflicht: true, min: 0, max: 100_000_000 },
+    vatRate: { typ: 'enum', pflicht: true, werte: exports.VAT_RATES },
+    discountPct: { typ: 'number', pflicht: false, min: 0, max: 100, nachkomma: 2 },
+});
+const positionen = { typ: 'list', pflicht: true, min: 1, max: 500, eintrag: { typ: 'object', pflicht: true, felder: exports.POSITION_FELDER } };
+exports.RECHNUNG_ANFRAGEN = Object.freeze({
+    createCustomer: {
+        customer: { typ: 'object', pflicht: true, felder: exports.KUNDE_FELDER },
+        idempotencyKey: idempotencyKey(false),
+    },
+    getCustomer: {
+        customerId: id,
+        externalId: { typ: 'string', pflicht: false, min: 1, max: 120 },
+    },
+    updateCustomer: {
+        customerId: idPflicht,
+        customer: { typ: 'object', pflicht: true, felder: KUNDE_PATCH },
+    },
+    searchCustomers: {
+        externalId: { typ: 'string', pflicht: false, min: 1, max: 120 },
+        vatId: text(20),
+        email: text(254),
+        name: text(200),
+        limit,
+        cursor,
+    },
+    issueInvoice: {
+        idempotencyKey: idempotencyKey(true),
+        customerId: id,
+        taxScheme: { typ: 'enum', pflicht: true, werte: exports.TAX_SCHEMES },
+        priceMode: { typ: 'enum', pflicht: true, werte: exports.PRICE_MODES },
+        serviceStart: datum(true),
+        serviceEnd: datum(),
+        paymentTermDays: { typ: 'integer', pflicht: false, min: 0, max: 365 },
+        orderReference: text(200),
+        intro: text(2000),
+        note: text(2000),
+        paymentReference: text(140),
+        girocode: { typ: 'boolean', pflicht: false },
+        tracking: { typ: 'boolean', pflicht: false },
+        items: positionen,
+        metadata: { typ: 'map', pflicht: false, maxSchluessel: 20, schluesselMuster: '^[a-zA-Z0-9_]{1,40}$', wertMax: 500 },
+    },
+    cancelInvoice: {
+        idempotencyKey: idempotencyKey(true),
+        invoiceId: idPflicht,
+        reason: { typ: 'enum', pflicht: true, werte: exports.CREDIT_NOTE_REASONS },
+        note: text(2000),
+    },
+    createCreditNote: {
+        idempotencyKey: idempotencyKey(true),
+        invoiceId: idPflicht,
+        reason: { typ: 'enum', pflicht: true, werte: exports.CREDIT_NOTE_REASONS },
+        note: text(2000),
+        items: positionen,
+    },
+    getInvoice: {
+        invoiceId: id,
+        number: { typ: 'string', pflicht: false, min: 1, max: 100 },
+    },
+    listInvoices: {
+        from: datum(),
+        to: datum(),
+        status: { typ: 'enum', pflicht: false, werte: exports.INVOICE_LIST_STATUS },
+        docType: { typ: 'enum', pflicht: false, werte: exports.DOC_TYPES },
+        customerId: id,
+        limit,
+        cursor,
+    },
+    getInvoicePdf: {
+        invoiceId: idPflicht,
+    },
+    getInvoiceXml: {
+        invoiceId: idPflicht,
+        format: { typ: 'enum', pflicht: false, werte: exports.EINVOICE_FORMATS },
+    },
+});
+/** Genau eines dieser Felder muss gesetzt sein (je Aufruf, je Gruppe). */
+exports.RECHNUNG_GENAU_EINS = Object.freeze({
+    getCustomer: [['customerId', 'externalId']],
+    getInvoice: [['invoiceId', 'number']],
+});
+/** Mindestens eines dieser Felder muss gesetzt sein (je Aufruf, je Gruppe). */
+exports.RECHNUNG_MINDESTENS_EINS = Object.freeze({
+    searchCustomers: [['externalId', 'vatId', 'email', 'name']],
+});

package/dist/esm/client/aufrufe.d.ts

@@ -13,7 +13,7 @@
  * umhuellt, muss ihn weiterhin absetzen koennen.
  */
 import type { TransportBodyFields } from './transport.js';
-export declare const AUFRUFE: readonly ["activateCashregister", "cancelReceipt", "createCustomerCashregister", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCustomerCredentials", "getCustomerSignatureStatus", "getFirstReceiptDate", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "hobexPayApi", "hobexRefundApi", "listCustomerCashregisters", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "requestCustomerSignature", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updatePartnerWebhook"];
+export declare const AUFRUFE: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "requestCustomerSignature", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook"];
 export type Aufruf = typeof AUFRUFE[number];
 /** Wie [KasseneckTransport], nur mit bekanntem Aufrufnamen. Nicht exportiert nach aussen. */
 export type InternerTransport = <T = unknown>(functionName: Aufruf, params?: Record<string, unknown>, extraBodyFields?: TransportBodyFields, secretParams?: readonly string[]) => Promise<T>;

package/dist/esm/client/aufrufe.js

@@ -1,6 +1,9 @@
 export const AUFRUFE = [
     'activateCashregister',
+    'cancelInvoice',
     'cancelReceipt',
+    'createCreditNote',
+    'createCustomer',
     'createCustomerCashregister',
     'createPartnerCustomer',
     'checkPartnerCustomerEmail',
@@ -14,9 +17,13 @@ export const AUFRUFE = [
     'endRegisterSession',
     'financeWebService',
     'generateFullReceiptId',
+    'getCustomer',
     'getCustomerCredentials',
     'getCustomerSignatureStatus',
     'getFirstReceiptDate',
+    'getInvoice',
+    'getInvoicePdf',
+    'getInvoiceXml',
     'getKasseSettings',
     'getPartnerCustomer',
     'getPartnerInfo',
@@ -24,7 +31,9 @@ export const AUFRUFE = [
     'getReceipt',
     'hobexPayApi',
     'hobexRefundApi',
+    'issueInvoice',
     'listCustomerCashregisters',
+    'listInvoices',
     'listMyArticleGroups',
     'listMyArticles',
     'listMyCashregisters',
@@ -41,6 +50,7 @@ export const AUFRUFE = [
     'registerUserLogin',
     'renewRegisterSession',
     'requestCustomerSignature',
+    'searchCustomers',
     'sendPartnerCustomerFonLink',
     'sendPartnerWebhookTest',
     'sendReceiptEmail',
@@ -49,5 +59,6 @@ export const AUFRUFE = [
     'stripeCaptureIntent',
     'unpairRegisterDevice',
     'rotatePartnerWebhookSecret',
+    'updateCustomer',
     'updatePartnerWebhook',
 ];

package/dist/esm/client/receipts.d.ts

@@ -2,6 +2,7 @@ import { ReceiptType, type ReceiptTypeKey, KeckPaymentMethod, type KeckPaymentMe
 import { type Receipt, type ReceiptCompany, type ReceiptItem, type Voucher, type ReceiptSummary, type ReportMonth, type CancellationItem, type CancellationOf, type CancellationReason } from '../models/index.js';
 import type { InternerTransport } from './aufrufe.js';
 import type { Pruefangaben, ReceiptLayout } from '../receipt/layout.js';
+import type { LogoStufe } from '../receipt/blatt.js';
 /**
  * Beleg-Endpunkte — Zwilling der Beleg-Aufrufe in
  * kasseneck_api/lib/kasseneck_api.dart.
@@ -168,6 +169,12 @@ export interface ReceiptWithCompany {
      * fuer Clients, die das Layout selbst bauen; null bei altem Backend.
      */
     pruefangaben: Pruefangaben | null;
+    /**
+     * Groesse des Firmenlogos am Beleg (Kasse-Einstellung `logoSkala` des
+     * Betriebs). Bildschirm, Bon und PDF setzen das Logo in genau dieser Stufe;
+     * liefert das Backend sie nicht (alt), gilt `M` -- der Bestandswert.
+     */
+    logoStufe: LogoStufe;
 }
 /**
  * Gemeinsame Umsetzung aller Belegarten (Zwilling von `_createReceipt`).

package/dist/esm/client/receipts.js

@@ -567,5 +567,6 @@ function belegMitFirmaAusHuelle(daten, functionName) {
         kopfId: typeof d.kopfId === 'string' ? d.kopfId : null,
         layout,
         pruefangaben: pa ? { karteRegistriertAm: text(pa.karteRegistriertAm), kasseRegistriertAm: text(pa.kasseRegistriertAm) } : null,
+        logoStufe: d.logo_skala === 'S' || d.logo_skala === 'M' || d.logo_skala === 'L' || d.logo_skala === 'XL' ? d.logo_skala : 'M',
     };
 }

package/dist/esm/kasse/drucker.d.ts

@@ -1,5 +1,6 @@
 import type { InternerTransport } from '../client/aufrufe.js';
 import type { ReceiptLayout } from '../receipt/layout.js';
+import type { DruckLogo } from '../receipt/layout-escpos.js';
 /**
  * Netzwerk-Bondrucker ueber Epson "Server Direct Print": das Backend fuehrt
  * je Konto Drucker mit einer geheimen Abhol-URL; die Kasse legt Druckjobs
@@ -46,6 +47,10 @@ export interface CreatePrintJobOptions {
     receiptId?: string;
     titel?: string;
     quelle?: string;
+    /** Firmenlogo als fertiges Rasterbild (`logoRaster`); der Server dekodiert keine Bilder. */
+    logo?: DruckLogo | null;
+    /** "erstellt mit Kasseneck" am Ende (Konto-Flag `kreiseck_logo`). */
+    marke?: boolean;
 }
 export declare function createPrintJob(rufen: InternerTransport, o: CreatePrintJobOptions): Promise<DruckJob>;
 export declare function getPrintJob(rufen: InternerTransport, o: {

package/dist/esm/kasse/drucker.js

@@ -1,3 +1,4 @@
+import { rasterZeilenBase64 } from '../printing/index.js';
 const text = (v) => (typeof v === 'string' && v ? v : null);
 const zahl = (v) => (typeof v === 'number' && Number.isFinite(v) ? v : null);
 export async function listMyPrinters(rufen) {
@@ -22,6 +23,14 @@ export async function createPrintJob(rufen, o) {
         params.titel = o.titel;
     if (o.quelle)
         params.quelle = o.quelle;
+    if (o.logo) {
+        params.logo = {
+            stufe: o.logo.stufe, pxBreite: o.logo.pxBreite, pxHoehe: o.logo.pxHoehe,
+            breite: o.logo.raster.breite, hoehe: o.logo.raster.hoehe, zeilen: rasterZeilenBase64(o.logo.raster),
+        };
+    }
+    if (o.marke === true)
+        params.marke = true;
     const daten = await rufen('createPrintJob', params);
     return { jobId: String(daten?.jobId ?? ''), status: text(daten?.status) ?? 'offen', ergebnis: null };
 }

package/dist/esm/kasse/settings.js

@@ -112,8 +112,11 @@ export const KASSE_TASTEN_STANDARD = Object.freeze({
     korbLeeren: ['Mod+C'],
 });
 export const KASSE_BETRIEB_STANDARD = Object.freeze({
-    // Petrol aus der Markenpalette ("Ecke, Aktion") — nicht das alte Blau.
-    logoText: 'K', logoAn: true, logoGroesse: 'M', wasserzeichen: 'anmeldung', farbe: '#116B6B',
+    // Das Petrol der Marke: die Aktionsfarbe des Design-Systems (Rolle `brand`).
+    // Stand bis September 2026 auf dem Wert des alten Markenhandbuchs,
+    // der um 0,07 in OKLab danebenlag. Unsichtbar, aber es war die letzte Stelle
+    // im Haus, an der eine zweite Zahl fuer dieselbe Farbe stand.
+    logoText: 'K', logoAn: true, logoGroesse: 'M', wasserzeichen: 'anmeldung', farbe: '#136B6B',
     stil: 'klar', schrift: 'M', schriftEinst: 'S', kachelstil: 'streifen', uhr: true,
     sperrbild: true, foto: true, autoAbMin: 0, abNachVerkauf: false, schnellLogin: true,
     preisAnzeigen: true, ustAnzeigen: false, emoji: true, katFarben: true, freiErlaubt: true,

package/dist/esm/printing/escpos.d.ts

@@ -24,8 +24,9 @@
  * CP437-Plaetze umkodiert (ä = 0x84, ü = 0x81, ß = 0xE1, ...). Zeichen ohne
  * CP437-Platz werden zu `?` — weiterhin ein Byte je Zeichen.
  *
- * Nicht enthalten (bewusst): Rasterbilder/Logos, Capability-Profile einzelner
- * Druckermodelle, Kassenlade, 1D-Barcodes.
+ * Nicht enthalten (bewusst): Bilddekodierung (PNG/JPEG liest die Huelle),
+ * Capability-Profile einzelner Druckermodelle, Kassenlade, 1D-Barcodes.
+ * Fertige einfarbige Rasterbilder (Logo) gehen ueber [escPosRasterBild].
  */
 import { type QrModulGroesse } from './qr-groesse.js';
 /** Papierbreite der Bonrolle. */
@@ -103,6 +104,7 @@ export interface EscPosQrOptions {
      * die Regel in `qr-groesse.ts`.
      */
     size?: QrSize;
+    /** Fehlerkorrektur; Vorgabe `M` wie auf allen Druckwegen (siehe `qrCodeBytes`). */
     correction?: QrCorrection;
     /** Deckel fuer die gerechnete Modulgroesse; wirkungslos neben `size`. */
     groesse?: QrModulGroesse;
@@ -255,6 +257,12 @@ export declare function escPosRow(doc: EscPosDocument, columns: readonly PosColu
  * es wird kein Bild uebertragen.
  *
  * Bei Kasseneck-Belegen steht hier der maschinenlesbare RKSV-Code.
+ *
+ * Fehlerkorrektur ohne Angabe: **M** (bis 0.13: L). Die Groessenrechnung
+ * (`qrModulAnzahl`), das Blatt (Anteil am Bildschirm und im PDF), der
+ * ePOS-Weg (`level_m`) und der Bildweg rechnen alle mit M — druckte der
+ * native Befehl mit L, kaeme fuer manche Nutzlasten ein kleineres Symbol
+ * heraus als der Bildschirm zeigt.
  */
 export declare function qrCodeBytes(text: string, options?: {
     size?: QrSize;
@@ -266,8 +274,8 @@ export declare function qrCodeBytes(text: string, options?: {
  * **gerechneter** Modulgroesse, sofern `options.size` sie nicht festlegt.
  *
  * Ohne `size` entscheidet die Regel aus `qr-groesse.ts`: so gross wie
- * moeglich, gedeckelt durch `options.groesse` (Vorgabe `auto` = der
- * Bestandswert 4 dieses Pakets). Passt das Symbol auch mit der
+ * moeglich, gedeckelt durch `options.groesse` (Vorgabe `auto` = hoechstens 6
+ * Punkte je Modul, wie im Flutter-Zwilling). Passt das Symbol auch mit der
  * Ausnahmegroesse nicht aufs Papier, geht **kein** QR-Befehl hinaus und
  * `doc.qrFehler` sagt warum: der Drucker schneidet ein zu breites Symbol
  * nicht ab, er laesst es weg — ein Befehl, von dem man weiss, dass er nichts
@@ -300,4 +308,30 @@ export declare function qrRasterPunkte(paperSize: PosPaperSize, moduleAnzahl: nu
     groesse?: QrModulGroesse;
     ruhezoneModule?: number;
 }): number;
+/**
+ * Einfarbiges Rasterbild in Druckpunkten, zeilenweise: `punkte[y * breite + x]`,
+ * 1 = schwarz. Entsteht fuer das Firmenlogo in `logoRaster` (receipt/bild.ts).
+ */
+export interface RasterBild {
+    readonly breite: number;
+    readonly hoehe: number;
+    readonly punkte: Uint8Array;
+}
+/** Die Rasterzeilen als Bytes: MSB zuerst, jede Zeile auf volle Bytes aufgefuellt. */
+export declare function rasterZeilenBytes(bild: RasterBild): Uint8Array;
+/**
+ * Die Rasterzeilen als Base64 -- ohne Buffer, laeuft im Browser und in Node.
+ * Eine Stelle fuer ePOS-`<image>` und den Druckjob an den Server.
+ */
+export declare function rasterZeilenBase64(bild: RasterBild): string;
+/**
+ * Ein Rasterbild (`GS v 0`) -- das Firmenlogo am Bon.
+ *
+ * Anders als `escPosQrRaster` folgt KEIN Zeilenvorschub: `GS v 0` schiebt das
+ * Papier um die Bildhoehe, ein LF danach waere eine zusaetzliche Leerzeile,
+ * die Bildschirm und PDF nicht haben. Die Luft um das Logo kommt aus dem Blatt.
+ */
+export declare function escPosRasterBild(doc: EscPosDocument, bild: RasterBild, options?: {
+    align?: PosAlign;
+}): void;
 export {};

package/dist/esm/printing/escpos.js

@@ -24,8 +24,9 @@
  * CP437-Plaetze umkodiert (ä = 0x84, ü = 0x81, ß = 0xE1, ...). Zeichen ohne
  * CP437-Platz werden zu `?` — weiterhin ein Byte je Zeichen.
  *
- * Nicht enthalten (bewusst): Rasterbilder/Logos, Capability-Profile einzelner
- * Druckermodelle, Kassenlade, 1D-Barcodes.
+ * Nicht enthalten (bewusst): Bilddekodierung (PNG/JPEG liest die Huelle),
+ * Capability-Profile einzelner Druckermodelle, Kassenlade, 1D-Barcodes.
+ * Fertige einfarbige Rasterbilder (Logo) gehen ueber [escPosRasterBild].
  */
 import { QR_DRUCK_PUNKTE, QR_MINDEST_PUNKTE, QR_MODUL_DECKEL, QR_RUHEZONE_MODULE, qrGroesseFuer, } from './qr-groesse.js';
 // -------------------------------------------------------------- Befehlsbytes
@@ -581,13 +582,19 @@ export function escPosRow(doc, columns) {
  * es wird kein Bild uebertragen.
  *
  * Bei Kasseneck-Belegen steht hier der maschinenlesbare RKSV-Code.
+ *
+ * Fehlerkorrektur ohne Angabe: **M** (bis 0.13: L). Die Groessenrechnung
+ * (`qrModulAnzahl`), das Blatt (Anteil am Bildschirm und im PDF), der
+ * ePOS-Weg (`level_m`) und der Bildweg rechnen alle mit M — druckte der
+ * native Befehl mit L, kaeme fuer manche Nutzlasten ein kleineres Symbol
+ * heraus als der Bildschirm zeigt.
  */
 export function qrCodeBytes(text, options = {}) {
     const size = options.size ?? 4;
     if (!istGanzzahl(size) || size < 1 || size > 8) {
         throw new Error('QR-Modulgroesse muss eine Ganzzahl im Bereich 1..8 sein');
     }
-    const correction = options.correction ?? 'L';
+    const correction = options.correction ?? 'M';
     const stufe = QR_KORREKTUR[correction];
     if (stufe === undefined) {
         throw new Error(`Unbekannte QR-Fehlerkorrektur: ${String(correction)}`);
@@ -628,8 +635,8 @@ export function qrCodeBytes(text, options = {}) {
  * **gerechneter** Modulgroesse, sofern `options.size` sie nicht festlegt.
  *
  * Ohne `size` entscheidet die Regel aus `qr-groesse.ts`: so gross wie
- * moeglich, gedeckelt durch `options.groesse` (Vorgabe `auto` = der
- * Bestandswert 4 dieses Pakets). Passt das Symbol auch mit der
+ * moeglich, gedeckelt durch `options.groesse` (Vorgabe `auto` = hoechstens 6
+ * Punkte je Modul, wie im Flutter-Zwilling). Passt das Symbol auch mit der
  * Ausnahmegroesse nicht aufs Papier, geht **kein** QR-Befehl hinaus und
  * `doc.qrFehler` sagt warum: der Drucker schneidet ein zu breites Symbol
  * nicht ab, er laesst es weg — ein Befehl, von dem man weiss, dass er nichts
@@ -714,9 +721,10 @@ export function escPosQrRaster(doc, matrix, options = {}) {
     if (!istGanzzahl(punkte) || punkte < 1) {
         throw new Error('punkteJeModul muss eine Ganzzahl >= 1 sein');
     }
+    // Modulraster (samt Ruhezone) auf Druckpunkte skaliert -- dieselbe Bitquelle
+    // wie das Logo, nur aus einem QR-Modul-Bool statt aus Graustufen gewonnen.
     const breite = gesamtModule * punkte;
-    const byteJeZeile = Math.ceil(breite / 8);
-    const daten = new Uint8Array(byteJeZeile * breite);
+    const bildpunkte = new Uint8Array(breite * breite);
     for (let y = 0; y < breite; y++) {
         const modulY = Math.floor(y / punkte) - ruhezone;
         if (modulY < 0 || modulY >= module)
@@ -728,18 +736,14 @@ export function escPosQrRaster(doc, matrix, options = {}) {
                 continue;
             if (zeile[modulX] !== true)
                 continue;
-            const i = y * byteJeZeile + (x >> 3);
-            daten[i] = daten[i] | (0x80 >> (x & 7));
+            bildpunkte[y * breite + x] = 1;
         }
     }
+    const daten = rasterZeilenBytes({ breite, hoehe: breite, punkte: bildpunkte });
     escPosSetStyles(doc, { align: options.align ?? 'center' });
     // GS v 0 m xL xH yL yH d1...dk — m = 0: normale Dichte, 1:1.
-    anhaengen(doc, [
-        GS, 0x76, 0x30, 0x00,
-        byteJeZeile & 0xff, (byteJeZeile >> 8) & 0xff,
-        breite & 0xff, (breite >> 8) & 0xff,
-        ...daten,
-    ]);
+    anhaengen(doc, rasterBildKopf(breite, breite));
+    anhaengen(doc, daten);
     anhaengen(doc, [ZEILENUMBRUCH]);
     if ((options.align ?? 'center') !== 'left') {
         escPosSetStyles(doc, { align: 'left' });
@@ -755,3 +759,68 @@ export function qrRasterPunkte(paperSize, moduleAnzahl, options = {}) {
     const deckel = QR_MODUL_DECKEL[options.groesse ?? 'auto'];
     return Math.max(1, Math.min(deckel, Math.floor(QR_DRUCK_PUNKTE[paperSize] / (moduleAnzahl + 2 * ruhezone))));
 }
+/** Die Rasterzeilen als Bytes: MSB zuerst, jede Zeile auf volle Bytes aufgefuellt. */
+export function rasterZeilenBytes(bild) {
+    if (!istGanzzahl(bild.breite) || bild.breite < 1 || !istGanzzahl(bild.hoehe) || bild.hoehe < 1) {
+        throw new Error('Rasterbild ohne gueltiges Mass');
+    }
+    if (bild.punkte.length !== bild.breite * bild.hoehe)
+        throw new Error('Rasterbild: Punkte passen nicht zum Mass');
+    const byteJeZeile = Math.ceil(bild.breite / 8);
+    const daten = new Uint8Array(byteJeZeile * bild.hoehe);
+    for (let y = 0; y < bild.hoehe; y++) {
+        for (let x = 0; x < bild.breite; x++) {
+            if (bild.punkte[y * bild.breite + x] !== 1)
+                continue;
+            const i = y * byteJeZeile + (x >> 3);
+            daten[i] = daten[i] | (0x80 >> (x & 7));
+        }
+    }
+    return daten;
+}
+/**
+ * Die Rasterzeilen als Base64 -- ohne Buffer, laeuft im Browser und in Node.
+ * Eine Stelle fuer ePOS-`<image>` und den Druckjob an den Server.
+ */
+export function rasterZeilenBase64(bild) {
+    const bytes = rasterZeilenBytes(bild);
+    let binaer = '';
+    for (let i = 0; i < bytes.length; i += 0x8000) {
+        binaer += String.fromCharCode(...bytes.subarray(i, i + 0x8000));
+    }
+    return btoa(binaer);
+}
+/**
+ * Der `GS v 0`-Kopf (Byte-Breite, Zeilenhoehe) -- die Rasterzeilen selbst
+ * haengt der Aufrufer an. Gemeinsame Rahmung fuer das Logo (`escPosRasterBild`)
+ * und den QR-Bildweg (`escPosQrRaster`): beide drucken dasselbe Bildkommando,
+ * nur mit unterschiedlichem Nachlauf (Zeilenvorschub ja/nein).
+ */
+function rasterBildKopf(breite, hoehe) {
+    const byteJeZeile = Math.ceil(breite / 8);
+    return [GS, 0x76, 0x30, 0x00, byteJeZeile & 0xff, (byteJeZeile >> 8) & 0xff, hoehe & 0xff, (hoehe >> 8) & 0xff];
+}
+/**
+ * Ein Rasterbild (`GS v 0`) -- das Firmenlogo am Bon.
+ *
+ * Anders als `escPosQrRaster` folgt KEIN Zeilenvorschub: `GS v 0` schiebt das
+ * Papier um die Bildhoehe, ein LF danach waere eine zusaetzliche Leerzeile,
+ * die Bildschirm und PDF nicht haben. Die Luft um das Logo kommt aus dem Blatt.
+ */
+export function escPosRasterBild(doc, bild, options = {}) {
+    // Masse pruefen, BEVOR gepackt wird: ein zu breites Bild soll nicht erst
+    // Speicher fuer seine Rasterzeilen belegen. `GS v 0` traegt die Hoehe in zwei
+    // Bytes (yL yH) -- ueber 65535 Punkte liefe sie still ueber und der Drucker
+    // laese den Rest des Bilds als Befehle.
+    if (bild.breite > QR_DRUCK_PUNKTE[doc.paperSize])
+        throw new Error('Rasterbild breiter als der Druckkopf');
+    if (bild.hoehe > 0xffff)
+        throw new Error('Rasterbild hoeher als 65535 Punkte');
+    const daten = rasterZeilenBytes(bild);
+    escPosSetStyles(doc, { align: options.align ?? 'center' });
+    anhaengen(doc, rasterBildKopf(bild.breite, bild.hoehe));
+    anhaengen(doc, daten);
+    if ((options.align ?? 'center') !== 'left') {
+        escPosSetStyles(doc, { align: 'left' });
+    }
+}

package/dist/esm/printing/index.d.ts

@@ -1,4 +1,4 @@
-export { type PosPaperSize, type PosAlign, type PosFont, type PosCutMode, type PosCodeTable, type PosTextSize, type QrSize, type QrCorrection, type QrMatrix, type PosStyles, type PosColumn, type EscPosOptions, type EscPosTextOptions, type EscPosHrOptions, type EscPosQrOptions, type EscPosQrRasterOptions, type EscPosDocument, createEscPosDocument, escPosBytes, escPosReset, escPosSetGlobalCodeTable, escPosSetGlobalFont, escPosSetStyles, escPosText, escPosEmptyLines, escPosFeed, escPosCut, escPosHr, escPosRow, escPosQrCode, escPosQrRaster, qrRasterPunkte, encodeEscPosText, qrCodeBytes, escPosMaxCharsPerLine, escPosWortzeilen, wortzeilenText, } from './escpos.js';
-export { type QrModulGroesse, type QrGroesse, QR_MODUL_DECKEL, QR_RUHEZONE_MODULE, QR_MINDEST_PUNKTE, QR_AUSNAHME_PUNKTE, QR_HOECHST_PUNKTE, QR_DRUCK_PUNKTE, qrModulAnzahl, qrGroesseBerechnen, qrGroesseFuer, } from './qr-groesse.js';
+export { type PosPaperSize, type PosAlign, type PosFont, type PosCutMode, type PosCodeTable, type PosTextSize, type QrSize, type QrCorrection, type QrMatrix, type PosStyles, type PosColumn, type EscPosOptions, type EscPosTextOptions, type EscPosHrOptions, type EscPosQrOptions, type EscPosQrRasterOptions, type EscPosDocument, createEscPosDocument, escPosBytes, escPosReset, escPosSetGlobalCodeTable, escPosSetGlobalFont, escPosSetStyles, escPosText, escPosEmptyLines, escPosFeed, escPosCut, escPosHr, escPosRow, escPosQrCode, escPosQrRaster, qrRasterPunkte, type RasterBild, rasterZeilenBytes, rasterZeilenBase64, escPosRasterBild, encodeEscPosText, qrCodeBytes, escPosMaxCharsPerLine, escPosWortzeilen, wortzeilenText, } from './escpos.js';
+export { type QrModulGroesse, type QrGroesse, QR_MODUL_DECKEL, QR_RUHEZONE_MODULE, QR_MINDEST_PUNKTE, QR_AUSNAHME_PUNKTE, QR_HOECHST_PUNKTE, QR_DRUCK_PUNKTE, qrModulAnzahl, qrPasstInVersion, qrGroesseBerechnen, qrGroesseFuer, } from './qr-groesse.js';
 export { escPosPrintableText } from './printable.js';
 export { type UsbEndpointLike, type UsbAlternateLike, type UsbInterfaceLike, type UsbConfigurationLike, type UsbTransferOutResultLike, type UsbWriterLike, type UsbIdentityLike, type UsbDeviceLike, type UsbPrinterEndpoint, type UsbPrinterConnection, USB_VENDOR_EPSON, USB_CLASS_PRINTER, UsbTimeoutError, usbDeviceKey, usbFindPrinterEndpoint, usbWriteAll, usbConnectPrinter, usbPrint, usbDisconnect, } from './webusb.js';

package/dist/esm/printing/index.js

@@ -1,4 +1,4 @@
-export { createEscPosDocument, escPosBytes, escPosReset, escPosSetGlobalCodeTable, escPosSetGlobalFont, escPosSetStyles, escPosText, escPosEmptyLines, escPosFeed, escPosCut, escPosHr, escPosRow, escPosQrCode, escPosQrRaster, qrRasterPunkte, encodeEscPosText, qrCodeBytes, escPosMaxCharsPerLine, escPosWortzeilen, wortzeilenText, } from './escpos.js';
-export { QR_MODUL_DECKEL, QR_RUHEZONE_MODULE, QR_MINDEST_PUNKTE, QR_AUSNAHME_PUNKTE, QR_HOECHST_PUNKTE, QR_DRUCK_PUNKTE, qrModulAnzahl, qrGroesseBerechnen, qrGroesseFuer, } from './qr-groesse.js';
+export { createEscPosDocument, escPosBytes, escPosReset, escPosSetGlobalCodeTable, escPosSetGlobalFont, escPosSetStyles, escPosText, escPosEmptyLines, escPosFeed, escPosCut, escPosHr, escPosRow, escPosQrCode, escPosQrRaster, qrRasterPunkte, rasterZeilenBytes, rasterZeilenBase64, escPosRasterBild, encodeEscPosText, qrCodeBytes, escPosMaxCharsPerLine, escPosWortzeilen, wortzeilenText, } from './escpos.js';
+export { QR_MODUL_DECKEL, QR_RUHEZONE_MODULE, QR_MINDEST_PUNKTE, QR_AUSNAHME_PUNKTE, QR_HOECHST_PUNKTE, QR_DRUCK_PUNKTE, qrModulAnzahl, qrPasstInVersion, qrGroesseBerechnen, qrGroesseFuer, } from './qr-groesse.js';
 export { escPosPrintableText } from './printable.js';
 export { USB_VENDOR_EPSON, USB_CLASS_PRINTER, UsbTimeoutError, usbDeviceKey, usbFindPrinterEndpoint, usbWriteAll, usbConnectPrinter, usbPrint, usbDisconnect, } from './webusb.js';