@rocksky/sdk 0.3.0 → 0.5.0

package/dist/client.d.ts

@@ -1,116 +1,170 @@
-import { type HttpClientConfig } from "./http.js";
-import { type PaginateArgs } from "./paginate.js";
-import { RealtimeClient, type RealtimeOptions } from "./realtime.js";
-import { ActorNamespace } from "./namespaces/actor.js";
-import { AlbumNamespace } from "./namespaces/album.js";
-import { ApikeyNamespace } from "./namespaces/apikey.js";
-import { ArtistNamespace } from "./namespaces/artist.js";
-import { ChartsNamespace } from "./namespaces/charts.js";
-import { DropboxNamespace } from "./namespaces/dropbox.js";
-import { FeedNamespace } from "./namespaces/feed.js";
-import { GoogleDriveNamespace } from "./namespaces/googledrive.js";
-import { GraphNamespace } from "./namespaces/graph.js";
-import { LikeNamespace } from "./namespaces/like.js";
-import { MirrorNamespace } from "./namespaces/mirror.js";
-import { PlayerNamespace } from "./namespaces/player.js";
-import { PlaylistNamespace } from "./namespaces/playlist.js";
-import { ScrobbleNamespace } from "./namespaces/scrobble.js";
-import { ShoutNamespace } from "./namespaces/shout.js";
-import { SongNamespace } from "./namespaces/song.js";
-import { SpotifyNamespace } from "./namespaces/spotify.js";
-import { StatsNamespace } from "./namespaces/stats.js";
-import type { Endpoints } from "./generated/types.js";
-import type { AuthProvider, ClientOptions, FetchLike, RequestOptions } from "./types.js";
-type XrpcOpts = {
-    params?: Record<string, unknown>;
-    body?: unknown;
-    requireAuth?: boolean;
-} & RequestOptions;
+import type { ActorProfileViewBasic, ActorProfileViewDetailed, AlbumViewBasic, ArtistViewBasic, FeedSearchResultsView, ScrobbleViewBasic, SongViewBasic, StatsGlobalStatsView } 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.
+ */
+export interface DateInterval {
+    startDate?: string;
+    endDate?: string;
+}
+/** Factories for {@link DateInterval} windows used by the `top*Interval` charts. */
+export declare const Interval: {
+    /** No bounds — the all-time chart. */
+    allTime: () => DateInterval;
+    /** The last `n` days ending now. */
+    lastDays: (n: number) => DateInterval;
+    /** The last `n` weeks ending now. */
+    lastWeeks: (n: number) => DateInterval;
+    /** The last `n` months ending now. */
+    lastMonths: (n: number) => DateInterval;
+    /** The last `n` years ending now. */
+    lastYears: (n: number) => DateInterval;
+    /** An explicit closed `[start, end]` window. */
+    range: (start: Date, end: Date) => DateInterval;
+};
+/** The default public Rocksky AppView base URL. */
+export declare const DEFAULT_APPVIEW = "https://api.rocksky.app";
+/** Unauthenticated read client over the public Rocksky AppView XRPC. */
 export declare class RockskyClient {
-    readonly config: HttpClientConfig;
-    readonly actor: ActorNamespace;
-    readonly album: AlbumNamespace;
-    readonly apikey: ApikeyNamespace;
-    readonly artist: ArtistNamespace;
-    readonly charts: ChartsNamespace;
-    readonly dropbox: DropboxNamespace;
-    readonly feed: FeedNamespace;
-    readonly googledrive: GoogleDriveNamespace;
-    readonly graph: GraphNamespace;
-    readonly like: LikeNamespace;
-    readonly mirror: MirrorNamespace;
-    readonly player: PlayerNamespace;
-    readonly playlist: PlaylistNamespace;
-    readonly scrobble: ScrobbleNamespace;
-    readonly shout: ShoutNamespace;
-    readonly song: SongNamespace;
-    readonly spotify: SpotifyNamespace;
-    readonly stats: StatsNamespace;
-    constructor(options?: ClientOptions);
-    /** Build a one-off authenticated copy without mutating this client. */
-    withAuth(auth: AuthProvider): RockskyClient;
-    /** Build a copy with an overridden base URL. */
-    withBaseUrl(baseUrl: string): RockskyClient;
-    /**
-     * Open a realtime WebSocket connection to /ws.
-     *
-     *   const rt = client.realtime({ token, clientName: "my-app" });
-     *   rt.on("message", m => console.log(m));
-     *   await rt.connect();
-     *
-     * Defaults `baseUrl` to this client's base URL. Override anything by
-     * passing the option, or use `RealtimeClient.builder()` for full control.
-     */
-    realtime(options: Omit<RealtimeOptions, "baseUrl"> & Partial<Pick<RealtimeOptions, "baseUrl">>): RealtimeClient;
+    private rpc;
     /**
-     * Page through any limit/offset or cursor-based endpoint as an async iterable.
-     *
-     *   for await (const s of client.paginate({
-     *     fetch: ({ limit, offset }) =>
-     *       client.actor.getActorScrobbles({ did, limit, offset }),
-     *     pageSize: 50,
-     *   })) { ... }
+     * Build a read client against an AppView base URL (defaults to
+     * {@link DEFAULT_APPVIEW}). Pass `token` to send it as
+     * `Authorization: Bearer <token>` on every read — needed only for auth-gated
+     * queries.
      */
-    paginate<T>(args: PaginateArgs<T>): AsyncIterable<T> & {
-        toArray(): Promise<T[]>;
-    };
-    /**
-     * Direct escape hatch — call any XRPC endpoint by NSID.
-     *
-     * Known NSIDs (string literals) are typed via the generated `Endpoints`
-     * map; arbitrary strings fall back to `unknown` (override with `<T>`).
-     */
-    xrpc<K extends keyof Endpoints>(nsid: K, method?: "GET" | "POST", opts?: XrpcOpts): Promise<Endpoints[K]>;
-    xrpc<T = unknown>(nsid: string, method?: "GET" | "POST", opts?: XrpcOpts): Promise<T>;
-    static builder(): RockskyClientBuilder;
-    private optionsSnapshot;
-}
-/**
- * Fluent builder.
- *
- *   const client = RockskyClient.builder()
- *     .baseUrl("https://api.rocksky.app")
- *     .auth(() => loadToken())
- *     .timeout(10_000)
- *     .retries(3)
- *     .userAgent("my-app/1.0")
- *     .build();
- */
-export declare class RockskyClientBuilder {
-    private readonly opts;
-    baseUrl(url: string): this;
-    auth(auth: AuthProvider): this;
-    bearer(token: string): this;
-    fetch(impl: FetchLike): this;
-    header(key: string, value: string): this;
-    headers(headers: Record<string, string>): this;
-    userAgent(ua: string): this;
-    timeout(ms: number): this;
-    retries(n: number): this;
-    retryDelay(ms: number): this;
-    build(): RockskyClient;
+    constructor(appview?: string, token?: string);
+    private query;
+    /** An actor's detailed profile. `actor` is a handle or DID. */
+    profile(actor: string): Promise<ActorProfileViewDetailed>;
+    /** An actor's scrobbles, newest first. */
+    scrobbles(actor: string, limit?: number, offset?: number): Promise<ScrobbleViewBasic[]>;
+    /** 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>;
+    /** An actor's most-played songs. */
+    songs(actor: string, limit?: number, offset?: number): Promise<SongViewBasic[]>;
+    /** An actor's loved (liked) songs. */
+    lovedSongs(actor: string, limit?: number, offset?: number): Promise<SongViewBasic[]>;
+    /** An actor's most-played albums. */
+    albums(actor: string, limit?: number, offset?: number): Promise<AlbumViewBasic[]>;
+    /** An actor's most-played artists. */
+    artists(actor: string, limit?: number, offset?: number): Promise<ArtistViewBasic[]>;
+    /** The platform-wide top tracks chart (all-time). */
+    topTracks(limit?: number, offset?: number): Promise<SongViewBasic[]>;
+    /** The platform-wide top artists chart (all-time). */
+    topArtists(limit?: number, offset?: number): Promise<ArtistViewBasic[]>;
+    /** The top tracks chart over a typed {@link DateInterval}. */
+    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[]>;
+    /** An album's tracklist by album at:// URI. */
+    albumTracks(uri: string): Promise<SongViewBasic[]>;
+    /** An artist's albums by artist at:// URI. */
+    artistAlbums(uri: string): Promise<AlbumViewBasic[]>;
+    /** 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[]>;
+    /** A single scrobble by its at:// URI. */
+    scrobble(uri: string): Promise<ScrobbleViewBasic>;
+    /** The accounts `actor` follows. */
+    follows(actor: string, limit?: number, cursor?: string): Promise<ActorProfileViewBasic[]>;
+    /** The accounts that follow `actor`. */
+    followers(actor: string, limit?: number, cursor?: string): Promise<ActorProfileViewBasic[]>;
+    /** Followers of `actor` that the viewer also follows. */
+    knownFollowers(actor: string, limit?: number, cursor?: string): Promise<ActorProfileViewBasic[]>;
+    /** Full-text search across songs, albums, artists, playlists, actors. */
+    search(query: string): Promise<FeedSearchResultsView>;
+    /** Platform-wide totals. */
+    globalStats(): Promise<StatsGlobalStatsView>;
+    /** A feed by its at:// URI (paginate via `cursor`). */
+    feed(feed: string, limit?: number, cursor?: string): Promise<unknown>;
+    /** A single album with its tracklist. */
+    album(uri: string): Promise<unknown>;
+    /** A single artist with detail. */
+    artist(uri: string): Promise<unknown>;
+    /** Resolve full canonical metadata for a bare title + artist
+     * (`app.rocksky.song.matchSong`); optionally anchor with `mbId` / `isrc`. */
+    matchSong(title: string, artist: string, mbId?: string, isrc?: string): Promise<unknown>;
+    /** A single song by at:// `uri` (or by `mbid` / `isrc` / `spotifyId`). */
+    song(opts: {
+        uri?: string;
+        mbid?: string;
+        isrc?: string;
+        spotifyId?: string;
+    }): Promise<unknown>;
+    /** An actor's playlists. */
+    actorPlaylists(actor: string, limit?: number, offset?: number): Promise<unknown>;
+    /** Actors with similar taste to `actor`. */
+    neighbours(actor: string): Promise<unknown>;
+    /** Music compatibility between the viewer and `actor` (auth). */
+    compatibility(actor: string): Promise<unknown>;
+    /** An artist's all-time listeners. */
+    artistListeners(uri: string, limit?: number, offset?: number): Promise<unknown>;
+    /** An artist's recent listeners. */
+    artistRecentListeners(uri: string, limit?: number, offset?: number): Promise<unknown>;
+    /** A song's recent listeners. */
+    songRecentListeners(uri: string, limit?: number, offset?: number): Promise<unknown>;
+    /** A scrobble time-series chart. Scope with any of `did` / `artisturi` /
+     * `albumuri` / `songuri` / `genre` and bound with `from` / `to`. */
+    scrobblesChart(opts: {
+        did?: string;
+        artisturi?: string;
+        albumuri?: string;
+        songuri?: string;
+        genre?: string;
+        from?: string;
+        to?: string;
+    }): Promise<unknown>;
+    /** List the available feed generators. */
+    feedGenerators(size?: number): Promise<unknown>;
+    /** A single feed generator's record. */
+    feedGenerator(feed: string): Promise<unknown>;
+    /** The stories row. */
+    stories(size?: number, feed?: string, following?: boolean): Promise<unknown>;
+    /** Track recommendations for `actor`. */
+    recommendations(actor: string, limit?: number): Promise<unknown>;
+    /** Artist recommendations for `actor`. */
+    artistRecommendations(actor: string, limit?: number): Promise<unknown>;
+    /** Album recommendations for `actor`. */
+    albumRecommendations(actor: string, limit?: number): Promise<unknown>;
+    /** An actor's aggregate stats. */
+    stats(actor: string): Promise<unknown>;
+    /** An actor's year-in-review. */
+    wrapped(actor: string, year?: number): Promise<unknown>;
+    /** The viewer's configured scrobble mirror sources (auth). */
+    mirrorSources(): Promise<unknown>;
+    /** What `actor` is playing now. */
+    currentlyPlaying(playerId?: string, actor?: string): Promise<unknown>;
+    /** A player's playback queue. */
+    playbackQueue(playerId: string): Promise<unknown>;
+    /** What `actor` is playing now on Spotify. */
+    spotifyCurrentlyPlaying(actor: string): Promise<unknown>;
+    /** The playlist catalog. */
+    playlists(limit?: number, offset?: number): Promise<unknown>;
+    /** A single playlist with its items. */
+    playlist(uri: string): Promise<unknown>;
+    /** Shouts on an album. */
+    albumShouts(uri: string, limit?: number, offset?: number): Promise<unknown>;
+    /** Shouts on an artist. */
+    artistShouts(uri: string, limit?: number, offset?: number): Promise<unknown>;
+    /** Shouts on a profile. */
+    profileShouts(actor: string, limit?: number, offset?: number): Promise<unknown>;
+    /** Shouts on a track. */
+    trackShouts(uri: string): Promise<unknown>;
+    /** Replies to a shout. */
+    shoutReplies(uri: string, limit?: number, offset?: number): Promise<unknown>;
+    /** An actor's Rockbox EQ / audio settings. */
+    audioSettings(actor: string): Promise<unknown>;
+    /** The viewer's API keys (auth). */
+    apikeys(limit?: number, offset?: number): Promise<unknown>;
 }
