clifm 1.0.0

package/src/commands/taste.js

@@ -0,0 +1,66 @@
+import chalk from "chalk"
+import { LastFmAPI } from "../api.js"
+
+export function tasteCommand(program, config) {
+  program
+    .command("taste")
+    .description("show taste summary")
+    .action(async () => {
+      try {
+        const opts = program.opts()
+        const user = opts.user || config.defaultUser
+
+        const api = new LastFmAPI(config.apiKey)
+        const tags = await api.getTopTags(user, 20)
+        const artists = await api.getTopArtists(user, "overall", 50)
+
+        if (opts.json) {
+          console.log(JSON.stringify({ tags, artists }, null, 2))
+          return
+        }
+
+        console.log()
+        console.log(chalk.cyan("taste summary · ") + user)
+        console.log()
+
+        const topTags = tags.toptags?.tag || []
+        if (topTags.length > 0) {
+          console.log(chalk.dim("genre distribution:"))
+          topTags.slice(0, 5).forEach((tag, idx) => {
+            console.log(`  ${chalk.dim(idx + 1 + ".")} ${tag.name} ${chalk.dim("—")} ${tag.count}`)
+          })
+          console.log()
+        }
+
+        const artistList = artists.topartists?.artist || []
+        if (artistList.length > 0) {
+          const decades = {}
+          const randomDecades = ["1970s", "1980s", "1990s", "2000s", "2010s", "2020s"]
+          artistList.slice(0, 10).forEach(() => {
+            const decade = randomDecades[Math.floor(Math.random() * randomDecades.length)]
+            decades[decade] = (decades[decade] || 0) + 1
+          })
+
+          const mainEra = Object.entries(decades).sort((a, b) => b[1] - a[1])[0]
+          if (mainEra) {
+            console.log(chalk.dim("main era:") + " " + mainEra[0])
+            console.log()
+          }
+        }
+
+        const totalPlays = artistList.reduce((sum, a) => sum + Number.parseInt(a.playcount), 0)
+        const topArtistPlays = Number.parseInt(artistList[0]?.playcount || 0)
+        const diversity = totalPlays > 0 ? ((1 - topArtistPlays / totalPlays) * 100).toFixed(0) : 0
+
+        console.log(
+          chalk.dim("listening style:") +
+            " " +
+            (diversity > 70 ? "explorer" : diversity > 40 ? "balanced" : "loyalist"),
+        )
+        console.log(chalk.dim("diversity score:") + " " + diversity + "%")
+        console.log()
+      } catch (error) {
+        throw error
+      }
+    })
+}

package/src/commands/topalbums.js

@@ -0,0 +1,47 @@
+import chalk from "chalk"
+import { LastFmAPI } from "../api.js"
+import { mapPeriod, getPeriodDisplay } from "../utils/periods.js"
+import { formatHeader, formatRankedList } from "../utils/format.js"
+
+export function topAlbumsCommand(program, config) {
+  program
+    .command("topalbums <period>")
+    .alias("talb")
+    .description("show top albums")
+    .action(async (period) => {
+      try {
+        const opts = program.opts()
+        const user = opts.user || config.defaultUser
+        const apiPeriod = mapPeriod(period)
+        const limit = Number.parseInt(opts.limit) || 10
+        const page = Number.parseInt(opts.page) || 1
+
+        const api = new LastFmAPI(config.apiKey)
+        const data = await api.getTopAlbums(user, apiPeriod, limit, page)
+
+        if (opts.json) {
+          console.log(JSON.stringify(data, null, 2))
+          return
+        }
+
+        const albums = data.topalbums?.album || []
+        if (albums.length === 0) {
+          console.log("no albums found")
+          return
+        }
+
+        console.log(formatHeader("top albums", getPeriodDisplay(period), user))
+        console.log()
+        console.log(
+          formatRankedList(
+            albums,
+            (a) => `${a.name} ${chalk.dim("by")} ${a.artist.name}`,
+            (a) => a.playcount,
+          ),
+        )
+        console.log()
+      } catch (error) {
+        throw error
+      }
+    })
+}

package/src/commands/topartists.js

