@ctrl/deluge 7.0.0 → 7.1.0

package/README.md

@@ -70,6 +70,15 @@ const res = await client.removeTorrent('torrent_id', true);
 console.log(res);
 ```
 
+##### export and create from state
+
+If you're shutting down the server often (serverless?) you can export the state
+
+```ts
+const state = client.exportState()
+const client = Deluge.createFromState(config, state);
+```
+
 ### See Also
 transmission - https://github.com/scttcper/transmission  
 qbittorrent - https://github.com/scttcper/qbittorrent  

package/dist/src/deluge.d.ts

@@ -1,11 +1,20 @@
 import { ofetch } from 'ofetch';
-import type { AddTorrentOptions as NormalizedAddTorrentOptions, AllClientData, NormalizedTorrent, TorrentClient, TorrentSettings } from '@ctrl/shared-torrent';
+import { Cookie } from 'tough-cookie';
+import type { Jsonify } from 'type-fest';
+import type { AddTorrentOptions as NormalizedAddTorrentOptions, AllClientData, NormalizedTorrent, TorrentClient, TorrentClientConfig, TorrentClientState } from '@ctrl/shared-torrent';
 import type { AddTorrentOptions, AddTorrentResponse, BooleanStatus, ConfigResponse, DefaultResponse, DelugeSettings, GetHostsResponse, GetHostStatusResponse, ListMethods, PluginInfo, PluginsListResponse, StringStatus, TorrentFiles, TorrentInfo, TorrentListResponse, TorrentOptions, TorrentStatus, Tracker, UploadResponse } from './types.js';
+interface DelugeState extends TorrentClientState {
+    auth: {
+        cookie?: Cookie;
+        msgId: number;
+    };
+}
 export declare class Deluge implements TorrentClient {
-    config: TorrentSettings;
-    private _msgId;
-    private _cookie?;
-    constructor(options?: Partial<TorrentSettings>);
+    static createFromState(config: Readonly<TorrentClientConfig>, state: Readonly<Jsonify<DelugeState>>): Deluge;
+    config: TorrentClientConfig;
+    state: DelugeState;
+    constructor(options?: Partial<TorrentClientConfig>);
+    exportState(): Jsonify<DelugeState>;
     resetSession(): void;
     getHosts(): Promise<GetHostsResponse>;
     /**
@@ -108,3 +117,4 @@ export declare class Deluge implements TorrentClient {
     request<T extends object>(method: string, params?: any[], needsAuth?: boolean, autoConnect?: boolean): Promise<ReturnType<typeof ofetch.raw<T>>>;
     private _validateAuth;
 }
+export {};

package/dist/src/deluge.js

@@ -12,15 +12,37 @@ const defaults = {
     timeout: 5000,
 };
 export class Deluge {
+    static createFromState(config, state) {
+        const deluge = new Deluge(config);
+        deluge.state = {
+            ...state,
+            auth: state.auth
+                ? {
+                    cookie: Cookie.fromJSON(state.auth.cookie),
+                    msgId: state.auth.msgId,
+                }
+                : { msgId: 0 },
+        };
+        return deluge;
+    }
     config;
-    _msgId = 0;
-    _cookie;
+    state = { auth: { msgId: 0 } };
     constructor(options = {}) {
         this.config = { ...defaults, ...options };
     }
+    exportState() {
+        return JSON.parse(JSON.stringify({
+            ...this.state,
+            auth: this.state.auth
+                ? {
+                    cookie: this.state.auth.cookie.toJSON(),
+                    msgId: this.state.auth.msgId,
+                }
+                : { msgId: 0 },
+        }));
+    }
     resetSession() {
-        this._cookie = undefined;
-        this._msgId = 0;
+        this.state.auth = { msgId: 0 };
     }
     async getHosts() {
         const res = await this.request('web.get_hosts', [], true, false);
@@ -75,15 +97,15 @@ export class Deluge {
      */
     async checkSession() {
         // cookie is missing or expires in x seconds
-        if (this._cookie) {
+        if (this.state.auth.cookie) {
             // eslint-disable-next-line new-cap
-            if (this._cookie.TTL() < 5000) {
+            if (this.state.auth.cookie.TTL() < 5000) {
                 this.resetSession();
                 return false;
             }
             return true;
         }
-        if (this._cookie) {
+        if (this.state.auth.cookie) {
             try {
                 const check = await this.request('auth.check_session', undefined, false);
                 const body = await check.json();
@@ -108,7 +130,7 @@ export class Deluge {
         if (!res.ok || !res.headers?.get('set-cookie')?.length) {
             throw new Error('Auth failed, incorrect password');
         }
-        this._cookie = Cookie.parse(res.headers.get('set-cookie'));
+        this.state.auth.cookie = Cookie.parse(res.headers.get('set-cookie'));
         return true;
     }
     /**
@@ -298,7 +320,7 @@ export class Deluge {
         }
         // update current password to new password
         this.config.password = password;
-        this._cookie = Cookie.parse(res.headers.get('set-cookie'));
+        this.state.auth.cookie = Cookie.parse(res.headers.get('set-cookie'));
         return body;
     }
     async getAllData() {
@@ -512,8 +534,8 @@ export class Deluge {
         return req._data;
     }
     async request(method, params = [], needsAuth = true, autoConnect = true) {
-        if (this._msgId === 4096) {
-            this._msgId = 0;
+        if (this.state.auth.msgId === 4096) {
+            this.state.auth.msgId = 0;
         }
         if (needsAuth) {
             await this._validateAuth();
@@ -525,7 +547,7 @@ export class Deluge {
             }
         }
         const headers = {
-            Cookie: this._cookie?.cookieString?.(),
+            Cookie: this.state.auth.cookie?.cookieString?.(),
         };
         const url = joinURL(this.config.baseUrl, this.config.path);
         const res = await ofetch.raw(url, {
@@ -533,7 +555,7 @@ export class Deluge {
             body: JSON.stringify({
                 method,
                 params,
-                id: this._msgId++,
+                id: this.state.auth.msgId++,
             }),
             headers,
             retry: 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ctrl/deluge",
-  "version": "7.0.0",
+  "version": "7.1.0",
   "description": "TypeScript api wrapper for deluge using got",
   "author": "Scott Cooper <scttcper@gmail.com>",
   "license": "MIT",
@@ -33,23 +33,24 @@
   },
   "dependencies": {
     "@ctrl/magnet-link": "^4.0.2",
-    "@ctrl/shared-torrent": "^6.1.0",
+    "@ctrl/shared-torrent": "^6.2.1",
     "node-fetch-native": "^1.6.4",
     "ofetch": "^1.4.1",
     "tough-cookie": "^5.0.0",
+    "type-fest": "^4.30.2",
     "ufo": "^1.5.4",
     "uint8array-extras": "^1.4.0"
   },
   "devDependencies": {
     "@biomejs/biome": "1.9.4",
-    "@ctrl/eslint-config-biome": "4.2.11",
-    "@sindresorhus/tsconfig": "6.0.0",
-    "@types/node": "22.9.0",
-    "@vitest/coverage-v8": "2.1.4",
+    "@ctrl/eslint-config-biome": "4.3.1",
+    "@sindresorhus/tsconfig": "7.0.0",
+    "@types/node": "22.10.2",
+    "@vitest/coverage-v8": "2.1.8",
     "p-wait-for": "5.0.2",
-    "typedoc": "0.26.11",
-    "typescript": "5.6.3",
-    "vitest": "2.1.4"
+    "typedoc": "0.27.5",
+    "typescript": "5.7.2",
+    "vitest": "2.1.8"
   },
   "publishConfig": {
     "access": "public",