@meowpanel/api 0.2.0 → 0.4.0

package/esm/src/resources/servers/features.d.ts

@@ -0,0 +1,81 @@
+import type { HttpClient } from '../../http.js';
+import type { NanoID } from '../../types.js';
+/** Where a feature's availability comes from, resolved most-specific-wins. */
+export type FeatureSource = 'server' | 'egg' | 'node';
+/** Where an effective setting value comes from. `server` is a client override, `feature` is the default. */
+export type FeatureSettingSource = 'server' | 'feature';
+/** One resolved setting of an effective feature. */
+export interface FeatureSetting {
+    /** The effective resolved value. */
+    value: unknown;
+    /** Whether the value is a client override (`server`) or the feature default (`feature`). */
+    source: FeatureSettingSource;
+    /** The feature's code-defined default for this setting. */
+    default: unknown;
+}
+/** A feature as it applies to a specific server, with its resolved settings. */
+export interface EffectiveFeature {
+    /** The feature key, e.g. `"minecraft.players"`. */
+    name: string;
+    /** Whether the feature is enabled for this server. */
+    enabled: boolean;
+    /** When `true`, the enabled state is fixed and cannot be toggled. */
+    locked: boolean;
+    /** Where the feature's availability is granted from. */
+    source: FeatureSource;
+    /** The selected variant, or `null` when the feature has none. */
+    variant: string | null;
+    /** Resolved settings, keyed by setting name. */
+    settings: Record<string, FeatureSetting>;
+}
+/**
+ * Manages the feature configuration of a specific server.
+ *
+ * Access via `server.features`.
+ *
+ * @example
+ * ```ts ignore
+ * const features = await server.features.list();
+ * await server.features.setEnabled('minecraft.players', true);
+ * await server.features.update('minecraft.players', { settings: { show_players_online: false } });
+ * ```
+ */
+export declare class ServerFeaturesManager {
+    private readonly serverId;
+    private readonly http;
+    /** @internal */
+    constructor(serverId: NanoID, http: HttpClient);
+    /** List the features available to this server, with their resolved state. */
+    list(): Promise<EffectiveFeature[]>;
+    /**
+     * Fetch a single feature's resolved state.
+     *
+     * @throws {@link ApiError} with `isNotFound === true` if the feature is not available to the server.
+     */
+    get(feature: string): Promise<EffectiveFeature>;
+    /**
+     * Update a feature's settings or variant.
+     *
+     * A `null` setting value, or a `null` variant, resets it to the feature default.
+     *
+     * @param feature The feature key.
+     * @param payload The settings and/or variant to change.
+     */
+    update(feature: string, payload: {
+        settings?: Record<string, unknown>;
+        variant?: string | null;
+    }): Promise<EffectiveFeature>;
+    /**
+     * Enable or disable a feature.
+     *
+     * @throws {@link ApiError} with `isForbidden === true` if the feature is locked.
+     */
+    setEnabled(feature: string, enabled: boolean): Promise<EffectiveFeature>;
+    /**
+     * Enable or disable several features at once.
+     *
+     * @param features A map of feature key to desired enabled state.
+     */
+    setEnabledBulk(features: Record<string, boolean>): Promise<EffectiveFeature[]>;
+}
+//# sourceMappingURL=features.d.ts.map

package/esm/src/resources/servers/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../../../src/src/resources/servers/features.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,8EAA8E;AAC9E,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAEtD,4GAA4G;AAC5G,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAExD,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC9B,oCAAoC;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,4FAA4F;IAC5F,MAAM,EAAE,oBAAoB,CAAC;IAC7B,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,gFAAgF;AAChF,MAAM,WAAW,gBAAgB;IAChC,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,qEAAqE;IACrE,MAAM,EAAE,OAAO,CAAC;IAChB,wDAAwD;IACxD,MAAM,EAAE,aAAa,CAAC;IACtB,iEAAiE;IACjE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACzC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,qBAAqB;IAGhC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHtB,gBAAgB;gBAEE,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU;IAGlC,6EAA6E;IACtE,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAI1C;;;;OAIG;IACI,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAItD;;;;;;;OAOG;IACI,MAAM,CACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GACtE,OAAO,CAAC,gBAAgB,CAAC;IAO5B;;;;OAIG;IACI,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAO/E;;;;OAIG;IACI,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAGrF"}

