@rocksky/cli 0.1.0

package/src/cmd/search.ts

@@ -0,0 +1,72 @@
+import chalk from "chalk";
+import { RockskyClient } from "client";
+
+export async function search(
+  query: string,
+  { limit = 20, albums = false, artists = false, tracks = false, users = false }
+) {
+  const client = new RockskyClient();
+  const results = await client.search(query, { size: limit });
+  if (results.records.length === 0) {
+    console.log(`No results found for ${chalk.magenta(query)}.`);
+    return;
+  }
+
+  // merge all results into one array with type and sort by xata_scrore
+  let mergedResults = results.records.map((record) => ({
+    ...record,
+    type: record.table,
+  }));
+
+  if (albums) {
+    mergedResults = mergedResults.filter((record) => record.table === "albums");
+  }
+
+  if (artists) {
+    mergedResults = mergedResults.filter(
+      (record) => record.table === "artists"
+    );
+  }
+
+  if (tracks) {
+    mergedResults = mergedResults.filter(({ table }) => table === "tracks");
+  }
+
+  if (users) {
+    mergedResults = mergedResults.filter(({ table }) => table === "users");
+  }
+
+  mergedResults.sort((a, b) => b.xata_score - a.xata_score);
+
+  for (const { table, record } of mergedResults) {
+    if (table === "users") {
+      console.log(
+        `${chalk.bold.magenta(record.handle)} ${
+          record.display_name
+        } ${chalk.yellow(`https://rocksky.app/profile/${record.did}`)}`
+      );
+    }
+
+    if (table === "albums") {
+      const link = record.uri
+        ? `https://rocksky.app/${record.uri?.split("at://")[1]}`
+        : "";
+      console.log(
+        `${chalk.bold.magenta(record.title)} ${record.artist} ${chalk.yellow(
+          link
+        )}`
+      );
+    }
+
+    if (table === "tracks") {
+      const link = record.uri
+        ? `https://rocksky.app/${record.uri?.split("at://")[1]}`
+        : "";
+      console.log(
+        `${chalk.bold.magenta(record.title)} ${record.artist} ${chalk.yellow(
+          link
+        )}`
+      );
+    }
+  }
+}

package/src/cmd/stats.ts

@@ -0,0 +1,56 @@
+import chalk from "chalk";
+import { RockskyClient } from "client";
+import fs from "fs/promises";
+import os from "os";
+import path from "path";
+import { getBorderCharacters, table } from "table";
+
+export async function stats(did?: string) {
+  const tokenPath = path.join(os.homedir(), ".rocksky", "token.json");
+  try {
+    await fs.access(tokenPath);
+  } catch (err) {
+    if (!did) {
+      console.error(
+        `You are not logged in. Please run ${chalk.greenBright(
+          "`rocksky login <username>.bsky.social`"
+        )} first.`
+      );
+      return;
+    }
+  }
+
+  const tokenData = await fs.readFile(tokenPath, "utf-8");
+  const { token } = JSON.parse(tokenData);
+  if (!token && !did) {
+    console.error(
+      `You are not logged in. Please run ${chalk.greenBright(
+        "`rocksky login <username>.bsky.social`"
+      )} first.`
+    );
+    return;
+  }
+
+  const client = new RockskyClient(token);
+  const stats = await client.stats(did);
+
+  console.log(
+    table(
+      [
+        ["Scrobbles", chalk.magenta(stats.scrobbles)],
+        ["Tracks", chalk.magenta(stats.tracks)],
+        ["Albums", chalk.magenta(stats.albums)],
+        ["Artists", chalk.magenta(stats.artists)],
+        ["Loved Tracks", chalk.magenta(stats.lovedTracks)],
+      ],
+      {
+        border: getBorderCharacters("void"),
+        columnDefault: {
+          paddingLeft: 0,
+          paddingRight: 1,
+        },
+        drawHorizontalLine: () => false,
+      }
+    )
+  );
+}

package/src/cmd/tracks.ts

@@ -0,0 +1,16 @@
+import chalk from "chalk";
+import { RockskyClient } from "client";
+
+export async function tracks(did, { skip, limit }) {
+  const client = new RockskyClient();
+  const tracks = await client.getTracks(did, { skip, limit });
+  let rank = 1;
+  for (const track of tracks) {
+    console.log(
+      `${rank} ${chalk.magenta(track.title)} ${track.artist} ${chalk.yellow(
+        track.play_count + " plays"
+      )}`
+    );
+    rank++;
+  }
+}

package/src/cmd/whoami.ts

