silver-music-notifier 1.0.0 → 1.1.0

package/README.md

@@ -19,15 +19,17 @@ driver), which is built automatically on install.
 
 MusicBrainz requires every API client to identify a contact (an email or URL) in
 its User-Agent, and throttles or blocks requests without one. The first time you
-run a command that hits the API (`add` or `refresh`), the CLI **prompts you for a
-contact** and saves it. You can also set it ahead of time:
+run most CLI commands, the CLI **prompts you for a contact** and saves it.
+Non-network setup commands such as `config set`, `clear-data`, and `dismiss`
+can run before the contact is configured. You can also set it ahead of time:
 
 ```bash
 silver-music-notifier config set musicbrainz.contact you@example.com
 ```
 
-or in the web UI's **Settings** view. In a non-interactive context (no TTY), the
-command errors with this guidance instead of prompting.
+or in the web UI's **Settings** view after the app has launched. In a
+non-interactive context (no TTY), commands that require the contact error with
+this guidance instead of prompting.
 
 ## Usage
 
@@ -55,9 +57,12 @@ silver-music-notifier add "X" --mbid <mbid>    # add an exact MBID
 silver-music-notifier list                     # list tracked artists
 silver-music-notifier remove "Radiohead"       # stop tracking (by name or MBID)
 silver-music-notifier refresh                  # fetch releases + notify on new ones
+silver-music-notifier refresh --no-notify      # fetch without sending email
 silver-music-notifier releases --new --limit 20
+silver-music-notifier dismiss <release-mbid>   # hide a release's New badge
 silver-music-notifier config get               # show settings
 silver-music-notifier config set notify.email true