package/esm/src/resources/servers/features.js

@@ -0,0 +1,60 @@
+/**
+ * Manages the feature configuration of a specific server.
+ *
+ * Access via `server.features`.
+ *
+ * @example
+ * ```ts ignore
+ * const features = await server.features.list();
+ * await server.features.setEnabled('minecraft.players', true);
+ * await server.features.update('minecraft.players', { settings: { show_players_online: false } });
+ * ```
+ */
+export class ServerFeaturesManager {
+    serverId;
+    http;
+    /** @internal */
+    constructor(serverId, http) {
+        this.serverId = serverId;
+        this.http = http;
+    }
+    /** List the features available to this server, with their resolved state. */
+    list() {
+        return this.http.get(`/servers/${this.serverId}/features`);
+    }
+    /**
+     * Fetch a single feature's resolved state.
+     *
+     * @throws {@link ApiError} with `isNotFound === true` if the feature is not available to the server.
+     */
+    get(feature) {
+        return this.http.get(`/servers/${this.serverId}/features/${encodeURIComponent(feature)}`);
+    }
+    /**
+     * Update a feature's settings or variant.
+     *
+     * A `null` setting value, or a `null` variant, resets it to the feature default.
+     *
+     * @param feature The feature key.
+     * @param payload The settings and/or variant to change.
+     */
+    update(feature, payload) {
+        return this.http.patch(`/servers/${this.serverId}/features/${encodeURIComponent(feature)}`, payload);
+    }
+    /**
+     * Enable or disable a feature.
+     *
+     * @throws {@link ApiError} with `isForbidden === true` if the feature is locked.
+     */
+    setEnabled(feature, enabled) {
+        return this.http.post(`/servers/${this.serverId}/features/${encodeURIComponent(feature)}`, { enabled });
+    }
+    /**
+     * Enable or disable several features at once.
+     *
+     * @param features A map of feature key to desired enabled state.
+     */
+    setEnabledBulk(features) {
+        return this.http.post(`/servers/${this.serverId}/features`, { features });
+    }
+}

package/esm/src/resources/servers/files.d.ts