@@ -0,0 +1,45 @@
+import chalk from "chalk";
+import { RockskyClient } from "client";
+import fs from "fs/promises";
+import os from "os";
+import path from "path";
+
+export async function whoami() {
+  const tokenPath = path.join(os.homedir(), ".rocksky", "token.json");
+  try {
+    await fs.access(tokenPath);
+  } catch (err) {
+    console.error(
+      `You are not logged in. Please run ${chalk.greenBright(
+        "`rocksky login <username>.bsky.social`"
+      )} first.`
+    );
+    return;
+  }
+
+  const tokenData = await fs.readFile(tokenPath, "utf-8");
+  const { token } = JSON.parse(tokenData);
+  if (!token) {
+    console.error(
+      `You are not logged in. Please run ${chalk.greenBright(
+        "`rocksky login <username>.bsky.social`"
+      )} first.`
+    );
+    return;
+  }
+
+  const client = new RockskyClient(token);
+  try {
+    const user = await client.getCurrentUser();
+    console.log(`You are logged in as ${user.handle} (${user.displayName}).`);
+    console.log(
+      `View your profile at: ${chalk.magenta(
+        `https://rocksky.app/profile/${user.handle}`
+      )}`
+    );
+  } catch (err) {
+    console.error(
+      `Failed to fetch user data. Please check your token and try again.`
+    );
+  }
+}

package/src/index.ts

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+
+import { albums } from "cmd/albums";
+import { artists } from "cmd/artists";
+import { createApiKey } from "cmd/create";
+import { nowplaying } from "cmd/nowplaying";
+import { scrobble } from "cmd/scrobble";
+import { scrobbles } from "cmd/scrobbles";
+import { search } from "cmd/search";
+import { stats } from "cmd/stats";
+import { tracks } from "cmd/tracks";
+import { whoami } from "cmd/whoami";
+import { Command } from "commander";
+import version from "../package.json" assert { type: "json" };
+import { login } from "./cmd/login";
+
+const program = new Command();
+
+program
+  .name("rocksky")
+  .description(
+    "Command-line interface for Rocksky – scrobble tracks, view stats, and manage your listening history."
+  )
+  .version(version.version);
+
+program
+  .command("login")
+  .argument("<handle>", "your BlueSky handle (e.g., <username>.bsky.social)")
+  .description("login with your BlueSky account and get a session token.")
+  .action(login);
+
+program
+  .command("whoami")
+  .description("get the current logged-in user.")
+  .action(whoami);
+
+program
+  .command("nowplaying")
+  .argument(
+    "[did]",
+    "the DID or handle of the user to get the now playing track for."
+  )
+  .description("get the currently playing track.")
+  .action(nowplaying);
+
+program
+  .command("scrobbles")
+  .option("-s, --skip <number>", "number of scrobbles to skip")
+  .option("-l, --limit <number>", "number of scrobbles to limit")
+  .argument("[did]", "the DID or handle of the user to get the scrobbles for.")
+  .description("display recently played tracks.")
+  .action(scrobbles);
+
+program
+  .command("search")
+  .option("-a, --albums", "search for albums")
+  .option("-t, --tracks", "search for tracks")
+  .option("-u, --users", "search for users")
+  .option("-l, --limit <number>", "number of results to limit")
+  .argument(
+    "<query>",
+    "the search query, e.g., artist, album, title or account"
+  )
+  .description("search for tracks, albums, or accounts.")
+  .action(search);
+
+program
+  .command("stats")
+  .option("-l, --limit <number>", "number of results to limit")
+  .argument("[did]", "the DID or handle of the user to get stats for.")
+  .description("get the user's listening stats.")
+  .action(stats);
+
+program
+  .command("artists")
+  .option("-l, --limit <number>", "number of results to limit")
+  .argument("[did]", "the DID or handle of the user to get artists for.")
+  .description("get the user's top artists.")
+  .action(artists);
+
+program
+  .command("albums")
+  .option("-l, --limit <number>", "number of results to limit")
+  .argument("[did]", "the DID or handle of the user to get albums for.")
+  .description("get the user's top albums.")
+  .action(albums);
+
+program
+  .command("tracks")
+  .option("-l, --limit <number>", "number of results to limit")
+  .argument("[did]", "the DID or handle of the user to get tracks for.")
+  .description("get the user's top tracks.")
+  .action(tracks);
+
+program
+  .command("scrobble")
+  .argument("<track>", "the title of the track")
+  .argument("<artist>", "the artist of the track")
+  .option("-t, --timestamp <timestamp>", "the timestamp of the scrobble")
+  .description("scrobble a track to your profile.")
+  .action(scrobble);
+
+program
+  .command("create")
+  .description("create a new API key.")
+  .command("apikey")
+  .argument("<name>", "the name of the API key")
+  .option("-d, --description <description>", "the description of the API key")
+  .description("create a new API key.")
+  .action(createApiKey);
+
+program.parse(process.argv);

package/tsconfig.json

@@ -0,0 +1,31 @@
+{
+	"compilerOptions": {
+		"allowJs": true,
+		"allowSyntheticDefaultImports": true,
+		"baseUrl": "src",
+		"declaration": true,
+		"sourceMap": true,
+		"esModuleInterop": true,
+		"inlineSourceMap": false,
+		"lib": ["esnext", "DOM"],
+		"listEmittedFiles": false,
+		"listFiles": false,
+		"moduleResolution": "node",
+		"noFallthroughCasesInSwitch": true,
+		"pretty": true,
+		"resolveJsonModule": true,
+		"rootDir": ".",
+		"skipLibCheck": true,
+		"strict": false,
+		"traceResolution": false,
+		"outDir": "",
+		"target": "esnext",
+		"module": "esnext",
+		"types": [
+			"@types/node",
+			"@types/express",
+		]
+	},
+	"exclude": ["node_modules", "dist", "tests"],
+	"include": ["src", "scripts"]
+}