@jellyfin/sdk 0.0.0-unstable.202510281331 → 0.0.0-unstable.202510281431

package/CHANGELOG.md

@@ -7,11 +7,22 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+### Changed
+
+* Ensure `Authorization` header is sent for all requests ([#948](https://github.com/jellyfin/jellyfin-sdk-typescript/pull/948)).
+
+### Deprecated
+
+* Deprecate authentication helper methods in `Api` class ([#949](https://github.com/jellyfin/jellyfin-sdk-typescript/pull/948)).
+  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.
+
 ## [0.12.0] - 2025-10-21
 
 ### Security
 
-* Bumped axios peer dependency version ([#939](https://github.com/jellyfin/jellyfin-sdk-typescript/pull/939)). Note that this axios vulnerability only affected applications running in node.js.
+* Bumped axios peer dependency version ([#939](https://github.com/jellyfin/jellyfin-sdk-typescript/pull/939)).
+  Note that this axios vulnerability only affected applications running in node.js.
 
 ### Added
 
@@ -81,7 +92,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 * API classes are no longer exposed via getters.
   Instead you need to call a function passing the `Api` instance as a parameter.
   For example: `getSystemApi(api)`.
-  While I do feel this is a slightly worse developer experience, it was a necessary change to support tree-shaking ([#149](https://github.com/jellyfin/jellyfin-sdk-typescript/pull/149)).
+  While I do feel this is a slightly worse developer experience, it was a necessary change to support tree-shaking
+  ([#149](https://github.com/jellyfin/jellyfin-sdk-typescript/pull/149)).
 * `BaseItemKind` is now included in the generated client.
   Imports will need updated ([#187](https://github.com/jellyfin/jellyfin-sdk-typescript/pull/187)).
 

package/lib/api.d.ts

@@ -19,7 +19,8 @@ export declare class Api {
     constructor(basePath: string, clientInfo: ClientInfo, deviceInfo: DeviceInfo, accessToken?: string, axiosInstance?: AxiosInstance);
     get configuration(): Configuration;
     /**
-     * Convenience method for authenticating a user by name and updating the internal state.
+     * Convenience method for authenticating a user by name.
+     * @deprecated Use `getUserApi().authenticateUserByName()` instead.
      * @param username The username.
      * @param password The user password if required.
      */
@@ -32,7 +33,8 @@ export declare class Api {
      */
     getUri(url: string, params?: object): string;
     /**
-     * Convenience method for logging out and updating the internal state.
+     * Convenience method for logging out.
+     * @deprecated Use `getSessionApi().reportSessionEnded()` instead.
      */
     logout(): Promise<AxiosResponse<never> | AxiosResponse<void>>;
     get authorizationHeader(): string;

package/lib/api.js

@@ -27,18 +27,15 @@ class Api {
         });
     }
     /**
-     * Convenience method for authenticating a user by name and updating the internal state.
+     * Convenience method for authenticating a user by name.
+     * @deprecated Use `getUserApi().authenticateUserByName()` instead.
      * @param username The username.
      * @param password The user password if required.
      */
     authenticateUserByName(username, password) {
         return getUserApi(this).authenticateUserByName(
         // The axios client does some strange wrapping of the param object
-        { authenticateUserByName: { Username: username, Pw: password } }).then(response => {
-            // Update the current token and configuration object
-            this.accessToken = response.data.AccessToken || '';
-            return response;
-        });
+        { authenticateUserByName: { Username: username, Pw: password } });
     }
     /**
      * Gets a full URI for a relative URL to the Jellyfin server for a given SDK Api instance.
@@ -54,13 +51,11 @@ class Api {
         });
     }
     /**
-     * Convenience method for logging out and updating the internal state.
+     * Convenience method for logging out.
+     * @deprecated Use `getSessionApi().reportSessionEnded()` instead.
      */
     logout() {
-        return getSessionApi(this).reportSessionEnded().then(response => {
-            this.accessToken = '';
-            return response;
-        });
+        return getSessionApi(this).reportSessionEnded();
     }
     get authorizationHeader() {
         return getAuthorizationHeader(this.clientInfo, this.deviceInfo, this.accessToken);

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

@@ -5,8 +5,23 @@ import { SessionApi } from '../../generated-client/api/session-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 SessionApi that updates the state of the access token in the Api instance. */
+class AugmentedSessionApi extends SessionApi {
+    constructor(api) {
+        super(api.configuration, undefined, api.axiosInstance);
+        this.api = api;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-empty-object-type
+    reportSessionEnded(options) {
+        return super.reportSessionEnded(options)
+            .then(response => {
+            this.api.accessToken = '';
+            return response;
+        });
+    }
+}
 function getSessionApi(api) {
-    return new SessionApi(api.configuration, undefined, api.axiosInstance);
+    return new AugmentedSessionApi(api);
 }
 
 export { getSessionApi };

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

@@ -5,8 +5,33 @@ import { UserApi } from '../../generated-client/api/user-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 UserApi that updates the state of the access token in the Api instance. */
+class AugmentedUserApi extends UserApi {
+    constructor(api) {
+        super(api.configuration, undefined, api.axiosInstance);
+        this.api = api;
+    }
+    authenticateUserByName(requestParameters, options
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-empty-object-type
+    ) {
+        return super.authenticateUserByName(requestParameters, options)
+            .then(response => {
+            this.api.accessToken = response.data.AccessToken || '';
+            return response;
+        });
+    }
+    authenticateWithQuickConnect(requestParameters, options
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-empty-object-type
+    ) {
+        return super.authenticateWithQuickConnect(requestParameters, options)
+            .then(response => {
+            this.api.accessToken = response.data.AccessToken || '';
+            return response;
+        });
+    }
+}
 function getUserApi(api) {
-    return new UserApi(api.configuration, undefined, api.axiosInstance);
+    return new AugmentedUserApi(api);
 }
 
 export { getUserApi };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jellyfin/sdk",
-  "version": "0.0.0-unstable.202510281331+commit.2d43c36d9b6a9c9fc2dfbeb29a247664f58d1402",
+  "version": "0.0.0-unstable.202510281431+commit.cee2d235547bdd73ae23661cce21c10aa20eaca0",
   "description": "A TypeScript SDK for Jellyfin.",
   "keywords": [
     "jellyfin"
@@ -30,6 +30,7 @@
     "@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",