@ctrl/plex 3.11.0 → 3.12.1

package/dist/src/audio.js

@@ -1,7 +1,8 @@
-import { URLSearchParams } from 'url';
+import { URLSearchParams } from 'node:url';
 import { Playable } from './base/playable.js';
 import { fetchItem, fetchItems } from './baseFunctionality.js';
 import { Chapter, Collection, Country, Field, Format, Genre, Guid, Image, Label, Media, Mood, Similar, Style, Subformat, } from './media.js';
+const hasSonicAdventure = (s) => typeof s.sonicAdventure === 'function';
 /**
  * Base class for all audio objects including Artist, Album, and Track.
  */
@@ -83,53 +84,61 @@ export class Audio extends Playable {
      */
     _loadData(data) {
         this._data = data;
-        const addedAtTimestamp = data.addedAt ? parseInt(data.addedAt, 10) : NaN;
-        this.addedAt = isNaN(addedAtTimestamp) ? undefined : new Date(addedAtTimestamp * 1000);
+        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.artBlurHash = data.artBlurHash;
-        const distanceFloat = data.distance ? parseFloat(data.distance) : NaN;
-        this.distance = isNaN(distanceFloat) ? undefined : distanceFloat;
+        const distanceFloat = data.distance ? Number.parseFloat(data.distance) : Number.NaN;
+        this.distance = Number.isNaN(distanceFloat) ? undefined : distanceFloat;
         this.guid = data.guid;
-        const indexInt = data.index ? parseInt(data.index, 10) : NaN;
-        this.index = isNaN(indexInt) ? undefined : indexInt;
+        const indexInt = data.index ? Number.parseInt(data.index, 10) : Number.NaN;
+        this.index = Number.isNaN(indexInt) ? undefined : indexInt;
         this.key = data.key ?? this.key ?? '';
-        const lastRatedAtTimestamp = data.lastRatedAt ? parseInt(data.lastRatedAt, 10) : NaN;
-        this.lastRatedAt = isNaN(lastRatedAtTimestamp)
+        const lastRatedAtTimestamp = data.lastRatedAt
+            ? Number.parseInt(data.lastRatedAt, 10)
+            : Number.NaN;
+        this.lastRatedAt = Number.isNaN(lastRatedAtTimestamp)
             ? undefined
             : new Date(lastRatedAtTimestamp * 1000);
-        const lastViewedAtTimestamp = data.lastViewedAt ? parseInt(data.lastViewedAt, 10) : NaN;
-        this.lastViewedAt = isNaN(lastViewedAtTimestamp)
+        const lastViewedAtTimestamp = data.lastViewedAt
+            ? Number.parseInt(data.lastViewedAt, 10)
+            : Number.NaN;
+        this.lastViewedAt = Number.isNaN(lastViewedAtTimestamp)
             ? undefined
             : new Date(lastViewedAtTimestamp * 1000);
-        const librarySectionIDInt = data.librarySectionID ? parseInt(data.librarySectionID, 10) : NaN;
-        this.librarySectionID = isNaN(librarySectionIDInt)
+        const librarySectionIDInt = data.librarySectionID
+            ? Number.parseInt(data.librarySectionID, 10)
+            : Number.NaN;
+        this.librarySectionID = Number.isNaN(librarySectionIDInt)
             ? this.librarySectionID
             : librarySectionIDInt;
         this.librarySectionKey = data.librarySectionKey;
         this.librarySectionTitle = data.librarySectionTitle;
         // listType is handled by the getter
         const musicAnalysisVersionInt = data.musicAnalysisVersion
-            ? parseInt(data.musicAnalysisVersion, 10)
-            : NaN;
-        this.musicAnalysisVersion = isNaN(musicAnalysisVersionInt)
+            ? Number.parseInt(data.musicAnalysisVersion, 10)
+            : Number.NaN;
+        this.musicAnalysisVersion = Number.isNaN(musicAnalysisVersionInt)
             ? undefined
             : musicAnalysisVersionInt;
         this.playlistItemID = data.playlistItemID;
         this.ratingKey = data.ratingKey;
-        const ratingKeyInt = data.ratingKey ? parseInt(data.ratingKey, 10) : NaN;
-        this.ratingKey = isNaN(ratingKeyInt) ? this.ratingKey : ratingKeyInt.toString();
+        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.thumbBlurHash = data.thumbBlurHash;
         this.title = data.title ?? this.title;
         this.titleSort = data.titleSort ?? this.title;
         this.type = data.type ?? this.type;
-        const updatedAtTimestamp = data.updatedAt ? parseInt(data.updatedAt, 10) : NaN;
-        this.updatedAt = isNaN(updatedAtTimestamp) ? undefined : new Date(updatedAtTimestamp * 1000);
-        const userRatingFloat = data.userRating ? parseFloat(data.userRating) : NaN;
-        this.userRating = isNaN(userRatingFloat) ? undefined : userRatingFloat;
-        const viewCountInt = data.viewCount !== undefined ? parseInt(data.viewCount, 10) : NaN;
-        this.viewCount = isNaN(viewCountInt) ? 0 : viewCountInt;
+        const updatedAtTimestamp = data.updatedAt ? Number.parseInt(data.updatedAt, 10) : Number.NaN;
+        this.updatedAt = Number.isNaN(updatedAtTimestamp)
+            ? undefined
+            : new Date(updatedAtTimestamp * 1000);
+        const userRatingFloat = data.userRating ? Number.parseFloat(data.userRating) : Number.NaN;
+        this.userRating = Number.isNaN(userRatingFloat) ? undefined : userRatingFloat;
+        const viewCountInt = data.viewCount !== undefined ? Number.parseInt(data.viewCount, 10) : Number.NaN;
+        this.viewCount = Number.isNaN(viewCountInt) ? 0 : viewCountInt;
         // Map tag arrays like video.ts does
         this.fields = data.Field?.map((d) => new Field(this.server, d, undefined, this)) ?? [];
         this.images = data.Image?.map((d) => new Image(this.server, d, undefined, this)) ?? [];
@@ -238,7 +247,6 @@ export class Track extends Audio {
      */
     async sonicAdventure(to) {
         const section = await this.section();
-        const hasSonicAdventure = (s) => typeof s.sonicAdventure === 'function';
         if (!hasSonicAdventure(section)) {
             throw new Error('Section does not support sonicAdventure');
         }
@@ -459,13 +467,15 @@ export class Artist extends Audio {
      */
     _loadData(data) {
         super._loadData(data);
-        const albumSortInt = data.albumSort ? parseInt(String(data.albumSort), 10) : NaN;
-        this.albumSort = isNaN(albumSortInt) ? -1 : albumSortInt;
-        const audienceRatingFloat = data.audienceRating !== undefined ? parseFloat(String(data.audienceRating)) : NaN;
-        this.audienceRating = isNaN(audienceRatingFloat) ? undefined : audienceRatingFloat;
+        const albumSortInt = data.albumSort ? Number.parseInt(String(data.albumSort), 10) : Number.NaN;
+        this.albumSort = Number.isNaN(albumSortInt) ? -1 : albumSortInt;
+        const audienceRatingFloat = data.audienceRating !== undefined
+            ? Number.parseFloat(String(data.audienceRating))
+            : Number.NaN;
+        this.audienceRating = Number.isNaN(audienceRatingFloat) ? undefined : audienceRatingFloat;
         this.key = data.key?.replace('/children', '');
-        const ratingFloat = data.rating !== undefined ? parseFloat(String(data.rating)) : NaN;
-        this.rating = isNaN(ratingFloat) ? undefined : ratingFloat;
+        const ratingFloat = data.rating !== undefined ? Number.parseFloat(String(data.rating)) : Number.NaN;
+        this.rating = Number.isNaN(ratingFloat) ? undefined : ratingFloat;
         this.theme = data.theme;
         this.countries = data.Country?.map(d => new Country(this.server, d, undefined, this));
         this.genres = data.Genre?.map(d => new Genre(this.server, d, undefined, this));
@@ -551,7 +561,7 @@ export class Album extends Audio {
                 ? new Date(data.originallyAvailableAt)
                 : undefined;
             // Check if the date is valid
-            if (this.originallyAvailableAt && isNaN(this.originallyAvailableAt.getTime())) {
+            if (this.originallyAvailableAt && Number.isNaN(this.originallyAvailableAt.getTime())) {
                 this.originallyAvailableAt = undefined;
             }
         }

package/dist/src/audio.types.d.ts

@@ -66,12 +66,12 @@ export interface TrackData {
     skipCount?: number;
     source?: string;
     viewOffset?: number;
-    Chapter?: import('./video.types.js').ChapterData[];
+    Chapter?: Array<import('./video.types.js').ChapterData>;
     Collection?: MediaTagData[];
     Genre?: MediaTagData[];
     Guid?: MediaTagData[];
     Label?: MediaTagData[];
-    Media?: import('./video.types.js').MediaData[];
+    Media?: Array<import('./video.types.js').MediaData>;
 }
 export interface ArtistData {
     key: string;

package/dist/src/base/partialPlexObject.js

@@ -1,4 +1,4 @@
-import { URLSearchParams } from 'url';
+import { URLSearchParams } from 'node:url';
 import { SearchResult, searchType } from '../search.js';
 import { getAgentIdentifier, ltrim, tagHelper } from '../util.js';
 import { PlexObject } from './plexObject.js';
@@ -80,7 +80,7 @@ export class PartialPlexObject extends PlexObject {
         const key = `/library/metadata/${this.ratingKey}/match`;
         if (auto) {
             const autoMatch = await this.matches();
-            if (autoMatch.length) {
+            if (autoMatch.length > 0) {
                 searchResult = autoMatch[0];
             }
             else {
@@ -170,7 +170,7 @@ export class PartialPlexObject extends PlexObject {
      * @param maxresults Only return the specified number of results (optional).
      * @param mindate Min datetime to return results from.
      */
-    async history(maxresults = 9999999, mindate) {
+    async history(maxresults = 9_999_999, mindate) {
         return this.server.history(maxresults, mindate, this.ratingKey);
     }
     async section() {
@@ -257,7 +257,7 @@ export class PartialPlexObject extends PlexObject {
      * @param remove If this is active remove the tags in items.
      */
     async _editTags(tag, items, locked = true, remove = false) {
-        const value = this[tag + 's'];
+        const value = this[`${tag}s`];
         const existingCols = value?.filter((x) => x && remove).map((x) => x.tag) ?? [];
         const d = tagHelper(tag, [...existingCols, ...items], locked, remove);
         await this.edit(d);

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

@@ -1,4 +1,4 @@
-import type { PlayQueue as PlayQueueType } from '../playqueue.js';
+import { type PlayQueue as PlayQueueType } from '../playqueue.js';
 import type { CreatePlayQueueOptions } from '../playqueue.types.js';
 import { PartialPlexObject } from './partialPlexObject.js';
 /**

package/dist/src/base/plexObject.js

@@ -1,4 +1,4 @@
-import { URLSearchParams } from 'url';
+import { URLSearchParams } from 'node:url';
 /**
  * Base class for all? Plex objects
  */
@@ -61,8 +61,9 @@ export class PlexObject {
                     params.set(k, (value === true ? 1 : value).toString());
                 }
             }
-            if ([...params.keys()].length) {
-                detailsKey += '?' + params.toString();
+            const searchParams = params.toString();
+            if (searchParams.length > 0) {
+                detailsKey += `?${searchParams}`;
             }
         }
         return detailsKey;

package/dist/src/client.d.ts

@@ -1,4 +1,4 @@
-import { URL } from 'url';
+import { URL } from 'node:url';
 import type { Player } from './client.types.js';
 export interface PlexOptions {
     /** (:class:`~plexapi.server.PlexServer`): PlexServer this client is connected to (optional). */

package/dist/src/client.js

@@ -1,5 +1,5 @@
+import { URL, URLSearchParams } from 'node:url';
 import { ofetch } from 'ofetch';
-import { URL, URLSearchParams } from 'url';
 import { BASE_HEADERS, TIMEOUT } from './config.js';
 /**
  * Main class for interacting with a Plex client. This class can connect

package/dist/src/config.js

@@ -1,4 +1,4 @@
-import os from 'os';
+import os from 'node:os';
 import { getMAC, parseMAC } from '@ctrl/mac-address';
 // TODO: Load User Defined Config
 // const DEFAULT_CONFIG_PATH = os.path.expanduser('~/.config/plexapi/config.ini');

package/dist/src/library.d.ts

@@ -365,7 +365,7 @@ export declare abstract class LibrarySection<SType = SectionType> extends PlexOb
      * Returns a list of playlists from this library section.
      */
     playlists(): Promise<Playlist[]>;
-    collections(args?: Record<string, number | string | boolean>): Promise<Collections<SType>[]>;
+    collections(args?: Record<string, number | string | boolean>): Promise<Array<Collections<SType>>>;
     /**
      * Returns a list of available Folders for this library section.
      */

package/dist/src/library.js

@@ -1,4 +1,4 @@
-import { URLSearchParams } from 'url';
+import { URLSearchParams } from 'node:url';
 import { PartialPlexObject } from './base/partialPlexObject.js';
 import { PlexObject } from './base/plexObject.js';
 import { Album, Artist, Track } from './audio.js';
@@ -206,7 +206,7 @@ export class Library {
             language,
             ...extra,
         });
-        const url = '/library/sections?' + search.toString();
+        const url = `/library/sections?${search.toString()}`;
         return this.server.query(url, 'post');
     }
     /**

package/dist/src/media.js

@@ -50,7 +50,7 @@ export class MediaPart extends PlexObject {
         const params = new URLSearchParams({ allParts: '1' });
         const streamId = typeof stream === 'number' ? stream : stream.id;
         params.set('audioStreamID', streamId.toString());
-        await this.server.query(key + '?' + params.toString(), 'put');
+        await this.server.query(`${key}?${params.toString()}`, 'put');
         return this;
     }
     /**
@@ -62,7 +62,7 @@ export class MediaPart extends PlexObject {
         const params = new URLSearchParams({ allParts: '1' });
         const streamId = typeof stream === 'number' ? stream : stream.id;
         params.set('subtitleStreamID', streamId.toString());
-        await this.server.query(key + '?' + params.toString(), 'put');
+        await this.server.query(`${key}?${params.toString()}`, 'put');
         return this;
     }
     /**
@@ -130,16 +130,16 @@ export class SubtitleStream extends MediaPartStream {
         super._loadData(data);
         this.canAutoSync = Boolean(data.canAutoSync); // Use !! for boolean casting from potential string/number
         this.container = data.container;
-        this.forced = Boolean(parseInt(data.forced ?? '0', 10));
+        this.forced = Boolean(Number.parseInt(data.forced ?? '0', 10));
         this.format = data.format;
         this.headerCompression = data.headerCompression;
-        this.hearingImpaired = Boolean(parseInt(data.hearingImpaired ?? '0', 10));
+        this.hearingImpaired = Boolean(Number.parseInt(data.hearingImpaired ?? '0', 10));
         this.perfectMatch = Boolean(data.perfectMatch);
         this.providerTitle = data.providerTitle;
-        this.score = data.score ? parseInt(data.score, 10) : undefined;
+        this.score = data.score ? Number.parseInt(data.score, 10) : undefined;
         this.sourceKey = data.sourceKey;
         this.transient = data.transient;
-        this.userID = data.userID ? parseInt(data.userID, 10) : undefined;
+        this.userID = data.userID ? Number.parseInt(data.userID, 10) : undefined;
     }
 }
 /**
@@ -151,9 +151,9 @@ export class LyricStream extends MediaPartStream {
     _loadData(data) {
         super._loadData(data);
         this.format = data.format;
-        this.minLines = data.minLines ? parseInt(data.minLines, 10) : undefined;
+        this.minLines = data.minLines ? Number.parseInt(data.minLines, 10) : undefined;
         this.provider = data.provider;
-        this.timed = Boolean(parseInt(data.timed ?? '0', 10));
+        this.timed = Boolean(Number.parseInt(data.timed ?? '0', 10));
     }
 }
 /**
@@ -408,23 +408,25 @@ export class AudioStream extends MediaPartStream {
     _loadData(data) {
         super._loadData(data);
         this.audioChannelLayout = data.audioChannelLayout;
-        this.bitDepth = data.bitDepth ? parseInt(data.bitDepth, 10) : undefined;
+        this.bitDepth = data.bitDepth ? Number.parseInt(data.bitDepth, 10) : undefined;
         this.bitrateMode = data.bitrateMode;
-        this.channels = data.channels ? parseInt(data.channels, 10) : undefined;
-        this.duration = data.duration ? parseInt(data.duration, 10) : undefined;
+        this.channels = data.channels ? Number.parseInt(data.channels, 10) : undefined;
+        this.duration = data.duration ? Number.parseInt(data.duration, 10) : undefined;
         this.profile = data.profile;
-        this.samplingRate = data.samplingRate ? parseInt(data.samplingRate, 10) : undefined;
-        this.streamIdentifier = data.streamIdentifier ? parseInt(data.streamIdentifier, 10) : undefined;
-        this.visualImpaired = Boolean(parseInt(data.visualImpaired ?? '0', 10));
+        this.samplingRate = data.samplingRate ? Number.parseInt(data.samplingRate, 10) : undefined;
+        this.streamIdentifier = data.streamIdentifier
+            ? Number.parseInt(data.streamIdentifier, 10)
+            : undefined;
+        this.visualImpaired = Boolean(Number.parseInt(data.visualImpaired ?? '0', 10));
         // Track only attributes
-        this.albumGain = data.albumGain ? parseFloat(data.albumGain) : undefined;
-        this.albumPeak = data.albumPeak ? parseFloat(data.albumPeak) : undefined;
-        this.albumRange = data.albumRange ? parseFloat(data.albumRange) : undefined;
+        this.albumGain = data.albumGain ? Number.parseFloat(data.albumGain) : undefined;
+        this.albumPeak = data.albumPeak ? Number.parseFloat(data.albumPeak) : undefined;
+        this.albumRange = data.albumRange ? Number.parseFloat(data.albumRange) : undefined;
         this.endRamp = data.endRamp;
-        this.gain = data.gain ? parseFloat(data.gain) : undefined;
-        this.loudness = data.loudness ? parseFloat(data.loudness) : undefined;
-        this.lra = data.lra ? parseFloat(data.lra) : undefined;
-        this.peak = data.peak ? parseFloat(data.peak) : undefined;
+        this.gain = data.gain ? Number.parseFloat(data.gain) : undefined;
+        this.loudness = data.loudness ? Number.parseFloat(data.loudness) : undefined;
+        this.lra = data.lra ? Number.parseFloat(data.lra) : undefined;
+        this.peak = data.peak ? Number.parseFloat(data.peak) : undefined;
         this.startRamp = data.startRamp;
     }
 }

package/dist/src/myplex.js

@@ -43,7 +43,7 @@ export class MyPlexAccount {
         });
         return {
             ...pin,
-            uri: `https://app.plex.tv/auth#?clientID=${encodeURIComponent(clientIdentifier)}&code=${encodeURIComponent(pin.code)}&context%5Bdevice%5D%5Bproduct%5D=${encodeURIComponent(appName)}${forwardUrl ? '&forwardUrl=' + encodeURIComponent(forwardUrl) : ''}`,
+            uri: `https://app.plex.tv/auth#?clientID=${encodeURIComponent(clientIdentifier)}&code=${encodeURIComponent(pin.code)}&context%5Bdevice%5D%5Bproduct%5D=${encodeURIComponent(appName)}${forwardUrl ? `&forwardUrl=${encodeURIComponent(forwardUrl)}` : ''}`,
         };
     }
     /**
@@ -220,7 +220,7 @@ export class MyPlexAccount {
      */
     async claimToken() {
         const url = 'https://plex.tv/api/claim/token.json';
-        const response = await this.query(url, 'get', undefined);
+        const response = await this.query(url, 'get');
         return response.token;
     }
     /**
@@ -422,8 +422,8 @@ export class MyPlexDevice extends PlexObject {
         });
         this.screenResolution = data.$.screenResolution;
         this.screenDensity = data.$.screenDensity;
-        this.createdAt = new Date(parseInt(data.$.createdAt, 10));
-        this.lastSeenAt = new Date(parseInt(data.$.lastSeenAt, 10));
+        this.createdAt = new Date(Number.parseInt(data.$.createdAt, 10));
+        this.lastSeenAt = new Date(Number.parseInt(data.$.lastSeenAt, 10));
         this.connections = data.Connection?.map(connection => connection.$.uri);
     }
 }

package/dist/src/playlist.js

@@ -1,4 +1,4 @@
-import { URLSearchParams } from 'url';
+import { URLSearchParams } from 'node:url';
 import { Playable } from './base/playable.js';
 import { Album, Artist, Track } from './audio.js';
 import { fetchItems } from './baseFunctionality.js';
@@ -9,18 +9,24 @@ import { Episode, Movie } from './video.js';
  */
 function contentClass(data) {
     switch (data.type) {
-        case 'episode':
+        case 'episode': {
             return Episode;
-        case 'movie':
+        }
+        case 'movie': {
             return Movie;
-        case 'track':
+        }
+        case 'track': {
             return Track;
-        case 'album':
+        }
+        case 'album': {
             return Album;
-        case 'artist':
+        }
+        case 'artist': {
             return Artist;
-        default:
+        }
+        default: {
             throw new Error(`Media type '${data.type}' not implemented`);
+        }
     }
 }
 export class Playlist extends Playable {

package/dist/src/playqueue.js

@@ -255,7 +255,7 @@ export class PlayQueue extends PlexObject {
         this.playQueueSourceURI = data.playQueueSourceURI;
         this.playQueueTotalCount = data.playQueueTotalCount;
         this.playQueueVersion = data.playQueueVersion;
-        this.size = data.size || this.playQueueTotalCount;
+        this.size = data.size > 0 ? data.size : this.playQueueTotalCount;
         // selectedItem will be set lazily when accessing items
     }
     _invalidateCacheAndLoadData(data) {

package/dist/src/server.d.ts

@@ -1,4 +1,4 @@
-import { URL, URLSearchParams } from 'url';
+import { URL, URLSearchParams } from 'node:url';
 import { Playable } from './base/playable.js';
 import { PlexClient } from './client.js';
 import { Hub, Library } from './library.js';

package/dist/src/server.js

@@ -1,5 +1,5 @@
+import { URL, URLSearchParams } from 'node:url';
 import { ofetch } from 'ofetch';
-import { URL, URLSearchParams } from 'url';
 import { fetchItem, fetchItems } from './baseFunctionality.js';
 import { PlexClient } from './client.js';
 import { BASE_HEADERS, TIMEOUT, X_PLEX_CONTAINER_SIZE } from './config.js';
@@ -93,8 +93,9 @@ export class PlexServer {
         if (limit) {
             params.limit = limit.toString();
         }
-        const key = '/hubs/search?' + new URLSearchParams(params).toString();
-        const hubs = await fetchItems(this, key, undefined, Hub, this);
+        const url = new URL('/hubs/search', this.baseurl);
+        url.search = new URLSearchParams(params).toString();
+        const hubs = await fetchItems(this, url.pathname + url.search, undefined, Hub, this);
         return hubs;
     }
     /**
@@ -137,7 +138,7 @@ export class PlexServer {
      * @param accountId request history for a specific account ID.
      * @param librarySectionId request history for a specific library section ID.
      */
-    async history(maxresults = 9999999, mindate, ratingKey, accountId, librarySectionId) {
+    async history(maxresults = 9_999_999, mindate, ratingKey, accountId, librarySectionId) {
         const args = { sort: 'viewedAt:desc' };
         if (ratingKey !== undefined) {
             args.metadataItemID = ratingKey.toString();
@@ -154,21 +155,22 @@ export class PlexServer {
         args['X-Plex-Container-Start'] = '0';
         args['X-Plex-Container-Size'] = Math.min(X_PLEX_CONTAINER_SIZE, maxresults).toString();
         let results = [];
-        let key = '/status/sessions/history/all?' + new URLSearchParams(args).toString();
-        let raw = await this.query(key);
+        const url = new URL('/status/sessions/history/all', this.baseurl);
+        url.search = new URLSearchParams(args).toString();
+        let raw = await this.query(url.pathname + url.search);
         const totalResults = raw.MediaContainer.totalSize;
         // Filter out null/undefined items from the metadata
         const validMetadata = raw.MediaContainer.Metadata?.filter(Boolean) ?? [];
-        results = results.concat(validMetadata);
+        results.push(...validMetadata);
         while (results.length <= totalResults &&
             X_PLEX_CONTAINER_SIZE === raw.MediaContainer.size &&
             maxresults > results.length) {
             args['X-Plex-Container-Start'] = (Number(args['X-Plex-Container-Start']) + Number(args['X-Plex-Container-Size'])).toString();
-            key = '/status/sessions/history/all?' + new URLSearchParams(args).toString();
-            raw = await this.query(key);
+            url.search = new URLSearchParams(args).toString();
+            raw = await this.query(url.pathname + url.search);
             // Filter out null/undefined items from the metadata
             const validMetadata = raw.MediaContainer.Metadata?.filter(item => item != null) ?? [];
-            results = results.concat(validMetadata);
+            results.push(...validMetadata);
         }
         return results;
     }
@@ -264,10 +266,15 @@ export class PlexServer {
      *    None for server, 'playlist' for playlists, 'details' for all other media types.
      */
     _buildWebURL(base = 'https://app.plex.tv/desktop/', endpoint, params) {
+        const url = new URL(base);
+        const queryString = params?.toString() ? `?${params.toString()}` : '';
         if (endpoint) {
-            return `${base}#!/server/${this.machineIdentifier}/${endpoint}?${params?.toString()}`;
+            url.hash = `!/server/${this.machineIdentifier}/${endpoint}${queryString}`;
         }
-        return `${base}#!/media/${this.machineIdentifier}/com.plexapp.plugins.library?${params?.toString()}`;
+        else {
+            url.hash = `!/media/${this.machineIdentifier}/com.plexapp.plugins.library${queryString}`;
+        }
+        return url.toString();
     }
     _uriRoot() {
         return `server://${this.machineIdentifier}/com.plexapp.plugins.library`;

package/dist/src/settings.js

@@ -1,4 +1,4 @@
-import { URLSearchParams } from 'url';
+import { URLSearchParams } from 'node:url';
 import { PlexObject } from './base/plexObject.js';
 import { NotFound } from './exceptions.js';
 import { lowerFirst } from './util.js';
@@ -74,7 +74,7 @@ export class Setting extends PlexObject {
      */
     set(value) {
         if (typeof value !== typeof this.value) {
-            throw new Error('Invalid type');
+            throw new TypeError('Invalid type');
         }
         this._setValue = value;
     }

package/dist/src/util.d.ts

@@ -10,11 +10,11 @@ export interface MetadataContainer<T extends {
 export declare function rsplit(str: string, sep: string, maxsplit: number): string[];
 /**
  * Return the full agent identifier from a short identifier, name, or confirm full identifier.
- * @param section
- * @param agent
  */
 export declare function getAgentIdentifier(section: Section, agent: string): Promise<string>;
-/** Simple tag helper for editing a object. */
+/**
+ * Simple tag helper for editing a object.
+ */
 export declare function tagHelper(tag: string, items: string[], locked?: boolean, remove?: boolean): Record<string, string | number>;
 export declare function ltrim(x: string, characters: string[]): string;
 export declare function lowerFirst(str: string): string;

package/dist/src/util.js

@@ -1,11 +1,12 @@
 export function rsplit(str, sep, maxsplit) {
     const split = str.split(sep);
-    return maxsplit ? [split.slice(0, -maxsplit).join(sep)].concat(split.slice(-maxsplit)) : split;
+    if (maxsplit) {
+        return [split.slice(0, -maxsplit).join(sep), ...split.slice(-maxsplit)];
+    }
+    return split;
 }
 /**
  * Return the full agent identifier from a short identifier, name, or confirm full identifier.
- * @param section
- * @param agent
  */
 export async function getAgentIdentifier(section, agent) {
     const agents = [];
@@ -14,11 +15,13 @@ export async function getAgentIdentifier(section, agent) {
         if (identifiers.includes(agent)) {
             return ag.identifier;
         }
-        agents.concat(identifiers);
+        agents.push(...identifiers);
     }
     throw new Error(`Couldnt find "${agent}" in agents list (${agents.join(', ')})`);
 }
-/** Simple tag helper for editing a object. */
+/**
+ * Simple tag helper for editing a object.
+ */
 export function tagHelper(tag, items, locked = true, remove = false) {
     const data = {};
     if (remove) {
@@ -40,9 +43,8 @@ export function ltrim(x, characters) {
     while (characters.includes(x[start])) {
         start += 1;
     }
-    const end = x.length - 1;
-    return x.substr(start, end);
+    return x.slice(start);
 }
 export function lowerFirst(str) {
-    return str.charAt(0).toUpperCase() + str.slice(1);
+    return str.charAt(0).toLowerCase() + str.slice(1);
 }

package/dist/src/video.d.ts

@@ -1,4 +1,4 @@
-import type { URL } from 'url';
+import type { URL } from 'node:url';
 import { Playable } from './base/playable.js';
 import type { ExtrasData, FullShowData, MovieData, ShowData } from './library.types.js';
 import { Chapter, Collection, Country, Director, Genre, Guid, Marker, Media, Poster, Producer, Rating, Role, Similar, Writer } from './media.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ctrl/plex",
-  "version": "3.11.0",
+  "version": "3.12.1",
   "description": "plex api client in typescript using ofetch",
   "author": "Scott Cooper <scttcper@gmail.com>",
   "publishConfig": {
@@ -36,31 +36,31 @@
     "@ctrl/mac-address": "^3.1.0",
     "ofetch": "^1.5.1",
     "p-any": "^4.0.0",
-    "type-fest": "^5.2.0",
+    "type-fest": "^5.3.1",
     "ws": "^8.18.3",
     "xml2js": "^0.6.2"
   },
   "devDependencies": {
-    "@ctrl/oxlint-config": "1.3.2",
+    "@ctrl/oxlint-config": "1.3.3",
     "@ctrl/video-filename-parser": "5.4.1",
     "@sindresorhus/tsconfig": "8.1.0",
     "@trivago/prettier-plugin-sort-imports": "6.0.0",
-    "@types/node": "24.10.1",
+    "@types/node": "25.0.3",
     "@types/ws": "8.18.1",
     "@types/xml2js": "0.4.14",
-    "@types/yargs": "17.0.34",
-    "@vitest/coverage-v8": "4.0.8",
-    "execa": "9.6.0",
-    "globby": "15.0.0",
+    "@types/yargs": "17.0.35",
+    "@vitest/coverage-v8": "4.0.16",
+    "execa": "9.6.1",
+    "globby": "16.1.0",
     "make-dir": "5.1.0",
     "ora": "9.0.0",
-    "oxlint": "1.28.0",
-    "p-retry": "7.1.0",
-    "prettier": "3.6.2",
-    "tsx": "4.20.6",
-    "typedoc": "0.28.14",
+    "oxlint": "1.35.0",
+    "p-retry": "7.1.1",
+    "prettier": "3.7.4",
+    "tsx": "4.21.0",
+    "typedoc": "0.28.15",
     "typescript": "5.9.3",
-    "vitest": "4.0.8",
+    "vitest": "4.0.16",
     "yargs": "18.0.0"
   },
   "release": {
@@ -91,5 +91,5 @@
   "engines": {
     "node": ">=18"
   },
-  "packageManager": "pnpm@10.22.0"
+  "packageManager": "pnpm@10.26.1"
 }