fluncle 0.52.0 → 0.54.0

package/bin/fluncle.mjs

@@ -423,7 +423,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.52.0".trim() ? "0.52.0".trim() : "0.1.0";
+  currentVersion = "0.54.0".trim() ? "0.54.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -1912,7 +1912,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.52.0".trim() ? "0.52.0".trim() : "0.1.0";
+  currentVersion2 = "0.54.0".trim() ? "0.54.0".trim() : "0.1.0";
 });
 
 // src/commands/track.ts
@@ -2540,6 +2540,62 @@ var init_mixtape_youtube2 = __esm(() => {
   init_output();
 });
 
+// src/commands/newsletter.ts
+var exports_newsletter = {};
+__export(exports_newsletter, {
+  newsletterUpdateCommand: () => newsletterUpdateCommand,
+  newsletterSendCommand: () => newsletterSendCommand,
+  newsletterListCommand: () => newsletterListCommand,
+  newsletterDraftCommand: () => newsletterDraftCommand
+});
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
+function buildBody2(options, { requireContent }) {
+  const body = {};
+  if (options.contentFile !== undefined) {
+    body.contentJson = readContentFile(options.contentFile);
+  } else if (requireContent) {
+    throw new CliError2("missing_content", "A draft needs the structured content payload via --content-file <edition.json>");
+  }
+  if (options.subject !== undefined) {
+    body.subject = options.subject;
+  }
+  if (options.windowSince !== undefined) {
+    body.windowSince = options.windowSince;
+  }
+  if (options.windowUntil !== undefined) {
+    body.windowUntil = options.windowUntil;
+  }
+  return body;
+}
+function readContentFile(filePath) {
+  if (!existsSync2(filePath)) {
+    throw new CliError2("file_not_found", `Content file not found: ${filePath}`);
+  }
+  const text = readFileSync2(filePath, "utf-8");
+  try {
+    return JSON.parse(text);
+  } catch (error) {
+    throw new CliError2("invalid_content_json", `Content JSON parse failed: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+async function newsletterDraftCommand(options) {
+  return adminApiPost("/api/admin/newsletter/editions", buildBody2(options, { requireContent: true }));
+}
+async function newsletterUpdateCommand(id, options) {
+  return adminApiPatch(`/api/admin/newsletter/editions/${encodeURIComponent(id)}`, buildBody2(options, { requireContent: false }));
+}
+async function newsletterSendCommand(id) {
+  return adminApiPost(`/api/admin/newsletter/editions/${encodeURIComponent(id)}/send`);
+}
+async function newsletterListCommand() {
+  const response = await adminApiGet("/api/admin/newsletter/editions");
+  return response.editions;
+}
+var init_newsletter = __esm(() => {
+  init_api();
+  init_output();
+});
+
 // src/commands/add.ts
 async function addCommand2(spotifyUrl, options) {
   const result = await adminApiPost("/api/admin/tracks", {
@@ -3149,7 +3205,7 @@ var COORD_FALLBACK2 = "—";
 var init_format2 = () => {};
 
 // src/cli.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
 import path2 from "path";
 
 // ../../node_modules/commander/lib/error.js
@@ -5476,6 +5532,26 @@ function addAdminCommands(program2) {
     const { publishYoutubeCommand: publishYoutubeCommand3 } = await Promise.resolve().then(() => (init_mixtape_youtube2(), exports_mixtape_youtube2));
     await runMixtapePublishYoutube(idOrLogId, options, publishYoutubeCommand3);
   });
+  const adminNewsletter = configureCommand(admin.command("newsletter").description("Newsletter edition commands"));
+  adminNewsletter.action(() => {
+    adminNewsletter.outputHelp();
+  });
+  adminNewsletter.command("draft").description("Persist a newsletter edition draft (the agent authors it, you send it)").option("--content-file <file>", "Structured edition content payload (JSON)").option("--subject <text>", "Email subject line").option("--window-since <date>", "Discovery-window start (ISO)").option("--window-until <date>", "Discovery-window end (ISO)").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
+    const { newsletterDraftCommand: newsletterDraftCommand2 } = await Promise.resolve().then(() => (init_newsletter(), exports_newsletter));
+    await runNewsletterDraft(options, newsletterDraftCommand2);
+  });
+  adminNewsletter.command("update").description("Update a draft edition's payload, subject, or window").argument("[id]").option("--content-file <file>", "Structured edition content payload (JSON)").option("--subject <text>", "Email subject line").option("--window-since <date>", "Discovery-window start (ISO)").option("--window-until <date>", "Discovery-window end (ISO)").option("--json", "Print JSON", false).allowExcessArguments().action(async (id, options) => {
+    const { newsletterUpdateCommand: newsletterUpdateCommand2 } = await Promise.resolve().then(() => (init_newsletter(), exports_newsletter));
+    await runNewsletterUpdate(id, options, newsletterUpdateCommand2);
+  });
+  adminNewsletter.command("send").description("Send an edition \u2014 OPERATOR only (Resend broadcast + mint the number)").argument("[id]").option("--json", "Print JSON", false).allowExcessArguments().action(async (id, options) => {
+    const { newsletterSendCommand: newsletterSendCommand2 } = await Promise.resolve().then(() => (init_newsletter(), exports_newsletter));
+    await runNewsletterSend(id, options, newsletterSendCommand2);
+  });
+  adminNewsletter.command("list").description("List every edition including drafts (the cron's miss-recovery read)").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
+    const { newsletterListCommand: newsletterListCommand2 } = await Promise.resolve().then(() => (init_newsletter(), exports_newsletter));
+    await runNewsletterList(options, newsletterListCommand2);
+  });
   const submissions = configureCommand(admin.command("submissions").description("Review listener submissions"));
   submissions.option("--json", "Print JSON", false).action(async (options) => {
     const { listSubmissionsCommand: listSubmissionsCommand2 } = await Promise.resolve().then(() => (init_submissions(), exports_submissions));
@@ -5555,7 +5631,7 @@ async function runTrackPreviewArchive(idOrLogId, options, previewArchiveUploadCo
   console.log(`  mime: ${result.mime}`);
 }
 async function runTrackObserve(idOrLogId, options, trackObserveCommand2) {
-  const script = options.scriptFile ? readFileSync2(options.scriptFile, "utf8") : options.script;
+  const script = options.scriptFile ? readFileSync3(options.scriptFile, "utf8") : options.script;
   if (!idOrLogId || !script || !script.trim()) {
     throw new Error("Usage: fluncle admin tracks observe <track_id|log_id> (--script <text> | --script-file <file>) [--voice-id <id>] [--model <model>] [--duration-ms <ms>] [--context-note <text>] [--json]");
   }
@@ -5631,6 +5707,7 @@ async function runBackfillLastfm(options, backfillLastfmCommand2) {
   const limit = parseListLimit(options.limit);
   const loved = [];
   const failed = [];
+  const skipped = [];
   let cursor;
   let dryRun = options.dryRun;
   while (loved.length + failed.length < limit) {
@@ -5639,9 +5716,10 @@ async function runBackfillLastfm(options, backfillLastfmCommand2) {
     dryRun = result.dryRun;
     loved.push(...result.loved);
     failed.push(...result.failed);
+    skipped.push(...result.skipped);
     if (!options.json) {
       const verb2 = result.dryRun ? "Would love" : "Loved";
-      console.log(`  \u2026${verb2.toLowerCase()} ${result.lovedCount}; ${result.failedCount} failed`);
+      console.log(`  \u2026${verb2.toLowerCase()} ${result.lovedCount}; ${result.failedCount} failed; ${result.skippedCount} skipped`);
     }
     if (result.nextCursor === null) {
       break;
@@ -5655,12 +5733,14 @@ async function runBackfillLastfm(options, backfillLastfmCommand2) {
       failedCount: failed.length,
       loved,
       lovedCount: loved.length,
-      ok: true
+      ok: true,
+      skipped,
+      skippedCount: skipped.length
     });
     return;
   }
   const verb = dryRun ? "Would love" : "Loved";
-  console.log(`${verb} ${loved.length} finding(s) on Last.fm; ${failed.length} failed.`);
+  console.log(`${verb} ${loved.length} finding(s) on Last.fm; ${failed.length} failed; ${skipped.length} skipped.`);
   for (const logId of loved) {
     console.log(`  ${logId}`);
   }
@@ -5672,6 +5752,7 @@ async function runBackfillDiscogs(options, backfillDiscogsCommand2) {
   const limit = parseListLimit(options.limit);
   const resolved = [];
   const unresolved = [];
+  const skipped = [];
   let cursor;
   let dryRun = options.dryRun;
   while (resolved.length + unresolved.length < limit) {
@@ -5680,9 +5761,10 @@ async function runBackfillDiscogs(options, backfillDiscogsCommand2) {
     dryRun = result.dryRun;
     resolved.push(...result.resolved);
     unresolved.push(...result.unresolved);
+    skipped.push(...result.skipped);
     if (!options.json) {
       const verb2 = result.dryRun ? "would resolve" : "resolved";
-      console.log(`  \u2026${verb2} ${result.resolvedCount}; ${result.unresolvedCount} unresolved`);
+      console.log(`  \u2026${verb2} ${result.resolvedCount}; ${result.unresolvedCount} unresolved; ${result.skippedCount} skipped`);
     }
     if (result.nextCursor === null) {
       break;
@@ -5695,13 +5777,15 @@ async function runBackfillDiscogs(options, backfillDiscogsCommand2) {
       ok: true,
       resolved,
       resolvedCount: resolved.length,
+      skipped,
+      skippedCount: skipped.length,
       unresolved,
       unresolvedCount: unresolved.length
     });
     return;
   }
   const verb = dryRun ? "Would resolve" : "Resolved";
-  console.log(`${verb} ${resolved.length} Discogs release id(s); ${unresolved.length} unresolved.`);
+  console.log(`${verb} ${resolved.length} Discogs release id(s); ${unresolved.length} unresolved; ${skipped.length} skipped.`);
   for (const item of resolved) {
     const master = item.masterId ? ` (master ${item.masterId})` : "";
     console.log(`  ${item.logId}: release ${item.releaseId}${master}`);
@@ -5717,7 +5801,7 @@ async function runTrackVideo(idOrLogId, options, trackVideoCommand2) {
       return;
     }
     const candidate = path2.join(dir, name);
-    return existsSync2(candidate) ? candidate : undefined;
+    return existsSync3(candidate) ? candidate : undefined;
   };
   const resolveFile = (explicit, name) => {
     if (explicit) {
@@ -5983,6 +6067,53 @@ function formatCue(ms) {
   }
   return `${minutes}:${seconds.toString().padStart(2, "0")}`;
 }
+async function runNewsletterDraft(options, newsletterDraftCommand2) {
+  const result = await newsletterDraftCommand2(options);
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  console.log(`Drafted edition ${result.edition.id}. It stays a draft until the operator sends it.`);
+}
+async function runNewsletterUpdate(id, options, newsletterUpdateCommand2) {
+  if (!id) {
+    throw new Error("Missing edition id. Usage: fluncle admin newsletter update <id>");
+  }
+  const result = await newsletterUpdateCommand2(id, options);
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  console.log(`Saved draft ${result.edition.id}.`);
+}
+async function runNewsletterSend(id, options, newsletterSendCommand2) {
+  if (!id) {
+    throw new Error("Missing edition id. Usage: fluncle admin newsletter send <id>");
+  }
+  const result = await newsletterSendCommand2(id);
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  const number = result.edition.number;
+  console.log(number === undefined ? `Sent edition ${result.edition.id}.` : `Sent edition #${number} \u2014 it's out to the list and in the archive.`);
+}
+async function runNewsletterList(options, newsletterListCommand2) {
+  const editions = await newsletterListCommand2();
+  if (options.json) {
+    printJson({ editions, ok: true });
+    return;
+  }
+  if (editions.length === 0) {
+    console.log("No editions yet.");
+    return;
+  }
+  for (const edition of editions) {
+    const label = edition.number === undefined ? "draft" : `#${edition.number}`;
+    const subject = edition.subject ?? "(no subject)";
+    console.log(`${label}	${edition.status}	${edition.id}	${subject}`);
+  }
+}
 async function runAdd(spotifyUrl, options, addCommand3) {
   if (!spotifyUrl) {
     throw new Error("Missing Spotify track URL");

package/package.json

@@ -31,5 +31,5 @@
     "url": "git+https://github.com/mauricekleine/fluncle.git"
   },
   "type": "module",
-  "version": "0.52.0"
+  "version": "0.54.0"
 }