@bobfrankston/brother-label 1.0.14 → 1.1.2

package/cli.d.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
  * Brother Label Printer CLI
- * Thin wrapper around the API
+ * Thin wrapper around api.ts using shared CLI primitives from label-core.
  */
 export {};
 //# sourceMappingURL=cli.d.ts.map

package/cli.js

@@ -1,309 +1,279 @@
 #!/usr/bin/env node
 /**
  * Brother Label Printer CLI
- * Thin wrapper around the API
+ * Thin wrapper around api.ts using shared CLI primitives from label-core.
  */
 import * as fs from "fs";
 import * as path from "path";
-import { print, render, renderSegments, printSegments, getConfig, setConfig, getConfigPath, listPrinters, } from "./api.js";
-const VERSION = "1.0.13";
+import { preprocessSingleQuotes, parseArgs, } from "@bobfrankston/label-core";
+import { print, render, renderSegments, printSegments, getConfig, setConfig, getConfigPath, listPrinters, detectTapeSize, brotherPrinter, } from "./api.js";
+const VERSION = "1.1.0";
 const VALID_TAPES = [6, 9, 12, 18, 24];
 function parseTape(value) {
     const num = parseInt(value.replace("mm", ""), 10);
     if (!VALID_TAPES.includes(num)) {
-        throw new Error(`Invalid tape size: ${value}. Valid: 6, 9, 12, 18, 24`);
+        throw new Error(`Invalid tape size: ${value}. Valid: ${VALID_TAPES.join(", ")}`);
     }
     return num;
 }
