@rocksky/sdk 0.12.0 → 0.14.0

package/README.md

@@ -45,6 +45,29 @@ methods cover the rest: `album`, `artist`, `song`, `feed`, `playlists`,
 Every named method is sugar over the universal escape hatch **`rk.get(nsid,
 params)`**, which calls ANY read query by nsid and returns `unknown`.
 
+**Filtering**: `catalogSongs`, `catalogArtists`, `catalogAlbums`, and
+`scrobbleFeed` take an optional RSQL `filter` (string or `Filter`) — build one
+fluently, with the per-endpoint field constants for discoverability:
+
+```ts
+import { Filter, RockskyClient, ScrobbleFields, SongFields } from "@rocksky/sdk";
+
+const rk = new RockskyClient();
+const filter = Filter.eq(SongFields.artist, "Daft Punk")
+  .and(Filter.gt(SongFields.duration, 200_000))
+  .or(Filter.in(SongFields.genre, ["house", "electro"]));
+const songs = await rk.catalogSongs(50, 0, undefined, filter);
+// filter sent: artist=="Daft Punk";duration=gt=200000,genre=in=(house,electro)
+
+// scrobbles support dotted selectors into the joined track/user/artist:
+await rk.scrobbleFeed(undefined, false, 50, 0,
+  Filter.eq(ScrobbleFields.trackArtist, "Daft Punk").and(Filter.ge(ScrobbleFields.date, "2025-01-01")));
+```
+
+Operators: `eq` (supports `*` wildcards), `ne`, `gt`, `ge`, `lt`, `le`, `in`,
+`out`, `isNull`, `isNotNull`, chained with `.and()` / `.or()` (parentheses
+inserted automatically per RSQL precedence).
+
 **Typed date-window charts**: `topTracksInterval(limit, offset, interval)` and
 `topArtistsInterval(...)` take a `DateInterval` built with the `Interval`
 factories — `Interval.allTime()`, `Interval.lastDays(n)`, `Interval.lastWeeks(n)`,
