An ID on the command line is decimal digits only (closes #185)

files --collection, get, get-thumb and helper fix-missing-thumbnails
--file read an ID with Number(), so 0x10 meant 16, 1e3 meant 1000 and
an empty string meant 0, and --file dropped an ID it could not read.
parseID in src/cli-commands.ts now takes an ID only when it is decimal
digits and a safe integer; anything else prints "Invalid file ID: ARG"
or "Invalid collection ID: ARG" and the command exits 1. The fixer
checks every --file ID before it opens the library, so one bad ID fails
the whole command before any request.

Model: opus-5-5

src/cli-commands.ts

@@ -97,6 +97,20 @@ const requireSession = (ctx: CliContext): Client | undefined => {
     return client;
 };
 
+// `text` as an ID, or undefined after telling the user it is not one. An ID is
+// written in decimal digits and is a safe integer; `Number()` alone would read
+// `0x10` as 16, `1e3` as 1000 and "" as 0.
+const parseID = (
+    ctx: CliContext,
+    kind: "file" | "collection",
+    text: string,
+): number | undefined => {
+    const id = Number(text);
+    if (/^[0-9]+$/.test(text) && Number.isSafeInteger(id)) return id;
+    ctx.stderr.write(`Invalid ${kind} ID: ${text}\n`);
+    return undefined;
+};
+
 // A library client that omits `fetchMLData`, so the point commands below do not
 // kick the library's background ML backfill: they read metadata, or fetch one
 // file's content, and exit. `backup` and `backup-metadata` handle ML on their
@@ -247,11 +261,8 @@ export const filesCommand = async (
     await init();
     const client = requireSession(ctx);
     if (!client) return 3;
-    const collectionID = Number(opts.collection);
-    if (!Number.isFinite(collectionID)) {
-        ctx.stderr.write("Invalid collection ID\n");
-        return 1;
-    }
+    const collectionID = parseID(ctx, "collection", opts.collection);
+    if (collectionID === undefined) return 1;
 
     const lib = await openReadLibrary(ctx, client);
     try {
@@ -289,11 +300,8 @@ export const getCommand = async (
     await init();
     const client = requireSession(ctx);
     if (!client) return 3;
-    const fileID = Number(fileIDStr);
-    if (!Number.isFinite(fileID)) {
-        ctx.stderr.write("Invalid file ID\n");
-        return 1;
-    }
+    const fileID = parseID(ctx, "file", fileIDStr);
+    if (fileID === undefined) return 1;
 
     const lib = await openReadLibrary(ctx, client);
     try {
@@ -347,11 +355,8 @@ export const getThumbCommand = async (
     await init();
     const client = requireSession(ctx);
     if (!client) return 3;
-    const fileID = Number(fileIDStr);
-    if (!Number.isFinite(fileID)) {
-        ctx.stderr.write("Invalid file ID\n");
-        return 1;
-    }
+    const fileID = parseID(ctx, "file", fileIDStr);
+    if (fileID === undefined) return 1;
 
     const lib = await openReadLibrary(ctx, client);
     try {
@@ -516,15 +521,19 @@ export const fixMissingThumbnailsCommand = async (
     await init();
     const client = requireSession(ctx);
     if (!client) return 3;
+    // One bad --file ID fails the whole command, before anything is fetched.
+    let fileIDs: number[] = [];
+    for (const text of opts.file ?? []) {
+        const fileID = parseID(ctx, "file", text);
+        if (fileID === undefined) return 1;
+        fileIDs.push(fileID);
+    }
     const lib = await openReadLibrary(ctx, client);
     try {
         // Refresh first so files added since the cache was written are found;
         // a failed refresh throws.
         await lib.fresh();
-        let fileIDs: number[];
-        if (opts.file && opts.file.length > 0) {
-            fileIDs = opts.file.map(Number).filter(Number.isFinite);
-        } else {
+        if (fileIDs.length === 0) {
             ctx.stderr.write("Scanning for missing thumbnails...\n");
             const missing = await listMissingThumbnails(lib, client, (msg) => {
                 if (!opts.json) ctx.stderr.write(msg + "\n");