-/** Convenience factory — equivalent to `new RockskyClient(options)`. */
-export declare function createClient(options?: ClientOptions): RockskyClient;
-export {};
 //# 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.d.ts

@@ -0,0 +1,38 @@
+/** What an {@link RockskyIndex.indexCar} pass added. */
+export interface IndexStats {
+    artists: number;
+    albums: number;
+    songs: number;
+    scrobbles: number;
+}
+export declare function totalIndexed(s: IndexStats): number;
+/**
+ * Local duplicate-prevention mirror of a user's repo, keyed by Rocksky's
+ * identity hashes, backed by an embedded LevelDB (classic-level). Built from the
+ * repo CAR by {@link Agent.syncRepo} and kept live by {@link Agent.hydrateFromJetstream}.
+ */
+export declare class RockskyIndex {
+    private db;
+    constructor(path: string);
+    /** Open the database (call before use). */
+    open(): Promise<void>;
+    /** Close the database. */
+    close(): Promise<void>;
+    private get;
+    songUri(did: string, title: string, artist: string, album: string): Promise<string | undefined>;
+    albumUri(did: string, album: string, albumArtist: string): Promise<string | undefined>;
+    artistUri(did: string, albumArtist: string): Promise<string | undefined>;
+    scrobbleUri(did: string, title: string, artist: string, album: string, secs: number): Promise<string | undefined>;
+    private putPrimary;
+    recordSong(did: string, title: string, artist: string, album: string, uri: string): Promise<void>;
+    recordAlbum(did: string, album: string, albumArtist: string, uri: string): Promise<void>;
+    recordArtist(did: string, albumArtist: string, uri: string): Promise<void>;
+    recordScrobble(did: string, title: string, artist: string, album: string, secs: number, uri: string): Promise<void>;
+    cursor(did: string): Promise<number>;
+    setCursor(did: string, timeUS: number): Promise<void>;
+    /** Ingest a full repo CAR for `did`, indexing song/album/artist/scrobble. */
+    indexCar(did: string, car: Uint8Array): Promise<IndexStats>;
+    /** Apply a single Jetstream commit event to the index. */
+    applyCommit(did: string, col: string, operation: string, rkey: string, record: Record<string, unknown> | undefined): Promise<void>;
+}
+//# sourceMappingURL=dedup.d.ts.map

