@rocksky/cli 0.3.1 → 0.3.2

package/README.md

@@ -2,6 +2,10 @@
 
 🎧 The official command-line interface for [Rocksky](https://rocksky.app) — a modern, decentralized music tracking and discovery platform built on [AT Protocol](https://atproto.com).
 
+📚 **[View Full Documentation](https://docs.rocksky.app)**
+
+![Rocksky CLI Preview](./preview.png)
+
 ## Features
 - 🔐 Authenticate with your Rocksky account using OAuth
 - 🎵 View your currently playing track
@@ -11,6 +15,7 @@
 - 🤖 MCP Server
 
 ## Table of Contents
+- [Documentation](#documentation)
 - [Installation](#installation)
 - [Run in development](#run-in-development)
 - [Usage](#usage)
@@ -25,6 +30,10 @@
   - [albums](#albums)
   - [tracks](#tracks)
 
+## Documentation
+
+For comprehensive guides, API references, and tutorials, visit the official documentation at **[docs.rocksky.app](https://docs.rocksky.app)**.
+
 ## Installation
 
 ```sh

package/dist/index.js

@@ -7583,11 +7583,12 @@ async function sync() {
   await subscribeToJetstream(user);
   logger.info`  DID: ${did}`;
   logger.info`  Handle: ${handle}`;
+  const carReader = await downloadCarFile(agent);
   const [artists, albums, songs, scrobbles] = await Promise.all([
-    getRockskyUserArtists(agent),
-    getRockskyUserAlbums(agent),
-    getRockskyUserSongs(agent),
-    getRockskyUserScrobbles(agent)
+    getRockskyUserArtists(agent, carReader),
+    getRockskyUserAlbums(agent, carReader),
+    getRockskyUserSongs(agent, carReader),
+    getRockskyUserScrobbles(agent, carReader)
   ]);
   logger.info`  Artists: ${artists.length}`;
   logger.info`  Albums: ${albums.length}`;
@@ -8163,14 +8164,16 @@ const onNewScrobble = async (record, cid, uri, user) => {
     user
   );
 };
-const getRockskyUserSongs = async (agent) => {
+const downloadCarFile = async (agent) => {
+  logger.info(`Fetching repository CAR file ...`);
+  const repoRes = await agent.com.atproto.sync.getRepo({
+    did: agent.assertDid
+  });
+  return CarReader.fromBytes(new Uint8Array(repoRes.data));
+};
+const getRockskyUserSongs = async (agent, carReader) => {
   const results = [];
   try {
-    logger.info(`Fetching repository CAR file for songs...`);
-    const repoRes = await agent.com.atproto.sync.getRepo({
-      did: agent.assertDid
-    });
-    const carReader = await CarReader.fromBytes(new Uint8Array(repoRes.data));
     const collection = "app.rocksky.song";
     for await (const { cid, bytes } of carReader.blocks()) {
       try {
@@ -8200,15 +8203,11 @@ const getRockskyUserSongs = async (agent) => {
   }
   return results;
 };
-const getRockskyUserAlbums = async (agent) => {
+const getRockskyUserAlbums = async (agent, carReader) => {
   const results = [];
   try {
-    logger.info(`Fetching repository CAR file for albums...`);
-    const repoRes = await agent.com.atproto.sync.getRepo({
-      did: agent.assertDid
-    });
-    const carReader = await CarReader.fromBytes(new Uint8Array(repoRes.data));
     const collection = "app.rocksky.album";
+    logger.info`Extracting ${collection} records from CAR file ...`;
     for await (const { cid, bytes } of carReader.blocks()) {
       try {
         const decoded = cbor.decode(bytes);
@@ -8237,15 +8236,11 @@ const getRockskyUserAlbums = async (agent) => {
   }
   return results;
 };
-const getRockskyUserArtists = async (agent) => {
+const getRockskyUserArtists = async (agent, carReader) => {
   const results = [];
   try {
-    logger.info(`Fetching repository CAR file for artists...`);
-    const repoRes = await agent.com.atproto.sync.getRepo({
-      did: agent.assertDid
-    });
-    const carReader = await CarReader.fromBytes(new Uint8Array(repoRes.data));
     const collection = "app.rocksky.artist";
+    logger.info`Extracting ${collection} records from CAR file ...`;
     for await (const { cid, bytes } of carReader.blocks()) {
       try {
         const decoded = cbor.decode(bytes);
@@ -8273,15 +8268,11 @@ const getRockskyUserArtists = async (agent) => {
   }
   return results;
 };
-const getRockskyUserScrobbles = async (agent) => {
+const getRockskyUserScrobbles = async (agent, carReader) => {
   const results = [];
   try {
-    logger.info(`Fetching repository CAR file for scrobbles...`);
-    const repoRes = await agent.com.atproto.sync.getRepo({
-      did: agent.assertDid
-    });
-    const carReader = await CarReader.fromBytes(new Uint8Array(repoRes.data));
     const collection = "app.rocksky.scrobble";
+    logger.info`Extracting ${collection} records from CAR file ...`;
     for await (const { cid, bytes } of carReader.blocks()) {
       try {
         const decoded = cbor.decode(bytes);
@@ -8793,7 +8784,7 @@ async function whoami() {
   }
 }
 
-var version = "0.3.1";
+var version = "0.3.2";
 
 async function login(handle) {
   const app = express();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rocksky/cli",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Command-line interface for Rocksky – scrobble tracks, view stats, and manage your listening history",
   "main": "dist/index.js",
   "type": "module",

package/src/cmd/sync.ts

@@ -39,11 +39,13 @@ export async function sync() {
   logger.info`  DID: ${did}`;
   logger.info`  Handle: ${handle}`;
 
+  const carReader = await downloadCarFile(agent);
+
   const [artists, albums, songs, scrobbles] = await Promise.all([
-    getRockskyUserArtists(agent),
-    getRockskyUserAlbums(agent),
-    getRockskyUserSongs(agent),
-    getRockskyUserScrobbles(agent),
+    getRockskyUserArtists(agent, carReader),
+    getRockskyUserAlbums(agent, carReader),
+    getRockskyUserSongs(agent, carReader),
+    getRockskyUserScrobbles(agent, carReader),
   ]);
 
   logger.info`  Artists: ${artists.length}`;
@@ -880,7 +882,20 @@ const onNewScrobble = async (
   );
 };
 
-const getRockskyUserSongs = async (agent: Agent): Promise<Songs> => {
+const downloadCarFile = async (agent: Agent) => {
+  logger.info(`Fetching repository CAR file ...`);
+
+  const repoRes = await agent.com.atproto.sync.getRepo({
+    did: agent.assertDid,
+  });
+
+  return CarReader.fromBytes(new Uint8Array(repoRes.data));
+};
+
+const getRockskyUserSongs = async (
+  agent: Agent,
+  carReader: CarReader,
+): Promise<Songs> => {
   const results: {
     value: Song.Record;
     uri: string;
@@ -888,13 +903,6 @@ const getRockskyUserSongs = async (agent: Agent): Promise<Songs> => {
   }[] = [];
 
   try {
-    logger.info(`Fetching repository CAR file for songs...`);
-
-    const repoRes = await agent.com.atproto.sync.getRepo({
-      did: agent.assertDid,
-    });
-
-    const carReader = await CarReader.fromBytes(new Uint8Array(repoRes.data));
     const collection = "app.rocksky.song";
 
     for await (const { cid, bytes } of carReader.blocks()) {
@@ -932,7 +940,10 @@ const getRockskyUserSongs = async (agent: Agent): Promise<Songs> => {
   return results;
 };
 
-const getRockskyUserAlbums = async (agent: Agent): Promise<Albums> => {
+const getRockskyUserAlbums = async (
+  agent: Agent,
+  carReader: CarReader,
+): Promise<Albums> => {
   const results: {
     value: Album.Record;
     uri: string;
@@ -940,16 +951,8 @@ const getRockskyUserAlbums = async (agent: Agent): Promise<Albums> => {
   }[] = [];
 
   try {
-    logger.info(`Fetching repository CAR file for albums...`);
-
-    // Use getRepo to fetch the entire repository as a CAR file
-    const repoRes = await agent.com.atproto.sync.getRepo({
-      did: agent.assertDid,
-    });
-
-    // Parse the CAR file
-    const carReader = await CarReader.fromBytes(new Uint8Array(repoRes.data));
     const collection = "app.rocksky.album";
+    logger.info`Extracting ${collection} records from CAR file ...`;
 
     for await (const { cid, bytes } of carReader.blocks()) {
       try {
@@ -984,7 +987,10 @@ const getRockskyUserAlbums = async (agent: Agent): Promise<Albums> => {
   return results;
 };
 
-const getRockskyUserArtists = async (agent: Agent): Promise<Artists> => {
+const getRockskyUserArtists = async (
+  agent: Agent,
+  carReader: CarReader,
+): Promise<Artists> => {
   const results: {
     value: Artist.Record;
     uri: string;
@@ -992,14 +998,8 @@ const getRockskyUserArtists = async (agent: Agent): Promise<Artists> => {
   }[] = [];
 
   try {
-    logger.info(`Fetching repository CAR file for artists...`);
-
-    const repoRes = await agent.com.atproto.sync.getRepo({
-      did: agent.assertDid,
-    });
-
-    const carReader = await CarReader.fromBytes(new Uint8Array(repoRes.data));
     const collection = "app.rocksky.artist";
+    logger.info`Extracting ${collection} records from CAR file ...`;
 
     for await (const { cid, bytes } of carReader.blocks()) {
       try {
@@ -1034,7 +1034,10 @@ const getRockskyUserArtists = async (agent: Agent): Promise<Artists> => {
   return results;
 };
 
-const getRockskyUserScrobbles = async (agent: Agent): Promise<Scrobbles> => {
+const getRockskyUserScrobbles = async (
+  agent: Agent,
+  carReader: CarReader,
+): Promise<Scrobbles> => {
   const results: {
     value: Scrobble.Record;
     uri: string;
@@ -1042,14 +1045,8 @@ const getRockskyUserScrobbles = async (agent: Agent): Promise<Scrobbles> => {
   }[] = [];
 
   try {
-    logger.info(`Fetching repository CAR file for scrobbles...`);
-
-    const repoRes = await agent.com.atproto.sync.getRepo({
-      did: agent.assertDid,
-    });
-
-    const carReader = await CarReader.fromBytes(new Uint8Array(repoRes.data));
     const collection = "app.rocksky.scrobble";
+    logger.info`Extracting ${collection} records from CAR file ...`;
 
     for await (const { cid, bytes } of carReader.blocks()) {
       try {