@letterstory/cli 0.61.0 → 0.61.1

package/lib/cli.mjs

@@ -55,7 +55,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.61.0";
+export const VERSION = "0.61.1";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value.
@@ -807,10 +807,13 @@ Sequences (multi-step cold email sent from your mailers; approving or enrolling
   sequences get <sequence-id>                          Flow, enrollments, who replied at each step
   sequences create --name <n> (--flow '<json>'|--flow-file <path>) [--mailer <mailer-id>]...
            [--[no-]opt-out-footer] [--[no-]postal-address-footer] [--[no-]unsubscribe-links] [--[no-]detect-reply-opt-outs]
-                                                       New draft sequence (nothing sends yet; rails default on, opt-out line off)
+           [--send-window-start <HH:MM>] [--send-window-end <HH:MM>] [--send-window-timezone <IANA tz>]
+                                                       New draft sequence (nothing sends yet; rails default on, opt-out line off;
+                                                       sends 9:00-17:00 in each recipient's inferred timezone, else the sender's)
   sequences update <sequence-id> [--name <n>] [--flow '<json>'|--flow-file <path>]
            [--status draft|active|paused|archived] [--mailer <mailer-id>]...
            [--[no-]opt-out-footer] [--[no-]postal-address-footer] [--[no-]unsubscribe-links] [--[no-]detect-reply-opt-outs]
+           [--send-window-start <HH:MM>] [--send-window-end <HH:MM>] [--send-window-timezone <IANA tz>]
   sequences pause|resume <sequence-id>                 Stop / restart sending
   sequences enroll <sequence-id> (--list <list-id> | --email <addr>... | --recipients '<json>'|--recipients-file <path>)
   sequences stop <sequence-id> <enrollment-id>         Stop one recipient

package/lib/commands/outbound.mjs

@@ -60,6 +60,31 @@ const SEQUENCE_RAIL_ARGS = {
 	unsubscribe_links: { flag: "unsubscribe-links", type: "bool", negate: "no-unsubscribe-links" },
 	detect_reply_opt_outs: { flag: "detect-reply-opt-outs", type: "bool", negate: "no-detect-reply-opt-outs" },
 };
+
+// A send-window edge from --<flag> HH:MM (or a raw minute of day) → the
+// schema's minute-of-day number.
+function windowMinute(flag) {
+	return (flags) => {
+		const raw = flagStr(flags[flag]);
+		if (raw === undefined) return undefined;
+		if (/^\d+$/.test(raw)) return Number(raw);
+		const match = /^(\d{1,2}):(\d{2})$/.exec(raw);
+		if (!match || Number(match[1]) > 23 || Number(match[2]) > 59) {
+			throw new CliError(`--${flag} takes HH:MM or a minute of day 0–1439 (got ${raw})`);
+		}
+		return Number(match[1]) * 60 + Number(match[2]);
+	};
+}
+
+// The send window, shared by create and update: when emails may go out
+// (default 9:00–17:00), in each recipient's inferred timezone, falling back to
+// the sender's --send-window-timezone when the location is unknown. Equal
+// start and end turns the window off.
+const SEQUENCE_WINDOW_ARGS = {
+	send_window_start_minute: { value: windowMinute("send-window-start") },
+	send_window_end_minute: { value: windowMinute("send-window-end") },
+	send_window_timezone: "send-window-timezone",
+};
 const PROSPECT_STATUSES = ["new", "contacted", "replied", "unsubscribed", "archived"];
 const mailerIds = {
 	value: (flags) => {
@@ -101,6 +126,7 @@ export const ARGS = {
 		},
 		mailer_ids: mailerIds,
 		...SEQUENCE_RAIL_ARGS,
+		...SEQUENCE_WINDOW_ARGS,
 	},
 	update_sequence: {
 		sequence_id: { positional: 0, label: "sequence-id", required: true },
@@ -109,6 +135,7 @@ export const ARGS = {
 		status: { flag: "status", enum: SEQUENCE_STATUSES },
 		mailer_ids: mailerIds,
 		...SEQUENCE_RAIL_ARGS,
+		...SEQUENCE_WINDOW_ARGS,
 	},
 	enroll_in_sequence: {
 		sequence_id: { positional: 0, label: "sequence-id", required: true },
@@ -260,8 +287,8 @@ export const ARGS = {
 
 // Flags the computed `value` sources read (refuseUnknownFlags can't see them).
 const VALUE_FLAGS = {
-	create_sequence: ["flow", "flow-file", "mailer"],
-	update_sequence: ["flow", "flow-file", "mailer"],
+	create_sequence: ["flow", "flow-file", "mailer", "send-window-start", "send-window-end"],
+	update_sequence: ["flow", "flow-file", "mailer", "send-window-start", "send-window-end"],
 	enroll_in_sequence: ["recipients", "recipients-file", "email"],
 	update_review_item: ["body", "file"],
 	import_prospects_csv: ["csv", "csv-file"],

package/package.json

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