@ctrl/plex 3.12.1 → 4.0.0

package/README.md

@@ -19,7 +19,11 @@ Create a plex connection
 ```ts
 import { MyPlexAccount } from '@ctrl/plex';
 
-const account = await new MyPlexAccount('http://localhost:32400', 'username', 'password').connect();
+const account = await new MyPlexAccount({
+  baseUrl: 'http://localhost:32400',
+  username: 'username',
+  password: 'password',
+}).connect();
 const resource = await account.resource('<SERVERNAME>');
 const plex = await resource.connect();
 const library = await plex.library();

package/dist/src/alert.js

@@ -8,7 +8,7 @@ export class AlertListener {
         this.callback = callback;
     }
     async run() {
-        const url = this.server.url(this.key, true).toString().replace('http', 'ws');
+        const url = this.server.url(this.key, { includeToken: true }).toString().replace('http', 'ws');
         this._ws = new WebSocket(url);
         this._ws.on('message', (buffer) => {
             try {

package/dist/src/audio.d.ts

@@ -155,7 +155,9 @@ export declare class Track extends Audio {
     /**
      * Returns the Plex Web URL pointing to the album details page for this track.
      */
-    getWebURL(base?: string): string;
+    getWebURL({ base }?: {
+        base?: string;
+    }): string;
     /**
      * Returns a sonic adventure from the current track to the specified track.
      * @param to The target track for the sonic adventure.

package/dist/src/audio.js

@@ -37,7 +37,7 @@ export class Audio extends Playable {
         // or it might be used for things like `/tree`? The python `url` method seems rarely used directly.
         // For now, mirroring the python seems safest. If `part` is meant to be appended to `this.key`,
         // the logic would need changing.
-        return part ? this.server.url(part, true)?.toString() : undefined;
+        return part ? this.server.url(part, { includeToken: true })?.toString() : undefined;
     }
     /** Indicates if the audio item has undergone sonic analysis. */
     get hasSonicAnalysis() {
@@ -86,7 +86,7 @@ export class Audio extends Playable {
         this._data = data;
         const addedAtTimestamp = data.addedAt ? Number.parseInt(data.addedAt, 10) : Number.NaN;
         this.addedAt = Number.isNaN(addedAtTimestamp) ? undefined : new Date(addedAtTimestamp * 1000);
-        this.art = data.art ? this.server.url(data.art, true)?.toString() : undefined;
+        this.art = data.art ? this.server.url(data.art, { includeToken: true })?.toString() : undefined;
         this.artBlurHash = data.artBlurHash;
         const distanceFloat = data.distance ? Number.parseFloat(data.distance) : Number.NaN;
         this.distance = Number.isNaN(distanceFloat) ? undefined : distanceFloat;
@@ -126,7 +126,9 @@ export class Audio extends Playable {
         const ratingKeyInt = data.ratingKey ? Number.parseInt(data.ratingKey, 10) : Number.NaN;
         this.ratingKey = Number.isNaN(ratingKeyInt) ? this.ratingKey : ratingKeyInt.toString();
         this.summary = data.summary;
-        this.thumb = data.thumb ? this.server.url(data.thumb, true)?.toString() : undefined;
+        this.thumb = data.thumb
+            ? this.server.url(data.thumb, { includeToken: true })?.toString()
+            : undefined;
         this.thumbBlurHash = data.thumbBlurHash;
         this.title = data.title ?? this.title;
         this.titleSort = data.titleSort ?? this.title;
@@ -230,13 +232,13 @@ export class Track extends Audio {
     /**
      * Returns the Plex Web URL pointing to the album details page for this track.
      */
-    getWebURL(base) {
+    getWebURL({ base } = {}) {
         if (this.parentKey) {
             const params = new URLSearchParams();
             params.append('key', this.parentKey);
-            return this.server._buildWebURL(base, 'details', params);
+            return this.server._buildWebURL({ base, endpoint: 'details', params });
         }
-        return super.getWebURL(base);
+        return super.getWebURL({ base });
     }
     // metadataDirectory property requires Path module and filesystem access, which is
     // complex in node/browser. Omitting for now, might need specific implementation.

package/dist/src/base/partialPlexObject.d.ts

@@ -1,5 +1,6 @@
 import type { Section } from '../library.js';
 import { SearchResult } from '../search.js';
+import type { HistoryOptions } from '../server.types.js';
 import { PlexObject } from './plexObject.js';
 export declare abstract class PartialPlexObject extends PlexObject {
     _INCLUDES: {
@@ -61,26 +62,24 @@ export declare abstract class PartialPlexObject extends PlexObject {
     get isFullObject(): boolean;
     /**
      * Use match result to update show metadata.
-     * @param searchResult Search result @see {@link PartialPlexObject.matches}
-     * @param auto True uses first match from matches, False allows user to provide the match
-     * @param agent (str): Agent name to be used (imdb, thetvdb, themoviedb, etc.)
+     * @param options Match options.
      */
-    fixMatch(searchResult?: SearchResult, auto?: boolean, agent?: string): Promise<void>;
+    fixMatch({ searchResult, auto, agent, }?: {
+        searchResult?: SearchResult;
+        auto?: boolean;
+        agent?: string;
+    }): Promise<void>;
     /**
-     *
-     * @param agent Agent name to be used (imdb, thetvdb, themoviedb, etc.)
-     * @param title Title of item to search for
-     * @param year Year of item to search in
-     * @param language Language of item to search in
+     * @param options Match options.
      *
      *  Examples:
      *  1. video.matches()
-     *  2. video.matches(title="something", year=2020)
-     *  3. video.matches(title="something")
-     *  4. video.matches(year=2020)
-     *  5. video.matches(title="something", year="")
-     *  6. video.matches(title="", year=2020)
-     *  7. video.matches(title="", year="")
+     *  2. video.matches({ title: "something", year: "2020" })
+     *  3. video.matches({ title: "something" })
+     *  4. video.matches({ year: "2020" })
+     *  5. video.matches({ title: "something", year: "" })
+     *  6. video.matches({ title: "", year: "2020" })
+     *  7. video.matches({ title: "", year: "" })
      *
      *  1. The default behaviour in Plex Web = no params in plexapi
      *  2. Both title and year specified by user
@@ -92,15 +91,19 @@ export declare abstract class PartialPlexObject extends PlexObject {
      *
      *  For 2 to 7, the agent and language is automatically filled in
      */
-    matches(agent?: string, title?: string, year?: string, language?: string): Promise<SearchResult[]>;
+    matches({ agent, title, year, language, }?: {
+        agent?: string;
+        title?: string;
+        year?: string;
+        language?: string;
+    }): Promise<SearchResult[]>;
     /** Unmatches metadata match from object. */
     unmatch(): Promise<any>;
     /**
      * Get Play History for a media item.
-     * @param maxresults Only return the specified number of results (optional).
-     * @param mindate Min datetime to return results from.
+     * @param options Filter and paging options.
      */
-    history(maxresults?: number, mindate?: Date): Promise<import("../server.types.js").HistoryResult[]>;
+    history(options?: Omit<HistoryOptions, 'ratingKey'>): Promise<import("../server.types.js").HistoryResult[]>;
     section(): Promise<Section>;
     /**
      * Delete a media element. This has to be enabled under settings > server > library in plex webui.
@@ -118,7 +121,9 @@ export declare abstract class PartialPlexObject extends PlexObject {
     addGenre(genres: string[]): Promise<void>;
     /** Remove a genre(s). */
     removeGenre(genres: string[]): Promise<void>;
-    getWebURL(base?: string): string;
+    getWebURL({ base }?: {
+        base?: string;
+    }): string;
     /**
      * Edit an object.
      * @param changeObj Obj of settings to edit.
@@ -140,8 +145,7 @@ export declare abstract class PartialPlexObject extends PlexObject {
      * Helper to edit and refresh a tags.
      * @param tag tag name
      * @param items list of tags to add
-     * @param locked lock this field.
-     * @param remove If this is active remove the tags in items.
+     * @param options
      */
     private _editTags;
 }

package/dist/src/base/partialPlexObject.js

@@ -45,7 +45,7 @@ export class PartialPlexObject extends PlexObject {
      */
     async analyze() {
         const key = `/${ltrim(this.key, ['/'])}/analyze`;
-        await this.server.query(key, 'put');
+        await this.server.query({ path: key, method: 'put' });
     }
     /**
      * load full data / reload the data for this object from this.key.
@@ -57,7 +57,7 @@ export class PartialPlexObject extends PlexObject {
             throw new Error('Cannot reload an object not built from a URL');
         }
         this.initpath = key;
-        const data = await this.server.query(key);
+        const data = await this.server.query({ path: key });
         const innerData = data.MediaContainer ?? data;
         this._loadFullData(innerData);
     }
@@ -72,11 +72,9 @@ export class PartialPlexObject extends PlexObject {
     }
     /**
      * Use match result to update show metadata.
-     * @param searchResult Search result @see {@link PartialPlexObject.matches}
-     * @param auto True uses first match from matches, False allows user to provide the match
-     * @param agent (str): Agent name to be used (imdb, thetvdb, themoviedb, etc.)
+     * @param options Match options.
      */
-    async fixMatch(searchResult, auto = false, agent = '') {
+    async fixMatch({ searchResult, auto = false, agent = '', } = {}) {
         const key = `/library/metadata/${this.ratingKey}/match`;
         if (auto) {
             const autoMatch = await this.matches();
@@ -92,23 +90,19 @@ export class PartialPlexObject extends PlexObject {
         }
         const params = new URLSearchParams({ guid: searchResult.guid, name: searchResult.name });
         const url = `${key}?${params.toString()}`;
-        await this.server.query(url, 'put');
+        await this.server.query({ path: url, method: 'put' });
     }
     /**
-     *
-     * @param agent Agent name to be used (imdb, thetvdb, themoviedb, etc.)
-     * @param title Title of item to search for
-     * @param year Year of item to search in
-     * @param language Language of item to search in
+     * @param options Match options.
      *
      *  Examples:
      *  1. video.matches()
-     *  2. video.matches(title="something", year=2020)
-     *  3. video.matches(title="something")
-     *  4. video.matches(year=2020)
-     *  5. video.matches(title="something", year="")
-     *  6. video.matches(title="", year=2020)
-     *  7. video.matches(title="", year="")
+     *  2. video.matches({ title: "something", year: "2020" })
+     *  3. video.matches({ title: "something" })
+     *  4. video.matches({ year: "2020" })
+     *  5. video.matches({ title: "something", year: "" })
+     *  6. video.matches({ title: "", year: "2020" })
+     *  7. video.matches({ title: "", year: "" })
      *
      *  1. The default behaviour in Plex Web = no params in plexapi
      *  2. Both title and year specified by user
@@ -120,7 +114,7 @@ export class PartialPlexObject extends PlexObject {
      *
      *  For 2 to 7, the agent and language is automatically filled in
      */
-    async matches(agent, title, year, language) {
+    async matches({ agent, title, year, language, } = {}) {
         const key = `/library/metadata/${this.ratingKey}/matches`;
         const params = new URLSearchParams({ manual: '1' });
         if (agent && [title, year, language].some(x => x)) {
@@ -157,21 +151,22 @@ export class PartialPlexObject extends PlexObject {
                 params.append('agent', section.agent);
             }
         }
-        const data = await this.server.query(`${key}?${params.toString()}`, 'get');
+        const data = await this.server.query({
+            path: `${key}?${params.toString()}`,
+        });
         return data.MediaContainer.SearchResult.map(r => new SearchResult(this.server, r));
     }
     /** Unmatches metadata match from object. */
     async unmatch() {
         const key = `/library/metadata/${this.ratingKey}/unmatch`;
-        return this.server.query(key, 'put');
+        return this.server.query({ path: key, method: 'put' });
     }
     /**
      * Get Play History for a media item.
-     * @param maxresults Only return the specified number of results (optional).
-     * @param mindate Min datetime to return results from.
+     * @param options Filter and paging options.
      */
-    async history(maxresults = 9_999_999, mindate) {
-        return this.server.history(maxresults, mindate, this.ratingKey);
+    async history(options = {}) {
+        return this.server.history({ ...options, ratingKey: this.ratingKey });
     }
     async section() {
         return (await this.server.library()).sectionByID(this.librarySectionID);
@@ -180,7 +175,7 @@ export class PartialPlexObject extends PlexObject {
      * Delete a media element. This has to be enabled under settings > server > library in plex webui.
      */
     async delete() {
-        return this.server.query(this.key, 'delete');
+        return this.server.query({ path: this.key, method: 'delete' });
     }
     /** Add a collection(s). */
     async addCollection(collections) {
@@ -188,7 +183,7 @@ export class PartialPlexObject extends PlexObject {
     }
     /** Remove a collection(s). */
     async removeCollection(collections) {
-        await this._editTags('collection', collections, undefined, true);
+        await this._editTags('collection', collections, { remove: true });
     }
     /** Add a label(s). */
     async addLabel(labels) {
@@ -196,7 +191,7 @@ export class PartialPlexObject extends PlexObject {
     }
     /** Remove a label(s). */
     async removeLabel(labels) {
-        await this._editTags('label', labels, undefined, true);
+        await this._editTags('label', labels, { remove: true });
     }
     /** Add a genre(s). */
     async addGenre(genres) {
@@ -204,10 +199,10 @@ export class PartialPlexObject extends PlexObject {
     }
     /** Remove a genre(s). */
     async removeGenre(genres) {
-        await this._editTags('genre', genres, undefined, true);
+        await this._editTags('genre', genres, { remove: true });
     }
-    getWebURL(base) {
-        return this._getWebURL(base);
+    getWebURL({ base } = {}) {
+        return this._getWebURL({ base });
     }
     /**
      * Edit an object.
@@ -237,29 +232,31 @@ export class PartialPlexObject extends PlexObject {
         }
         const strObj = Object.fromEntries(Object.entries(changeObj).map(([key, value]) => [key, value.toString()]));
         const params = new URLSearchParams(strObj);
-        const url = this.server.url(`/library/sections/${this.librarySectionID}/all`, true, params);
-        await this.server.query(url.toString(), 'put');
+        const url = this.server.url(`/library/sections/${this.librarySectionID}/all`, {
+            includeToken: true,
+            params,
+        });
+        await this.server.query({ path: url.toString(), method: 'put' });
     }
     /**
      * Get the Plex Web URL with the correct parameters.
      * Private method to allow overriding parameters from subclasses.
      */
-    _getWebURL(base) {
+    _getWebURL({ base } = {}) {
         const params = new URLSearchParams();
         params.append('key', this.key);
-        return this.server._buildWebURL(base, 'details', params);
+        return this.server._buildWebURL({ base, endpoint: 'details', params });
     }
     /**
      * Helper to edit and refresh a tags.
      * @param tag tag name
      * @param items list of tags to add
-     * @param locked lock this field.
-     * @param remove If this is active remove the tags in items.
+     * @param options
      */
-    async _editTags(tag, items, locked = true, remove = false) {
+    async _editTags(tag, items, { locked = true, remove = false } = {}) {
         const value = this[`${tag}s`];
         const existingCols = value?.filter((x) => x && remove).map((x) => x.tag) ?? [];
-        const d = tagHelper(tag, [...existingCols, ...items], locked, remove);
+        const d = tagHelper(tag, [...existingCols, ...items], { locked, remove });
         await this.edit(d);
         await this.reload();
     }

package/dist/src/base/plexObject.js

@@ -30,7 +30,7 @@ export class PlexObject {
         if (!key) {
             throw new Error('Cannot reload an object not built from a URL');
         }
-        const data = await this.server.query(key);
+        const data = await this.server.query({ path: key });
         const innerData = data.MediaContainer ? data.MediaContainer : data;
         this._loadData(innerData);
     }
@@ -42,7 +42,7 @@ export class PlexObject {
      */
     async refresh() {
         const key = `${this.key}/refresh`;
-        await this.server.query(key, 'put');
+        await this.server.query({ path: key, method: 'put' });
     }
     /**
      * Returns True if this object is a child of the given class.

package/dist/src/baseFunctionality.js

@@ -28,7 +28,7 @@ export const OPERATORS = {
  */
 export async function fetchItem(server, ekey, options, cls) {
     const key = typeof ekey === 'number' ? `/library/metadata/${ekey.toString()}` : ekey;
-    const response = await server.query(key);
+    const response = await server.query({ path: key });
     const containerKey = cls?.TAG ?? 'Metadata';
     const elems = response.MediaContainer[containerKey] ?? [];
     for (const elem of elems) {
@@ -44,7 +44,7 @@ export async function fetchItem(server, ekey, options, cls) {
  * on how this is used.
  */
 export async function fetchItems(server, ekey, options, Cls, parent) {
-    const response = await server.query(ekey);
+    const response = await server.query({ path: ekey });
     const { MediaContainer } = response;
     const elems = MediaContainer[Cls?.TAG] ?? MediaContainer.Metadata ?? [];
     const items = findItems(elems, options, Cls, server, parent);

package/dist/src/client.d.ts

@@ -94,9 +94,11 @@ export declare class PlexClient {
      * Build a URL string with proper token argument. Token will be appended to the URL
      * if either includeToken is True or TODO: CONFIG.log.show_secrets is 'true'.
      * @param key
-     * @param includeToken
+     * @param options
      */
-    url(key: string, includeToken?: boolean): URL;
+    url(key: string, { includeToken }?: {
+        includeToken?: boolean;
+    }): URL;
     protected _loadData(data: Player): void;
     /**
      * Returns a dict of all default headers for Client requests.

package/dist/src/client.js

@@ -97,9 +97,9 @@ export class PlexClient {
      * Build a URL string with proper token argument. Token will be appended to the URL
      * if either includeToken is True or TODO: CONFIG.log.show_secrets is 'true'.
      * @param key
-     * @param includeToken
+     * @param options
      */
-    url(key, includeToken = false) {
+    url(key, { includeToken = false } = {}) {
         if (!this._baseurl) {
             throw new Error('PlexClient object missing baseurl.');
         }

package/dist/src/library.d.ts

@@ -309,7 +309,14 @@ export declare abstract class LibrarySection<SType = SectionType> extends PlexOb
      * @param tab The library tab (recommended, library, collections, playlists, timeline).
      * @param key A hub key.
      */
-    getWebURL(base?: string, tab?: string, key?: string): string;
+    getWebURL({ base, tab, key, }?: {
+        /** The base URL before the fragment (``#!``). Default is https://app.plex.tv/desktop. */
+        base?: string;
+        /** The library tab (recommended, library, collections, playlists, timeline). */
+        tab?: string;
+        /** A hub key. */
+        key?: string;
+    }): string;
     /**
      * Search the library. The http requests will be batched in container_size. If you are only looking for the
      * first <num> results, it would be wise to set the maxresults option to that amount so the search doesn't iterate
@@ -422,9 +429,13 @@ export declare class ShowSection extends LibrarySection<Show> {
     /**
      * Returns a list of recently added episodes from this library section.
      *
-     * @param maxresults Max number of items to return (default 50).
+     * @param options Filter and paging options.
      */
-    recentlyAdded(args: any, libtype?: string, maxresults?: number): Promise<Show[]>;
+    recentlyAdded({ args, libtype, maxResults, }?: {
+        args?: any;
+        libtype?: string;
+        maxResults?: number;
+    }): Promise<Show[]>;
 }
 export declare class MusicSection extends LibrarySection<Track> {
     static TYPE: string;
@@ -446,11 +457,17 @@ export declare class MusicSection extends LibrarySection<Track> {
     /** Search for a track. */
     searchTracks(args?: Partial<SearchArgs>): Promise<Track[]>;
     /** Returns a list of recently added artists from this library section. */
-    recentlyAddedArtists(maxresults?: number): Promise<Artist[]>;
+    recentlyAddedArtists({ maxResults }?: {
+        maxResults?: number;
+    }): Promise<Artist[]>;
     /** Returns a list of recently added albums from this library section. */
-    recentlyAddedAlbums(maxresults?: number): Promise<Album[]>;
+    recentlyAddedAlbums({ maxResults }?: {
+        maxResults?: number;
+    }): Promise<Album[]>;
     /** Returns a list of recently added tracks from this library section. */
-    recentlyAddedTracks(maxresults?: number): Promise<Track[]>;
+    recentlyAddedTracks({ maxResults }?: {
+        maxResults?: number;
+    }): Promise<Track[]>;
     /**
      * Returns a list of tracks from this library section that are part of a sonic adventure.
      * IDs should be of a track; other IDs will return an empty list or an error.

package/dist/src/library.js

@@ -19,7 +19,7 @@ export class Library {
      */
     async sections() {
         const key = '/library/sections';
-        const elems = await this.server.query(key);
+        const elems = await this.server.query({ path: key });
         const sections = [];
         if (!elems.MediaContainer.Directory) {
             return sections;
@@ -207,7 +207,7 @@ export class Library {
             ...extra,
         });
         const url = `/library/sections?${search.toString()}`;
-        return this.server.query(url, 'post');
+        return this.server.query({ path: url, method: 'post' });
     }
     /**
      * Returns a list of all media from all library sections.
@@ -239,7 +239,7 @@ export class Library {
      * library, you may like to optimize the database.
      */
     async optimize() {
-        await this.server.query('/library/optimize?async=1', 'put');
+        await this.server.query({ path: '/library/optimize?async=1', method: 'put' });
     }
     /**
      * Validates a filter field and values are available as a custom filter for the library.
@@ -338,7 +338,7 @@ export class LibrarySection extends PlexObject {
      * @param tab The library tab (recommended, library, collections, playlists, timeline).
      * @param key A hub key.
      */
-    getWebURL(base, tab, key) {
+    getWebURL({ base, tab, key, } = {}) {
         const params = new URLSearchParams();
         params.append('source', this.key);
         if (tab) {
@@ -348,7 +348,7 @@ export class LibrarySection extends PlexObject {
             params.append('key', key);
             params.append('pageType', 'list');
         }
-        return this.server._buildWebURL(base, undefined, params);
+        return this.server._buildWebURL({ base, params });
     }
     /**
      * Search the library. The http requests will be batched in container_size. If you are only looking for the
@@ -389,14 +389,14 @@ export class LibrarySection extends PlexObject {
      */
     async analyze() {
         const key = `/library/sections/${this.key}/analyze`;
-        await this.server.query(key, 'post');
+        await this.server.query({ path: key, method: 'post' });
     }
     /**
      * If a section has items in the Trash, use this option to empty the Trash
      */
     async emptyTrash() {
         const key = `/library/sections/${this.key}/emptyTrash`;
-        await this.server.query(key, 'put');
+        await this.server.query({ path: key, method: 'put' });
     }
     /**
      * Get Play History for this library Section for the owner.
@@ -404,21 +404,21 @@ export class LibrarySection extends PlexObject {
      * @param mindate (datetime): Min datetime to return results from.
      */
     // async history(maxresults=9999999, mindate?: Date): Promise<any> {
-    //   return this.server.history(maxresults=maxresults, mindate=mindate, librarySectionID=self.key, accountID=1)
+    //   return this.server.history({ maxResults, minDate, librarySectionId: this.key, accountId: 1 })
     // }
     /**
      * Scan this section for new media.
      */
     async update() {
         const key = `/library/sections/${this.key}/refresh`;
-        await this.server.query(key);
+        await this.server.query({ path: key });
     }
     /**
      * Cancel update of this Library Section.
      */
     async cancelUpdate() {
         const key = `/library/sections/${this.key}/refresh`;
-        await this.server.query(key, 'delete');
+        await this.server.query({ path: key, method: 'delete' });
     }
     /**
      * Forces a download of fresh media information from the internet.
@@ -426,7 +426,7 @@ export class LibrarySection extends PlexObject {
      */
     async refresh() {
         const key = `/library/sections/${this.key}/refresh?force=1`;
-        await this.server.query(key);
+        await this.server.query({ path: key });
     }
     /**
      * Delete the preview thumbnails for items in this library. This cannot
@@ -434,12 +434,12 @@ export class LibrarySection extends PlexObject {
      */
     async deleteMediaPreviews() {
         const key = `/library/sections/${this.key}/indexes`;
-        await this.server.query(key, 'delete');
+        await this.server.query({ path: key, method: 'delete' });
     }
     /** Delete a library section. */
     async delete() {
         const key = `/library/sections/${this.key}`;
-        await this.server.query(key, 'delete');
+        await this.server.query({ path: key, method: 'delete' });
     }
     /**
      * Edit a library
@@ -448,7 +448,7 @@ export class LibrarySection extends PlexObject {
     async edit(kwargs) {
         const params = new URLSearchParams(kwargs);
         const part = `/library/sections/${this.key}?${params.toString()}`;
-        await this.server.query(part, 'put');
+        await this.server.query({ path: part, method: 'put' });
         const library = await this.server.library();
         const sections = await library.sections();
         for (const section of sections) {
@@ -569,7 +569,7 @@ export class LibrarySection extends PlexObject {
     }
     async _loadFilters() {
         const key = `/library/sections/${this.key}/all?includeMeta=1&includeAdvanced=1&X-Plex-Container-Start=0&X-Plex-Container-Size=0`;
-        const data = await this.server.query(key);
+        const data = await this.server.query({ path: key });
         // rtag='Meta'
         this._filterTypes = findItems(data, undefined, FilteringType);
     }
@@ -664,10 +664,10 @@ export class ShowSection extends LibrarySection {
     /**
      * Returns a list of recently added episodes from this library section.
      *
-     * @param maxresults Max number of items to return (default 50).
+     * @param options Filter and paging options.
      */
-    async recentlyAdded(args, libtype = 'episode', maxresults = 50) {
-        return this.search({ libtype, maxresults, sort: 'episode.addedAt:desc', ...args });
+    async recentlyAdded({ args, libtype = 'episode', maxResults = 50, } = {}) {
+        return this.search({ libtype, maxresults: maxResults, sort: 'episode.addedAt:desc', ...args });
     }
 }
 export class MusicSection extends LibrarySection {
@@ -702,16 +702,16 @@ export class MusicSection extends LibrarySection {
         return this.search({ ...args, libtype: 'track' }, Track);
     }
     /** Returns a list of recently added artists from this library section. */
-    async recentlyAddedArtists(maxresults = 50) {
-        return this.search({ maxresults, sort: 'addedAt:desc', libtype: 'artist' }, Artist);
+    async recentlyAddedArtists({ maxResults = 50 } = {}) {
+        return this.search({ maxresults: maxResults, sort: 'addedAt:desc', libtype: 'artist' }, Artist);
     }
     /** Returns a list of recently added albums from this library section. */
-    async recentlyAddedAlbums(maxresults = 50) {
-        return this.search({ maxresults, sort: 'addedAt:desc', libtype: 'album' }, Album);
+    async recentlyAddedAlbums({ maxResults = 50 } = {}) {
+        return this.search({ maxresults: maxResults, sort: 'addedAt:desc', libtype: 'album' }, Album);
     }
     /** Returns a list of recently added tracks from this library section. */
-    async recentlyAddedTracks(maxresults = 50) {
-        return this.search({ maxresults, sort: 'addedAt:desc', libtype: 'track' }, Track);
+    async recentlyAddedTracks({ maxResults = 50 } = {}) {
+        return this.search({ maxresults: maxResults, sort: 'addedAt:desc', libtype: 'track' }, Track);
     }
     /**
      * Returns a list of tracks from this library section that are part of a sonic adventure.
@@ -770,7 +770,7 @@ export class Collections extends PartialPlexObject {
      */
     async items() {
         const key = `/library/metadata/${this.ratingKey}/children`;
-        const data = await this.server.query(key);
+        const data = await this.server.query({ path: key });
         return (data.MediaContainer.Metadata?.map(d => new this.VIDEO_TYPE(this.server, d, undefined, this)) ?? []);
     }
     _loadFullData(data) {