@@ -86,10 +109,12 @@ SHA-256, identical to the server and every other Rocksky SDK.
 ## Duplicate prevention + real-time sync
 
 An optional local index (embedded [classic-level](https://github.com/Level/classic-level)
-LevelDB) prevents duplicate writes and stays live off the firehose:
+LevelDB) prevents duplicate writes and stays live off the firehose. It is
+Node-only, so it lives on its own subpath — the main `@rocksky/sdk` entry stays
+browser-safe:
 
 ```ts
-import { RockskyIndex } from "@rocksky/sdk";
+import { RockskyIndex } from "@rocksky/sdk/dedup";
 
 const idx = new RockskyIndex("./dedup");
 await idx.open();

package/dist/client.d.ts

@@ -1,5 +1,6 @@
+import type { Filter } from "./filter.js";
 import { RockskyLibrary } from "./library.js";
-import type { ActorProfileViewBasic, ActorProfileViewDetailed, AlbumViewBasic, AlbumViewDetailed, ArtistViewBasic, ArtistViewDetailed, ChartsView, FeedGeneratorsView, FeedRecommendationsView, FeedRecommendedAlbumsView, FeedRecommendedArtistsView, FeedSearchResultsView, FeedStoriesView, FeedView, GetActorCompatibilityOutput, GetActorNeighboursOutput, GetActorPlaylistsOutput, GetAlbumShoutsOutput, GetApikeysOutput, GetArtistListenersOutput, GetArtistRecentListenersOutput, GetArtistShoutsOutput, GetFeedGeneratorOutput, GetMirrorSourcesOutput, GetProfileShoutsOutput, GetShoutRepliesOutput, GetSongRecentListenersOutput, GetTrackShoutsOutput, GetUnreadCountOutput, ListNotificationsOutput, PlayerCurrentlyPlayingViewDetailed, PlayerPlaybackQueueViewDetailed, PlaylistGetPlaylistsOutput, PlaylistViewDetailed, RockboxSettingsView, ScrobbleViewBasic, SongViewBasic, SongViewDetailed, StatsGlobalStatsView, StatsView, StatsWrappedView, UpdateSeenOutput } from "./generated/types.js";
+import type { ActorProfileViewBasic, ActorProfileViewDetailed, AlbumViewBasic, AlbumViewDetailed, ArtistViewBasic, ArtistViewDetailed, ChartsView, CreateScrobbleInput, FollowAccountOutput, FeedGeneratorsView, FeedRecommendationsView, FeedRecommendedAlbumsView, FeedRecommendedArtistsView, FeedSearchResultsView, FeedStoriesView, FeedView, GetActorCompatibilityOutput, GetActorNeighboursOutput, GetActorPlaylistsOutput, GetAlbumShoutsOutput, GetApikeysOutput, GetArtistListenersOutput, GetArtistRecentListenersOutput, GetArtistShoutsOutput, GetFeedGeneratorOutput, GetMirrorSourcesOutput, GetProfileShoutsOutput, GetShoutRepliesOutput, GetSongRecentListenersOutput, GetTrackShoutsOutput, GetUnreadCountOutput, ListNotificationsOutput, MirrorSourceView, PlayerCurrentlyPlayingViewDetailed, PlayerPlaybackQueueViewDetailed, PlaylistGetPlaylistsOutput, PlaylistViewDetailed, PutAudioSettingsInput, PutMirrorSourceInput, RockboxSettingsView, ScrobbleViewBasic, SongViewBasic, SongViewDetailed, StatsGlobalStatsView, StatsView, StatsWrappedView, UnfollowAccountOutput, UpdateSeenOutput } from "./generated/types.js";
 /**
  * A typed date window for the `top*` charts. Build one with the {@link Interval}
  * factories; `range` bounds are RFC-3339 datetimes.
@@ -50,6 +51,13 @@ export declare class RockskyClient {
     /** Call any AppView read query by nsid; returns the raw JSON response. Every
      * method here is sugar over this — use it for queries without a wrapper. */
     get(nsid: string, params?: Record<string, unknown>): Promise<unknown>;
+    /** Call any AppView procedure by nsid. `params` ride the query string (some
+     * procedures take their arguments there), `body` is the JSON input — omitted
+     * entirely when `undefined`. Escape hatch for procedures without a wrapper. */
+    post<T = unknown>(nsid: string, opts?: {
+        params?: Record<string, unknown>;
+        body?: unknown;
+    }): Promise<T>;
     /** An actor's most-played songs. */
     songs(actor: string, limit?: number, offset?: number): Promise<SongViewBasic[]>;
     /** An actor's loved (liked) songs. */
@@ -66,12 +74,15 @@ export declare class RockskyClient {
     topTracksInterval(limit: number, offset: number, interval: DateInterval): Promise<SongViewBasic[]>;
     /** The top artists chart over a typed {@link DateInterval}. */
     topArtistsInterval(limit: number, offset: number, interval: DateInterval): Promise<ArtistViewBasic[]>;
-    /** The album catalog, optionally filtered by `genre`. */
-    catalogAlbums(limit?: number, offset?: number, genre?: string): Promise<AlbumViewBasic[]>;
-    /** The artist catalog, optionally filtered by `genre`. */
-    catalogArtists(limit?: number, offset?: number, genre?: string): Promise<ArtistViewBasic[]>;
-    /** The song catalog, optionally filtered by `genre`. */
-    catalogSongs(limit?: number, offset?: number, genre?: string): Promise<SongViewBasic[]>;
+    /** The album catalog, optionally filtered by `genre` and/or an RSQL
+     * {@link Filter} expression (see {@link AlbumFields}). */
+    catalogAlbums(limit?: number, offset?: number, genre?: string, filter?: string | Filter): Promise<AlbumViewBasic[]>;
+    /** The artist catalog, optionally filtered by `genre` and/or an RSQL
+     * {@link Filter} expression (see {@link ArtistFields}). */
+    catalogArtists(limit?: number, offset?: number, genre?: string, filter?: string | Filter): Promise<ArtistViewBasic[]>;
+    /** The song catalog, optionally filtered by `genre` and/or an RSQL
+     * {@link Filter} expression (see {@link SongFields}). */
+    catalogSongs(limit?: number, offset?: number, genre?: string, filter?: string | Filter): Promise<SongViewBasic[]>;
     /** An album's tracklist by album at:// URI. */
     albumTracks(uri: string): Promise<SongViewBasic[]>;
     /** An artist's albums by artist at:// URI. */
@@ -79,8 +90,9 @@ export declare class RockskyClient {
     /** An artist's top tracks by artist at:// URI. */
     artistTracks(uri: string, limit?: number, offset?: number): Promise<SongViewBasic[]>;
     /** A social/global scrobbles feed. Pass `did` to scope to an actor and
-     * `following = true` for their follow graph. */
-    scrobbleFeed(did?: string, following?: boolean, limit?: number, offset?: number): Promise<ScrobbleViewBasic[]>;
+     * `following = true` for their follow graph. `filter` takes an RSQL
+     * {@link Filter} expression (see {@link ScrobbleFields}). */
+    scrobbleFeed(did?: string, following?: boolean, limit?: number, offset?: number, filter?: string | Filter): Promise<ScrobbleViewBasic[]>;
     /** A single scrobble by its at:// URI. */
     scrobble(uri: string): Promise<ScrobbleViewBasic>;
     /** The accounts `actor` follows. */
@@ -183,5 +195,17 @@ export declare class RockskyClient {
      * to mark **all** of the viewer's notifications. Returns the number remaining
      * unread. */
     updateSeen(ids?: string[]): Promise<UpdateSeenOutput>;
+    /** Follow an account by DID or handle (`app.rocksky.graph.followAccount`). Auth required. */
+    followAccount(account: string): Promise<FollowAccountOutput>;
+    /** Unfollow an account by DID or handle (`app.rocksky.graph.unfollowAccount`). Auth required. */
+    unfollowAccount(account: string): Promise<UnfollowAccountOutput>;
+    /** Submit a scrobble through the AppView (`app.rocksky.scrobble.createScrobble`).
+     * Auth required. For direct-to-PDS scrobbling use {@link Agent} instead. */
+    createScrobble(input: CreateScrobbleInput): Promise<ScrobbleViewBasic>;
+    /** Create or update a mirror source (`app.rocksky.mirror.putMirrorSource`). Auth required. */
+    putMirrorSource(input: PutMirrorSourceInput): Promise<MirrorSourceView>;
+    /** Patch the viewer's Rockbox audio settings (`app.rocksky.rockbox.putAudioSettings`).
+     * Auth required. */
+    putAudioSettings(input: PutAudioSettingsInput): Promise<RockboxSettingsView>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/dedup.js

@@ -0,0 +1,215 @@
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
+// src/dedup.ts
+import { fromUint8Array } from "@atcute/car";
+import { decode as cborDecode, fromBytes, isBytes, isCidLink } from "@atcute/cbor";
+import { toString as cidToString } from "@atcute/cid";
+import { ClassicLevel } from "classic-level";
+
+// src/hash.ts
+import { sha256 } from "@noble/hashes/sha2.js";
+import { bytesToHex } from "@noble/hashes/utils.js";
+function sha256Lower(s) {
+  return bytesToHex(sha256(new TextEncoder().encode(s.toLowerCase())));
+}
+function songHash(title, artist, album) {
+  return sha256Lower(`${title} - ${artist} - ${album}`);
+}
+function albumHash(album, albumArtist) {
+  return sha256Lower(`${album} - ${albumArtist}`);
+}
+function artistHash(albumArtist) {
+  return sha256Lower(albumArtist);
+}
+
+// src/dedup.ts
+var C_ARTIST = "app.rocksky.artist";
+var C_ALBUM = "app.rocksky.album";
+var C_SONG = "app.rocksky.song";
+var C_SCROBBLE = "app.rocksky.scrobble";
+var SEP = "\x00";
+function totalIndexed(s) {
+  return s.artists + s.albums + s.songs + s.scrobbles;
+}
+function identKey(did, col, hash) {
+  return `${did}${SEP}${col}${SEP}${hash}`;
+}
+function scrobbleKey(did, songH, secs) {
+  return `${did}${SEP}${C_SCROBBLE}${SEP}${songH}${SEP}${secs}`;
+}
+function primaryFor(did, col, rec) {
+  const s = (k) => typeof rec[k] === "string" ? rec[k] : "";
+  switch (col) {
+    case C_ARTIST:
+      return s("name") ? identKey(did, C_ARTIST, artistHash(s("name"))) : undefined;
+    case C_ALBUM:
+      return s("title") && s("artist") ? identKey(did, C_ALBUM, albumHash(s("title"), s("artist"))) : undefined;
+    case C_SONG:
+      return s("title") && s("artist") && s("album") ? identKey(did, C_SONG, songHash(s("title"), s("artist"), s("album"))) : undefined;
+    case C_SCROBBLE: {
+      if (s("title") && s("artist") && s("album") && s("createdAt")) {
+        const secs = Math.floor(Date.parse(s("createdAt")) / 1000);
+        if (!Number.isNaN(secs))
+          return scrobbleKey(did, songHash(s("title"), s("artist"), s("album")), secs);
+      }
+      return;
+    }
+  }
+  return;
+}
+
+class RockskyIndex {
+  db;
+  constructor(path) {
+    this.db = new ClassicLevel(path, { keyEncoding: "utf8", valueEncoding: "utf8" });
+  }
+  open() {
+    return this.db.open();
+  }
+  close() {
+    return this.db.close();
+  }
+  async get(key) {
+    try {
+      return await this.db.get(key);
+    } catch {
+      return;
+    }
+  }
+  songUri(did, title, artist, album) {
+    return this.get(identKey(did, C_SONG, songHash(title, artist, album)));
+  }
+  albumUri(did, album, albumArtist) {
+    return this.get(identKey(did, C_ALBUM, albumHash(album, albumArtist)));
+  }
+  artistUri(did, albumArtist) {
+    return this.get(identKey(did, C_ARTIST, artistHash(albumArtist)));
+  }
+  scrobbleUri(did, title, artist, album, secs) {
+    return this.get(scrobbleKey(did, songHash(title, artist, album), secs));
+  }
+  async putPrimary(did, col, primary, uri) {
+    const rkey = uri.slice(uri.lastIndexOf("/") + 1);
+    await this.db.batch([
+      { type: "put", key: primary, value: uri },
+      { type: "put", key: `${SEP}rk${SEP}${did}${SEP}${col}${SEP}${rkey}`, value: primary }
+    ]);
+  }
+  recordSong(did, title, artist, album, uri) {
+    return this.putPrimary(did, C_SONG, identKey(did, C_SONG, songHash(title, artist, album)), uri);
+  }
+  recordAlbum(did, album, albumArtist, uri) {
+    return this.putPrimary(did, C_ALBUM, identKey(did, C_ALBUM, albumHash(album, albumArtist)), uri);
+  }
+  recordArtist(did, albumArtist, uri) {
+    return this.putPrimary(did, C_ARTIST, identKey(did, C_ARTIST, artistHash(albumArtist)), uri);
+  }
+  recordScrobble(did, title, artist, album, secs, uri) {
+    return this.putPrimary(did, C_SCROBBLE, scrobbleKey(did, songHash(title, artist, album), secs), uri);
+  }
+  cursor(did) {
+    return this.get(`${SEP}meta${SEP}cursor${SEP}${did}`).then((v) => v ? Number(v) : 0);
+  }
+  async setCursor(did, timeUS) {
+    await this.db.put(`${SEP}meta${SEP}cursor${SEP}${did}`, String(timeUS));
+  }
+  async indexCar(did, car) {
+    const reader = fromUint8Array(car);
+    const blocks = new Map;
+    for (const entry of reader)
+      blocks.set(cidToString(entry.cid), entry.bytes);
+    const root = reader.roots[0];
+    if (!root)
+      throw new Error("CAR has no root");
+    const commit = cborDecode(blocks.get(root.$link));
+    const stats = { artists: 0, albums: 0, songs: 0, scrobbles: 0 };
+    const ops = [];
+    for (const [path, valueLink] of walkMst(blocks, commit.data.$link)) {
+      const slash = path.indexOf("/");
+      if (slash < 0)
+        continue;
+      const col = path.slice(0, slash);
+      const rkey = path.slice(slash + 1);
+      if (col !== C_ARTIST && col !== C_ALBUM && col !== C_SONG && col !== C_SCROBBLE)
+        continue;
+      const recBytes = blocks.get(valueLink);
+      if (!recBytes)
+        continue;
+      const rec = cborDecode(recBytes);
+      const primary = primaryFor(did, col, rec);
+      if (!primary)
+        continue;
+      const uri = `at://${did}/${col}/${rkey}`;
+      ops.push({ type: "put", key: primary, value: uri });
+      ops.push({ type: "put", key: `${SEP}rk${SEP}${did}${SEP}${col}${SEP}${rkey}`, value: primary });
+      if (col === C_ARTIST)
+        stats.artists++;
+      else if (col === C_ALBUM)
+        stats.albums++;
+      else if (col === C_SONG)
+        stats.songs++;
+      else
+        stats.scrobbles++;
+    }
+    if (commit.rev)
+      ops.push({ type: "put", key: `${SEP}meta${SEP}rev${SEP}${did}`, value: commit.rev });
+    await this.db.batch(ops);
+    return stats;
+  }
+  async applyCommit(did, col, operation, rkey, record) {
+    if (operation === "create" || operation === "update") {
+      if (!record)
+        return;
+      const primary = primaryFor(did, col, record);
+      if (!primary)
+        return;
+      await this.putPrimary(did, col, primary, `at://${did}/${col}/${rkey}`);
+    } else if (operation === "delete") {
+      const rk = `${SEP}rk${SEP}${did}${SEP}${col}${SEP}${rkey}`;
+      const primary = await this.get(rk);
+      if (primary) {
+        await this.db.batch([
+          { type: "del", key: primary },
+          { type: "del", key: rk }
+        ]);
+      }
+    }
+  }
+}
+function* walkMst(blocks, cid) {
+  const raw = blocks.get(cid);
+  if (!raw)
+    return;
+  const node = cborDecode(raw);
+  if (node.l && isCidLink(node.l))
+    yield* walkMst(blocks, node.l.$link);
+  let last = new Uint8Array(0);
+  for (const e of node.e) {
+    const suffix = isBytes(e.k) ? fromBytes(e.k) : e.k;
+    const key = new Uint8Array(e.p + suffix.length);
+    key.set(last.subarray(0, e.p), 0);
+    key.set(suffix, e.p);
+    yield [new TextDecoder().decode(key), e.v.$link];
+    last = key;
+    if (e.t && isCidLink(e.t))
+      yield* walkMst(blocks, e.t.$link);
+  }
+}
+export {
+  RockskyIndex,
+  totalIndexed
+};