+silver-music-notifier clear-data               # delete artists/releases, keep settings
 ```
 
 ## Notifications
@@ -65,12 +70,43 @@ silver-music-notifier config set notify.email true
 When `refresh` finds releases it has never seen before, it can notify you two ways:
 
 - **In-page badges** — "New" badges in the web UI (always available).
-- **Email** — an HTML summary, sent once SMTP is configured and the email toggle
-  is on. Configure it in the **Settings** view or via `config set smtp.*`.
+- **Email** — one HTML email per new release, sent once SMTP is configured and
+  the email toggle is on. Configure it in the **Settings** view or via
+  `config set smtp.host`, `smtp.port`, `smtp.secure`, `smtp.user`, `smtp.pass`,
+  `smtp.from`, and `smtp.to`.
+
+Adding a new artist refreshes that artist immediately, but treats the existing
+catalog as your starting baseline: it does not send email for those releases or
+mark them with "New" badges.
 
 `refresh` is manual — run it from the CLI, the web button, or your own scheduler
 (cron, systemd timer, etc.).
 
+### Cron refresh
+
+To check for new releases on a schedule, first make sure the CLI has the required
+MusicBrainz contact and any notification settings configured:
+
+```bash
+silver-music-notifier config set musicbrainz.contact you@example.com
+silver-music-notifier config set notify.email true   # optional, if SMTP is configured
+```
+
+Then add a cron entry. This example refreshes every day at 9:00 AM:
+
+```cron
+0 9 * * * /usr/bin/env silver-music-notifier refresh >> "$HOME/.local/share/silver-music-notifier/cron.log" 2>&1
+```
+
+If cron cannot find the command, use the full path from
+`command -v silver-music-notifier`. To use a custom database location, set
+`SILVER_MUSIC_NOTIFIER_DATA_DIR` in the cron line:
+
+```cron
+0 9 * * *
+SILVER_MUSIC_NOTIFIER_DATA_DIR="$HOME/.local/share/silver-music-notifier" /usr/bin/env silver-music-notifier refresh >> "$HOME/.local/share/silver-music-notifier/cron.log" 2>&1
+```
+
 ## Data & configuration
 
 State lives in a single SQLite file (`data.db`) in your per-user data directory:
@@ -89,23 +125,3 @@ variable.
 Notification methods (in-page / email) and the MusicBrainz contact are
 configured in the web UI's **Settings** view or via `silver-music-notifier
 config set …` — not through environment variables.
-
-The only environment variable is:
-
-- `SILVER_MUSIC_NOTIFIER_DATA_DIR` — override the data directory (must be an env
-  var, since all other settings are stored inside it).
-
-## Development
-
-```bash
-npm install
-npm run dev        # backend (tsx watch, :3001) + Vite dev server (:5173, proxies /api)
-npm run build      # bundle CLI/server (tsup) + build web (vite) into dist/
-npm run typecheck
-npm run lint       # eslint
-npm run lint:fix   # eslint --fix
-npm run format     # prettier --write .
-```
-
-A Husky `pre-commit` hook runs `lint-staged` (eslint `--fix` then prettier on
-staged files) followed by `typecheck`, so commits are auto-formatted and linted.

package/dist/cli/index.js

@@ -12,10 +12,10 @@ import { dirname, join as join2 } from "path";
 // src/lib/musicbrainz.ts
 import { MusicBrainzApi } from "musicbrainz-api";
 
-// package.json
+// package.json with { type: 'json' }
 var package_default = {
   name: "silver-music-notifier",
-  version: "1.0.0",
+  version: "1.1.0",
   description: "Track artists and get notified of their new music releases from MusicBrainz, via CLI or a local web UI.",
   license: "MIT",
   author: "Andrey Goder <andy.goder@gmail.com>",
@@ -434,34 +434,106 @@ async function fetchReleaseGroups(artistMbid) {
 
 // src/lib/notify.ts
 import nodemailer from "nodemailer";
-function summaryLine(newReleases) {
-  const n = newReleases.length;
-  const artists = [...new Set(newReleases.map((r) => r.artistName))];
-  const who = artists.length <= 3 ? artists.join(", ") : `${artists.slice(0, 3).join(", ")} +${artists.length - 3} more`;
-  return `${n} new release${n === 1 ? "" : "s"} from ${who}`;
+
+// src/lib/Release.ts
+var Release = class _Release {
+  mbid;
+  artistMbid;
+  artistName;
+  title;
+  primaryType;
+  secondaryTypes;
+  firstReleaseDate;
+  firstSeenAt;
+  isNew;
+  constructor(input) {
+    this.mbid = input.mbid;
+    this.artistMbid = input.artistMbid;
+    this.artistName = input.artistName;
+    this.title = input.title;
+    this.primaryType = input.primaryType;
+    this.secondaryTypes = input.secondaryTypes;
+    this.firstReleaseDate = input.firstReleaseDate;
+    this.firstSeenAt = input.firstSeenAt;
+    this.isNew = input.dismissedAt == null && input.lastRefresh != null && input.firstSeenAt >= input.lastRefresh;
+  }
+  static list(opts = {}) {
+    const lastRefresh = Settings.getLastRefreshAt();
+    const rows = AppDb.getDefault().prepare(
+      `SELECT rg.mbid, rg.artist_mbid, a.name AS artist_name, rg.title,
+                rg.primary_type, rg.secondary_types, rg.first_release_date,
+                rg.first_seen_at, rg.dismissed_at
+         FROM release_groups rg
+         JOIN artists a ON a.mbid = rg.artist_mbid
+         ORDER BY (rg.first_release_date IS NULL), rg.first_release_date DESC, rg.title`
+    ).all();
+    const items = rows.map(
+      (row) => new _Release({
+        mbid: row.mbid,
+        artistMbid: row.artist_mbid,
+        artistName: row.artist_name,
+        title: row.title,
+        primaryType: row.primary_type,
+        secondaryTypes: row.secondary_types,
+        firstReleaseDate: row.first_release_date,
+        firstSeenAt: row.first_seen_at,
+        dismissedAt: row.dismissed_at,
+        lastRefresh
+      })
+    );
+    const filtered = opts.onlyNew ? items.filter((i) => i.isNew) : items;
+    return opts.limit ? filtered.slice(0, opts.limit) : filtered;
+  }
+  static dismiss(mbid) {
+    const res = AppDb.getDefault().prepare("UPDATE release_groups SET dismissed_at = ? WHERE mbid = ?").run((/* @__PURE__ */ new Date()).toISOString(), mbid);
+    return res.changes > 0;
+  }
+};
+
+// src/lib/formatReleaseDate.ts
+var monthNames = [
+  "Jan",
+  "Feb",
+  "Mar",
+  "Apr",
+  "May",
+  "Jun",
+  "Jul",
+  "Aug",
+  "Sep",
+  "Oct",
+  "Nov",
+  "Dec"
+];
+function formatReleaseDate(value) {
+  if (!value) {
+    return "\u2014";
+  }
+  const [year, month, day] = value.split("-").map(Number);
+  if (!year) {
+    return value;
+  }
+  if (month && !day) {
+    return `${monthNames[month - 1]} ${year}`;
+  }
+  if (!month || !day) {
+    return value;
+  }
+  return `${day} ${monthNames[month - 1]} ${year}`;
+}
+
+// src/lib/notify.ts
+function subjectLine(r) {
+  return `New Release: ${r.title} by ${r.artistName}`;
 }
-function emailHtml(newReleases) {
-  const rows = newReleases.map((r) => {
-    const type = [r.primaryType, ...r.secondaryTypes].filter(Boolean).join(" / ");
-    const date = r.firstReleaseDate ?? "\u2014";
-    return `<tr>
-        <td style="padding:4px 12px 4px 0">${escapeHtml(r.artistName)}</td>
-        <td style="padding:4px 12px 4px 0"><strong>${escapeHtml(r.title)}</strong></td>
-        <td style="padding:4px 12px 4px 0">${escapeHtml(type)}</td>
-        <td style="padding:4px 0">${escapeHtml(date)}</td>
-      </tr>`;
-  }).join("");
+function emailHtml(r) {
+  const type = [r.primaryType, ...r.secondaryTypes].filter(Boolean).join(" / ");
+  const title = `<strong>${escapeHtml(r.title)}</strong>`;
+  const artist = escapeHtml(r.artistName);
+  const typeText = type ? ` (${escapeHtml(type)})` : "";
+  const dateText = r.firstReleaseDate ? ` was released on ${escapeHtml(formatReleaseDate(r.firstReleaseDate))}` : " is out";
   return `<div style="font-family:system-ui,sans-serif">
