@letterstory/cli 0.83.0 → 0.84.0

package/lib/cli.mjs

@@ -57,7 +57,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.83.0";
+export const VERSION = "0.84.0";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value. Every `type: "bool"` flag (and its

package/lib/commands/outbound.mjs

@@ -110,6 +110,22 @@ function intPositional(index, label) {
 	};
 }
 
+/**
+ * A mail message ref: an IMAP UID (sent as a number) or a Gmail message id
+ * (hex string). An all-digit Gmail id past the safe-integer range stays a string.
+ */
+function messageRefPositional(index, label) {
+	return {
+		value: (_flags, positionals) => {
+			const raw = positionals[index];
+			if (raw === undefined) throw new CliError(`Missing required <${label}>`);
+			if (/^\d+$/.test(raw) && Number.isSafeInteger(Number(raw))) return Number(raw);
+			if (/^[0-9a-f]{1,32}$/i.test(raw)) return raw;
+			throw new CliError(`<${label}> must be a message uid or Gmail message id (got ${raw})`);
+		},
+	};
+}
+
 const SUPPRESSION_REASONS = ["unsubscribe", "bounce", "complaint", "manual"];
 const MAILER_FOLDERS = ["inbox", "sent"];
 
@@ -275,7 +291,7 @@ export const ARGS = {
 	},
 	get_mailer_message: {
 		mailer_id: { positional: 0, label: "mailer-id", required: true },
-		uid: intPositional(1, "uid"),
+		uid: messageRefPositional(1, "uid"),
 		folder: { flag: "folder", required: true, enum: MAILER_FOLDERS },
 	},
 	set_mailer_forwarding: {

package/lib/commands/targets.mjs

@@ -26,7 +26,7 @@ function readOffering(flags) {
 const offering = { value: readOffering };
 
 // `--priority high|normal|low|default`: how much the target's questions count in share of
-// voice (high = 2 votes, normal = 1, low = ½); default = back to the question-type default.
+// voice (high = 3 votes, normal = 2, low = 1); default = back to high, a target's default.
 function readPriority(flags) {
 	const v = flagStr(flags.priority);
 	if (v === undefined) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@letterstory/cli",
-	"version": "0.83.0",
+	"version": "0.84.0",
 	"description": "Spin up and manage Letterstory phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",