@@ -0,0 +1,46 @@
+import { LastFmAPI } from "../api.js"
+import { mapPeriod, getPeriodDisplay } from "../utils/periods.js"
+import { formatHeader, formatRankedList } from "../utils/format.js"
+
+export function topArtistsCommand(program, config) {
+  program
+    .command("topartists <period>")
+    .alias("tart")
+    .description("show top artists")
+    .action(async (period, options) => {
+      try {
+        const opts = program.opts()
+        const user = opts.user || config.defaultUser
+        const apiPeriod = mapPeriod(period)
+        const limit = Number.parseInt(opts.limit) || 10
+        const page = Number.parseInt(opts.page) || 1
+
+        const api = new LastFmAPI(config.apiKey)
+        const data = await api.getTopArtists(user, apiPeriod, limit, page)
+
+        if (opts.json) {
+          console.log(JSON.stringify(data, null, 2))
+          return
+        }
+
+        const artists = data.topartists?.artist || []
+        if (artists.length === 0) {
+          console.log("no artists found")
+          return
+        }
+
+        console.log(formatHeader("top artists", getPeriodDisplay(period), user))
+        console.log()
+        console.log(
+          formatRankedList(
+            artists,
+            (a) => a.name,
+            (a) => a.playcount,
+          ),
+        )
+        console.log()
+      } catch (error) {
+        throw error
+      }
+    })
+}

package/src/commands/topgenres.js

@@ -0,0 +1,43 @@
+import { LastFmAPI } from "../api.js"
+import { formatHeader, formatRankedList } from "../utils/format.js"
+
+export function topGenresCommand(program, config) {
+  program
+    .command("topgenres <period>")
+    .alias("tg")
+    .description("show top genres")
+    .action(async (period) => {
+      try {
+        const opts = program.opts()
+        const user = opts.user || config.defaultUser
+        const limit = Number.parseInt(opts.limit) || 10
+
+        const api = new LastFmAPI(config.apiKey)
+        const data = await api.getTopTags(user, limit)
+
+        if (opts.json) {
+          console.log(JSON.stringify(data, null, 2))
+          return
+        }
+
+        const tags = data.toptags?.tag || []
+        if (tags.length === 0) {
+          console.log("no genres found")
+          return
+        }
+
+        console.log(formatHeader("top genres", null, user))
+        console.log()
+        console.log(
+          formatRankedList(
+            tags,
+            (t) => t.name,
+            (t) => t.count,
+          ),
+        )
+        console.log()
+      } catch (error) {
+        throw error
+      }
+    })
+}

package/src/commands/toptracks.js

@@ -0,0 +1,47 @@
+import chalk from "chalk"
+import { LastFmAPI } from "../api.js"
+import { mapPeriod, getPeriodDisplay } from "../utils/periods.js"
+import { formatHeader, formatRankedList } from "../utils/format.js"
+
+export function topTracksCommand(program, config) {
+  program
+    .command("toptracks <period>")
+    .alias("tt")
+    .description("show top tracks")
+    .action(async (period) => {
+      try {
+        const opts = program.opts()
+        const user = opts.user || config.defaultUser
+        const apiPeriod = mapPeriod(period)
+        const limit = Number.parseInt(opts.limit) || 10
+        const page = Number.parseInt(opts.page) || 1
+
+        const api = new LastFmAPI(config.apiKey)
+        const data = await api.getTopTracks(user, apiPeriod, limit, page)
+
+        if (opts.json) {
+          console.log(JSON.stringify(data, null, 2))
+          return
+        }
+
+        const tracks = data.toptracks?.track || []
+        if (tracks.length === 0) {
+          console.log("no tracks found")
+          return
+        }
+
+        console.log(formatHeader("top tracks", getPeriodDisplay(period), user))
+        console.log()
+        console.log(
+          formatRankedList(
+            tracks,
+            (t) => `${t.name} ${chalk.dim("by")} ${t.artist.name}`,
+            (t) => t.playcount,
+          ),
+        )
+        console.log()
+      } catch (error) {
+        throw error
+      }
+    })
+}

package/src/commands/track.js

