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

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/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/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/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.202512091852+commit.b1c8b8d74a21b64230f76e1db7b7120704869e3f",
   "description": "A TypeScript SDK for Jellyfin.",
   "keywords": [
     "jellyfin"