@jellyfin/sdk 0.0.0-unstable.202512090502 → 0.0.0-unstable.202601062209

package/.nvmrc

@@ -0,0 +1 @@
+24

package/CHANGELOG.md

@@ -7,6 +7,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+### Added
+
+* `getLibraryApi` now returns an augmented class with a `getDownloadUrl` method ([#967](https://github.com/jellyfin/jellyfin-sdk-typescript/pull/967)).
+
 ## [0.13.0] - 2025-10-28
 
 ### Changed
@@ -15,7 +19,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ### Deprecated
 
-* Deprecate authentication helper methods in `Api` class ([#949](https://github.com/jellyfin/jellyfin-sdk-typescript/pull/948)).
+* Deprecate authentication helper methods in `Api` class ([#949](https://github.com/jellyfin/jellyfin-sdk-typescript/pull/949)).
   Updating the `accessToken` is now handled transparently in `getUserApi` and `getSessionApi`. If you need to handle
   authentication manually, then you should manually create `UserApi` and `SessionApi` instances.
 

package/eslint.config.mjs

@@ -0,0 +1,118 @@
+import eslint from '@eslint/js';
+import stylistic from '@stylistic/eslint-plugin';
+import vitest from '@vitest/eslint-plugin';
+import importPlugin from 'eslint-plugin-import';
+import globals from 'globals';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+	// Global ignores
+	{
+		ignores: [
+			'dist/**',
+			'docs/**',
+			'src/generated-client/**',
+			'lib/**',
+			'node_modules/**'
+		]
+	},
+
+	// Base config for all files
+	eslint.configs.recommended,
+	...tseslint.configs.recommended,
+
+	// Main source files config
+	{
+		files: ['**/*.ts', '**/*.mjs', '**/*.js'],
+		plugins: {
+			'@stylistic': stylistic,
+			'import': importPlugin
+		},
+		languageOptions: {
+			globals: {
+				...globals.node
+			}
+		},
+		settings: {
+			'import/resolver': {
+				typescript: true,
+				node: true
+			}
+		},
+		rules: {
+			'import/order': ['error', {
+				'alphabetize': { 'order': 'asc', 'caseInsensitive': true },
+				'newlines-between': 'always-and-inside-groups'
+			}],
+
+			'@stylistic/type-annotation-spacing': ['error'],
+
+			'@typescript-eslint/consistent-type-imports': ['error'],
+
+			'array-callback-return': ['error'],
+			'arrow-spacing': ['error'],
+			'block-spacing': ['error'],
+			'brace-style': ['error', '1tbs', { 'allowSingleLine': true }],
+			'comma-dangle': ['error', 'never'],
+			'comma-spacing': ['error'],
+			'curly': ['error', 'multi-line'],
+			'eol-last': ['error'],
+			'indent': ['error', 'tab', { 'SwitchCase': 1 }],
+			'jsx-quotes': ['error', 'prefer-single'],
+			'key-spacing': ['error'],
+			'keyword-spacing': ['error'],
+			'max-statements-per-line': ['error'],
+			'no-floating-decimal': ['error'],
+			'no-multi-spaces': ['error'],
+			'no-multiple-empty-lines': ['error', { 'max': 1 }],
+			'no-restricted-globals': ['error'],
+			'no-trailing-spaces': ['error'],
+			'no-unreachable': ['error'],
+			'no-unused-expressions': ['error', { 'allowShortCircuit': true, 'allowTernary': true, 'allowTaggedTemplates': true }],
+			'object-curly-spacing': ['error', 'always'],
+			'one-var': ['error', 'never'],
+			'padded-blocks': ['error', 'never'],
+			'prefer-const': ['error', { 'destructuring': 'all' }],
+			'quotes': ['error', 'single', { 'avoidEscape': true, 'allowTemplateLiterals': false }],
+			'semi': ['error'],
+			'no-var': ['error'],
+			'space-before-blocks': ['error'],
+			'space-before-function-paren': ['error', { 'anonymous': 'never', 'named': 'never', 'asyncArrow': 'always' }],
+			'space-infix-ops': 'error',
+			'yoda': 'error'
+		}
+	},
+
+	// Source files - browser environment
+	{
+		files: ['src/**/*.ts'],
+		languageOptions: {
+			globals: {
+				...globals.browser
+			}
+		}
+	},
+
+	// Test files config
+	{
+		files: ['**/*.test.ts'],
+		plugins: {
+			vitest
+		},
+		languageOptions: {
+			globals: {
+				...globals.node
+			}
+		},
+		rules: {
+			...vitest.configs.recommended.rules,
+			'vitest/consistent-test-it': ['error'],
+			'vitest/prefer-lowercase-title': ['error', { 'ignoreTopLevelDescribe': true }],
+			'vitest/require-top-level-describe': ['error'],
+			// Disable because we use custom `itIf` helper that the plugin doesn't recognize
+			'vitest/no-standalone-expect': 'off',
+			// Disable rules that require type information (would need parserOptions.project)
+			'vitest/valid-title': 'off'
+		}
+	}
+);

package/lib/api.d.ts

@@ -9,6 +9,8 @@ import type { AuthenticationResult } from './generated-client/models/authenticat
 import type { ClientInfo, DeviceInfo } from './models';
 /** The authorization header field name. */
 export declare const AUTHORIZATION_HEADER = "Authorization";
+/** The authorization query parameter name. */
+export declare const AUTHORIZATION_PARAMETER = "ApiKey";
 /** Class representing the Jellyfin API. */
 export declare class Api {
     basePath: string;

package/lib/api.js

@@ -6,6 +6,8 @@ import { getUserApi } from './utils/api/user-api.js';
 
 /** The authorization header field name. */
 const AUTHORIZATION_HEADER = 'Authorization';
+/** The authorization query parameter name. */
+const AUTHORIZATION_PARAMETER = 'ApiKey';
 /** Class representing the Jellyfin API. */
 class Api {
     constructor(basePath, clientInfo, deviceInfo, accessToken = '', axiosInstance = globalAxios) {
@@ -62,4 +64,4 @@ class Api {
     }
 }
 
-export { AUTHORIZATION_HEADER, Api };
+export { AUTHORIZATION_HEADER, AUTHORIZATION_PARAMETER, Api };

package/lib/generated-client/api/activity-log-api.d.ts

@@ -26,6 +26,7 @@ export declare const ActivityLogApiAxiosParamCreator: (configuration?: Configura
      * @param {number} [startIndex] The record index to start at. All items with a lower index will be dropped from the results.
      * @param {number} [limit] The maximum number of records to return.
      * @param {string} [minDate] The minimum date.
+     * @param {string} [maxDate] The maximum date.
      * @param {boolean} [hasUserId] Filter log entries if it has user id, or not.
      * @param {string} [name] Filter by name.
      * @param {string} [overview] Filter by overview.
@@ -39,7 +40,7 @@ export declare const ActivityLogApiAxiosParamCreator: (configuration?: Configura
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getLogEntries: (startIndex?: number, limit?: number, minDate?: string, hasUserId?: boolean, name?: string, overview?: string, shortOverview?: string, type?: string, itemId?: string, username?: string, severity?: LogLevel, sortBy?: Array<ActivityLogSortBy>, sortOrder?: Array<SortOrder>, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    getLogEntries: (startIndex?: number, limit?: number, minDate?: string, maxDate?: string, hasUserId?: boolean, name?: string, overview?: string, shortOverview?: string, type?: string, itemId?: string, username?: string, severity?: LogLevel, sortBy?: Array<ActivityLogSortBy>, sortOrder?: Array<SortOrder>, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
 };
 /**
  * ActivityLogApi - functional programming interface
@@ -52,6 +53,7 @@ export declare const ActivityLogApiFp: (configuration?: Configuration) => {
      * @param {number} [startIndex] The record index to start at. All items with a lower index will be dropped from the results.
      * @param {number} [limit] The maximum number of records to return.
      * @param {string} [minDate] The minimum date.
+     * @param {string} [maxDate] The maximum date.
      * @param {boolean} [hasUserId] Filter log entries if it has user id, or not.
      * @param {string} [name] Filter by name.
      * @param {string} [overview] Filter by overview.
@@ -65,7 +67,7 @@ export declare const ActivityLogApiFp: (configuration?: Configuration) => {
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getLogEntries(startIndex?: number, limit?: number, minDate?: string, hasUserId?: boolean, name?: string, overview?: string, shortOverview?: string, type?: string, itemId?: string, username?: string, severity?: LogLevel, sortBy?: Array<ActivityLogSortBy>, sortOrder?: Array<SortOrder>, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ActivityLogEntryQueryResult>>;
+    getLogEntries(startIndex?: number, limit?: number, minDate?: string, maxDate?: string, hasUserId?: boolean, name?: string, overview?: string, shortOverview?: string, type?: string, itemId?: string, username?: string, severity?: LogLevel, sortBy?: Array<ActivityLogSortBy>, sortOrder?: Array<SortOrder>, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ActivityLogEntryQueryResult>>;
 };
 /**
  * ActivityLogApi - factory interface
@@ -105,6 +107,12 @@ export interface ActivityLogApiGetLogEntriesRequest {
      * @memberof ActivityLogApiGetLogEntries
      */
     readonly minDate?: string;
+    /**
+     * The maximum date.
+     * @type {string}
+     * @memberof ActivityLogApiGetLogEntries
+     */
+    readonly maxDate?: string;
     /**
      * Filter log entries if it has user id, or not.
      * @type {boolean}

package/lib/generated-client/api/activity-log-api.js

@@ -26,6 +26,7 @@ const ActivityLogApiAxiosParamCreator = function (configuration) {
          * @param {number} [startIndex] The record index to start at. All items with a lower index will be dropped from the results.
          * @param {number} [limit] The maximum number of records to return.
          * @param {string} [minDate] The minimum date.
+         * @param {string} [maxDate] The maximum date.
          * @param {boolean} [hasUserId] Filter log entries if it has user id, or not.
          * @param {string} [name] Filter by name.
          * @param {string} [overview] Filter by overview.
@@ -39,7 +40,7 @@ const ActivityLogApiAxiosParamCreator = function (configuration) {
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        getLogEntries: async (startIndex, limit, minDate, hasUserId, name, overview, shortOverview, type, itemId, username, severity, sortBy, sortOrder, options = {}) => {
+        getLogEntries: async (startIndex, limit, minDate, maxDate, hasUserId, name, overview, shortOverview, type, itemId, username, severity, sortBy, sortOrder, options = {}) => {
             const localVarPath = `/System/ActivityLog/Entries`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
@@ -63,6 +64,11 @@ const ActivityLogApiAxiosParamCreator = function (configuration) {
                     minDate.toISOString() :
                     minDate;
             }
+            if (maxDate !== undefined) {
+                localVarQueryParameter['maxDate'] = (maxDate instanceof Date) ?
+                    maxDate.toISOString() :
+                    maxDate;
+            }
             if (hasUserId !== undefined) {
                 localVarQueryParameter['hasUserId'] = hasUserId;
             }
@@ -116,6 +122,7 @@ const ActivityLogApiFp = function (configuration) {
          * @param {number} [startIndex] The record index to start at. All items with a lower index will be dropped from the results.
          * @param {number} [limit] The maximum number of records to return.
          * @param {string} [minDate] The minimum date.
+         * @param {string} [maxDate] The maximum date.
          * @param {boolean} [hasUserId] Filter log entries if it has user id, or not.
          * @param {string} [name] Filter by name.
          * @param {string} [overview] Filter by overview.
@@ -129,9 +136,9 @@ const ActivityLogApiFp = function (configuration) {
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async getLogEntries(startIndex, limit, minDate, hasUserId, name, overview, shortOverview, type, itemId, username, severity, sortBy, sortOrder, options) {
+        async getLogEntries(startIndex, limit, minDate, maxDate, hasUserId, name, overview, shortOverview, type, itemId, username, severity, sortBy, sortOrder, options) {
             var _a, _b, _c;
-            const localVarAxiosArgs = await localVarAxiosParamCreator.getLogEntries(startIndex, limit, minDate, hasUserId, name, overview, shortOverview, type, itemId, username, severity, sortBy, sortOrder, options);
+            const localVarAxiosArgs = await localVarAxiosParamCreator.getLogEntries(startIndex, limit, minDate, maxDate, hasUserId, name, overview, shortOverview, type, itemId, username, severity, sortBy, sortOrder, options);
             const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
             const localVarOperationServerBasePath = (_c = (_b = operationServerMap['ActivityLogApi.getLogEntries']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -153,7 +160,7 @@ const ActivityLogApiFactory = function (configuration, basePath, axios) {
          * @throws {RequiredError}
          */
         getLogEntries(requestParameters = {}, options) {
-            return localVarFp.getLogEntries(requestParameters.startIndex, requestParameters.limit, requestParameters.minDate, requestParameters.hasUserId, requestParameters.name, requestParameters.overview, requestParameters.shortOverview, requestParameters.type, requestParameters.itemId, requestParameters.username, requestParameters.severity, requestParameters.sortBy, requestParameters.sortOrder, options).then((request) => request(axios, basePath));
+            return localVarFp.getLogEntries(requestParameters.startIndex, requestParameters.limit, requestParameters.minDate, requestParameters.maxDate, requestParameters.hasUserId, requestParameters.name, requestParameters.overview, requestParameters.shortOverview, requestParameters.type, requestParameters.itemId, requestParameters.username, requestParameters.severity, requestParameters.sortBy, requestParameters.sortOrder, options).then((request) => request(axios, basePath));
         },
     };
 };
@@ -173,7 +180,7 @@ class ActivityLogApi extends BaseAPI {
      * @memberof ActivityLogApi
      */
     getLogEntries(requestParameters = {}, options) {
-        return ActivityLogApiFp(this.configuration).getLogEntries(requestParameters.startIndex, requestParameters.limit, requestParameters.minDate, requestParameters.hasUserId, requestParameters.name, requestParameters.overview, requestParameters.shortOverview, requestParameters.type, requestParameters.itemId, requestParameters.username, requestParameters.severity, requestParameters.sortBy, requestParameters.sortOrder, options).then((request) => request(this.axios, this.basePath));
+        return ActivityLogApiFp(this.configuration).getLogEntries(requestParameters.startIndex, requestParameters.limit, requestParameters.minDate, requestParameters.maxDate, requestParameters.hasUserId, requestParameters.name, requestParameters.overview, requestParameters.shortOverview, requestParameters.type, requestParameters.itemId, requestParameters.username, requestParameters.severity, requestParameters.sortBy, requestParameters.sortOrder, options).then((request) => request(this.axios, this.basePath));
     }
 }
 

package/lib/generated-client/index.js

@@ -146,7 +146,6 @@ export { TonemappingMode } from './models/tonemapping-mode.js';
 export { TonemappingRange } from './models/tonemapping-range.js';
 export { TranscodeReason } from './models/transcode-reason.js';
 export { TranscodeSeekInfo } from './models/transcode-seek-info.js';
-export { TranscodingInfoTranscodeReasonsEnum } from './models/transcoding-info.js';
 export { TransportStreamTimestamp } from './models/transport-stream-timestamp.js';
 export { TrickplayScanBehavior } from './models/trickplay-scan-behavior.js';
 export { UnratedItem } from './models/unrated-item.js';

package/lib/generated-client/models/album-info.d.ts

@@ -91,11 +91,11 @@ export interface AlbumInfo {
     'AlbumArtists'?: Array<string>;
     /**
      * Gets or sets the artist provider ids.
-     * @type {{ [key: string]: string | null; }}
+     * @type {{ [key: string]: string; }}
      * @memberof AlbumInfo
      */
     'ArtistProviderIds'?: {
-        [key: string]: string | null;
+        [key: string]: string;
     };
     /**
      *

package/lib/generated-client/models/backup-manifest-dto.d.ts

@@ -20,29 +20,29 @@ export interface BackupManifestDto {
      * @type {string}
      * @memberof BackupManifestDto
      */
-    'ServerVersion'?: string;
+    'ServerVersion': string;
     /**
      * Gets or sets the backup engine version this backup was created with.
      * @type {string}
      * @memberof BackupManifestDto
      */
-    'BackupEngineVersion'?: string;
+    'BackupEngineVersion': string;
     /**
      * Gets or sets the date this backup was created with.
      * @type {string}
      * @memberof BackupManifestDto
      */
-    'DateCreated'?: string;
+    'DateCreated': string;
     /**
      * Gets or sets the path to the backup on the system.
      * @type {string}
      * @memberof BackupManifestDto
      */
-    'Path'?: string;
+    'Path': string;
     /**
      *
      * @type {BackupOptionsDto}
      * @memberof BackupManifestDto
      */
-    'Options'?: BackupOptionsDto;
+    'Options': BackupOptionsDto;
 }

package/lib/generated-client/models/backup-restore-request-dto.d.ts

@@ -19,5 +19,5 @@ export interface BackupRestoreRequestDto {
      * @type {string}
      * @memberof BackupRestoreRequestDto
      */
-    'ArchiveFileName'?: string;
+    'ArchiveFileName': string;
 }

package/lib/generated-client/models/base-item-dto-image-blur-hashes.d.ts

@@ -16,106 +16,106 @@
 export interface BaseItemDtoImageBlurHashes {
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemDtoImageBlurHashes
      */
     'Primary'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemDtoImageBlurHashes
      */
     'Art'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemDtoImageBlurHashes
      */
     'Backdrop'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemDtoImageBlurHashes
      */
     'Banner'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemDtoImageBlurHashes
      */
     'Logo'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemDtoImageBlurHashes
      */
     'Thumb'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemDtoImageBlurHashes
      */
     'Disc'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemDtoImageBlurHashes
      */
     'Box'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemDtoImageBlurHashes
      */
     'Screenshot'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemDtoImageBlurHashes
      */
     'Menu'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemDtoImageBlurHashes
      */
     'Chapter'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemDtoImageBlurHashes
      */
     'BoxRear'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemDtoImageBlurHashes
      */
     'Profile'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
 }

package/lib/generated-client/models/base-item-dto.d.ts

@@ -582,11 +582,11 @@ export interface BaseItemDto {
     'MediaSourceCount'?: number | null;
     /**
      * Gets or sets the image tags.
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemDto
      */
     'ImageTags'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     } | null;
     /**
      * Gets or sets the backdrop image tags.
@@ -668,13 +668,13 @@ export interface BaseItemDto {
     'Chapters'?: Array<ChapterInfo> | null;
     /**
      * Gets or sets the trickplay manifest.
-     * @type {{ [key: string]: { [key: string]: TrickplayInfoDto; }; }}
+     * @type {{ [key: string]: { [key: string]: TrickplayInfoDto; } | null; }}
      * @memberof BaseItemDto
      */
     'Trickplay'?: {
         [key: string]: {
             [key: string]: TrickplayInfoDto;
-        };
+        } | null;
     } | null;
     /**
      *

package/lib/generated-client/models/base-item-person-image-blur-hashes.d.ts

@@ -16,106 +16,106 @@
 export interface BaseItemPersonImageBlurHashes {
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemPersonImageBlurHashes
      */
     'Primary'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemPersonImageBlurHashes
      */
     'Art'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemPersonImageBlurHashes
      */
     'Backdrop'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemPersonImageBlurHashes
      */
     'Banner'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemPersonImageBlurHashes
      */
     'Logo'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemPersonImageBlurHashes
      */
     'Thumb'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemPersonImageBlurHashes
      */
     'Disc'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemPersonImageBlurHashes
      */
     'Box'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemPersonImageBlurHashes
      */
     'Screenshot'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemPersonImageBlurHashes
      */
     'Menu'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemPersonImageBlurHashes
      */
     'Chapter'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemPersonImageBlurHashes
      */
     'BoxRear'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
     /**
      *
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof BaseItemPersonImageBlurHashes
      */
     'Profile'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     };
 }

package/lib/generated-client/models/cast-receiver-application.d.ts

@@ -19,11 +19,11 @@ export interface CastReceiverApplication {
      * @type {string}
      * @memberof CastReceiverApplication
      */
-    'Id'?: string;
+    'Id': string;
     /**
      * Gets or sets the cast receiver application name.
      * @type {string}
      * @memberof CastReceiverApplication
      */
-    'Name'?: string;
+    'Name': string;
 }

package/lib/generated-client/models/channel-mapping-options-dto.d.ts

@@ -22,13 +22,13 @@ export interface ChannelMappingOptionsDto {
      * @type {Array<TunerChannelMapping>}
      * @memberof ChannelMappingOptionsDto
      */
-    'TunerChannels'?: Array<TunerChannelMapping>;
+    'TunerChannels': Array<TunerChannelMapping>;
     /**
      * Gets or sets list of provider channels.
      * @type {Array<NameIdPair>}
      * @memberof ChannelMappingOptionsDto
      */
-    'ProviderChannels'?: Array<NameIdPair>;
+    'ProviderChannels': Array<NameIdPair>;
     /**
      * Gets or sets list of mappings.
      * @type {Array<NameValuePair>}

package/lib/generated-client/models/create-playlist-dto.d.ts

@@ -21,7 +21,7 @@ export interface CreatePlaylistDto {
      * @type {string}
      * @memberof CreatePlaylistDto
      */
-    'Name'?: string;
+    'Name': string;
     /**
      * Gets or sets item ids to add to the playlist.
      * @type {Array<string>}

package/lib/generated-client/models/custom-database-option.d.ts

@@ -19,11 +19,11 @@ export interface CustomDatabaseOption {
      * @type {string}
      * @memberof CustomDatabaseOption
      */
-    'Key'?: string;
+    'Key': string;
     /**
      * Gets or sets the value.
      * @type {string}
      * @memberof CustomDatabaseOption
      */
-    'Value'?: string;
+    'Value': string;
 }

package/lib/generated-client/models/custom-database-options.d.ts

@@ -20,19 +20,19 @@ export interface CustomDatabaseOptions {
      * @type {string}
      * @memberof CustomDatabaseOptions
      */
-    'PluginName'?: string;
+    'PluginName': string;
     /**
      * Gets or sets the plugin assembly to search for providers.
      * @type {string}
      * @memberof CustomDatabaseOptions
      */
-    'PluginAssembly'?: string;
+    'PluginAssembly': string;
     /**
      * Gets or sets the connection string for the custom database provider.
      * @type {string}
      * @memberof CustomDatabaseOptions
      */
-    'ConnectionString'?: string;
+    'ConnectionString': string;
     /**
      * Gets or sets the list of extra options for the custom provider.
      * @type {Array<CustomDatabaseOption>}

package/lib/generated-client/models/database-configuration-options.d.ts

@@ -21,7 +21,7 @@ export interface DatabaseConfigurationOptions {
      * @type {string}
      * @memberof DatabaseConfigurationOptions
      */
-    'DatabaseType'?: string;
+    'DatabaseType': string;
     /**
      *
      * @type {CustomDatabaseOptions}

package/lib/generated-client/models/device-profile.d.ts

@@ -14,7 +14,7 @@ import type { DirectPlayProfile } from './direct-play-profile';
 import type { SubtitleProfile } from './subtitle-profile';
 import type { TranscodingProfile } from './transcoding-profile';
 /**
- * A MediaBrowser.Model.Dlna.DeviceProfile represents a set of metadata which determines which content a certain device is able to play.  <br />  Specifically, it defines the supported <see cref=\"P:MediaBrowser.Model.Dlna.DeviceProfile.ContainerProfiles\">containers</see> and  <see cref=\"P:MediaBrowser.Model.Dlna.DeviceProfile.CodecProfiles\">codecs</see> (video and/or audio, including codec profiles and levels)  the device is able to direct play (without transcoding or remuxing),  as well as which <see cref=\"P:MediaBrowser.Model.Dlna.DeviceProfile.TranscodingProfiles\">containers/codecs to transcode to</see> in case it isn\'t.
+ * A MediaBrowser.Model.Dlna.DeviceProfile represents a set of metadata which determines which content a certain device is able to play.     Specifically, it defines the supported <see cref=\"P:MediaBrowser.Model.Dlna.DeviceProfile.ContainerProfiles\">containers</see> and  <see cref=\"P:MediaBrowser.Model.Dlna.DeviceProfile.CodecProfiles\">codecs</see> (video and/or audio, including codec profiles and levels)  the device is able to direct play (without transcoding or remuxing),  as well as which <see cref=\"P:MediaBrowser.Model.Dlna.DeviceProfile.TranscodingProfiles\">containers/codecs to transcode to</see> in case it isn\'t.
  * @export
  * @interface DeviceProfile
  */

package/lib/generated-client/models/folder-storage-dto.d.ts

@@ -19,7 +19,7 @@ export interface FolderStorageDto {
      * @type {string}
      * @memberof FolderStorageDto
      */
-    'Path'?: string;
+    'Path': string;
     /**
      * Gets the free space of the underlying storage device of the Jellyfin.Api.Models.SystemInfoDtos.FolderStorageDto.Path.
      * @type {number}

package/lib/generated-client/models/general-command.d.ts

@@ -29,10 +29,10 @@ export interface GeneralCommand {
     'ControllingUserId'?: string;
     /**
      *
-     * @type {{ [key: string]: string | null; }}
+     * @type {{ [key: string]: string; }}
      * @memberof GeneralCommand
      */
     'Arguments'?: {
-        [key: string]: string | null;
+        [key: string]: string;
     };
 }

package/lib/generated-client/models/index.js

@@ -84,7 +84,6 @@ export { TonemappingMode } from './tonemapping-mode.js';
 export { TonemappingRange } from './tonemapping-range.js';
 export { TranscodeReason } from './transcode-reason.js';
 export { TranscodeSeekInfo } from './transcode-seek-info.js';
-export { TranscodingInfoTranscodeReasonsEnum } from './transcoding-info.js';
 export { TransportStreamTimestamp } from './transport-stream-timestamp.js';
 export { TrickplayScanBehavior } from './trickplay-scan-behavior.js';
 export { UnratedItem } from './unrated-item.js';

package/lib/generated-client/models/library-storage-dto.d.ts

@@ -20,17 +20,17 @@ export interface LibraryStorageDto {
      * @type {string}
      * @memberof LibraryStorageDto
      */
-    'Id'?: string;
+    'Id': string;
     /**
      * Gets or sets the name of the library.
      * @type {string}
      * @memberof LibraryStorageDto
      */
-    'Name'?: string;
+    'Name': string;
     /**
      * Gets or sets the storage informations about the folders used in a library.
      * @type {Array<FolderStorageDto>}
      * @memberof LibraryStorageDto
      */
-    'Folders'?: Array<FolderStorageDto>;
+    'Folders': Array<FolderStorageDto>;
 }

package/lib/generated-client/models/log-file.d.ts

@@ -37,5 +37,5 @@ export interface LogFile {
      * @type {string}
      * @memberof LogFile
      */
-    'Name'?: string;
+    'Name': string;
 }

package/lib/generated-client/models/playlist-dto.d.ts

@@ -26,11 +26,11 @@ export interface PlaylistDto {
      * @type {Array<PlaylistUserPermissions>}
      * @memberof PlaylistDto
      */
-    'Shares'?: Array<PlaylistUserPermissions>;
+    'Shares': Array<PlaylistUserPermissions>;
     /**
      * Gets or sets the item ids.
      * @type {Array<string>}
      * @memberof PlaylistDto
      */
-    'ItemIds'?: Array<string>;
+    'ItemIds': Array<string>;
 }

package/lib/generated-client/models/remote-lyric-info-dto.d.ts

@@ -20,17 +20,17 @@ export interface RemoteLyricInfoDto {
      * @type {string}
      * @memberof RemoteLyricInfoDto
      */
-    'Id'?: string;
+    'Id': string;
     /**
      * Gets the provider name.
      * @type {string}
      * @memberof RemoteLyricInfoDto
      */
-    'ProviderName'?: string;
+    'ProviderName': string;
     /**
      *
      * @type {LyricDto}
      * @memberof RemoteLyricInfoDto
      */
-    'Lyrics'?: LyricDto;
+    'Lyrics': LyricDto;
 }

package/lib/generated-client/models/series-timer-info-dto.d.ts

@@ -199,11 +199,11 @@ export interface SeriesTimerInfoDto {
     'DayPattern'?: DayPattern;
     /**
      * Gets or sets the image tags.
-     * @type {{ [key: string]: string; }}
+     * @type {{ [key: string]: string | null; }}
      * @memberof SeriesTimerInfoDto
      */
     'ImageTags'?: {
-        [key: string]: string;
+        [key: string]: string | null;
     } | null;
     /**
      * Gets or sets the parent thumb item id.

package/lib/generated-client/models/system-storage-dto.d.ts

@@ -21,47 +21,47 @@ export interface SystemStorageDto {
      * @type {FolderStorageDto}
      * @memberof SystemStorageDto
      */
-    'ProgramDataFolder'?: FolderStorageDto;
+    'ProgramDataFolder': FolderStorageDto;
     /**
      *
      * @type {FolderStorageDto}
      * @memberof SystemStorageDto
      */
-    'WebFolder'?: FolderStorageDto;
+    'WebFolder': FolderStorageDto;
     /**
      *
      * @type {FolderStorageDto}
      * @memberof SystemStorageDto
      */
-    'ImageCacheFolder'?: FolderStorageDto;
+    'ImageCacheFolder': FolderStorageDto;
     /**
      *
      * @type {FolderStorageDto}
      * @memberof SystemStorageDto
      */
-    'CacheFolder'?: FolderStorageDto;
+    'CacheFolder': FolderStorageDto;
     /**
      *
      * @type {FolderStorageDto}
      * @memberof SystemStorageDto
      */
-    'LogFolder'?: FolderStorageDto;
+    'LogFolder': FolderStorageDto;
     /**
      *
      * @type {FolderStorageDto}
      * @memberof SystemStorageDto
      */
-    'InternalMetadataFolder'?: FolderStorageDto;
+    'InternalMetadataFolder': FolderStorageDto;
     /**
      *
      * @type {FolderStorageDto}
      * @memberof SystemStorageDto
      */
-    'TranscodingTempFolder'?: FolderStorageDto;
+    'TranscodingTempFolder': FolderStorageDto;
     /**
      * Gets or sets the storage informations of all libraries.
      * @type {Array<LibraryStorageDto>}
      * @memberof SystemStorageDto
      */
-    'Libraries'?: Array<LibraryStorageDto>;
+    'Libraries': Array<LibraryStorageDto>;
 }

package/lib/generated-client/models/transcoding-info.d.ts

@@ -9,6 +9,7 @@
  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
  */
 import type { HardwareAccelerationType } from './hardware-acceleration-type';
+import type { TranscodeReason } from './transcode-reason';
 /**
  * Class holding information on a running transcode.
  * @export
@@ -92,7 +93,5 @@ export interface TranscodingInfo {
      * @type {Array<TranscodeReason>}
      * @memberof TranscodingInfo
      */
-    'TranscodeReasons'?: TranscodingInfoTranscodeReasonsEnum;
+    'TranscodeReasons'?: Array<TranscodeReason>;
 }
-export declare const TranscodingInfoTranscodeReasonsEnum: {};
-export type TranscodingInfoTranscodeReasonsEnum = typeof TranscodingInfoTranscodeReasonsEnum[keyof typeof TranscodingInfoTranscodeReasonsEnum];

package/lib/generated-client/models/user-data-change-info.d.ts

@@ -26,5 +26,5 @@ export interface UserDataChangeInfo {
      * @type {Array<UserItemDataDto>}
      * @memberof UserDataChangeInfo
      */
-    'UserDataList'?: Array<UserItemDataDto>;
+    'UserDataList': Array<UserItemDataDto>;
 }

package/lib/generated-client/models/user-item-data-dto.d.ts

@@ -73,7 +73,7 @@ export interface UserItemDataDto {
      * @type {string}
      * @memberof UserItemDataDto
      */
-    'Key'?: string;
+    'Key': string;
     /**
      * Gets or sets the item identifier.
      * @type {string}

package/lib/index.js

@@ -2,7 +2,7 @@ import * as discovery_index from './discovery/index.js';
 export { discovery_index as discovery };
 import * as utils_index from './utils/index.js';
 export { utils_index as utils };
-export { AUTHORIZATION_HEADER, Api } from './api.js';
+export { AUTHORIZATION_HEADER, AUTHORIZATION_PARAMETER, Api } from './api.js';
 export { Jellyfin } from './jellyfin.js';
 export { RecommendedServerInfoScore } from './models/recommended-server-info.js';
 export { ProductNameIssue, RecommendedServerIssue, SlowResponseIssue, SystemInfoIssue, VersionMissingIssue, VersionOutdatedIssue, VersionUnsupportedIssue } from './models/recommended-server-issue.js';

package/lib/models/api/image-request-parameters.d.ts

@@ -16,7 +16,7 @@ export interface ImageRequestParameters {
     quality?: number;
     fillWidth?: number;
     fillHeight?: number;
-    tag?: string;
+    tag?: string | null;
     cropWhitespace?: boolean;
     format?: ImageFormat;
     percentPlayed?: number;

package/lib/utils/api/library-api.d.ts

@@ -3,6 +3,18 @@
  * License, v. 2.0. If a copy of the MPL was not distributed with this
  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
  */
-import type { Api } from '../../api';
-import { LibraryApi } from '../../generated-client/api/library-api';
-export declare function getLibraryApi(api: Api): LibraryApi;
+import { type Api } from '../../api';
+import { LibraryApi, type LibraryApiGetDownloadRequest } from '../../generated-client/api/library-api';
+/** An augmented LibraryApi with URL helpers. */
+declare class AugmentedLibraryApi extends LibraryApi {
+    api: Api;
+    constructor(api: Api);
+    /**
+     * Get an Item download URL.
+     * @param requestParameters The download request parameters.
+     * @returns The Item download URL.
+     */
+    getDownloadUrl(requestParameters: LibraryApiGetDownloadRequest): string;
+}
+export declare function getLibraryApi(api: Api): AugmentedLibraryApi;
+export {};

package/lib/utils/api/library-api.js

@@ -1,3 +1,4 @@
+import { AUTHORIZATION_PARAMETER } from '../../api.js';
 import { LibraryApi } from '../../generated-client/api/library-api.js';
 
 /**
@@ -5,8 +6,23 @@ import { LibraryApi } from '../../generated-client/api/library-api.js';
  * License, v. 2.0. If a copy of the MPL was not distributed with this
  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
  */
+/** An augmented LibraryApi with URL helpers. */
+class AugmentedLibraryApi extends LibraryApi {
+    constructor(api) {
+        super(api.configuration, undefined, api.axiosInstance);
+        this.api = api;
+    }
+    /**
+     * Get an Item download URL.
+     * @param requestParameters The download request parameters.
+     * @returns The Item download URL.
+     */
+    getDownloadUrl(requestParameters) {
+        return this.api.getUri(`/Items/${requestParameters.itemId}/Download`, { [AUTHORIZATION_PARAMETER]: this.api.accessToken });
+    }
+}
 function getLibraryApi(api) {
-    return new LibraryApi(api.configuration, undefined, api.axiosInstance);
+    return new AugmentedLibraryApi(api);
 }
 
 export { getLibraryApi };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jellyfin/sdk",
-  "version": "0.0.0-unstable.202512090502+commit.cba2dc8ea5a03c559af6a7fdad6de57bc135ddca",
+  "version": "0.0.0-unstable.202601062209+commit.16e94e6038d4a7c77b33de7b55d80b203ffaa358",
   "description": "A TypeScript SDK for Jellyfin.",
   "keywords": [
     "jellyfin"
@@ -26,23 +26,26 @@
     "test:integration": "vitest integration"
   },
   "devDependencies": {
-    "@openapitools/openapi-generator-cli": "2.25.0",
-    "@rollup/plugin-typescript": "12.1.4",
-    "@stylistic/eslint-plugin": "2.13.0",
-    "@tsconfig/recommended": "1.0.10",
-    "@types/node": "24.9.1",
-    "@typescript-eslint/eslint-plugin": "8.46.2",
-    "@typescript-eslint/parser": "8.46.2",
-    "@vitest/coverage-v8": "3.2.4",
-    "@vitest/eslint-plugin": "1.3.23",
-    "eslint": "8.57.1",
+    "@openapitools/openapi-generator-cli": "2.26.0",
+    "@rollup/plugin-typescript": "12.3.0",
+    "@stylistic/eslint-plugin": "5.6.1",
+    "@tsconfig/recommended": "1.0.13",
+    "@types/node": "24.10.4",
+    "@typescript-eslint/eslint-plugin": "8.50.1",
+    "@typescript-eslint/parser": "8.50.1",
+    "@vitest/coverage-v8": "4.0.16",
+    "@vitest/eslint-plugin": "1.6.1",
+    "eslint": "9.39.2",
+    "eslint-import-resolver-typescript": "4.4.4",
     "eslint-plugin-import": "2.32.0",
-    "glob": "11.0.3",
+    "glob": "13.0.0",
+    "globals": "16.5.0",
     "rimraf": "5.0.10",
-    "rollup": "4.52.5",
-    "typedoc": "0.28.14",
+    "rollup": "4.54.0",
+    "typedoc": "0.28.15",
     "typescript": "5.9.3",
-    "vitest": "3.2.4"
+    "typescript-eslint": "8.50.1",
+    "vitest": "4.0.16"
   },
   "peerDependencies": {
     "axios": "^1.12.0"

package/lib/generated-client/models/transcoding-info.js

@@ -1,15 +0,0 @@
-/* tslint:disable */
-/* eslint-disable */
-/**
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * Do not edit the class manually.
- *
- * Jellyfin API
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at http://mozilla.org/MPL/2.0/.
- */
-const TranscodingInfoTranscodeReasonsEnum = {};
-
-export { TranscodingInfoTranscodeReasonsEnum };