@@ -1,4 +1,5 @@
-import type { NanoID } from '../../types.js';
+import { ServerJob } from './jobs.js';
+import type { NodeClient } from './node-client.js';
 import type { FileEntryData } from './types.js';
 /**
  * A single file or directory entry in a server's file system.
@@ -26,58 +27,42 @@ export declare class FileEntry {
     constructor(data: FileEntryData);
 }
 /**
- * Manages file system operations for a specific server via the Whisker node daemon API.
+ * Manages file system operations for a specific server via the Whisker node daemon.
  *
- * File operations communicate directly with the node daemon.
- * The node URL is resolved lazily on first use and cached for subsequent calls.
+ * File operations communicate directly with the node daemon. Archive operations
+ * (`compress`/`decompress`) may run as a background {@link ServerJob} when they exceed
+ * the daemon's fast-path window.
  *
  * @example
  * ```ts ignore
  * const entries = await server.files.list('/');
- * const content = await server.files.read('/server.properties');
- * await server.files.write('/server.properties', 'motd=Hello World\n');
- * await server.files.move({ from: '/old.txt', to: '/new.txt' });
- * await server.files.delete(['/backup.zip']);
+ * await server.files.write('/motd.txt', 'Hello World');
+ * const result = await server.files.compress(['/world'], '/');
+ * if (result instanceof ServerJob) await result.wait();
  * ```
  */
 export declare class ServerFilesManager {
-    private readonly serverId;
-    private readonly token;
-    private readonly resolveNodeUrl;
-    private nodeUrl?;
-    /**
-     * @param serverId      The server's NanoID.
-     * @param token         Bearer token for node authentication.
-     * @param resolveNodeUrl Async function that returns the daemon base URL for this server's node.
-     */
-    constructor(serverId: NanoID, token: string, resolveNodeUrl: () => Promise<string>);
-    /** Lazily resolve and cache the node daemon URL. */
-    private getNodeUrl;
-    /** Build a full node API URL for a file path endpoint. */
-    private buildFileUrl;
-    /** Shared auth headers for node requests. */
-    private get authHeaders();
-    /** Perform a raw fetch to the node and throw on non-2xx. */
-    private nodeFetch;
+    private readonly node;
+    /** @internal */
+    constructor(node: NodeClient);
+    /** Normalize a path to an absolute `/files` endpoint. */
+    private endpoint;
     /**
      * List the contents of a directory.
      *
      * @param path Absolute path to the directory, e.g. `"/"` or `"/plugins"`.
-     * @returns An array of {@link FileEntry} objects.
      */
     list(path: string): Promise<FileEntry[]>;
     /**
      * Read the text content of a file.
      *
      * @param path Absolute path to the file, e.g. `"/server.properties"`.
-     * @returns The file content as a UTF-8 string.
      */
     read(path: string): Promise<string>;
     /**
      * Read the raw binary content of a file.
      *
      * @param path Absolute path to the file.
-     * @returns The file content as an `ArrayBuffer`.
      */
     readBinary(path: string): Promise<ArrayBuffer>;
     /**
@@ -106,56 +91,59 @@ export declare class ServerFilesManager {
      *
      * @param from Absolute source path.
      * @param to   Absolute destination path.
+     * @param root Root directory for resolving relative paths. Defaults to `"/"`.
      */
-    move(from: string, to: string): Promise<void>;
+    move(from: string, to: string, root?: string): Promise<void>;
     /**
-     * Copy a file or directory to a new location.
+     * Copy a file or directory to a new path.
      *
-     * @param source   Absolute path of the source file or directory.
-     * @param location Absolute path of the destination directory.
+     * @param from Absolute source path.
+     * @param to   Absolute destination path.
+     * @param root Root directory for resolving relative paths. Defaults to `"/"`.
      */
-    copy(source: string, location: string): Promise<void>;
+    copy(from: string, to: string, root?: string): Promise<void>;
     /**
      * Create an empty file or directory.
      *
      * @param path      Absolute path of the new file or directory.
      * @param directory When `true`, creates a directory instead of a file.
+     * @param root      Root directory for resolving relative paths. Defaults to `"/"`.
      */
-    create(path: string, directory?: boolean): Promise<void>;
+    create(path: string, directory?: boolean, root?: string): Promise<void>;
     /**
-     * Compress one or more files into an archive.
+     * Compress one or more paths into a server-named archive.
+     *
+     * Resolves to a {@link FileEntry} for the created archive when the daemon finishes
+     * within its fast-path window, or a {@link ServerJob} to track when it runs longer.
      *
-     * @param files      Array of absolute paths to include in the archive.
-     * @param name       Name of the output archive file, e.g. `"backup.tar.gz"`.
-     * @param rootPath   Root directory for resolving relative paths. Defaults to `"/"`.
+     * @param paths Absolute paths to include in the archive.
+     * @param root  Root directory for resolving the paths. Defaults to `"/"`.
      */
-    compress(files: string[], name: string, rootPath?: string): Promise<void>;
+    compress(paths: string[], root?: string): Promise<FileEntry | ServerJob>;
     /**
      * Decompress (extract) an archive file.
      *
-     * @param file      Absolute path to the archive to extract.
-     * @param rootPath  Directory to extract the archive into. Defaults to `"/"`.
+     * Resolves to `null` when the daemon finishes within its fast-path window, or a
+     * {@link ServerJob} to track when it runs longer.
+     *
+     * @param path Absolute path to the archive to extract.
+     * @param root Directory to extract the archive into. Defaults to `"/"`.
      */
-    decompress(file: string, rootPath?: string): Promise<void>;
+    decompress(path: string, root?: string): Promise<ServerJob | null>;
     /**
      * Change the permissions (chmod) of one or more files.
      *
-     * @param entries    Array of `{ file, mode }` objects.
-     * @param rootPath   Root directory for resolving paths. Defaults to `"/"`.
-     *
-     * @example
-     * ```ts ignore
-     * await server.files.chmod([{ file: 'start.sh', mode: '755' }]);
-     * ```
+     * @param entries Array of `{ file, mode }` objects, e.g. `[{ file: 'start.sh', mode: '755' }]`.
+     * @param root    Root directory for resolving paths. Defaults to `"/"`.
      */
     chmod(entries: {
         file: string;
         mode: string;
-    }[], rootPath?: string): Promise<void>;
+    }[], root?: string): Promise<void>;
     /**
-     * Upload a file to the server using multipart form data.
+     * Upload a file using multipart form data.
      *
-     * @param path     Absolute directory path to upload the file into.
+     * @param path     Absolute directory path to upload into.
      * @param filename The name for the uploaded file.
      * @param content  The file content as a `Blob`, `File`, or `ArrayBuffer`.
      */