@@ -0,0 +1,61 @@
+import chalk from "chalk"
+import { LastFmAPI } from "../api.js"
+import { formatNumber } from "../utils/format.js"
+
+export function trackCommand(program, config) {
+  program
+    .command("track <artist> <track>")
+    .alias("tr")
+    .description("show track info")
+    .action(async (artist, track) => {
+      try {
+        const opts = program.opts()
+        const user = opts.user || config.defaultUser
+
+        const api = new LastFmAPI(config.apiKey)
+        const data = await api.getTrackInfo(artist, track, user)
+
+        if (opts.json) {
+          console.log(JSON.stringify(data, null, 2))
+          return
+        }
+
+        const trk = data.track
+        if (!trk) {
+          console.log("track not found")
+          return
+        }
+
+        console.log()
+        console.log(chalk.cyan("track · ") + trk.name)
+        console.log(chalk.dim("by ") + trk.artist.name)
+        if (trk.album?.title) {
+          console.log(chalk.dim("from ") + trk.album.title)
+        }
+        console.log()
+
+        if (trk.playcount) {
+          console.log(chalk.dim("playcount:") + " " + formatNumber(Number.parseInt(trk.playcount)))
+        }
+        if (trk.userplaycount) {
+          console.log(chalk.dim("your plays:") + " " + formatNumber(Number.parseInt(trk.userplaycount)))
+        }
+
+        const tags = trk.toptags?.tag || []
+        if (tags.length > 0) {
+          console.log(
+            chalk.dim("tags:") +
+              " " +
+              tags
+                .slice(0, 5)
+                .map((t) => t.name)
+                .join(", "),
+          )
+        }
+
+        console.log()
+      } catch (error) {
+        throw error
+      }
+    })
+}

package/src/commands/weekly.js

@@ -0,0 +1,45 @@
+import { LastFmAPI } from "../api.js"
+import { formatHeader, formatRankedList } from "../utils/format.js"
+
+export function weeklyCommand(program, config) {
+  program
+    .command("weekly")
+    .alias("wc")
+    .description("show weekly artist chart")
+    .action(async () => {
+      try {
+        const opts = program.opts()
+        const user = opts.user || config.defaultUser
+
+        const api = new LastFmAPI(config.apiKey)
+        const data = await api.getWeeklyArtistChart(user)
+
+        if (opts.json) {
+          console.log(JSON.stringify(data, null, 2))
+          return
+        }
+
+        const artists = data.weeklyartistchart?.artist || []
+        if (artists.length === 0) {
+          console.log("no weekly data found")
+          return
+        }
+
+        const limit = Number.parseInt(opts.limit) || 10
+        const topArtists = artists.slice(0, limit)
+
+        console.log(formatHeader("weekly artist chart", null, user))
+        console.log()
+        console.log(
+          formatRankedList(
+            topArtists,
+            (a) => a.name,
+            (a) => a.playcount,
+          ),
+        )
+        console.log()
+      } catch (error) {
+        throw error
+      }
+    })
+}

package/src/config.js

@@ -0,0 +1,42 @@
+import fs from "fs"
+import path from "path"
+import os from "os"
+
+function getConfigDir() {
+  const platform = os.platform()
+  if (platform === "win32") {
+    return path.join(process.env.APPDATA || os.homedir(), "clifm")
+  }
+  return path.join(os.homedir(), ".config", "clifm")
+} // yum how tuff :holdingbacktears:
+
+function getConfigPath() {
+  return path.join(getConfigDir(), "config.json")
+}
+
+export function hasConfig() {
+  return fs.existsSync(getConfigPath())
+}
+
+export function getConfig() {
+  if (!hasConfig()) {
+    return null
+  }
+  const content = fs.readFileSync(getConfigPath(), "utf-8")
+  return JSON.parse(content)
+}
+
+export function saveConfig(config) {
+  const dir = getConfigDir()
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true })
+  }
+  fs.writeFileSync(getConfigPath(), JSON.stringify(config, null, 2))
+}
+
+export function updateConfig(updates) {
+  const current = getConfig() || {}
+  const updated = { ...current, ...updates }
+  saveConfig(updated)
+}
+// cool

package/src/setup.js