-    <h2>${escapeHtml(summaryLine(newReleases))}</h2>
-    <table style="border-collapse:collapse">
-      <thead><tr>
-        <th align="left" style="padding:4px 12px 4px 0">Artist</th>
-        <th align="left" style="padding:4px 12px 4px 0">Title</th>
-        <th align="left" style="padding:4px 12px 4px 0">Type</th>
-        <th align="left" style="padding:4px 0">Released</th>
-      </tr></thead>
-      <tbody>${rows}</tbody>
-    </table>
+    <p>${title} by ${artist}${typeText}${dateText}.</p>
   </div>`;
 }
 function escapeHtml(s) {
@@ -479,12 +551,12 @@ function transport(s) {
     auth: smtp.user ? { user: smtp.user, pass: smtp.pass } : void 0
   });
 }
-async function emailNotify(newReleases, s) {
+async function sendReleaseEmail(release, s, subjectPrefix = "") {
   await transport(s).sendMail({
     from: s.smtp.from || s.smtp.user,
     to: s.smtp.to,
-    subject: summaryLine(newReleases),
-    html: emailHtml(newReleases)
+    subject: subjectPrefix + subjectLine(release),
+    html: emailHtml(release)
   });
 }
 async function notifyNewReleases(newReleases) {
@@ -496,14 +568,42 @@ async function notifyNewReleases(newReleases) {
     if (!s.smtpIsConfigured()) {
       console.warn("Email enabled but SMTP not configured \u2014 skipping email.");
     } else {
-      try {
-        await emailNotify(newReleases, s);
-      } catch (err) {
-        console.error("Email notification failed:", errMsg(err));
+      for (const release of newReleases) {
+        try {
+          await sendReleaseEmail(release, s);
+        } catch (err) {
+          console.error(
+            `Email notification failed for "${release.title}":`,
+            errMsg(err)
+          );
+        }
       }
     }
   }
 }
+function sampleRelease() {
+  const [latest] = Release.list({ limit: 1 });
+  if (latest) {
+    return {
+      mbid: latest.mbid,
+      artistMbid: latest.artistMbid,
+      artistName: latest.artistName,
+      title: latest.title,
+      primaryType: latest.primaryType,
+      secondaryTypes: latest.secondaryTypes ? latest.secondaryTypes.split(", ") : [],
+      firstReleaseDate: latest.firstReleaseDate
+    };
+  }
+  return {
+    mbid: "sample",
+    artistMbid: "sample",
+    artistName: "Example Artist",
+    title: "Example Album",
+    primaryType: "Album",
+    secondaryTypes: [],
+    firstReleaseDate: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10)
+  };
+}
 async function sendTestEmail(override) {
   const s = override ?? Settings.load();
   if (!s.smtpIsConfigured()) {
@@ -511,12 +611,7 @@ async function sendTestEmail(override) {
       "SMTP is not configured (host, user, and recipient required)."
     );
   }
-  await transport(s).sendMail({
-    from: s.smtp.from || s.smtp.user,
-    to: s.smtp.to,
-    subject: "silver-music-notifier test email",
-    text: "This is a test email from silver-music-notifier. SMTP is working."
-  });
+  await sendReleaseEmail(sampleRelease(), s, "[TEST] ");
 }
 function errMsg(err) {
   return err instanceof Error ? err.message : String(err);
@@ -586,7 +681,7 @@ var Artist = class _Artist {
 };
 
 // src/lib/refresh.ts
-async function refreshArtists(artists, opts, persistLastRefresh) {
+async function refreshArtists(artists, opts, persistLastRefresh, markReleasesSeen) {
   const db = AppDb.getDefault();
   const startedAt = (/* @__PURE__ */ new Date()).toISOString();
   const settings = Settings.load();
@@ -597,9 +692,9 @@ async function refreshArtists(artists, opts, persistLastRefresh) {
   const insert = db.prepare(`
     INSERT INTO release_groups
       (mbid, artist_mbid, title, primary_type, secondary_types,
-       first_release_date, first_seen_at, last_seen_at)
+       first_release_date, first_seen_at, last_seen_at, dismissed_at)
     VALUES (@mbid, @artist_mbid, @title, @primary_type, @secondary_types,
-            @first_release_date, @now, @now)
+            @first_release_date, @now, @now, @dismissed_at)
     ON CONFLICT(mbid) DO UPDATE SET
       title = excluded.title,
       primary_type = excluded.primary_type,
