rocksky 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e48d42415ab7937416c2e008a6b637b4e2aef4474f60aae824cf1e089a3814f3
-  data.tar.gz: eefc4a0023800e5f0d03a4fd41837589b9fc02bd49e4244bcd7a260bc88895a6
+  metadata.gz: 49ece2a26c96c4edb2110ec0ac28f0c5dcc46d4eb6e7a1b3526cf0f82b045599
+  data.tar.gz: 63a9342d472e413572ef7c5e9c756d930dd95c0571ccac56a16bb5f4e0a1a49b
 SHA512:
-  metadata.gz: 11773d9ea99df5d975d9c81636a3cd0058ea69a4a2cfcb9aa7b2579fbdcd0350f7b7c80ef34e4dadadd5b55232fd4d458773a319449d034118e7f436fafab71b
-  data.tar.gz: 94cf1dba5ddb40fb27781044b27bf3cbe1e3cea3720e522541f4db5ab85d1431b1992af384db625128f13c3971a7a543f22f2747e0e011b936d4de3092219a57
+  metadata.gz: 59b15a62bef85d1beb4f281dfa24388b92a0887d0101f2a5f6d88693f947fc0d70affe522ee19191bbce09a101480953ce1f16abe6ac28530dea573ce4af4fec
+  data.tar.gz: 728673d1cf68236bacb64c155e086659a22bfd0a57bb1f81ffe1522cd593f40151e4c1d6cbf892afef7ecc3dee043fc2188d1e93f1de2a4e242ba3a38a39f552

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.3.0
+
+- `feed.get_stories` now accepts optional `feed:` (at-uri) and `following:`
+  (boolean) kwargs. `feed:` narrows results to scrobbles in that feed
+  generator; `following: true` restricts to users the viewer follows and
+  requires an authenticated client. Filters intersect when both are supplied.
+
+## 0.2.0
+
+- Added lexicon-derived `Struct`s under `Rocksky::Generated::*` covering every
+  lex `*View*` / `*Record` / `*Input` / `*Output` / `*Params` shape. Generated
+  from `apps/api/lexicons/` via `bun run lexgen:types` at the repo root.
+
 ## 0.1.0
 
 - Initial release. Coverage for all `app.rocksky.*` XRPC endpoints across the

data/README.md