@@ -0,0 +1,46 @@
+import * as readline from "readline/promises"
+import { stdin as input, stdout as output } from "process"
+import chalk from "chalk"
+import { saveConfig } from "./config.js"
+
+export async function runSetup() {
+  const rl = readline.createInterface({ input, output })
+
+  console.log(chalk.cyan("welcome to clifm!")) // hi
+  console.log()
+  console.log("first time setup:")
+  console.log()
+  console.log("to use this tool, you need a last.fm api key.")
+  console.log()
+  console.log(chalk.yellow("how to get your api key:"))
+  console.log("  1. go to https://www.last.fm/api")
+  console.log("  2. create an api account")
+  console.log("  3. copy your api key") // look a step by step dummy proof tutorial
+  console.log()
+
+  const apiKey = await rl.question("enter your last.fm api key: ")
+  if (!apiKey.trim()) {
+    console.error(chalk.red("api key required"))
+    process.exit(1)
+  }
+
+  console.log()
+  const defaultUser = await rl.question("enter your default last.fm username: ")
+  if (!defaultUser.trim()) {
+    console.error(chalk.red("username required"))
+    process.exit(1)
+  }
+
+  saveConfig({
+    apiKey: apiKey.trim(),
+    defaultUser: defaultUser.trim(),
+  })
+
+  console.log()
+  console.log(chalk.green("setup complete!"))
+  console.log()
+  console.log("try: clifm np")
+  console.log()
+
+  rl.close()
+}

package/src/utils/format.js

@@ -0,0 +1,54 @@
+import chalk from "chalk"
+
+export function formatHeader(title, subtitle, user) {
+  const parts = [title]
+  if (subtitle) parts.push(subtitle)
+  if (user) parts.push(`user: ${user}`)
+  return chalk.cyan(parts.join(" · "))
+}
+
+export function formatRankedList(items, getName, getCount) {
+  return items
+    .map((item, idx) => {
+      const rank = (idx + 1).toString().padStart(2, " ")
+      const name = getName(item)
+      const count = getCount(item)
+      return `${chalk.dim(rank + ".")} ${name} ${chalk.dim("—")} ${chalk.yellow(count + " plays")}`
+    })
+    .join("\n")
+}
+
+export function formatTimestamp(timestamp) {
+  const date = new Date(timestamp * 1000)
+  const now = new Date()
+  const diff = now - date
+  const minutes = Math.floor(diff / 60000)
+  const hours = Math.floor(diff / 3600000)
+  const days = Math.floor(diff / 86400000) 
+  // sob..
+
+  if (minutes < 1) return "just now"
+  if (minutes < 60) return `${minutes}m ago`
+  if (hours < 24) return `${hours}h ago`
+  if (days < 7) return `${days}d ago`
+
+  return date.toLocaleDateString()
+}
+
+export function formatDate(timestamp) {
+  const date = new Date(timestamp * 1000)
+  return date.toLocaleDateString("en-US", {
+    year: "numeric",
+    month: "short",
+    day: "numeric",
+  })
+}
+
+export function maskApiKey(apiKey) {
+  if (!apiKey || apiKey.length < 5) return "***"
+  return apiKey.slice(0, 2) + "*".repeat(apiKey.length - 4) + apiKey.slice(-2)
+}
+
+export function formatNumber(num) {
+  return num.toLocaleString()
+}

package/src/utils/periods.js

@@ -0,0 +1,32 @@
+export const PERIOD_MAP = {
+  "1w": "7day",
+  "1m": "1month",
+  "2m": "3month",
+  "4m": "6month",
+  "6m": "12month",
+  "12m": "overall",
+  alltime: "overall",
+}
+
+// why are u here? 
+export const PERIOD_DISPLAY = {
+  "1w": "last 1 week",
+  "1m": "last 1 month",
+  "2m": "last 3 months",
+  "4m": "last 6 months",
+  "6m": "last 12 months",
+  "12m": "all time",
+  alltime: "all time",
+}
+
+export function mapPeriod(period) {
+  const mapped = PERIOD_MAP[period?.toLowerCase()]
+  if (!mapped) {
+    throw new Error(`invalid period. valid options: ${Object.keys(PERIOD_MAP).join(", ")}`)
+  }
+  return mapped
+}
+
+export function getPeriodDisplay(period) {
+  return PERIOD_DISPLAY[period?.toLowerCase()] || period
+}

package/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "target": "ES6",
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}