-// Detect content type from input string
-function buildPrintOptions(input, opts) {
-    const options = {};
-    // Parse tape option
-    if (opts.tape) {
-        options.tape = parseTape(opts.tape);
-    }
-    if (opts.printer) {
-        options.printer = opts.printer;
-    }
-    if (opts.aspect) {
-        options.aspect = opts.aspect;
-    }
-    if (opts.height) {
-        options.textHeight = opts.height;
-    }
-    // Explicit type flags override auto-detection
-    if (opts.text) {
-        options.text = input;
-        return options;
-    }
-    if (opts.html) {
-        options.htmlPath = path.resolve(input);
-        return options;
+const VALUED = [
+    { names: ["-tape"], key: "tape" },
+    { names: ["-p", "-printer"], key: "printer" },
+    { names: ["-o", "-output"], key: "output" },
+    { names: ["-a", "-aspect"], key: "aspect" },
+    { names: ["-H", "-height"], key: "height" },
+    { names: ["-s", "-space"], key: "space" },
+    { names: ["-timeout"], key: "timeout" },
+    { names: ["-interval"], key: "interval" },
+];
+const BOOLEAN = [
+    { names: ["-w", "-html"], key: "html" },
+    { names: ["-i", "-image"], key: "image" },
+    { names: ["-t"], key: "text" },
+    { names: ["-c", "-clip"], key: "clip" },
+    { names: ["-no-wait", "-nowait"], key: "nowait" },
+    { names: ["-help", "-h", "-?"], key: "help" },
+    { names: ["-version", "-v"], key: "version" },
+];
+const SUBCOMMANDS = ["list", "status", "config"];
+function showHelp() {
+    console.log(`Brother Label Printer CLI v${VERSION}
+
+Usage:
+  brother-print [options] <text>           Print text
+  brother-print [options] <file>           Print html/txt/image file (auto-detected)
+  brother-print -clip [options]            Print clipboard contents (image or text)
+  brother-print -text <v> -qr <v> ...      Print ordered text/qr segments
+  brother-print list                       List Brother printers and status
+  brother-print status [-p <name>]         Show printer status
+  brother-print config                     Show / set defaults
+
+Tape size is auto-detected from the printer. Use -tape to override.
+Single quotes can wrap arguments: '7"' 'line1\\nline2'
+
+Options:
+  -tape <size>         Tape size: 6, 9, 12, 18, 24 (mm) [auto-detected]
+  -p, -printer <name>  Printer queue name
+  -o, -output <file>   Save PNG to file instead of printing
+  -a, -aspect <r>      Aspect ratio width:height for HTML (e.g. 3.5:2)
+  -H, -height <size>   Text height: 12mm, .5in, or 50% (of tape height)
+  -s, -space <size>    Space between segments: 12px, 1mm, .2in
+  -t, -text            Force input as literal text (-text <v> for segments)
+  -qr <data>           QR code segment
+  -w, -html            Force input as HTML file path
+  -i, -image           Force input as image file path
+  -c, -clip            Read content from clipboard (image preferred, then text)
+  -no-wait             Fail immediately if printer is offline (default: wait)
+  -timeout <secs>      Max wait time when printer is offline
+  -interval <secs>     Polling interval while waiting (default 2)
+  -help                Show this help
+  -version             Show version`);
+}
+async function main() {
+    const argv = preprocessSingleQuotes(process.argv.slice(2));
+    let parsed;
+    try {
+        parsed = parseArgs(argv, VALUED, BOOLEAN, SUBCOMMANDS);
     }
-    if (opts.image) {
-        options.imagePath = path.resolve(input);
-        return options;
+    catch (e) {
+        console.error(`Error: ${e.message}`);
+        process.exit(1);
     }
-    // Auto-detect content type
-    const lower = input.toLowerCase();
-    if (lower.endsWith(".html") || lower.endsWith(".htm")) {
-        options.htmlPath = path.resolve(input);
+    if (parsed.unknown.length > 0) {
+        console.error(`Unknown option(s): ${parsed.unknown.join(", ")}`);
+        console.error(`Run "brother-print -help" for usage.`);
+        process.exit(1);
     }
-    else if (lower.endsWith(".txt")) {
-        options.textFile = path.resolve(input);
+    if (parsed.opts.help) {
+        showHelp();
+        return;
     }
-    else if (lower.endsWith(".png") || lower.endsWith(".jpg") || lower.endsWith(".jpeg") || lower.endsWith(".bmp") || lower.endsWith(".gif")) {
-        options.imagePath = path.resolve(input);
+    if (parsed.opts.version) {
+        console.log(VERSION);
+        return;
     }
-    else if (fs.existsSync(input)) {
-        // Exists but unknown extension - try to detect
-        const ext = path.extname(lower);
-        if (ext === ".html" || ext === ".htm") {
-            options.htmlPath = path.resolve(input);
-        }
-        else {
-            // Assume text file
-            options.textFile = path.resolve(input);
+    try {
+        switch (parsed.command) {
+            case "list":
+                await cmdList();
+                return;
+            case "status":
+                await cmdStatus(parsed.opts);
+                return;
+            case "config":
+                await cmdConfig(parsed.opts);
+                return;
         }
+        await cmdPrint(parsed.opts, parsed.segments, parsed.inputs);
     }
-    else {
-        // Treat as literal text
-        options.text = input;
+    catch (e) {
+        console.error(`Error: ${e.message}`);
+        process.exit(1);
     }
-    return options;
 }
-// Valued options: flag name(s) → canonical key
-const VALUED_OPTIONS = [
-    [["-tape"], "tape"],
-    [["-p", "-printer"], "printer"],
-    [["-o", "-output"], "output"],
-    [["-a", "-aspect"], "aspect"],
-    [["-H", "-height"], "height"],
-    [["-s", "-sp", "-space"], "space"],
-];
-// Boolean flags: flag name(s) → canonical key
-const BOOLEAN_FLAGS = [
-    [["-w", "-html"], "html"],
-    [["-i", "-image"], "image"],
-    [["-t"], "text"],
-    [["-help", "-h"], "help"],
-    [["-version", "-v"], "version"],
-];
-function parseArgs(argv) {
-    const args = argv.slice(2).map(a => a.startsWith("--") ? a.slice(1) : a);
-    const command = null;
-    const opts = {};
-    const segments = [];
-    let input = null;
-    let i = 0;
-    while (i < args.length) {
-        const arg = args[i];
-        // Segment flags: -text <value>, -qr <value>
-        if ((arg === "-text" || arg === "-qr") && i + 1 < args.length) {
-            segments.push({ type: arg === "-text" ? "text" : "qr", value: args[i + 1] });
-            i += 2;
-            continue;
-        }
-        // Valued options
-        let matched = false;
-        for (const [names, key] of VALUED_OPTIONS) {
-            if (names.includes(arg) && i + 1 < args.length) {
-                opts[key] = args[i + 1];
-                i += 2;
-                matched = true;
-                break;
-            }
-        }
-        if (matched)
-            continue;
-        // Boolean flags
-        for (const [names, key] of BOOLEAN_FLAGS) {
-            if (names.includes(arg)) {
-                opts[key] = true;
-                i++;
-                matched = true;
-                break;
-            }
-        }
-        if (matched)
-            continue;
-        // Subcommands
-        if ((arg === "list" || arg === "config") && command === null && input === null) {
-            return { ...parseRest(args, i), command: arg };
-        }
-        // Bare string → positional input (first one wins)
-        if (input === null) {
-            input = arg;
-        }
-        i++;
+async function cmdList() {
+    const printers = await listPrinters();
+    if (printers.length === 0) {
+        console.log("No Brother printers found.");
+        return;
     }
-    return { command, opts, segments, input };
-}
-// After recognizing a subcommand, parse the rest for that subcommand's options
-function parseRest(args, startIndex) {
-    const opts = {};
-    const segments = [];
-    let input = null;
-    let i = startIndex + 1;
-    while (i < args.length) {
-        const arg = args[i];
-        let matched = false;
-        for (const [names, key] of VALUED_OPTIONS) {
-            if (names.includes(arg) && i + 1 < args.length) {
-                opts[key] = args[i + 1];
-                i += 2;
-                matched = true;
-                break;
-            }
+    console.log(`Brother printers (${printers.length}):`);
+    for (const p of printers) {
+        let statusStr = "?";
+        try {
+            const s = await brotherPrinter.getStatus(p.name);
+            statusStr = s.online ? "online" : `offline (${s.statusText}${s.error ? ", " + s.error : ""})`;
         }
-        if (matched)
-            continue;
-        for (const [names, key] of BOOLEAN_FLAGS) {
-            if (names.includes(arg)) {
-                opts[key] = true;
-                i++;
-                matched = true;
-                break;
-            }
+        catch (e) {
+            statusStr = `status error: ${e.message}`;
         }
-        if (matched)
-            continue;
-        if (input === null)
-            input = arg;
-        i++;
+        console.log(`  ${p.name} — ${statusStr}`);
     }
-    return { command: null, opts, segments, input };
 }
-function showHelp() {
-    console.log(`Brother Label Printer CLI v${VERSION}
-
-Usage:
-  brother-print [options] <input>        Print text, file, or image
-  brother-print -text <v> -qr <v> ...    Print ordered segments
-  brother-print list                     List available printers
-  brother-print config                   Show/set configuration
-
-Options:
-  -tape <size>       Tape size: 6, 9, 12, 18, 24 (mm)
-  -p, -printer <n>   Printer name
-  -o, -output <file> Save to file instead of printing (png, jpg, bmp)
-  -a, -aspect <r>    Aspect ratio width:height for HTML (e.g., 3.5:2)
-  -H, -height <size> Text height: 12mm, .5in, or 50% (of tape height)
-  -s, -space <size>  Space between segments: 12px, 1mm, .2in
-  -t, -text          Force input as literal text (or -text <v> for segments)
-  -qr <data>         QR code segment
-  -w, -html          Force input as HTML file path
-  -i, -image         Force input as image file path
-  -help              Show this help
-  -version           Show version`);
+async function cmdStatus(opts) {
+    const name = opts.printer || undefined;
+    const s = await brotherPrinter.getStatus(name);
+    console.log(`Printer:   ${s.name}`);
+    console.log(`Online:    ${s.online ? "yes" : "no"}`);
+    console.log(`Status:    ${s.statusText}`);
+    if (s.error)
+        console.log(`Error:     ${s.error}`);
+    console.log(`Queue:     ${s.queueLength} job(s)`);
+    if (s.workOffline)
+        console.log(`Work offline flag: true`);
 }
-// --- Main ---
-async function main() {
-    const parsed = parseArgs(process.argv);
-    if (parsed.opts.help) {
-        showHelp();
+async function cmdConfig(opts) {
+    const hasUpdate = !!(opts.tape || opts.printer);
+    if (!hasUpdate) {
+        const cfg = getConfig();
+        console.log(`Configuration:`);
+        console.log(`  File:            ${getConfigPath()}`);
+        console.log(`  Default tape:    ${cfg.defaultTape ? cfg.defaultTape + "mm" : "(not set)"}`);
+        console.log(`  Default printer: ${cfg.defaultPrinter ?? "(not set)"}`);
+        console.log("\nValid tape sizes: 6, 9, 12, 18, 24");
         return;
     }
-    if (parsed.opts.version) {
-        console.log(VERSION);
-        return;
+    if (opts.tape) {
+        const t = parseTape(opts.tape);
+        setConfig({ defaultTape: t });
+        console.log(`Default tape set to: ${t}mm`);
     }
-    // Subcommands
-    if (parsed.command === "list") {
-        try {
-            const printers = await listPrinters();
-            if (printers.length === 0) {
-                console.log("No Brother printers found");
-            }
-            else {
-                console.log("Brother printers:");
-                printers.forEach(p => console.log(`  ${p.name}`));
-            }
-        }
-        catch (err) {
-            console.error(`Error: ${err.message}`);
-            process.exit(1);
-        }
-        return;
+    if (opts.printer) {
+        setConfig({ defaultPrinter: opts.printer });
+        console.log(`Default printer set to: ${opts.printer}`);
     }
-    if (parsed.command === "config") {
-        try {
-            if (!parsed.opts.tape && !parsed.opts.printer) {
-                const config = getConfig();
-                console.log("Configuration:");
-                console.log(`  File: ${getConfigPath()}`);
-                console.log(`  Default tape: ${config.defaultTape ? config.defaultTape + "mm" : "(not set)"}`);
-                console.log(`  Default printer: ${config.defaultPrinter ?? "(not set)"}`);
-                console.log("\nValid tape sizes: 6, 9, 12, 18, 24");
-                return;
-            }
-            if (parsed.opts.tape) {
-                const tape = parseTape(parsed.opts.tape);
-                setConfig({ defaultTape: tape });
-                console.log(`Default tape set to: ${tape}mm`);
-            }
-            if (parsed.opts.printer) {
-                setConfig({ defaultPrinter: parsed.opts.printer });
-                console.log(`Default printer set to: ${parsed.opts.printer}`);
-            }
+}
+async function resolveTape(opts) {
+    const explicit = opts.tape ? parseTape(opts.tape) : null;
+    const detected = await detectTapeSize(opts.printer);
+    if (explicit) {
+        if (detected && detected !== explicit) {
+            console.warn(`Warning: -tape ${explicit}mm specified but printer reports ${detected}mm tape loaded`);
         }
-        catch (err) {
-            console.error(`Error: ${err.message}`);
-            process.exit(1);
+        return explicit;
+    }
+    if (detected)
+        return detected;
+    return getConfig().defaultTape ?? 24;
+}
+async function cmdPrint(opts, segments, inputs) {
+    const tape = await resolveTape(opts);
+    // If there are 2+ positional inputs, treat each as a text segment.
+    // (A single positional input is handled below via classifyInput so it can
+    // auto-detect file paths.)
+    if (inputs.length > 1 || (inputs.length >= 1 && segments.length > 0)) {
+        for (const inp of inputs) {
+            segments.push({ type: "text", value: inp });
         }
-        return;
+        inputs.length = 0;
     }
-    // Multi-segment mode
-    if (parsed.segments.length > 0) {
-        try {
-            const tape = parsed.opts.tape ? parseTape(parsed.opts.tape) : undefined;
-            if (parsed.opts.output) {
-                const buffer = await renderSegments(parsed.segments, tape, parsed.opts.height, parsed.opts.space);
-                fs.writeFileSync(parsed.opts.output, buffer);
-                console.log(`Saved to ${parsed.opts.output}`);
-            }
-            else {
-                await printSegments(parsed.segments, { tape, printer: parsed.opts.printer, textHeight: parsed.opts.height, space: parsed.opts.space });
-                const effectiveTape = tape ?? getConfig().defaultTape ?? 24;
-                console.log(`Printed ${parsed.segments.length} segments on ${effectiveTape}mm tape`);
-            }
+    const baseOpts = {
+        printer: opts.printer,
+        wait: !opts.nowait,
+        waitTimeoutMs: opts.timeout ? Math.round(parseFloat(opts.timeout) * 1000) : undefined,
+        waitIntervalMs: opts.interval ? Math.round(parseFloat(opts.interval) * 1000) : undefined,
+        onWaiting: makeWaitCallback(),
+        log: (msg) => console.log(msg),
+    };
+    // Multi-segment mode: explicit -text/-qr (>=1 segment), with positional joined in
+    if (segments.length > 1 || (segments.length === 1 && inputs.length === 0)) {
+        const segOpts = {
+            ...baseOpts,
+            tape,
+            textHeight: opts.height,
+            space: opts.space,
+        };
+        if (opts.output) {
+            const buffer = await renderSegments(segments, tape, opts.height, opts.space);
+            fs.writeFileSync(opts.output, buffer);
+            console.log(`Saved to ${opts.output}`);
         }
-        catch (err) {
-            console.error(`Error: ${err.message}`);
-            process.exit(1);
+        else {
+            await printSegments(segments, segOpts);
+            console.log(`Printed ${segments.length} segment(s) on ${tape}mm tape`);
         }
         return;
     }
-    // Single input mode
-    if (!parsed.input) {
+    // Single content op
+    const printOpts = {
+        ...baseOpts,
+        tape,
+        aspect: opts.aspect,
+        textHeight: opts.height,
+    };
+    if (opts.clip) {
+        printOpts.clip = true;
+    }
+    else if (inputs.length === 1) {
+        Object.assign(printOpts, classifyInput(inputs[0], opts));
+    }
+    else if (inputs.length === 0 && segments.length === 0) {
         showHelp();
         return;
     }
-    try {
-        const options = buildPrintOptions(parsed.input, {
-            tape: parsed.opts.tape,
-            printer: parsed.opts.printer,
-            text: parsed.opts.text,
-            html: parsed.opts.html,
-            image: parsed.opts.image,
-            aspect: parsed.opts.aspect,
-            height: parsed.opts.height,
-        });
-        if (parsed.opts.output) {
-            const buffer = await render(options);
-            fs.writeFileSync(parsed.opts.output, buffer);
-            console.log(`Saved to ${parsed.opts.output}`);
-        }
-        else {
-            await print(options);
-            const tape = options.tape ?? getConfig().defaultTape ?? 24;
-            console.log(`Printed on ${tape}mm tape`);
-        }
+    if (opts.output) {
+        const buffer = await render(printOpts);
+        fs.writeFileSync(opts.output, buffer);
+        console.log(`Saved to ${opts.output}`);
+        return;
     }
-    catch (err) {
-        console.error(`Error: ${err.message}`);
-        process.exit(1);
+    await print(printOpts);
+    console.log(`Printed on ${tape}mm tape`);
+}
+function classifyInput(input, opts) {
+    if (opts.text)
+        return { text: input };
+    if (opts.html)
+        return { htmlPath: path.resolve(input) };
+    if (opts.image)
+        return { imagePath: path.resolve(input) };
+    const lower = input.toLowerCase();
+    if (lower.endsWith(".html") || lower.endsWith(".htm"))
+        return { htmlPath: path.resolve(input) };
+    if (lower.endsWith(".txt"))
+        return { textFile: path.resolve(input) };
+    if (/\.(png|jpg|jpeg|bmp|gif)$/i.test(lower))
+        return { imagePath: path.resolve(input) };
+    if (fs.existsSync(input)) {
+        const ext = path.extname(lower);
+        if (ext === ".html" || ext === ".htm")
+            return { htmlPath: path.resolve(input) };
+        return { textFile: path.resolve(input) };
     }
+    return { text: input };
+}
+function makeWaitCallback() {
+    let lastReport = 0;
+    return (status, elapsedMs, alternatives) => {
+        const secs = Math.floor(elapsedMs / 1000);
+        if (secs - lastReport < 5)
+            return;
+        lastReport = secs;
+        const altStr = alternatives.length > 0
+            ? `  (online alternatives: ${alternatives.map(a => a.name).join(", ")})`
+            : "";
+        console.log(`[brother-print] still waiting for ${status.name} (${status.statusText}${status.error ? ", " + status.error : ""}); ${secs}s elapsed${altStr}`);
+    };
 }
 main();
 //# sourceMappingURL=cli.js.map