@@ -132,7 +132,7 @@ pre-loaded with a `client` bound to your environment.
 ```bash
 $ gem install rocksky
 $ ROCKSKY_TOKEN=eyJ... rocksky-console
-Rocksky 0.1.0 — interactive console
+Rocksky 0.2.0 — interactive console
   base_url : https://api.rocksky.app
   token    : present (set via ROCKSKY_TOKEN)
 
@@ -194,6 +194,11 @@ client = Rocksky.new(open_timeout: 2, read_timeout: 5)
 | `open_timeout` | `10` seconds                  | —                     |
 | `read_timeout` | `30` seconds                  | —                     |
 
+## Types
+
+Lexicon-derived `Struct` types are available under `Rocksky::Generated::*`, mirroring every lex `*View*` / `*Record` / `*Input` / `*Output` / `*Params` shape from [the Rocksky lexicons](https://tangled.org/rocksky.app/rocksky/tree/main/apps/api/lexicons). Regenerate with `bun run lexgen:types` at the repo root.
+
+
 ## Examples
 
 The `examples/` directory contains runnable scripts:

data/lib/rocksky/generated/types.rb

@@ -0,0 +1,219 @@
+# frozen_string_literal: true
+# AUTO-GENERATED FILE -- DO NOT EDIT.
+# Source: apps/api/lexicons/**/*.json
+# Regenerate via: bun run lexgen:types
+
+module Rocksky
+  module Generated
+    BlobRef = Struct.new(:type, :ref, :mimeType, :size, keyword_init: true)
+
+    ActorArtistViewBasic = Struct.new(:id, :name, :picture, :uri, :user1Rank, :user2Rank, :weight, keyword_init: true)
+    ActorCompatibilityViewBasic = Struct.new(:compatibilityLevel, :compatibilityPercentage, :sharedArtists, :topSharedArtistNames, :topSharedDetailedArtists, :user1ArtistCount, :user2ArtistCount, keyword_init: true)
+    ActorNeighbourViewBasic = Struct.new(:userId, :did, :handle, :displayName, :avatar, :sharedArtistsCount, :similarityScore, :topSharedArtistNames, :topSharedArtistsDetails, keyword_init: true)
+    ActorProfileViewBasic = Struct.new(:id, :did, :handle, :displayName, :avatar, :createdAt, :updatedAt, keyword_init: true)
+    ActorProfileViewDetailed = Struct.new(:id, :did, :handle, :displayName, :avatar, :createdAt, :updatedAt, keyword_init: true)
+    ActorTrackView = Struct.new(:name, :artist, :album, :albumCoverUrl, :durationMs, :source, :recordingMbId, keyword_init: true)
+    AddDirectoryToQueueParams = Struct.new(:playerId, :directory, :position, :shuffle, keyword_init: true)
+    AddItemsToQueueParams = Struct.new(:playerId, :items, :position, :shuffle, keyword_init: true)
+    AlbumRecord = Struct.new(:title, :artist, :duration, :releaseDate, :year, :genre, :albumArt, :albumArtUrl, :tags, :youtubeLink, :spotifyLink, :tidalLink, :appleMusicLink, :createdAt, keyword_init: true)
+    AlbumViewBasic = Struct.new(:id, :uri, :title, :artist, :artistUri, :year, :albumArt, :releaseDate, :sha256, :playCount, :uniqueListeners, keyword_init: true)
+    AlbumViewDetailed = Struct.new(:id, :uri, :title, :artist, :artistUri, :year, :albumArt, :releaseDate, :sha256, :playCount, :uniqueListeners, :tags, :tracks, keyword_init: true)
+    ApiKeyView = Struct.new(:id, :name, :description, :createdAt, keyword_init: true)
+    ArtistListenerViewBasic = Struct.new(:id, :did, :handle, :displayName, :avatar, :mostListenedSong, :totalPlays, :rank, keyword_init: true)
+    ArtistMbid = Struct.new(:mbid, :name, keyword_init: true)
+    ArtistRecentListenerView = Struct.new(:id, :did, :handle, :displayName, :avatar, :timestamp, :scrobbleUri, keyword_init: true)
+    ArtistRecord = Struct.new(:name, :bio, :picture, :pictureUrl, :tags, :born, :died, :bornIn, :createdAt, keyword_init: true)
+    ArtistSongViewBasic = Struct.new(:uri, :title, :playCount, keyword_init: true)
+    ArtistViewBasic = Struct.new(:id, :uri, :name, :picture, :sha256, :playCount, :uniqueListeners, :tags, keyword_init: true)
+    ArtistViewDetailed = Struct.new(:id, :uri, :name, :picture, :sha256, :playCount, :uniqueListeners, :tags, keyword_init: true)
+    ChartsScrobbleViewBasic = Struct.new(:date, :count, keyword_init: true)
+    ChartsView = Struct.new(:scrobbles, keyword_init: true)
+    CreateApikeyInput = Struct.new(:name, :description, keyword_init: true)
+    CreatePlaylistParams = Struct.new(:name, :description, keyword_init: true)
+    CreateScrobbleInput = Struct.new(:title, :artist, :album, :duration, :mbId, :isrc, :albumArt, :trackNumber, :releaseDate, :year, :discNumber, :lyrics, :composer, :copyrightMessage, :label, :artistPicture, :spotifyLink, :lastfmLink, :tidalLink, :appleMusicLink, :youtubeLink, :deezerLink, :timestamp, keyword_init: true)
+    CreateShoutInput = Struct.new(:message, keyword_init: true)
+    CreateSongInput = Struct.new(:title, :artist, :albumArtist, :album, :duration, :mbId, :isrc, :albumArt, :trackNumber, :releaseDate, :year, :discNumber, :lyrics, keyword_init: true)
+    DescribeFeedGeneratorOutput = Struct.new(:did, :feeds, keyword_init: true)
+    DescribeFeedGeneratorParams = Struct.new(keyword_init: true)
+    DislikeShoutInput = Struct.new(:uri, keyword_init: true)
+    DislikeSongInput = Struct.new(:uri, keyword_init: true)
+    DownloadFileParams = Struct.new(:fileId, keyword_init: true)
+    DropboxFileListView = Struct.new(:files, keyword_init: true)
+    DropboxFileView = Struct.new(:id, :name, :pathLower, :pathDisplay, :clientModified, :serverModified, keyword_init: true)
+    DropboxTemporaryLinkView = Struct.new(:link, keyword_init: true)
+    FeedGeneratorsView = Struct.new(:feeds, keyword_init: true)
+    FeedGeneratorView = Struct.new(:id, :name, :description, :uri, :avatar, :creator, keyword_init: true)
+    FeedItemView = Struct.new(:scrobble, keyword_init: true)
+    FeedRecommendationsView = Struct.new(:recommendations, :cursor, keyword_init: true)
+    FeedRecommendationView = Struct.new(:title, :artist, :album, :albumArt, :trackUri, :artistUri, :albumUri, :genres, :recommendationScore, :source, :likesCount, keyword_init: true)
+    FeedRecommendedAlbumsView = Struct.new(:albums, :cursor, keyword_init: true)
+    FeedRecommendedAlbumView = Struct.new(:id, :uri, :title, :artist, :artistUri, :year, :albumArt, :recommendationScore, :source, keyword_init: true)
+    FeedRecommendedArtistsView = Struct.new(:artists, :cursor, keyword_init: true)
+    FeedRecommendedArtistView = Struct.new(:id, :uri, :name, :picture, :genres, :recommendationScore, :source, keyword_init: true)
+    FeedSearchResultsView = Struct.new(:hits, :processingTimeMs, :limit, :offset, :estimatedTotalHits, keyword_init: true)
+    FeedStoriesView = Struct.new(:stories, keyword_init: true)
+    FeedStoryView = Struct.new(:album, :albumArt, :albumArtist, :albumUri, :artist, :artistUri, :avatar, :createdAt, :did, :handle, :id, :title, :trackId, :trackUri, :uri, keyword_init: true)
+    FeedUriView = Struct.new(:uri, keyword_init: true)
+    FeedView = Struct.new(:feed, :cursor, keyword_init: true)
+    FollowAccountOutput = Struct.new(:subject, :followers, :cursor, keyword_init: true)
+    FollowAccountParams = Struct.new(:account, keyword_init: true)
+    FollowRecord = Struct.new(:createdAt, :subject, :via, keyword_init: true)
+    GeneratorRecord = Struct.new(:did, :avatar, :displayName, :description, :createdAt, keyword_init: true)
+    GetActorAlbumsOutput = Struct.new(:albums, keyword_init: true)
+    GetActorAlbumsParams = Struct.new(:did, :limit, :offset, :startDate, :endDate, keyword_init: true)
+    GetActorArtistsOutput = Struct.new(:artists, keyword_init: true)
+    GetActorArtistsParams = Struct.new(:did, :limit, :offset, :startDate, :endDate, keyword_init: true)
+    GetActorCompatibilityOutput = Struct.new(:compatibility, keyword_init: true)
+    GetActorCompatibilityParams = Struct.new(:did, keyword_init: true)
+    GetActorLovedSongsOutput = Struct.new(:tracks, keyword_init: true)
+    GetActorLovedSongsParams = Struct.new(:did, :limit, :offset, keyword_init: true)
+    GetActorNeighboursOutput = Struct.new(:neighbours, keyword_init: true)
+    GetActorNeighboursParams = Struct.new(:did, keyword_init: true)
+    GetActorPlaylistsOutput = Struct.new(:playlists, keyword_init: true)
+    GetActorPlaylistsParams = Struct.new(:did, :limit, :offset, keyword_init: true)
+    GetActorScrobblesOutput = Struct.new(:scrobbles, keyword_init: true)
+    GetActorScrobblesParams = Struct.new(:did, :limit, :offset, keyword_init: true)
+    GetActorSongsOutput = Struct.new(:songs, keyword_init: true)
+    GetActorSongsParams = Struct.new(:did, :limit, :offset, :startDate, :endDate, keyword_init: true)
+    GetAlbumParams = Struct.new(:uri, keyword_init: true)
+    GetAlbumRecommendationsParams = Struct.new(:did, :limit, keyword_init: true)
+    GetAlbumShoutsOutput = Struct.new(:shouts, keyword_init: true)
+    GetAlbumShoutsParams = Struct.new(:uri, :limit, :offset, keyword_init: true)
+    GetAlbumsOutput = Struct.new(:albums, keyword_init: true)
+    GetAlbumsParams = Struct.new(:limit, :offset, :genre, keyword_init: true)
+    GetAlbumTracksOutput = Struct.new(:tracks, keyword_init: true)
+    GetAlbumTracksParams = Struct.new(:uri, keyword_init: true)
+    GetApikeysOutput = Struct.new(:apiKeys, keyword_init: true)
+    GetApikeysParams = Struct.new(:offset, :limit, keyword_init: true)
+    GetArtistAlbumsOutput = Struct.new(:albums, keyword_init: true)
+    GetArtistAlbumsParams = Struct.new(:uri, keyword_init: true)
+    GetArtistListenersOutput = Struct.new(:listeners, keyword_init: true)
+    GetArtistListenersParams = Struct.new(:uri, :offset, :limit, keyword_init: true)
+    GetArtistParams = Struct.new(:uri, keyword_init: true)
+    GetArtistRecentListenersOutput = Struct.new(:listeners, keyword_init: true)
+    GetArtistRecentListenersParams = Struct.new(:uri, :offset, :limit, keyword_init: true)
+    GetArtistRecommendationsParams = Struct.new(:did, :limit, keyword_init: true)
+    GetArtistShoutsOutput = Struct.new(:shouts, keyword_init: true)
+    GetArtistShoutsParams = Struct.new(:uri, :limit, :offset, keyword_init: true)
+    GetArtistsOutput = Struct.new(:artists, keyword_init: true)
+    GetArtistsParams = Struct.new(:limit, :offset, :names, :genre, keyword_init: true)
+    GetArtistTracksOutput = Struct.new(:tracks, keyword_init: true)
+    GetArtistTracksParams = Struct.new(:uri, :limit, :offset, keyword_init: true)
+    GetCurrentlyPlayingParams = Struct.new(:playerId, :actor, keyword_init: true)
+    GetFeedGeneratorOutput = Struct.new(:view, keyword_init: true)
+    GetFeedGeneratorParams = Struct.new(:feed, keyword_init: true)
+    GetFeedGeneratorsParams = Struct.new(:size, keyword_init: true)
+    GetFeedParams = Struct.new(:feed, :limit, :cursor, keyword_init: true)
+    GetFeedSkeletonOutput = Struct.new(:scrobbles, :cursor, keyword_init: true)
+    GetFeedSkeletonParams = Struct.new(:feed, :limit, :offset, :cursor, keyword_init: true)
+    GetFileParams = Struct.new(:fileId, keyword_init: true)
+    GetFilesParams = Struct.new(:at, keyword_init: true)
+    GetFollowersOutput = Struct.new(:subject, :followers, :cursor, :count, keyword_init: true)
+    GetFollowersParams = Struct.new(:actor, :limit, :dids, :cursor, keyword_init: true)
+    GetFollowsOutput = Struct.new(:subject, :follows, :cursor, :count, keyword_init: true)
+    GetFollowsParams = Struct.new(:actor, :limit, :dids, :cursor, keyword_init: true)
+    GetGlobalStatsParams = Struct.new(keyword_init: true)
+    GetKnownFollowersOutput = Struct.new(:subject, :followers, :cursor, keyword_init: true)
+    GetKnownFollowersParams = Struct.new(:actor, :limit, :cursor, keyword_init: true)
+    GetMetadataParams = Struct.new(:path, keyword_init: true)
+    GetMirrorSourcesOutput = Struct.new(:sources, keyword_init: true)
+    GetMirrorSourcesParams = Struct.new(keyword_init: true)
+    GetPlaybackQueueParams = Struct.new(:playerId, keyword_init: true)
+    GetPlaylistParams = Struct.new(:uri, keyword_init: true)
+    GetPlaylistsOutput = Struct.new(:playlists, keyword_init: true)
+    GetPlaylistsParams = Struct.new(:limit, :offset, keyword_init: true)
+    GetProfileParams = Struct.new(:did, keyword_init: true)
+    GetProfileShoutsOutput = Struct.new(:shouts, keyword_init: true)
+    GetProfileShoutsParams = Struct.new(:did, :offset, :limit, keyword_init: true)
+    GetRecommendationsParams = Struct.new(:did, :limit, keyword_init: true)
+    GetScrobbleParams = Struct.new(:uri, keyword_init: true)
+    GetScrobblesChartParams = Struct.new(:did, :artisturi, :albumuri, :songuri, :genre, :from, :to, keyword_init: true)
+    GetScrobblesOutput = Struct.new(:scrobbles, keyword_init: true)
+    GetScrobblesParams = Struct.new(:did, :following, :limit, :offset, keyword_init: true)
+    GetShoutRepliesOutput = Struct.new(:shouts, keyword_init: true)
+    GetShoutRepliesParams = Struct.new(:uri, :limit, :offset, keyword_init: true)
+    GetSongParams = Struct.new(:uri, :mbid, :isrc, :spotifyId, keyword_init: true)
+    GetSongRecentListenersOutput = Struct.new(:listeners, keyword_init: true)
+    GetSongRecentListenersParams = Struct.new(:uri, :offset, :limit, keyword_init: true)
+    GetSongsOutput = Struct.new(:songs, keyword_init: true)
+    GetSongsParams = Struct.new(:limit, :offset, :genre, :mbid, :isrc, :spotifyId, keyword_init: true)
+    GetStatsParams = Struct.new(:did, keyword_init: true)
+    GetStoriesParams = Struct.new(:size, :feed, :following, keyword_init: true)
+    GetTemporaryLinkParams = Struct.new(:path, keyword_init: true)
+    GetTopArtistsOutput = Struct.new(:artists, keyword_init: true)
+    GetTopArtistsParams = Struct.new(:limit, :offset, :startDate, :endDate, keyword_init: true)
+    GetTopTracksOutput = Struct.new(:tracks, keyword_init: true)
+    GetTopTracksParams = Struct.new(:limit, :offset, :startDate, :endDate, keyword_init: true)
+    GetTrackShoutsOutput = Struct.new(:shouts, keyword_init: true)
+    GetTrackShoutsParams = Struct.new(:uri, keyword_init: true)
+    GetWrappedParams = Struct.new(:did, :year, keyword_init: true)
+    GoogledriveFileListView = Struct.new(:files, keyword_init: true)
+    GoogledriveFileView = Struct.new(:id, keyword_init: true)
+    # indicates that a handle or DID could not be resolved
+    GraphNotFoundActor = Struct.new(:actor, :notFound, keyword_init: true)
+    GraphRelationship = Struct.new(:did, :following, :followedBy, keyword_init: true)
+    InsertDirectoryParams = Struct.new(:uri, :directory, :position, keyword_init: true)
+    InsertFilesParams = Struct.new(:uri, :files, :position, keyword_init: true)
+    LikeRecord = Struct.new(:createdAt, :subject, keyword_init: true)
+    LikeShoutInput = Struct.new(:uri, keyword_init: true)
+    LikeSongInput = Struct.new(:uri, keyword_init: true)
+    MatchSongParams = Struct.new(:title, :artist, :mbId, :isrc, keyword_init: true)
+    MirrorSourceView = Struct.new(:provider, :enabled, :externalUsername, :hasCredentials, :lastPolledAt, :lastScrobbleSeenAt, keyword_init: true)
+    NextParams = Struct.new(:playerId, keyword_init: true)
+    PauseParams = Struct.new(:playerId, keyword_init: true)
+    PlayDirectoryParams = Struct.new(:playerId, :directoryId, :shuffle, :recurse, :position, keyword_init: true)
+    PlayerCurrentlyPlayingViewDetailed = Struct.new(:title, keyword_init: true)
+    PlayerPlaybackQueueViewDetailed = Struct.new(:tracks, keyword_init: true)
+    PlayFileParams = Struct.new(:playerId, :fileId, keyword_init: true)
+    PlaylistItemRecord = Struct.new(:subject, :createdAt, :track, :order, keyword_init: true)
+    PlaylistRecord = Struct.new(:name, :description, :picture, :pictureUrl, :createdAt, :spotifyLink, :tidalLink, :youtubeLink, :appleMusicLink, keyword_init: true)
+    # Basic view of a playlist, including its metadata
+    PlaylistViewBasic = Struct.new(:id, :title, :uri, :curatorDid, :curatorHandle, :curatorName, :curatorAvatarUrl, :description, :coverImageUrl, :createdAt, :trackCount, keyword_init: true)
+    # Detailed view of a playlist, including its tracks and metadata
+    PlaylistViewDetailed = Struct.new(:id, :title, :uri, :curatorDid, :curatorHandle, :curatorName, :curatorAvatarUrl, :description, :coverImageUrl, :createdAt, :tracks, keyword_init: true)
+    PlayParams = Struct.new(:playerId, keyword_init: true)
+    PreviousParams = Struct.new(:playerId, keyword_init: true)
+    ProfileRecord = Struct.new(:displayName, :description, :avatar, :banner, :labels, :joinedViaStarterPack, :createdAt, keyword_init: true)
+    PutMirrorSourceInput = Struct.new(:provider, :enabled, :externalUsername, :apiKey, keyword_init: true)
+    RadioRecord = Struct.new(:name, :url, :description, :genre, :logo, :website, :createdAt, keyword_init: true)
+    RadioViewBasic = Struct.new(:id, :name, :description, :createdAt, keyword_init: true)
+    RadioViewDetailed = Struct.new(:id, :name, :description, :website, :url, :genre, :logo, :createdAt, keyword_init: true)
+    RemoveApikeyParams = Struct.new(:id, keyword_init: true)
+    RemovePlaylistParams = Struct.new(:uri, keyword_init: true)
+    RemoveShoutParams = Struct.new(:id, keyword_init: true)
+    RemoveTrackParams = Struct.new(:uri, :position, keyword_init: true)
+    ReplyShoutInput = Struct.new(:shoutId, :message, keyword_init: true)
+    ReportShoutInput = Struct.new(:shoutId, :reason, keyword_init: true)
+    ScrobbleFirstScrobbleView = Struct.new(:handle, :avatar, :timestamp, keyword_init: true)
+    ScrobbleRecord = Struct.new(:title, :artist, :artists, :albumArtist, :album, :duration, :trackNumber, :discNumber, :releaseDate, :year, :genre, :tags, :composer, :lyrics, :copyrightMessage, :wiki, :albumArt, :albumArtUrl, :youtubeLink, :spotifyLink, :tidalLink, :appleMusicLink, :createdAt, :mbid, :label, :isrc, keyword_init: true)
+    ScrobbleViewBasic = Struct.new(:id, :user, :userDisplayName, :userAvatar, :title, :artist, :artistUri, :album, :albumUri, :cover, :date, :uri, :sha256, :liked, :likesCount, keyword_init: true)
+    ScrobbleViewDetailed = Struct.new(:id, :user, :title, :artist, :artistUri, :album, :albumUri, :cover, :date, :uri, :sha256, :liked, :likesCount, :listeners, :scrobbles, :artists, :firstScrobble, keyword_init: true)
+    SearchParams = Struct.new(:query, keyword_init: true)
+    SeekParams = Struct.new(:playerId, :position, keyword_init: true)
+    ShoutAuthor = Struct.new(:id, :did, :handle, :displayName, :avatar, keyword_init: true)
+    ShoutRecord = Struct.new(:message, :createdAt, :parent, :subject, keyword_init: true)
+    ShoutView = Struct.new(:id, :message, :parent, :createdAt, :author, keyword_init: true)
+    SongFirstScrobbleView = Struct.new(:handle, :avatar, :timestamp, keyword_init: true)
+    SongRecentListenerView = Struct.new(:id, :did, :handle, :displayName, :avatar, :timestamp, :scrobbleUri, keyword_init: true)
+    SongRecord = Struct.new(:title, :artist, :artists, :albumArtist, :album, :duration, :trackNumber, :discNumber, :releaseDate, :year, :genre, :tags, :composer, :lyrics, :copyrightMessage, :wiki, :albumArt, :albumArtUrl, :youtubeLink, :spotifyLink, :tidalLink, :appleMusicLink, :createdAt, :mbid, :label, :isrc, keyword_init: true)
+    SongViewBasic = Struct.new(:id, :title, :artist, :albumArtist, :albumArt, :uri, :album, :duration, :trackNumber, :discNumber, :playCount, :uniqueListeners, :albumUri, :artistUri, :sha256, :mbid, :isrc, :tags, :createdAt, keyword_init: true)
+    SongViewDetailed = Struct.new(:id, :title, :artist, :albumArtist, :albumArt, :uri, :album, :duration, :trackNumber, :discNumber, :playCount, :uniqueListeners, :albumUri, :artistUri, :sha256, :mbid, :isrc, :tags, :createdAt, :artists, :firstScrobble, keyword_init: true)
+    SpotifyTrackView = Struct.new(:id, :name, :artist, :album, :duration, :previewUrl, keyword_init: true)
+    StartPlaylistParams = Struct.new(:uri, :shuffle, :position, keyword_init: true)
+    StatsGlobalStatsView = Struct.new(:scrobbles, :users, :artists, :albums, :tracks, keyword_init: true)
+    StatsView = Struct.new(:scrobbles, :artists, :lovedTracks, :albums, :tracks, keyword_init: true)
+    StatsWrappedAlbum = Struct.new(:id, :title, :artist, :albumArt, :uri, :playCount, keyword_init: true)
+    StatsWrappedArtist = Struct.new(:id, :name, :picture, :uri, :playCount, keyword_init: true)
+    StatsWrappedDayCount = Struct.new(:date, :count, keyword_init: true)
+    StatsWrappedGenreCount = Struct.new(:genre, :count, keyword_init: true)
+    StatsWrappedMilestone = Struct.new(:trackTitle, :artistName, :timestamp, :trackUri, keyword_init: true)
+    StatsWrappedMonthCount = Struct.new(:month, :count, keyword_init: true)
+    StatsWrappedTrack = Struct.new(:id, :title, :artist, :albumArt, :uri, :artistUri, :albumUri, :playCount, keyword_init: true)
+    StatsWrappedView = Struct.new(:year, :totalScrobbles, :totalListeningTimeMinutes, :topArtists, :topTracks, :topAlbums, :topGenres, :scrobblesPerMonth, :mostActiveDay, :mostActiveHour, :newArtistsCount, :longestStreak, :firstScrobble, :lastScrobble, keyword_init: true)
+    StatusRecord = Struct.new(:track, :startedAt, :expiresAt, keyword_init: true)
+    StrongRef = Struct.new(:uri, :cid, keyword_init: true)
+    UnfollowAccountOutput = Struct.new(:subject, :followers, :cursor, keyword_init: true)
+    UnfollowAccountParams = Struct.new(:account, keyword_init: true)
+    UpdateApikeyInput = Struct.new(:id, :name, :description, keyword_init: true)
+  end
+end

data/lib/rocksky/resources/feed.rb

@@ -27,9 +27,11 @@ module Rocksky
         query("app.rocksky.feed.getFeed", feed: feed, limit: limit, cursor: cursor)
       end
 
-      # Stories (recent highlights).
-      def get_stories(size: nil)
-        query("app.rocksky.feed.getStories", size: size)
+      # Latest scrobble per user. Pass `feed:` (at-uri) to restrict to scrobbles
+      # in that feed generator, and/or `following: true` to restrict to users
+      # the viewer follows (requires an authenticated client).
+      def get_stories(size: nil, feed: nil, following: nil)
+        query("app.rocksky.feed.getStories", size: size, feed: feed, following: following)
       end
 
       # Track recommendations for an actor.

data/lib/rocksky/version.rb

@@ -1,3 +1,3 @@
 module Rocksky
-  VERSION = "0.1.0".freeze
+  VERSION = "0.3.0".freeze
 end

data/lib/rocksky.rb

@@ -19,6 +19,7 @@ require "rocksky/resources/song"
 require "rocksky/resources/spotify"
 require "rocksky/resources/stats"
 require "rocksky/client"
+require "rocksky/generated/types"
 
 module Rocksky
   # Build a new Rocksky client.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rocksky
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Rocksky
@@ -81,6 +81,7 @@ files:
 - lib/rocksky.rb
 - lib/rocksky/client.rb
 - lib/rocksky/error.rb
+- lib/rocksky/generated/types.rb
 - lib/rocksky/http.rb
 - lib/rocksky/resources/actor.rb
 - lib/rocksky/resources/album.rb