package/dist/errors.d.ts

@@ -1,6 +1,9 @@
-/** Error thrown when a Rocksky XRPC call returns a non-2xx `{ error, message }`. */
 export declare class RockskyError extends Error {
+    /** The XRPC error code (e.g. "InvalidRequest", "AuthMissing"), when the
+     * server sent one. */
     readonly kind?: string;
-    constructor(payload: unknown);
+    /** The HTTP status of the failed response, when known. */
+    readonly status?: number;
+    constructor(payload: unknown, status?: number);
 }
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBACX,OAAO,EAAE,OAAO;CAM7B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;IACrC;0BACsB;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM;CAO9C"}

package/dist/filter.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Fluent builder for RSQL filter expressions, accepted by the `filter`
+ * parameter of the catalog and scrobble-feed queries
+ * (app.rocksky.song.getSongs, app.rocksky.artist.getArtists,
+ * app.rocksky.album.getAlbums, app.rocksky.scrobble.getScrobbles).
+ *
+ * ```ts
+ * import { Filter } from "@rocksky/sdk";
+ *
+ * const filter = Filter.eq("artist", "Daft Punk")
+ *   .and(Filter.gt("duration", 200_000))
+ *   .or(Filter.in("genre", ["house", "electro"]));
+ *
+ * await client.catalogSongs(50, 0, undefined, filter);
+ * // artist=="Daft Punk";duration=gt=200000,genre=in=(house,electro)
+ * ```
+ *
+ * String values are quoted and escaped automatically when they contain
+ * characters RSQL reserves; `*` wildcards pass through unquoted so
+ * `Filter.eq("artist", "Daft*")` performs a case-insensitive match.
+ */
+export type FilterValue = string | number | boolean;
+export declare class Filter {
+    private readonly expr;
+    private readonly kind;
+    private constructor();
+    private static comparison;
+    private static list;
+    /** `field==value` — equals; `*` in string values is a wildcard. */
+    static eq(field: string, value: FilterValue): Filter;
+    /** `field!=value` — not equals. */
+    static ne(field: string, value: FilterValue): Filter;
+    /** `field=gt=value` — greater than. */
+    static gt(field: string, value: FilterValue): Filter;
+    /** `field=ge=value` — greater than or equal. */
+    static ge(field: string, value: FilterValue): Filter;
+    /** `field=lt=value` — less than. */
+    static lt(field: string, value: FilterValue): Filter;
+    /** `field=le=value` — less than or equal. */
+    static le(field: string, value: FilterValue): Filter;
+    /** `field=in=(a,b)` — matches any of the values. */
+    static in(field: string, values: FilterValue[]): Filter;
+    /** `field=out=(a,b)` — matches none of the values. */
+    static out(field: string, values: FilterValue[]): Filter;
+    /** `field==null` — the field is NULL. */
+    static isNull(field: string): Filter;
+    /** `field!=null` — the field is not NULL. */
+    static isNotNull(field: string): Filter;
+    /** Both sides must match (`;`). An `or` operand is parenthesized to keep RSQL precedence. */
+    and(other: Filter): Filter;
+    /** Either side may match (`,`). */
+    or(other: Filter): Filter;
+    private renderIn;
+    /** The RSQL expression string to send as the `filter` query param. */
+    build(): string;
+    toString(): string;
+}
+/** Filterable fields of app.rocksky.song.getSongs. */
+export declare const SongFields: {
+    readonly title: "title";
+    readonly artist: "artist";
+    readonly album: "album";
+    readonly albumArtist: "albumArtist";
+    readonly genre: "genre";
+    readonly composer: "composer";
+    readonly label: "label";
+    readonly duration: "duration";
+    readonly trackNumber: "trackNumber";
+    readonly discNumber: "discNumber";
+    readonly mbId: "mbId";
+    readonly isrc: "isrc";
+    readonly sha256: "sha256";
+    readonly uri: "uri";
+    readonly albumUri: "albumUri";
+    readonly artistUri: "artistUri";
+    readonly createdAt: "createdAt";
+};
+/** Filterable fields of app.rocksky.album.getAlbums. */
+export declare const AlbumFields: {
+    readonly title: "title";
+    readonly artist: "artist";
+    readonly year: "year";
+    readonly releaseDate: "releaseDate";
+    readonly sha256: "sha256";
+    readonly uri: "uri";
+    readonly artistUri: "artistUri";
+    readonly createdAt: "createdAt";
+};
+/** Filterable fields of app.rocksky.artist.getArtists. */
+export declare const ArtistFields: {
+    readonly name: "name";
+    readonly genres: "genres";
+    readonly bornIn: "bornIn";
+    readonly born: "born";
+    readonly died: "died";
+    readonly sha256: "sha256";
+    readonly uri: "uri";
+    readonly createdAt: "createdAt";
+};
+/** Filterable fields of app.rocksky.scrobble.getScrobbles (dotted selectors reach the joined track/user/artist). */
+export declare const ScrobbleFields: {
+    readonly uri: "uri";
+    readonly date: "date";
+    readonly timestamp: "timestamp";
+    readonly title: "title";
+    readonly artist: "artist";
+    readonly album: "album";
+    readonly trackTitle: "track.title";
+    readonly trackArtist: "track.artist";
+    readonly trackAlbum: "track.album";
+    readonly trackAlbumArtist: "track.albumArtist";
+    readonly trackGenre: "track.genre";
+    readonly trackDuration: "track.duration";
+    readonly trackIsrc: "track.isrc";
+    readonly trackMbId: "track.mbId";
+    readonly userDid: "user.did";
+    readonly userHandle: "user.handle";
+    readonly userDisplayName: "user.displayName";
+    readonly artistName: "artist.name";
+    readonly artistGenres: "artist.genres";
+};
+//# sourceMappingURL=filter.d.ts.map

