iobroker.ipp 0.0.0-stage → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Voodoo2man <Voodoo2man@outlook.de>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,81 @@
-# Temporary Holding Version
+# ioBroker Internet Printing Protocol
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+![Network printer monitoring illustration](admin/ipp-banner.jpg)
+
+[![NPM version](https://img.shields.io/npm/v/iobroker.ipp.svg)](https://www.npmjs.com/package/iobroker.ipp)
+[![Downloads](https://img.shields.io/npm/dm/iobroker.ipp.svg)](https://www.npmjs.com/package/iobroker.ipp)
+
+
+## ioBroker Internet Printing Protocol Adapter
+
+The adapter polls configured network printers using the Internet Printing Protocol (IPP) and publishes read-only availability, printer state, toner or ink levels, and supported page counters. It uses `Get-Printer-Attributes` over IPP/2.0; device and firmware support varies, so optional attributes may not be reported by every printer. Compatibility depends on each printer’s IPP implementation; no particular device has been verified against this implementation.
+
+Node.js 22 or newer, Admin 8.2.0 or newer, and js-controller 7.2.2 or newer are required.
+
+## Configuration
+
+Add one or more printers in the adapter settings. Each row contains:
+
+Printer entries are shown in individually collapsible sections, with fields arranged responsively for narrow and wide screens.
+
+| Setting | Description |
+| --- | --- |
+| ID | Stable object-tree identifier; use 1-32 letters, digits, underscores, or hyphens. German umlauts are transliterated (`ä` to `ae`, `ö` to `oe`, `ü` to `ue`, `ß` to `ss`). |
+| Label | Display name for the printer. |
+| Host | Printer hostname or IP address. |
+| Port | IPP port; defaults to `631`. |
+| IPP resource path | Printer resource path; defaults to `/ipp/print`. |
+| Use TLS | Use IPPS over TLS. |
+| Verify TLS certificate | Validate the printer's TLS certificate; disabled by default for self-signed printer certificates. |
+
+The polling interval defaults to 60 seconds and is limited to 10 seconds through 24 hours. The request timeout defaults to 5000 ms and is limited to 500-30000 ms. The adapter only sends the read-only `Get-Printer-Attributes` operation; it does not submit print jobs or change printer settings. Configure only printers that expose an IPP endpoint at the selected host, port, and resource path.
+
+Invalid printer rows are skipped with a warning that identifies the invalid fields. Debug logging reports configured field names and value types without printing configured values.
+
+When a printer is switched off or temporarily unreachable, the adapter marks it offline without a warning-level log; connection and timeout details are available at debug level. IPP protocol, TLS, and configuration errors remain warnings.
+
+## States
+
+Each configured printer gets a device with `status`, `supplies`, `counters`, and `details` channels. Supplementary IPP attributes are created directly under `details` (for example, `details.printer_location`); attributes already represented by the canonical status, model, and counter states are not duplicated. The adapter requests all IPP attributes and creates states for returned values except explicitly excluded capabilities, verbose attribute families, and raw marker values; selected capability/default attributes are retained. Arrays and structured values are stored as JSON strings; scalar values keep their boolean, number, or string type. Unknown, non-excluded attributes are added automatically under `details`. `status.online` is always present; `status.model`, `status.message`, and numeric `status.state` are published when supported. The state value is `0` (`off`) while the printer is unreachable, and returns to the reported IPP state when it reconnects. Previously read measurements remain available while offline. IPP marker levels are normalized to percentages using the reported low/high bounds and rounded to two decimal places. `pages_completed`, `impressions_completed`, and `media_sheets_completed` are created only when the printer reports them. Missing values are cleared rather than replaced with zero during successful polls. Request details are not logged.
+
+For supply reporting, the adapter combines `marker-names` with the corresponding entries in `marker-levels`, `marker-low-levels`, and `marker-high-levels`; `marker-types` is used when supplied. A supply is skipped if its name or any required numeric level/bound is missing, invalid, or out of range. Counters map from `pages-completed`, `impressions-completed`, and `media-sheets-completed` to `pages_completed`, `impressions_completed`, and `media_sheets_completed`. When reporting missing values, include the printer model and firmware, which of these IPP attributes the printer returns, and the raw values or state IDs that are absent.
+
+[![Donate with PayPal](https://camo.githubusercontent.com/ef8c60305542390406855547e32850909812a73c4abada236de22a6dc88b313f/68747470733a2f2f7777772e70617970616c6f626a656374732e636f6d2f64655f44452f44452f692f62746e2f62746e5f646f6e61746543435f4c472e676966)](https://www.paypal.com/donate/?hosted_button_id=3RJQGSJNRSHUJ)
+
+## Changelog
+<!--
+    Placeholder for the next version (at the beginning of the line):
+    ### **WORK IN PROGRESS**
+-->
+### 0.0.2 (2026-10-28)
+
+- (Voodoo2man) Added Node.js 22 support and documented printer supply and counter attributes.
+
+### 0.0.1 (2026-10-27)
+
+- (Voodoo2man) initial release
+
+Older release notes are available in [CHANGELOG_OLD.md](CHANGELOG_OLD.md).
+
+## License
+MIT License
+
+Copyright (c) 2026 Voodoo2man <Voodoo2man@outlook.de>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/admin/i18n/de.json

@@ -0,0 +1,13 @@
+{
+    "ipp adapter settings": "Adaptereinstellungen für ipp",
+    "Printers": "Drucker",
+    "ID": "ID",
+    "Label": "Bezeichnung",
+    "Host": "Host",
+    "Port": "Port",
+    "IPP resource path": "IPP-Ressourcenpfad",
+    "Use TLS": "TLS verwenden",
+    "Verify TLS certificate": "TLS-Zertifikat prüfen",
+    "Polling interval (seconds)": "Abfrageintervall (Sekunden)",
+    "Request timeout (milliseconds)": "Zeitlimit für Anfragen (Millisekunden)"
+}

package/admin/i18n/en.json

@@ -0,0 +1,13 @@
+{
+    "ipp adapter settings": "Adapter settings for ipp",
+    "Printers": "Printers",
+    "ID": "ID",
+    "Label": "Label",
+    "Host": "Host",
+    "Port": "Port",
+    "IPP resource path": "IPP resource path",
+    "Use TLS": "Use TLS",
+    "Verify TLS certificate": "Verify TLS certificate",
+    "Polling interval (seconds)": "Polling interval (seconds)",
+    "Request timeout (milliseconds)": "Request timeout (milliseconds)"
+}

package/admin/i18n/es.json

@@ -0,0 +1,13 @@
+{
+    "ipp adapter settings": "Configuración del adaptador ipp",
+    "Printers": "Impresoras",
+    "ID": "ID",
+    "Label": "Nombre",
+    "Host": "Host",
+    "Port": "Puerto",
+    "IPP resource path": "Ruta del recurso IPP",
+    "Use TLS": "Usar TLS",
+    "Verify TLS certificate": "Verificar certificado TLS",
+    "Polling interval (seconds)": "Intervalo de consulta (segundos)",
+    "Request timeout (milliseconds)": "Tiempo límite de solicitud (milisegundos)"
+}

package/admin/i18n/fr.json

@@ -0,0 +1,13 @@
+{
+    "ipp adapter settings": "Paramètres de l'adaptateur ipp",
+    "Printers": "Imprimantes",
+    "ID": "ID",
+    "Label": "Nom",
+    "Host": "Hôte",
+    "Port": "Port",
+    "IPP resource path": "Chemin de ressource IPP",
+    "Use TLS": "Utiliser TLS",
+    "Verify TLS certificate": "Vérifier le certificat TLS",
+    "Polling interval (seconds)": "Intervalle d'interrogation (secondes)",
+    "Request timeout (milliseconds)": "Délai d'attente de requête (millisecondes)"
+}

package/admin/i18n/it.json

@@ -0,0 +1,13 @@
+{
+    "ipp adapter settings": "Impostazioni dell'adattatore ipp",
+    "Printers": "Stampanti",
+    "ID": "ID",
+    "Label": "Nome",
+    "Host": "Host",
+    "Port": "Porta",
+    "IPP resource path": "Percorso risorsa IPP",
+    "Use TLS": "Usa TLS",
+    "Verify TLS certificate": "Verifica certificato TLS",
+    "Polling interval (seconds)": "Intervallo di polling (secondi)",
+    "Request timeout (milliseconds)": "Timeout della richiesta (millisecondi)"
+}

package/admin/i18n/nl.json

@@ -0,0 +1,13 @@
+{
+    "ipp adapter settings": "Adapterinstellingen voor ipp",
+    "Printers": "Printers",
+    "ID": "ID",
+    "Label": "Naam",
+    "Host": "Host",
+    "Port": "Poort",
+    "IPP resource path": "IPP-resourcepad",
+    "Use TLS": "TLS gebruiken",
+    "Verify TLS certificate": "TLS-certificaat verifiëren",
+    "Polling interval (seconds)": "Pollinterval (seconden)",
+    "Request timeout (milliseconds)": "Time-out voor verzoeken (milliseconden)"
+}

package/admin/i18n/pl.json

@@ -0,0 +1,13 @@
+{
+    "ipp adapter settings": "Ustawienia adaptera ipp",
+    "Printers": "Drukarki",
+    "ID": "ID",
+    "Label": "Nazwa",
+    "Host": "Host",
+    "Port": "Port",
+    "IPP resource path": "Ścieżka zasobu IPP",
+    "Use TLS": "Użyj TLS",
+    "Verify TLS certificate": "Weryfikuj certyfikat TLS",
+    "Polling interval (seconds)": "Interwał odpytywania (sekundy)",
+    "Request timeout (milliseconds)": "Limit czasu żądania (milisekundy)"
+}

package/admin/i18n/pt.json

@@ -0,0 +1,13 @@
+{
+    "ipp adapter settings": "Configurações do adaptador ipp",
+    "Printers": "Impressoras",
+    "ID": "ID",
+    "Label": "Nome",
+    "Host": "Host",
+    "Port": "Porta",
+    "IPP resource path": "Caminho do recurso IPP",
+    "Use TLS": "Usar TLS",
+    "Verify TLS certificate": "Verificar certificado TLS",
+    "Polling interval (seconds)": "Intervalo de consulta (segundos)",
+    "Request timeout (milliseconds)": "Tempo limite da solicitação (milissegundos)"
+}

package/admin/i18n/ru.json

@@ -0,0 +1,13 @@
+{
+    "ipp adapter settings": "Настройки адаптера ipp",
+    "Printers": "Принтеры",
+    "ID": "Идентификатор",
+    "Label": "Название",
+    "Host": "Узел",
+    "Port": "Порт",
+    "IPP resource path": "Путь ресурса IPP",
+    "Use TLS": "Использовать TLS",
+    "Verify TLS certificate": "Проверять сертификат TLS",
+    "Polling interval (seconds)": "Интервал опроса (секунды)",
+    "Request timeout (milliseconds)": "Тайм-аут запроса (миллисекунды)"
+}

package/admin/i18n/uk.json

@@ -0,0 +1,13 @@
+{
+    "ipp adapter settings": "Налаштування адаптера ipp",
+    "Printers": "Принтери",
+    "ID": "Ідентифікатор",
+    "Label": "Назва",
+    "Host": "Хост",
+    "Port": "Порт",
+    "IPP resource path": "Шлях ресурсу IPP",
+    "Use TLS": "Використовувати TLS",
+    "Verify TLS certificate": "Перевіряти сертифікат TLS",
+    "Polling interval (seconds)": "Інтервал опитування (секунди)",
+    "Request timeout (milliseconds)": "Час очікування запиту (мілісекунди)"
+}

package/admin/i18n/zh-cn.json

@@ -0,0 +1,13 @@
+{
+    "ipp adapter settings": "ipp 适配器设置",
+    "Printers": "打印机",
+    "ID": "ID",
+    "Label": "名称",
+    "Host": "主机",
+    "Port": "端口",
+    "IPP resource path": "IPP 资源路径",
+    "Use TLS": "使用 TLS",
+    "Verify TLS certificate": "验证 TLS 证书",
+    "Polling interval (seconds)": "轮询间隔（秒）",
+    "Request timeout (milliseconds)": "请求超时（毫秒）"
+}

package/admin/jsonConfig.json

@@ -0,0 +1,51 @@
+{
+    "i18n": true,
+    "type": "panel",
+    "items": {
+        "printers": {
+            "type": "accordion",
+            "label": "Printers",
+            "titleAttr": "id",
+            "items": [
+                { "attr": "id", "type": "text", "label": "ID", "xs": 12, "sm": 6 },
+                { "attr": "label", "type": "text", "label": "Label", "xs": 12, "sm": 6 },
+                { "attr": "host", "type": "text", "label": "Host", "xs": 12, "md": 8 },
+                { "attr": "port", "type": "number", "label": "Port", "default": 631, "xs": 12, "md": 4 },
+                { "attr": "basePath", "type": "text", "label": "IPP resource path", "default": "/ipp/print", "xs": 12 },
+                { "attr": "ssl", "type": "checkbox", "label": "Use TLS", "xs": 12, "sm": 6 },
+                { "attr": "verifySsl", "type": "checkbox", "label": "Verify TLS certificate", "default": false, "xs": 12, "sm": 6 }
+            ],
+            "xs": 12,
+            "sm": 12,
+            "md": 12,
+            "lg": 12,
+            "xl": 12
+        },
+        "intervalSeconds": {
+            "type": "number",
+            "label": "Polling interval (seconds)",
+            "default": 60,
+            "min": 10,
+            "max": 86400,
+            "step": 1,
+            "xs": 12,
+            "sm": 6,
+            "md": 6,
+            "lg": 6,
+            "xl": 6
+        },
+        "timeoutMs": {
+            "type": "number",
+            "label": "Request timeout (milliseconds)",
+            "default": 5000,
+            "min": 500,
+            "max": 30000,
+            "step": 500,
+            "xs": 12,
+            "sm": 6,
+            "md": 6,
+            "lg": 6,
+            "xl": 6
+        }
+    }
+}

package/build/io-package.json

@@ -0,0 +1,107 @@
+{
+    "common": {
+        "name": "ipp",
+        "nogit": true,
+        "version": "0.0.2",
+        "news": {
+            "0.0.2": {
+                "en": "Added Node.js 22 support and documented printer supply and counter attributes.",
+                "de": "Support für Node.js 22 hinzugefügt und Druckerbedarf und Zähler dokumentiert.",
+                "ru": "Добавлена поддержка Node.js 22 и документированные атрибуты расходных материалов и счетчиков принтеров.",
+                "pt": "Foi adicionado o suporte ao Node.js 22 e documentou a fonte e o contador.",
+                "nl": "Ondersteuning voor Node.js 22 toegevoegd en de printerbenodigdheden en tellerkenmerken gedocumenteerd.",
+                "fr": "Ajout du support de Node.js 22 et des attributs d'imprimante et de compteur documentés.",
+                "it": "Aggiunto il supporto per Node.js 22 e attributi di stampa e contatore.",
+                "es": "Se ha añadido Node.js 22 y ha documentado los atributos de suministro y contador.",
+                "pl": "Dodano obsługę Node.js 22 i udokumentowane atrybuty zasilania drukarki i licznika.",
+                "uk": "Додана підтримка Node.js 22 і задокументована подача принтера і атрибути лічильника.",
+                "zh-cn": "添加了 Node.js 22 支持，并记录了打印机供应和计数器属性。"
+            },
+            "0.0.1": {
+                "en": "initial release",
+                "de": "Erstveröffentlichung",
+                "ru": "Начальная версия",
+                "pt": "lançamento inicial",
+                "nl": "Eerste uitgave",
+                "fr": "Première version",
+                "it": "Versione iniziale",
+                "es": "Versión inicial",
+                "pl": "Pierwsze wydanie",
+                "uk": "Початкова версія",
+                "zh-cn": "首次出版"
+            }
+        },
+        "titleLang": {
+            "en": "Internet Printing Protocol",
+            "de": "Internet Printing Protocol",
+            "ru": "Internet Printing Protocol",
+            "pt": "Internet Printing Protocol",
+            "nl": "Internet Printing Protocol",
+            "fr": "Internet Printing Protocol",
+            "it": "Internet Printing Protocol",
+            "es": "Internet Printing Protocol",
+            "pl": "Internet Printing Protocol",
+            "uk": "Internet Printing Protocol",
+            "zh-cn": "Internet Printing Protocol"
+        },
+        "desc": {
+            "en": "Read-only monitoring of configured network printers using IPP/2.0 over HTTP or HTTPS",
+            "de": "Schreibgeschützte Überwachung konfigurierter Netzwerkdrucker über IPP/2.0 mit HTTP oder HTTPS",
+            "ru": "Мониторинг настроенных сетевых принтеров через IPP/2.0 по HTTP или HTTPS только для чтения",
+            "pt": "Monitorização de impressoras de rede configuradas através de IPP/2.0 por HTTP ou HTTPS, apenas para leitura",
+            "nl": "Alleen-lezen bewaking van geconfigureerde netwerkprinters via IPP/2.0 over HTTP of HTTPS",
+            "fr": "Surveillance en lecture seule des imprimantes réseau configurées via IPP/2.0 en HTTP ou HTTPS",
+            "it": "Monitoraggio in sola lettura delle stampanti di rete configurate tramite IPP/2.0 su HTTP o HTTPS",
+            "es": "Supervisión de solo lectura de impresoras de red mediante IPP/2.0 por HTTP o HTTPS",
+            "pl": "Monitorowanie skonfigurowanych drukarek sieciowych przez IPP/2.0 za pomocą HTTP lub HTTPS tylko do odczytu",
+            "uk": "Моніторинг налаштованих мережевих принтерів через IPP/2.0 за HTTP або HTTPS лише для читання",
+            "zh-cn": "通过 HTTP 或 HTTPS 上的 IPP/2.0 只读监控已配置的网络打印机"
+        },
+        "authors": [
+            "Voodoo2man <Voodoo2man@outlook.de>"
+        ],
+        "keywords": [
+            "printer",
+            "printing",
+            "IPP",
+            "IPP/2.0",
+            "IPPS"
+        ],
+        "licenseInformation": {
+            "type": "free",
+            "license": "MIT"
+        },
+        "platform": "Javascript/Node.js",
+        "icon": "ipp.png",
+        "enabled": true,
+        "extIcon": "https://raw.githubusercontent.com/Voodoo2man/ioBroker.ipp/main/admin/ipp.png",
+        "readme": "https://github.com/Voodoo2man/ioBroker.ipp/blob/main/README.md",
+        "loglevel": "info",
+        "tier": 3,
+        "mode": "daemon",
+        "type": "network",
+        "compact": true,
+        "connectionType": "local",
+        "dataSource": "poll",
+        "adminUI": {
+            "config": "json"
+        },
+        "dependencies": [
+            {
+                "js-controller": ">=7.2.2"
+            }
+        ],
+        "globalDependencies": [
+            {
+                "admin": ">=8.2.0"
+            }
+        ]
+    },
+    "native": {
+        "printers": [],
+        "intervalSeconds": 60,
+        "timeoutMs": 5000
+    },
+    "objects": [],
+    "instanceObjects": []
+}

package/build/lib/printerConfig.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePrinterConfig = parsePrinterConfig;
+exports.getPrinterConfigErrors = getPrinterConfigErrors;
+exports.describePrinterConfig = describePrinterConfig;
+function normalizeCheckbox(value) {
+    if (value === undefined || value === null || value === '') {
+        return false;
+    }
+    if (value === true || value === 1 || value === '1' || value === 'true') {
+        return true;
+    }
+    if (value === false || value === 0 || value === '0' || value === 'false') {
+        return false;
+    }
+    return null;
+}
+function normalizePrinterId(value) {
+    return value
+        .replace(/[äÄ]/g, match => (match === 'Ä' ? 'Ae' : 'ae'))
+        .replace(/[öÖ]/g, match => (match === 'Ö' ? 'Oe' : 'oe'))
+        .replace(/[üÜ]/g, match => (match === 'Ü' ? 'Ue' : 'ue'))
+        .replace(/ß/g, 'ss');
+}
+function parsePrinterConfig(value) {
+    const errors = getPrinterConfigErrors(value);
+    if (!value || typeof value !== 'object' || Array.isArray(value) || errors.length > 0) {
+        return { errors };
+    }
+    const printer = value;
+    const ssl = normalizeCheckbox(printer.ssl);
+    const verifySsl = normalizeCheckbox(printer.verifySsl);
+    if (ssl === null || verifySsl === null) {
+        if (ssl === null) {
+            errors.push('ssl must be true/false, 1/0, or an unchecked checkbox');
+        }
+        if (verifySsl === null) {
+            errors.push('verifySsl must be true/false, 1/0, or an unchecked checkbox');
+        }
+        return { errors };
+    }
+    return {
+        config: {
+            id: normalizePrinterId(printer.id),
+            label: typeof printer.label === 'string' ? printer.label : undefined,
+            host: printer.host,
+            port: printer.port,
+            basePath: printer.basePath,
+            ssl,
+            verifySsl,
+        },
+        errors: [],
+    };
+}
+function getPrinterConfigErrors(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return ['row must be an object'];
+    }
+    const printer = value;
+    const errors = [];
+    if (typeof printer.id !== 'string' || !/^[A-Za-z0-9_-]{1,32}$/.test(normalizePrinterId(printer.id))) {
+        errors.push('id must contain 1-32 letters, digits, underscores, or hyphens');
+    }
+    if (typeof printer.host !== 'string' || printer.host.trim() === '') {
+        errors.push('host is missing or is not text');
+    }
+    if (printer.port !== undefined &&
+        printer.port !== '' &&
+        (!Number.isInteger(Number(printer.port)) || Number(printer.port) < 1 || Number(printer.port) > 65535)) {
+        errors.push('port must be an integer from 1 to 65535');
+    }
+    if (printer.basePath !== undefined &&
+        (typeof printer.basePath !== 'string' || !printer.basePath.startsWith('/') || printer.basePath.includes('..'))) {
+        errors.push('basePath must start with / and must not contain ..');
+    }
+    for (const key of ['ssl', 'verifySsl']) {
+        if (normalizeCheckbox(printer[key]) === null) {
+            errors.push(`${key} must be true/false, 1/0, or an unchecked checkbox`);
+        }
+    }
+    return errors;
+}
+function describePrinterConfig(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return `rowType=${Array.isArray(value) ? 'array' : typeof value}`;
+    }
+    const printer = value;
+    const fields = ['id', 'label', 'host', 'port', 'basePath', 'ssl', 'verifySsl'];
+    return fields.map(key => `${key}=${key in printer ? typeof printer[key] : 'missing'}`).join(', ');
+}