package/dist/dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../src/dedup.ts"],"names":[],"mappings":"AAaA,wDAAwD;AACxD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAElD;AA+BD;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAA+B;gBAE7B,IAAI,EAAE,MAAM;IAIxB,2CAA2C;IAC3C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAGrB,0BAA0B;IAC1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAIR,GAAG;IAQjB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAG/F,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAGtF,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAGxE,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;YAInG,UAAU;IAOxB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAGjG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAGxF,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAG1E,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAG9B,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,6EAA6E;IACvE,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAoCjE,0DAA0D;IACpD,WAAW,CACf,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC1C,OAAO,CAAC,IAAI,CAAC;CAiBjB"}

package/dist/errors.d.ts

@@ -1,26 +1,6 @@
+/** Error thrown when a Rocksky XRPC call returns a non-2xx `{ error, message }`. */
 export declare class RockskyError extends Error {
-    readonly cause?: unknown;
-    constructor(message: string, options?: {
-        cause?: unknown;
-    });
-}
-export declare class RockskyHttpError extends RockskyError {
-    readonly status: number;
-    readonly statusText: string;
-    readonly url: string;
-    readonly body: unknown;
-    constructor(args: {
-        status: number;
-        statusText: string;
-        url: string;
-        body: unknown;
-        message?: string;
-    });
-}
-export declare class RockskyTimeoutError extends RockskyError {
-    constructor(ms: number);
-}
-export declare class RockskyAuthError extends RockskyError {
-    constructor(message?: string);
+    readonly kind?: string;
+    constructor(payload: unknown);
 }
 //# 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,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBACb,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAK3D;AAED,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;gBAEX,IAAI,EAAE;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,OAAO,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CAWF;AAED,qBAAa,mBAAoB,SAAQ,YAAY;gBACvC,EAAE,EAAE,MAAM;CAIvB;AAED,qBAAa,gBAAiB,SAAQ,YAAY;gBACpC,OAAO,SAA4B;CAIhD"}