package/dist/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../src/filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAapD,qBAAa,MAAM;IAEf,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFvB,OAAO;IAKP,OAAO,CAAC,MAAM,CAAC,UAAU;IAIzB,OAAO,CAAC,MAAM,CAAC,IAAI;IAOnB,mEAAmE;IACnE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM;IAIpD,mCAAmC;IACnC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM;IAIpD,uCAAuC;IACvC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM;IAIpD,gDAAgD;IAChD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM;IAIpD,oCAAoC;IACpC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM;IAIpD,6CAA6C;IAC7C,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM;IAIpD,oDAAoD;IACpD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM;IAIvD,sDAAsD;IACtD,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM;IAIxD,yCAAyC;IACzC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIpC,6CAA6C;IAC7C,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIvC,6FAA6F;IAC7F,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI1B,mCAAmC;IACnC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIzB,OAAO,CAAC,QAAQ;IAIhB,sEAAsE;IACtE,KAAK,IAAI,MAAM;IAIf,QAAQ,IAAI,MAAM;CAGnB;AAED,sDAAsD;AACtD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;CAkBb,CAAC;AAEX,wDAAwD;AACxD,eAAO,MAAM,WAAW;;;;;;;;;CASd,CAAC;AAEX,0DAA0D;AAC1D,eAAO,MAAM,YAAY;;;;;;;;;CASf,CAAC;AAEX,oHAAoH;AACpH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;CAoBjB,CAAC"}