@@ -628,7 +723,8 @@ async function refreshArtists(artists, opts, persistLastRefresh) {
             primary_type: g.primaryType,
             secondary_types: g.secondaryTypes.join(", ") || null,
             first_release_date: g.firstReleaseDate,
-            now
+            now,
+            dismissed_at: markReleasesSeen ? now : null
           });
           if (!seen) {
             newReleases.push({
@@ -667,67 +763,12 @@ async function refreshArtists(artists, opts, persistLastRefresh) {
   return summary;
 }
 async function refreshArtist(artist, opts = {}) {
-  return refreshArtists([artist], opts, false);
+  return refreshArtists([artist], opts, false, true);
 }
 async function refresh(opts = {}) {
-  return refreshArtists(Artist.list(), opts, true);
+  return refreshArtists(Artist.list(), opts, true, false);
 }
 
-// src/lib/Release.ts
-var Release = class _Release {
-  mbid;
-  artistMbid;
-  artistName;
-  title;
-  primaryType;
-  secondaryTypes;
-  firstReleaseDate;
-  firstSeenAt;
-  isNew;
-  constructor(input) {
-    this.mbid = input.mbid;
-    this.artistMbid = input.artistMbid;
-    this.artistName = input.artistName;
-    this.title = input.title;
-    this.primaryType = input.primaryType;
-    this.secondaryTypes = input.secondaryTypes;
-    this.firstReleaseDate = input.firstReleaseDate;
-    this.firstSeenAt = input.firstSeenAt;
-    this.isNew = input.dismissedAt == null && input.lastRefresh != null && input.firstSeenAt >= input.lastRefresh;
-  }
-  static list(opts = {}) {
-    const lastRefresh = Settings.getLastRefreshAt();
-    const rows = AppDb.getDefault().prepare(
-      `SELECT rg.mbid, rg.artist_mbid, a.name AS artist_name, rg.title,
-                rg.primary_type, rg.secondary_types, rg.first_release_date,
-                rg.first_seen_at, rg.dismissed_at
-         FROM release_groups rg
-         JOIN artists a ON a.mbid = rg.artist_mbid
-         ORDER BY (rg.first_release_date IS NULL), rg.first_release_date DESC, rg.title`
-    ).all();
-    const items = rows.map(
-      (row) => new _Release({
-        mbid: row.mbid,
-        artistMbid: row.artist_mbid,
-        artistName: row.artist_name,
-        title: row.title,
-        primaryType: row.primary_type,
-        secondaryTypes: row.secondary_types,
-        firstReleaseDate: row.first_release_date,
-        firstSeenAt: row.first_seen_at,
-        dismissedAt: row.dismissed_at,
-        lastRefresh
-      })
-    );
-    const filtered = opts.onlyNew ? items.filter((i) => i.isNew) : items;
-    return opts.limit ? filtered.slice(0, opts.limit) : filtered;
-  }
-  static dismiss(mbid) {
-    const res = AppDb.getDefault().prepare("UPDATE release_groups SET dismissed_at = ? WHERE mbid = ?").run((/* @__PURE__ */ new Date()).toISOString(), mbid);
-    return res.changes > 0;
-  }
-};
-
 // src/server/index.ts
 function webDir() {
   const here = dirname(fileURLToPath(import.meta.url));
@@ -848,17 +889,42 @@ function createApp() {
   return app;
 }
 function startServer(port) {
-  return new Promise((resolve) => {
-    createApp().listen(port, () => resolve());
+  return new Promise((resolve, reject) => {
+    const server = createApp().listen(port);
+    server.once("listening", () => {
+      server.removeListener("error", reject);
+      resolve(port);
+    });
+    server.once("error", reject);
   });
 }
 
 // src/cli/commands/web.ts
+var MAX_PORT_ATTEMPTS = 10;
+function isAddrInUse(err) {
+  return typeof err === "object" && err !== null && err.code === "EADDRINUSE";
+}
 function registerWeb(program2) {
   program2.command("web").description("Launch the local web UI").option("-p, --port <port>", "port to listen on", "3001").option("--no-open", "do not open a browser window").action(async (opts) => {
-    const port = Number(opts.port);
-    await startServer(port);
-    const url = `http://localhost:${port}`;
+    const requested = Number(opts.port);
+    let bound;
+    for (let port = requested; port < requested + MAX_PORT_ATTEMPTS; port++) {
+      try {
+        bound = await startServer(port);
+        break;
+      } catch (err) {
+        if (!isAddrInUse(err)) {
+          throw err;
+        }
+        console.log(`Port ${port} is in use, trying ${port + 1}\u2026`);
+      }
+    }
+    if (bound === void 0) {
+      throw new Error(
+        `Could not find a free port in range ${requested}\u2013${requested + MAX_PORT_ATTEMPTS - 1}.`
+      );
+    }
+    const url = `http://localhost:${bound}`;
     console.log(`silver-music-notifier web UI running at ${url}`);
     if (opts.open) {
       try {
@@ -1169,6 +1235,110 @@ async function ensureMbContact() {
   );
 }
 
+// package.json
+var package_default2 = {
+  name: "silver-music-notifier",
+  version: "1.1.0",
+  description: "Track artists and get notified of their new music releases from MusicBrainz, via CLI or a local web UI.",
+  license: "MIT",
+  author: "Andrey Goder <andy.goder@gmail.com>",
+  homepage: "https://github.com/czarandy/silver-music-notifier#readme",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/czarandy/silver-music-notifier.git"
+  },
+  bugs: {
+    url: "https://github.com/czarandy/silver-music-notifier/issues"
+  },
+  keywords: [
+    "musicbrainz",
+    "music",
+    "new-releases",
+    "release-radar",
+    "notifier",
+    "cli",
+    "sqlite"
+  ],
+  type: "module",
+  bin: {
+    "silver-music-notifier": "dist/cli/index.js"
+  },
+  files: [
+    "dist"
+  ],
+  publishConfig: {
+    access: "public"
+  },
+  engines: {
+    node: ">=22.12.0"
+  },
+  scripts: {
+    dev: 'concurrently -n server,web -c blue,magenta "tsx watch src/cli/index.ts web --no-open" "vite"',
+    build: "npm run build:bundle && npm run build:web",
+    "build:bundle": "tsup",
+    "build:web": "vite build",
+    prepare: "husky && npm run build",
+    refresh: "tsx src/cli/index.ts refresh",
+    typecheck: "tsc --noEmit",
+    test: "vitest run",
+    lint: "eslint .",
+    "lint:fix": "eslint --fix .",
+    format: "prettier --write .",
+    "format:check": "prettier --check .",
+    "check:exports": "publint",
+    "smoke:package": "npm run build && node scripts/package-smoke-test.mjs",
+    release: "bash scripts/release.sh"
+  },
+  "lint-staged": {
+    "*.{ts,tsx}": [
+      "eslint --fix --no-warn-ignored",
+      "prettier --write"
+    ],
+    "*.{js,jsx,json,css,md,html}": "prettier --write"
+  },
+  dependencies: {
+    "@inquirer/prompts": "^7.2.0",
+    "@tanstack/react-query": "^5.101.0",
+    "better-sqlite3": "^11.7.0",
+    commander: "^13.0.0",
+    "env-paths": "^3.0.0",
+    express: "^4.21.2",
+    "musicbrainz-api": "^1.2.1",
+    nodemailer: "^9.0.0",
+    open: "^10.1.0"
+  },
+  devDependencies: {
+    "@eslint/js": "^9.39.4",
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/express": "^4.17.21",
+    "@types/node": "^22.10.0",
+    "@types/nodemailer": "^6.4.17",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^6.0.2",
+    concurrently: "^9.1.0",
+    eslint: "^9.39.4",
+    globals: "^15.15.0",
+    husky: "^9.1.7",
+    "lint-staged": "^15.5.2",
+    prettier: "^3.8.4",
+    publint: "^0.3.21",
+    react: "^19.0.0",
+    "react-dom": "^19.0.0",
+    "silver-ui": "^0.7.1",
+    tsup: "^8.3.5",
+    tsx: "^4.19.2",
+    typescript: "^5.7.2",
+    "typescript-eslint": "^8.61.0",
+    vite: "^8.0.16",
+    vitest: "^4.1.8"
+  },
+  overrides: {
+    esbuild: "0.28.1",
+    "shell-quote": "1.8.4"
+  }
+};
+
 // src/cli/index.ts
 var program = new Command();
 var CONTACT_EXEMPT_COMMANDS = /* @__PURE__ */ new Set(["config", "clear-data", "dismiss"]);
@@ -1182,7 +1352,7 @@ program.hook("preAction", async (_thisCommand, actionCommand) => {
 });
 program.name("silver-music-notifier").description(
   "Track artists and get notified of their new music releases from MusicBrainz."
-).version("0.1.0");
+).version(package_default2.version);
 registerWeb(program);
 registerList(program);
 registerAdd(program);