+{"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"}

package/dist/generated/types.d.ts

@@ -777,6 +777,10 @@ export interface GetArtistTracksParams {
     /** The offset for pagination */
     offset?: number;
 }
+export interface GetAudioSettingsParams {
+    /** DID or handle of the user whose settings to fetch. Required for unauthenticated requests. */
+    did?: AtIdentifier;
+}
 export interface GetCurrentlyPlayingParams {
     playerId?: string;
     /** Handle or DID of the actor to retrieve the currently playing track for. If not provided, defaults to the current user. */
@@ -1241,6 +1245,16 @@ export interface ProfileRecord {
     joinedViaStarterPack?: StrongRef;
     createdAt?: DateTime;
 }
+export interface PutAudioSettingsInput {
+    /** Crossfade settings to apply. */
+    crossfade?: RockboxCrossfadeSettings;
+    /** Equalizer settings to apply. */
+    equalizer?: RockboxEqualizerSettings;
+    /** Replay gain settings to apply. */
+    replayGain?: RockboxReplayGainSettings;
+    /** Tone control settings to apply. */
+    tone?: RockboxToneSettings;
+}
 export interface PutMirrorSourceInput {
     /** One of: lastfm, listenbrainz, tealfm */
     provider: string;
@@ -1325,6 +1339,68 @@ export interface ReportShoutInput {
     /** The reason for reporting the shout */
     reason?: string;
 }
+export interface RockboxCrossfadeSettings {
+    /** Crossfade mode: disabled | enabled | shuffle | albumChange | trackChange */
+    mode?: string;
+    /** Fade-in delay in ms */
+    fadeInDelay?: number;
+    /** Fade-in duration in ms */
+    fadeInDuration?: number;
+    /** Fade-out delay in ms */
+    fadeOutDelay?: number;
+    /** Fade-out duration in ms */
+    fadeOutDuration?: number;
+    /** Fade-out mix mode: crossfade | mix */
+    fadeOutMixMode?: string;
+}
+export interface RockboxEqualizerBand {
+    /** Center frequency in Hz */
+    frequency: number;
+    /** Band gain in tenths of dB (e.g. 30 = +3.0 dB) */
+    gain: number;
+    /** Q factor × 10 (e.g. 7 = Q 0.7) */
+    q: number;
+}
+export interface RockboxEqualizerSettings {
+    /** Whether the equalizer is enabled */
+    enabled?: boolean;
+    /** Pre-amplification cut in tenths of dB applied before EQ bands (e.g. -60 = -6.0 dB) */
+    precut?: number;
+    /** Up to 10 EQ bands */
+    bands?: RockboxEqualizerBand[];
+}
+export interface RockboxReplayGainSettings {
+    /** Replay gain mode: disabled | track | album | trackIfShuffling */
+    mode?: string;
+    /** Pre-amplification in tenths of dB (e.g. 15 = +1.5 dB) */
+    preamp?: number;
+    /** Whether to prevent clipping by reducing volume */
+    preventClipping?: boolean;
+}
+export interface RockboxSettingsView {
+    /** Crossfade settings */
+    crossfade?: RockboxCrossfadeSettings;
+    /** Equalizer settings */
+    equalizer?: RockboxEqualizerSettings;
+    /** Replay gain settings */
+    replayGain?: RockboxReplayGainSettings;
+    /** Tone control settings (bass, treble, balance, channels) */
+    tone?: RockboxToneSettings;
+    /** When this settings record was first created. */
+    createdAt: DateTime;
+    /** When this settings record was last updated. */
+    updatedAt?: DateTime;
+}
+export interface RockboxToneSettings {
+    /** Bass level in dB */
+    bass?: number;
+    /** Treble level in dB */
+    treble?: number;
+    /** Left/right balance. Negative = left, positive = right */
+    balance?: number;
+    /** Channel configuration: stereo | mono | monoLeft | monoRight | karaoke | wide */
+    channels?: string;
+}
 export interface ScrobbleFirstScrobbleView {
     /** The handle of the user who first scrobbled this song. */
     handle?: string;
@@ -1390,26 +1466,32 @@ export interface ScrobbleRecord {
 export interface ScrobbleViewBasic {
     /** The unique identifier of the scrobble. */
     id?: string;
-    /** The handle of the user who created the scrobble. */
-    user?: string;
-    /** The display name of the user who created the scrobble. */
-    userDisplayName?: string;
-    /** The avatar URL of the user who created the scrobble. */
-    userAvatar?: Uri;
+    /** The unique identifier of the track this scrobble is of. */
+    trackId?: string;
     /** The title of the scrobble. */
     title?: string;
     /** The artist of the song. */
     artist?: string;
     /** The URI of the artist. */
     artistUri?: AtUri;
+    /** The album artist of the song. */
+    albumArtist?: string;
     /** The album of the song. */
     album?: string;
     /** The URI of the album. */
     albumUri?: AtUri;
     /** The album art URL of the song. */
-    cover?: Uri;
+    albumArt?: Uri;
+    /** The URI of the track (song) this scrobble is of. */
+    trackUri?: AtUri;
+    /** The handle of the user who created the scrobble. */
+    handle?: string;
+    /** The DID of the user who created the scrobble. */
+    did?: AtIdentifier;
+    /** The avatar URL of the user who created the scrobble. */
+    avatar?: Uri;
     /** The timestamp when the scrobble was created. */
-    date?: DateTime;
+    createdAt?: DateTime;
     /** The URI of the scrobble. */
     uri?: Uri;
     /** The SHA256 hash of the scrobble data. */
@@ -1459,6 +1541,20 @@ export interface SeekParams {
     /** The position in seconds to seek to */
     position: number;
 }
+export interface SettingsRecord {
+    /** Crossfade settings */
+    crossfade?: RockboxCrossfadeSettings;
+    /** Equalizer settings */
+    equalizer?: RockboxEqualizerSettings;
+    /** Replay gain settings */
+    replayGain?: RockboxReplayGainSettings;
+    /** Tone control settings (bass, treble, balance, channels) */
+    tone?: RockboxToneSettings;
+    /** When this settings record was first created. */
+    createdAt: DateTime;
+    /** When this settings record was last updated. */
+    updatedAt?: DateTime;
+}
 export interface ShoutAuthor {
     /** The unique identifier of the author. */
     id?: string;
@@ -1906,6 +2002,8 @@ export interface Endpoints {
     "app.rocksky.playlist.removePlaylist": void;
     "app.rocksky.playlist.removeTrack": void;
     "app.rocksky.playlist.startPlaylist": void;
+    "app.rocksky.rockbox.getAudioSettings": RockboxSettingsView;
+    "app.rocksky.rockbox.putAudioSettings": RockboxSettingsView;
     "app.rocksky.scrobble.createScrobble": ScrobbleViewBasic;
     "app.rocksky.scrobble.getScrobble": ScrobbleViewDetailed;
     "app.rocksky.scrobble.getScrobbles": GetScrobblesOutput;