package/dist/filter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=filter.test.d.ts.map

package/dist/filter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.test.d.ts","sourceRoot":"","sources":["../src/filter.test.ts"],"names":[],"mappings":""}

package/dist/generated/types.d.ts

@@ -224,6 +224,8 @@ export interface ArtistGetArtistsParams {
     names?: string;
     /** The genre to filter artists by */
     genre?: string;
+    /** RSQL filter expression, e.g. `name==Daft*;genres=in=(house,electro)`. Supports ==, !=, <, <=, >, >=, =in=, =out=, and `;`/`and`, `,`/`or` combinators, `*` wildcards in string values. Filterable fields: name, genres, bornIn, born, died, sha256, uri, createdAt */
+    filter?: string;
 }
 export interface ArtistListenerViewBasic {
     /** The unique identifier of the actor. */
@@ -754,6 +756,8 @@ export interface GetAlbumsParams {
     offset?: number;
     /** The genre to filter artists by */
     genre?: string;
+    /** RSQL filter expression, e.g. `artist=="Daft Punk";year=ge=2000`. Supports ==, !=, <, <=, >, >=, =in=, =out=, and `;`/`and`, `,`/`or` combinators, `*` wildcards in string values. Filterable fields: title, artist, year, releaseDate, sha256, uri, artistUri, createdAt */
+    filter?: string;
 }
 export interface GetAlbumTracksOutput {
     tracks?: SongViewBasic[];
@@ -1058,6 +1062,8 @@ export interface GetScrobblesParams {
     limit?: number;
     /** The offset for pagination */
     offset?: number;
+    /** RSQL filter expression, e.g. `track.artist=="Daft Punk";date=ge=2025-01-01`. Supports ==, !=, <, <=, >, >=, =in=, =out=, and `;`/`and`, `,`/`or` combinators, `*` wildcards in string values. Filterable fields: uri, date, timestamp, title, artist, album, track.title, track.artist, track.album, track.albumArtist, track.genre, track.duration, track.isrc, track.mbId, user.did, user.handle, user.displayName, artist.name, artist.genres */
+    filter?: string;
 }
 export interface GetShoutRepliesOutput {
     shouts?: unknown[];
@@ -1115,6 +1121,8 @@ export interface GetSongsParams {
     isrc?: string;
     /** Filter songs by Spotify track ID (resolved internally to the Spotify track URL) */
     spotifyId?: string;
+    /** RSQL filter expression, e.g. `artist=="Daft Punk";duration=gt=200000`. Supports ==, !=, <, <=, >, >=, =in=, =out=, and `;`/`and`, `,`/`or` combinators, `*` wildcards in string values. Filterable fields: title, artist, album, albumArtist, genre, composer, label, duration, trackNumber, discNumber, mbId, isrc, sha256, uri, albumUri, artistUri, createdAt */
+    filter?: string;
 }
 export interface GetStarredOutput {
 }
@@ -1362,6 +1370,17 @@ export interface NotificationActor {
     /** The URL of the actor's avatar image. */
     avatar?: Uri;
 }
+/** The song, album, or scrobble a notification relates to, for rich display. */
+export interface NotificationSubjectView {
+    /** The at-uri of the subject. */
+    uri: string;
+    /** The title of the track or album. */
+    title?: string;
+    /** The artist of the track or album. */
+    artist?: string;
+    /** The album art image URL. */
+    albumArt?: Uri;
+}
 export interface NotificationView {
     /** The unique identifier of the notification. */
     id: string;
@@ -1378,6 +1397,7 @@ export interface NotificationView {
     /** The content of the related shout, if any. */
     shoutContent?: string;
     actor?: NotificationActor;
+    subject?: NotificationSubjectView;
 }
 export interface PingOutput {
 }