package/esm/src/resources/servers/files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../../src/src/resources/servers/files.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../../src/src/resources/servers/files.ts"],"names":[],"mappings":"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"}

package/esm/src/resources/servers/files.js

@@ -1,4 +1,4 @@
-import { ApiError } from '../../errors.js';
+import { ServerJob } from './jobs.js';
 /**
  * A single file or directory entry in a server's file system.
  */
@@ -35,77 +35,37 @@ export class FileEntry {
     }
 }
 /**
- * Manages file system operations for a specific server via the Whisker node daemon API.
+ * Manages file system operations for a specific server via the Whisker node daemon.
  *
- * File operations communicate directly with the node daemon.
- * The node URL is resolved lazily on first use and cached for subsequent calls.
+ * File operations communicate directly with the node daemon. Archive operations
+ * (`compress`/`decompress`) may run as a background {@link ServerJob} when they exceed
+ * the daemon's fast-path window.
  *
  * @example
  * ```ts ignore
  * const entries = await server.files.list('/');
- * const content = await server.files.read('/server.properties');
- * await server.files.write('/server.properties', 'motd=Hello World\n');
- * await server.files.move({ from: '/old.txt', to: '/new.txt' });
- * await server.files.delete(['/backup.zip']);
+ * await server.files.write('/motd.txt', 'Hello World');
+ * const result = await server.files.compress(['/world'], '/');
+ * if (result instanceof ServerJob) await result.wait();
  * ```
  */
 export class ServerFilesManager {
-    serverId;
-    token;
-    resolveNodeUrl;
-    nodeUrl;
-    /**
-     * @param serverId      The server's NanoID.
-     * @param token         Bearer token for node authentication.
-     * @param resolveNodeUrl Async function that returns the daemon base URL for this server's node.
-     */
-    constructor(serverId, token, resolveNodeUrl) {
-        this.serverId = serverId;
-        this.token = token;
-        this.resolveNodeUrl = resolveNodeUrl;
-    }
-    /** Lazily resolve and cache the node daemon URL. */
-    async getNodeUrl() {
-        if (!this.nodeUrl)
-            this.nodeUrl = await this.resolveNodeUrl();
-        return this.nodeUrl;
-    }
-    /** Build a full node API URL for a file path endpoint. */
-    async buildFileUrl(endpoint) {
-        const base = await this.getNodeUrl();
-        return `${base}/api/servers/${this.serverId}/files${endpoint}`;
-    }
-    /** Shared auth headers for node requests. */
-    get authHeaders() {
-        return { 'Authorization': `Bearer ${this.token}` };
+    node;
+    /** @internal */
+    constructor(node) {
+        this.node = node;
     }
-    /** Perform a raw fetch to the node and throw on non-2xx. */
-    async nodeFetch(url, init = {}) {
-        const res = await globalThis.fetch(url, {
-            ...init,
-            headers: { ...this.authHeaders, ...init.headers },
-        });
-        if (!res.ok) {
-            let message = `HTTP ${res.status}`;
-            try {
-                const body = await res.json();
-                if (typeof body.error === 'string')
-                    message = body.error;
-            }
-            catch { /* ignore */ }
-            throw new ApiError({ message, status: res.status });
-        }
-        return res;
+    /** Normalize a path to an absolute `/files` endpoint. */
+    endpoint(path) {
+        return '/files' + (path.startsWith('/') ? path : `/${path}`);
     }
     /**
      * List the contents of a directory.
      *
      * @param path Absolute path to the directory, e.g. `"/"` or `"/plugins"`.
-     * @returns An array of {@link FileEntry} objects.
      */
     async list(path) {
-        const url = await this.buildFileUrl(path.startsWith('/') ? path : `/${path}`);
-        const res = await this.nodeFetch(url);
+        const res = await this.node.fetch(this.endpoint(path));
         const data = await res.json();
         return data.map((e) => new FileEntry(e));
     }
@@ -113,22 +73,18 @@ export class ServerFilesManager {
      * Read the text content of a file.
      *
      * @param path Absolute path to the file, e.g. `"/server.properties"`.
-     * @returns The file content as a UTF-8 string.
      */
     async read(path) {
-        const url = await this.buildFileUrl(path.startsWith('/') ? path : `/${path}`);
-        const res = await this.nodeFetch(url);
+        const res = await this.node.fetch(this.endpoint(path));
         return res.text();
     }
     /**
      * Read the raw binary content of a file.
      *
      * @param path Absolute path to the file.
-     * @returns The file content as an `ArrayBuffer`.
      */
     async readBinary(path) {
-        const url = await this.buildFileUrl(path.startsWith('/') ? path : `/${path}`);
-        const res = await this.nodeFetch(url);
+        const res = await this.node.fetch(this.endpoint(path));
         return res.arrayBuffer();
     }
     /**
@@ -138,8 +94,7 @@ export class ServerFilesManager {
      * @param content The UTF-8 text content to write.
      */
     async write(path, content) {
-        const url = await this.buildFileUrl(path.startsWith('/') ? path : `/${path}`);
-        await this.nodeFetch(url, {
+        await this.node.fetch(this.endpoint(path), {
             method: 'PUT',
             body: content,
             headers: { 'Content-Type': 'text/plain' },
@@ -153,9 +108,8 @@ export class ServerFilesManager {
      * @param contentType MIME type of the content.
      */
     async writeBinary(path, content, contentType) {
-        const url = await this.buildFileUrl(path.startsWith('/') ? path : `/${path}`);
         const body = content instanceof ArrayBuffer ? new Uint8Array(content) : content;
-        await this.nodeFetch(url, {
+        await this.node.fetch(this.endpoint(path), {
             method: 'PUT',
             body: body,
             headers: { 'Content-Type': contentType },
@@ -167,38 +121,33 @@ export class ServerFilesManager {
      * @param paths An array of absolute paths to delete.
      */
     async delete(paths) {
-        const url = await this.buildFileUrl('');
-        await this.nodeFetch(url, {
-            method: 'DELETE',
-            body: JSON.stringify({ root: '/', files: paths }),
-            headers: { 'Content-Type': 'application/json' },
-        });
+        await Promise.all(paths.map((p) => this.node.fetch(this.endpoint(p), { method: 'DELETE' })));
     }
     /**
      * Move (rename) a file or directory.
      *
      * @param from Absolute source path.
      * @param to   Absolute destination path.
+     * @param root Root directory for resolving relative paths. Defaults to `"/"`.
      */
-    async move(from, to) {
-        const url = await this.buildFileUrl('/move');
-        await this.nodeFetch(url, {
+    async move(from, to, root = '/') {
+        await this.node.fetch('/files/move', {
             method: 'POST',
-            body: JSON.stringify({ files: [{ from, to }] }),
+            body: JSON.stringify({ root, Paths: { [from]: to } }),
             headers: { 'Content-Type': 'application/json' },
         });
     }
     /**
-     * Copy a file or directory to a new location.
+     * Copy a file or directory to a new path.
      *
-     * @param source   Absolute path of the source file or directory.
-     * @param location Absolute path of the destination directory.
+     * @param from Absolute source path.
+     * @param to   Absolute destination path.
+     * @param root Root directory for resolving relative paths. Defaults to `"/"`.
      */
-    async copy(source, location) {
-        const url = await this.buildFileUrl('/copy');
-        await this.nodeFetch(url, {
+    async copy(from, to, root = '/') {
+        await this.node.fetch('/files/copy', {
             method: 'POST',
-            body: JSON.stringify({ location, files: [source] }),
+            body: JSON.stringify({ root, Paths: { [from]: to } }),
             headers: { 'Content-Type': 'application/json' },
         });
     }
@@ -207,75 +156,84 @@ export class ServerFilesManager {
      *
      * @param path      Absolute path of the new file or directory.
      * @param directory When `true`, creates a directory instead of a file.
+     * @param root      Root directory for resolving relative paths. Defaults to `"/"`.
      */
-    async create(path, directory = false) {
-        const url = await this.buildFileUrl('/create');
-        await this.nodeFetch(url, {
+    async create(path, directory = false, root = '/') {
+        await this.node.fetch('/files/create', {
             method: 'POST',
-            body: JSON.stringify({ name: path, directory }),
+            body: JSON.stringify({ root, Paths: { [path]: { type: directory ? 'directory' : 'file' } } }),
             headers: { 'Content-Type': 'application/json' },
         });
     }
     /**
-     * Compress one or more files into an archive.
+     * Compress one or more paths into a server-named archive.
+     *
+     * Resolves to a {@link FileEntry} for the created archive when the daemon finishes
+     * within its fast-path window, or a {@link ServerJob} to track when it runs longer.
      *
-     * @param files      Array of absolute paths to include in the archive.
-     * @param name       Name of the output archive file, e.g. `"backup.tar.gz"`.
-     * @param rootPath   Root directory for resolving relative paths. Defaults to `"/"`.
+     * @param paths Absolute paths to include in the archive.
+     * @param root  Root directory for resolving the paths. Defaults to `"/"`.
      */
-    async compress(files, name, rootPath = '/') {
-        const url = await this.buildFileUrl('/compress');
-        await this.nodeFetch(url, {
+    async compress(paths, root = '/') {
+        const res = await this.node.fetch('/files/compress', {
             method: 'POST',
-            body: JSON.stringify({ root_path: rootPath, files, name }),
+            body: JSON.stringify({ root, paths }),
             headers: { 'Content-Type': 'application/json' },
         });
+        if (res.status === 202) {
+            const { job_id } = await res.json();
+            return new ServerJob({ id: job_id }, this.node);
+        }
+        return new FileEntry(await res.json());
     }
     /**
      * Decompress (extract) an archive file.
      *
-     * @param file      Absolute path to the archive to extract.
-     * @param rootPath  Directory to extract the archive into. Defaults to `"/"`.
+     * Resolves to `null` when the daemon finishes within its fast-path window, or a
+     * {@link ServerJob} to track when it runs longer.
+     *
+     * @param path Absolute path to the archive to extract.
+     * @param root Directory to extract the archive into. Defaults to `"/"`.
      */
-    async decompress(file, rootPath = '/') {
-        const url = await this.buildFileUrl('/decompress');
-        await this.nodeFetch(url, {
+    async decompress(path, root = '/') {
+        const res = await this.node.fetch('/files/decompress', {
             method: 'POST',
-            body: JSON.stringify({ root_path: rootPath, file }),
+            body: JSON.stringify({ root, path }),
             headers: { 'Content-Type': 'application/json' },
         });
+        if (res.status === 202) {
+            const { job_id } = await res.json();
+            return new ServerJob({ id: job_id }, this.node);
+        }
+        return null;
     }
     /**
      * Change the permissions (chmod) of one or more files.
      *
-     * @param entries    Array of `{ file, mode }` objects.
-     * @param rootPath   Root directory for resolving paths. Defaults to `"/"`.
-     *
-     * @example
-     * ```ts ignore
-     * await server.files.chmod([{ file: 'start.sh', mode: '755' }]);
-     * ```
+     * @param entries Array of `{ file, mode }` objects, e.g. `[{ file: 'start.sh', mode: '755' }]`.
+     * @param root    Root directory for resolving paths. Defaults to `"/"`.
      */
-    async chmod(entries, rootPath = '/') {
-        const url = await this.buildFileUrl('/chmod');
-        await this.nodeFetch(url, {
+    async chmod(entries, root = '/') {
+        const paths = {};
+        for (const entry of entries)
+            paths[entry.file] = { mode: entry.mode };
+        await this.node.fetch('/files/chmod', {
             method: 'POST',
-            body: JSON.stringify({ root_path: rootPath, files: entries }),
+            body: JSON.stringify({ root, paths }),
             headers: { 'Content-Type': 'application/json' },
         });
     }
     /**
-     * Upload a file to the server using multipart form data.
+     * Upload a file using multipart form data.
      *
-     * @param path     Absolute directory path to upload the file into.
+     * @param path     Absolute directory path to upload into.
      * @param filename The name for the uploaded file.
      * @param content  The file content as a `Blob`, `File`, or `ArrayBuffer`.
      */
     async upload(path, filename, content) {
-        const url = await this.buildFileUrl(`/upload?directory=${encodeURIComponent(path)}`);
         const form = new FormData();
         const blob = content instanceof ArrayBuffer ? new Blob([content]) : content;
         form.append('files', blob, filename);
-        await this.nodeFetch(url, { method: 'POST', body: form });
+        await this.node.fetch(`/files/upload?directory=${encodeURIComponent(path)}`, { method: 'POST', body: form });
     }
 }