@meowpanel/api 0.3.0 → 0.4.0

package/script/src/resources/servers/activity.d.ts

@@ -1,14 +1,14 @@
 import type { HttpClient } from '../../http.js';
 import { ReactiveResource } from '../../reactive.js';
 import type { ListOptions, NanoID, Paginated } from '../../types.js';
-import { Member } from '../members.js';
+import { User } from '../users.js';
 import type { ActivityJobData, ActivityJobLogData, ActivityLogData } from './types.js';
 /**
  * A single log entry within an {@link ActivityJob}.
  */
 export declare class ActivityJobLog {
-    /** The type of log event, e.g. `"info"`, `"error"`. */
-    readonly type: string;
+    /** The event type identifier, e.g. `"server.power.start"`. */
+    readonly event: string;
     /** Structured metadata about this log event. */
     readonly metadata: Record<string, unknown>;
     /** When this log entry was created. */
@@ -59,10 +59,22 @@ export declare class ActivityLog extends ReactiveResource {
     serverId: NanoID | null;
     /** NanoID of the node this activity is associated with, if any. */
     nodeId: NanoID | null;
-    /** NanoID of the issuer (user or API key) who triggered this activity, or `null` for system. */
+    /** NanoID of the server group this activity is associated with, if any. */
+    groupId: NanoID | null;
+    /** NanoID of the host this activity is associated with, if any. */
+    hostId: NanoID | null;
+    /** The issuer's bare NanoID (parsed from the namespaced `issuer_id`), or `null`. */
     issuerId: NanoID | null;
-    /** The member who triggered this activity. */
-    issuer: Member | null | undefined;
+    /** The issuer's type, e.g. `'user'`, `'node'`, `'system'`, or `null`. */
+    issuerType: string | null;
+    /** The issuer who triggered this activity. */
+    issuer: User | null | undefined;
+    /** The subject's bare NanoID (parsed from the namespaced `subject_id`), or `null`. */
+    subjectId: NanoID | null;
+    /** The subject's type, or `null`. */
+    subjectType: string | null;
+    /** The subject this action was performed on. */
+    subject: User | null | undefined;
     /** The IP address the action was performed from, if available. */
     ip: string | null | undefined;
     /** Structured metadata about this activity (content depends on the event type). */
@@ -76,6 +88,36 @@ export declare class ActivityLog extends ReactiveResource {
     /** @internal */
     constructor(data: ActivityLogData);
 }
+/** Query options for an activity-log feed. */
+export interface ActivityFeedOptions {
+    page?: number;
+    perPage?: number;
+    /** Sort order by creation time. Defaults to oldest-first. */
+    sort?: 'created_at_asc' | 'created_at_desc';
+    /** Filter by event type, e.g. `"server.power.start"`. */
+    type?: string;
+    /** Filter by source IP. */
+    ip?: string;
+    /** Filter by the issuer's auth-issuer id. */
+    issuerId?: string;
+    /** Filter by the subject user's NanoID. */
+    subjectUserId?: NanoID;
+    /** Filter by server. */
+    serverId?: NanoID;
+    /** Filter by server group. */
+    groupId?: NanoID;
+    /** Filter by node. */
+    nodeId?: NanoID;
+    /** Filter by host. */
+    hostId?: NanoID;
+}
+/**
+ * Fetch an activity-log feed and map the entries to {@link ActivityLog} instances.
+ *
+ * @param extra Endpoint-specific query params (e.g. `scope`).
+ * @internal
+ */
+export declare function listActivities(http: HttpClient, path: string, opts?: ActivityFeedOptions, extra?: Record<string, string | undefined>): Promise<Paginated<ActivityLog>>;
 /**
  * Manages activity logs and async jobs for a specific server.
  *
@@ -95,9 +137,9 @@ export declare class ServerActivityManager {
     /**
      * Fetch a paginated list of activity log entries for this server.
      *
-     * @param opts Pagination options.
+     * @param opts Pagination and filter options.
      */
-    list(opts?: ListOptions): Promise<Paginated<ActivityLog>>;
+    list(opts?: ActivityFeedOptions): Promise<Paginated<ActivityLog>>;
     /**
      * Fetch a single activity log entry.
      *

package/script/src/resources/servers/activity.d.ts.map

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

package/script/src/resources/servers/activity.js

@@ -1,22 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ServerActivityManager = exports.ActivityLog = exports.ActivityJob = exports.ActivityJobLog = void 0;
+exports.listActivities = listActivities;
 const reactive_js_1 = require("../../reactive.js");
 const types_js_1 = require("../../types.js");
-const members_js_1 = require("../members.js");
+const users_js_1 = require("../users.js");
 /**
  * A single log entry within an {@link ActivityJob}.
  */
 class ActivityJobLog {
-    /** The type of log event, e.g. `"info"`, `"error"`. */
-    type;
+    /** The event type identifier, e.g. `"server.power.start"`. */
+    event;
     /** Structured metadata about this log event. */
     metadata;
     /** When this log entry was created. */
     createdAt;
     /** @internal */
     constructor(data) {
-        this.type = data.type;
+        this.event = data.event;
         this.metadata = data.metadata;
         this.createdAt = new Date(data.created_at);
     }
@@ -80,10 +81,22 @@ class ActivityLog extends reactive_js_1.ReactiveResource {
     serverId;
     /** NanoID of the node this activity is associated with, if any. */
     nodeId;
-    /** NanoID of the issuer (user or API key) who triggered this activity, or `null` for system. */
+    /** NanoID of the server group this activity is associated with, if any. */
+    groupId;
+    /** NanoID of the host this activity is associated with, if any. */
+    hostId;
+    /** The issuer's bare NanoID (parsed from the namespaced `issuer_id`), or `null`. */
     issuerId;
-    /** The member who triggered this activity. */
+    /** The issuer's type, e.g. `'user'`, `'node'`, `'system'`, or `null`. */
+    issuerType;
+    /** The issuer who triggered this activity. */
     issuer;
+    /** The subject's bare NanoID (parsed from the namespaced `subject_id`), or `null`. */
+    subjectId;
+    /** The subject's type, or `null`. */
+    subjectType;
+    /** The subject this action was performed on. */
+    subject;
     /** The IP address the action was performed from, if available. */
     ip;
     /** Structured metadata about this activity (content depends on the event type). */
@@ -101,8 +114,16 @@ class ActivityLog extends reactive_js_1.ReactiveResource {
         this.event = data.event;
         this.serverId = data.server_id ? (0, types_js_1.toNanoID)(data.server_id) : null;
         this.nodeId = data.node_id ? (0, types_js_1.toNanoID)(data.node_id) : null;
-        this.issuerId = data.issuer_id ? (0, types_js_1.toNanoID)(data.issuer_id) : null;
-        this.issuer = data.issuer ? new members_js_1.Member(data.issuer) : data.issuer;
+        this.groupId = data.group_id ? (0, types_js_1.toNanoID)(data.group_id) : null;
+        this.hostId = data.host_id ? (0, types_js_1.toNanoID)(data.host_id) : null;
+        const issuer = data.issuer_id ? (0, types_js_1.parseIssuerRef)(data.issuer_id) : null;
+        this.issuerId = issuer ? issuer.id : null;
+        this.issuerType = issuer ? issuer.type : null;
+        this.issuer = data.issuer ? new users_js_1.User(data.issuer) : data.issuer;
+        const subject = data.subject_id ? (0, types_js_1.parseIssuerRef)(data.subject_id) : null;
+        this.subjectId = subject ? subject.id : null;
+        this.subjectType = subject ? subject.type : null;
+        this.subject = data.subject ? new users_js_1.User(data.subject) : data.subject;
         this.ip = data.ip;
         this.metadata = data.metadata;
         this.jobId = data.job_id ? (0, types_js_1.toNanoID)(data.job_id) : null;
@@ -111,6 +132,28 @@ class ActivityLog extends reactive_js_1.ReactiveResource {
     }
 }
 exports.ActivityLog = ActivityLog;
+/**
+ * Fetch an activity-log feed and map the entries to {@link ActivityLog} instances.
+ *
+ * @param extra Endpoint-specific query params (e.g. `scope`).
+ * @internal
+ */
+async function listActivities(http, path, opts = {}, extra = {}) {
+    const params = {
+        sort: opts.sort,
+        type: opts.type,
+        ip: opts.ip,
+        issuer_id: opts.issuerId,
+        subject_user_id: opts.subjectUserId,
+        server_id: opts.serverId,
+        group_id: opts.groupId,
+        node_id: opts.nodeId,
+        host_id: opts.hostId,
+        ...extra,
+    };
+    const result = await http.list(path, { page: opts.page, perPage: opts.perPage }, params);
+    return { ...result, data: result.data.map((d) => new ActivityLog(d)) };
+}
 /**
  * Manages activity logs and async jobs for a specific server.
  *
@@ -133,11 +176,10 @@ class ServerActivityManager {
     /**
      * Fetch a paginated list of activity log entries for this server.
      *
-     * @param opts Pagination options.
+     * @param opts Pagination and filter options.
      */
-    async list(opts = {}) {
-        const result = await this.http.list(`/servers/${this.serverId}/activities`, opts);
-        return { ...result, data: result.data.map((d) => new ActivityLog(d)) };
+    list(opts = {}) {
+        return listActivities(this.http, `/servers/${this.serverId}/activities`, opts);
     }
     /**
      * Fetch a single activity log entry.

package/script/src/resources/servers/allocations.d.ts

@@ -37,8 +37,8 @@ export declare class ServerAllocationPort extends ReactiveResource {
     /** Optional human-readable description for this allocation, e.g. `"Voice Chat"`. */
     description: string | null;
     /** NanoID of the underlying port record. */
-    portId: NanoID | undefined;
-    /** Full metadata about the underlying port. */
+    metaId: NanoID | undefined;
+    /** Full metadata about the underlying port. Requires `?include=meta` (sent automatically). */
     meta: AllocationPortMeta | null | undefined;
     /** `true` if this is the server's primary allocation. */
     isPrimary: boolean;
@@ -73,7 +73,7 @@ export type AddAllocationEntry = {
  * ```ts ignore
  * const ports = await server.allocations.list();
  * const primary = await server.allocations.primary();
- * await server.allocations.update(portId, { description: 'Game port', isPrimary: true });
+ * await server.allocations.update(allocationId, { description: 'Game port', isPrimary: true });
  * await server.allocations.add([{ ip: '1.2.3.4', port: 25566 }]);
  * ```
  */

package/script/src/resources/servers/allocations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"allocations.d.ts","sourceRoot":"","sources":["../../../../src/src/resources/servers/allocations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAErE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAC;IACjB,sBAAsB;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC,oCAAoC;IACpC,SAAS,EAAE,IAAI,CAAC;IAChB,uCAAuC;IACvC,SAAS,EAAE,IAAI,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAqB,SAAQ,gBAAgB;IACzD,oDAAoD;IACpD,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,oFAAoF;IAC7E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,4CAA4C;IACrC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,+CAA+C;IACxC,IAAI,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,CAAC;IACnD,yDAAyD;IAClD,SAAS,EAAE,OAAO,CAAC;IAC1B,uDAAuD;IAChD,SAAS,EAAE,IAAI,CAAC;IACvB,6CAA6C;IACtC,SAAS,EAAE,IAAI,CAAC;IAEvB,mEAAmE;IACnE,IAAW,EAAE,IAAI,MAAM,GAAG,SAAS,CAElC;IAED,8CAA8C;IAC9C,IAAW,IAAI,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,qEAAqE;IACrE,IAAW,OAAO,IAAI,MAAM,GAAG,SAAS,CAGvC;IAED,gBAAgB;gBACG,IAAI,EAAE,wBAAwB;CAqBjD;AAED,6EAA6E;AAC7E,MAAM,MAAM,kBAAkB,GAC3B;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GACd;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,GAAG,MAAM,IAAI,MAAM,EAAE,CAAA;CAAE,CAAC;AAEjC;;;;;;;;;;;;GAYG;AACH,qBAAa,wBAAwB;IAGnC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHtB,gBAAgB;gBAEE,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU;IAGlC;;;;OAIG;IACU,IAAI,CAChB,IAAI,GAAE,WAAgB,GACpB,OAAO,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;IAW3C;;;;OAIG;IACU,OAAO,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAOrD;;;;OAIG;IACU,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAOrE;;;;;OAKG;IACU,MAAM,CAClB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GACpD,OAAO,CAAC,oBAAoB,CAAC;IAQhC;;;;;;;;;OASG;IACU,GAAG,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAM9D"}
+{"version":3,"file":"allocations.d.ts","sourceRoot":"","sources":["../../../../src/src/resources/servers/allocations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAErE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAC;IACjB,sBAAsB;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC,oCAAoC;IACpC,SAAS,EAAE,IAAI,CAAC;IAChB,uCAAuC;IACvC,SAAS,EAAE,IAAI,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAqB,SAAQ,gBAAgB;IACzD,oDAAoD;IACpD,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,oFAAoF;IAC7E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,4CAA4C;IACrC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,8FAA8F;IACvF,IAAI,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,CAAC;IACnD,yDAAyD;IAClD,SAAS,EAAE,OAAO,CAAC;IAC1B,uDAAuD;IAChD,SAAS,EAAE,IAAI,CAAC;IACvB,6CAA6C;IACtC,SAAS,EAAE,IAAI,CAAC;IAEvB,mEAAmE;IACnE,IAAW,EAAE,IAAI,MAAM,GAAG,SAAS,CAElC;IAED,8CAA8C;IAC9C,IAAW,IAAI,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,qEAAqE;IACrE,IAAW,OAAO,IAAI,MAAM,GAAG,SAAS,CAGvC;IAED,gBAAgB;gBACG,IAAI,EAAE,wBAAwB;CAqBjD;AAED,6EAA6E;AAC7E,MAAM,MAAM,kBAAkB,GAC3B;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GACd;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,GAAG,MAAM,IAAI,MAAM,EAAE,CAAA;CAAE,CAAC;AAEjC;;;;;;;;;;;;GAYG;AACH,qBAAa,wBAAwB;IAGnC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHtB,gBAAgB;gBAEE,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU;IAGlC;;;;OAIG;IACU,IAAI,CAChB,IAAI,GAAE,WAAgB,GACpB,OAAO,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;IAY3C;;;;OAIG;IACU,OAAO,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAQrD;;;;OAIG;IACU,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAQrE;;;;;OAKG;IACU,MAAM,CAClB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GACpD,OAAO,CAAC,oBAAoB,CAAC;IAQhC;;;;;;;;;OASG;IACU,GAAG,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAM9D"}

package/script/src/resources/servers/allocations.js

@@ -17,8 +17,8 @@ class ServerAllocationPort extends reactive_js_1.ReactiveResource {
     /** Optional human-readable description for this allocation, e.g. `"Voice Chat"`. */
     description;
     /** NanoID of the underlying port record. */
-    portId;
-    /** Full metadata about the underlying port. */
+    metaId;
+    /** Full metadata about the underlying port. Requires `?include=meta` (sent automatically). */
     meta;
     /** `true` if this is the server's primary allocation. */
     isPrimary;
@@ -45,7 +45,7 @@ class ServerAllocationPort extends reactive_js_1.ReactiveResource {
         super();
         this.id = (0, types_js_1.toNanoID)(data.id);
         this.description = data.description ?? null;
-        this.portId = data.port_id ? (0, types_js_1.toNanoID)(data.port_id) : undefined;
+        this.metaId = data.meta_id ? (0, types_js_1.toNanoID)(data.meta_id) : undefined;
         this.meta = data.meta
             ? {
                 id: (0, types_js_1.toNanoID)(data.meta.id),
@@ -73,7 +73,7 @@ exports.ServerAllocationPort = ServerAllocationPort;
  * ```ts ignore
  * const ports = await server.allocations.list();
  * const primary = await server.allocations.primary();
- * await server.allocations.update(portId, { description: 'Game port', isPrimary: true });
+ * await server.allocations.update(allocationId, { description: 'Game port', isPrimary: true });
  * await server.allocations.add([{ ip: '1.2.3.4', port: 25566 }]);
  * ```
  */
@@ -91,7 +91,7 @@ class ServerAllocationsManager {
      * @param opts Pagination options.
      */
     async list(opts = {}) {
-        const result = await this.http.list(`/servers/${this.serverId}/allocations`, opts);
+        const result = await this.http.list(`/servers/${this.serverId}/allocations`, opts, { include: 'meta' });
         return {
             ...result,
             data: result.data.map((d) => new ServerAllocationPort(d)),
@@ -103,7 +103,7 @@ class ServerAllocationsManager {
      * @throws {@link ApiError} with `isNotFound === true` if no primary allocation is set.
      */
     async primary() {
-        const data = await this.http.get(`/servers/${this.serverId}/allocations/primary`);
+        const data = await this.http.get(`/servers/${this.serverId}/allocations/primary`, { params: { include: 'meta' } });
         return new ServerAllocationPort(data);
     }
     /**
@@ -112,7 +112,7 @@ class ServerAllocationsManager {
      * @param allocationId The allocation record's NanoID.
      */
     async get(allocationId) {
-        const data = await this.http.get(`/servers/${this.serverId}/allocations/${allocationId}`);
+        const data = await this.http.get(`/servers/${this.serverId}/allocations/${allocationId}`, { params: { include: 'meta' } });
         return new ServerAllocationPort(data);
     }
     /**

package/script/src/resources/servers/backups.d.ts

@@ -0,0 +1,46 @@
+import { ServerJob } from './jobs.js';
+import type { NodeClient } from './node-client.js';
+/** Backup storage adapter. `whisker` is local node storage; `s3` is remote. */
+export type BackupAdapter = 'whisker' | 's3';
+/** Options for creating a backup. */
+export interface CreateBackupOptions {
+    /** Storage adapter to write the backup to. */
+    adapter: BackupAdapter;
+    /** Client-chosen UUID identifying the backup. */
+    uuid: string;
+    /** Newline- or glob-separated ignore patterns. */
+    ignore?: string;
+}
+/** Options for restoring a backup. */
+export interface RestoreBackupOptions {
+    /** Storage adapter the backup lives on. */
+    adapter: BackupAdapter;
+    /** Wipe the server's data directory before restoring. */
+    truncateDirectory?: boolean;
+    /** Download URL for the archive. Required for the `s3` adapter. */
+    downloadUrl?: string;
+}
+/**
+ * Create, restore, and delete backups on a server's node daemon.
+ *
+ * Create and restore run as daemon jobs, both return a {@link ServerJob} to track to
+ * completion. Access via `server.backups`.
+ *
+ * @example
+ * ```ts ignore
+ * const job = await server.backups.create({ adapter: 'whisker', uuid });
+ * await job.wait();
+ * ```
+ */
+export declare class ServerBackupsManager {
+    private readonly node;
+    /** @internal */
+    constructor(node: NodeClient);
+    /** Start a backup. Returns the job to track. */
+    create(opts: CreateBackupOptions): Promise<ServerJob>;
+    /** Restore a backup by its UUID. Returns the job to track. */
+    restore(backupUuid: string, opts: RestoreBackupOptions): Promise<ServerJob>;
+    /** Delete a backup by its UUID. Treats an already-missing backup as success. */
+    delete(backupUuid: string): Promise<void>;
+}
+//# sourceMappingURL=backups.d.ts.map

package/script/src/resources/servers/backups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backups.d.ts","sourceRoot":"","sources":["../../../../src/src/resources/servers/backups.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,IAAI,CAAC;AAE7C,qCAAqC;AACrC,MAAM,WAAW,mBAAmB;IACnC,8CAA8C;IAC9C,OAAO,EAAE,aAAa,CAAC;IACvB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,sCAAsC;AACtC,MAAM,WAAW,oBAAoB;IACpC,2CAA2C;IAC3C,OAAO,EAAE,aAAa,CAAC;IACvB,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,oBAAoB;IAEb,OAAO,CAAC,QAAQ,CAAC,IAAI;IADxC,gBAAgB;gBACoB,IAAI,EAAE,UAAU;IAEpD,gDAAgD;IACnC,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC;IASlE,8DAA8D;IACjD,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC;IASxF,gFAAgF;IACnE,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGtD"}

package/script/src/resources/servers/backups.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServerBackupsManager = void 0;
+const jobs_js_1 = require("./jobs.js");
+/**
+ * Create, restore, and delete backups on a server's node daemon.
+ *
+ * Create and restore run as daemon jobs, both return a {@link ServerJob} to track to
+ * completion. Access via `server.backups`.
+ *
+ * @example
+ * ```ts ignore
+ * const job = await server.backups.create({ adapter: 'whisker', uuid });
+ * await job.wait();
+ * ```
+ */
+class ServerBackupsManager {
+    node;
+    /** @internal */
+    constructor(node) {
+        this.node = node;
+    }
+    /** Start a backup. Returns the job to track. */
+    async create(opts) {
+        const { data } = await this.node.postJson('/backup', {
+            adapter: opts.adapter,
+            uuid: opts.uuid,
+            ignore: opts.ignore ?? '',
+        });
+        return new jobs_js_1.ServerJob({ id: data.job_id }, this.node);
+    }
+    /** Restore a backup by its UUID. Returns the job to track. */
+    async restore(backupUuid, opts) {
+        const body = { adapter: opts.adapter };
+        if (opts.truncateDirectory !== undefined)
+            body['truncate_directory'] = opts.truncateDirectory;
+        if (opts.downloadUrl !== undefined)
+            body['download_url'] = opts.downloadUrl;
+        const { data } = await this.node.postJson(`/backup/${backupUuid}/restore`, body);
+        return new jobs_js_1.ServerJob({ id: data.job_id }, this.node);
+    }
+    /** Delete a backup by its UUID. Treats an already-missing backup as success. */
+    async delete(backupUuid) {
+        await this.node.fetch(`/backup/${backupUuid}`, { method: 'DELETE' });
+    }
+}
+exports.ServerBackupsManager = ServerBackupsManager;

package/script/src/resources/servers/connection.d.ts

@@ -1,5 +1,6 @@
 import { ReactiveResource } from '../../reactive.js';
 import type { NanoID, PowerState } from '../../types.js';
+import type { JobStatus } from './jobs.js';
 /** Real-time resource utilization reported by the node. */
 export interface ServerUtilization {
     /** CPU usage as an absolute percentage (0–100+). */
@@ -17,6 +18,21 @@ export interface ServerUtilization {
     /** Server uptime in milliseconds. */
     uptimeMs: number;
 }
+/** Live progress update for a daemon job (compress, decompress, backup, restore). */
+export interface JobProgressEvent {
+    jobId: string;
+    type: string;
+    status: JobStatus;
+    progress: number;
+    message: string;
+}
+/** A single log line emitted by a daemon job. */
+export interface JobLogEvent {
+    jobId: string;
+    type: string;
+    group: string;
+    message: string;
+}
 /** Typed events emitted by {@link ServerConnection}. */
 export interface ServerConnectionEvents {
     /** A line of console output from the server process. */
@@ -25,6 +41,10 @@ export interface ServerConnectionEvents {
     status: PowerState;
     /** New resource utilization stats are available. */
     stats: ServerUtilization;
+    /** A daemon job advanced (progress, status, or message changed). */
+    job_progress: JobProgressEvent;
+    /** A daemon job emitted a log line. */
+    job_log: JobLogEvent;
 }
 /**
  * A real-time SSE connection to a specific server on its Whisker node daemon.
@@ -33,22 +53,22 @@ export interface ServerConnectionEvents {
  * Also maintains a rolling buffer of console output lines in {@link output}, pre-populated
  * with recent history fetched from the node on {@link connect}.
  *
- * Obtain a connection via {@link import('./server.ts').Server.connect}.
+ * Obtain a connection via `Server.createConnection`.
  *
  * @example
  * ```ts ignore
- * const conn = await server.connect();
+ * const conn = await server.createConnection();
  *
  * conn.on('status', (state) => console.log('Power state:', state));
  * conn.on('stats', (stats) => console.log('CPU:', stats.cpuAbsolute + '%'));
  *
- * await conn.connect();
+ * await conn.open();
  *
  * // Reactive: $conn.output is the full rolling buffer of console lines
  * // Live lines are appended automatically as they arrive over SSE
  *
  * // Later...
- * conn.disconnect();
+ * conn.close();
  * ```
  */
 export declare class ServerConnection extends ReactiveResource {
@@ -61,9 +81,9 @@ export declare class ServerConnection extends ReactiveResource {
     private sse?;
     private connected;
     /**
-     * Rolling buffer of console output lines, capped at {@link MAX_OUTPUT_LINES}.
+     * Rolling buffer of console output lines, capped at {@link ServerConnection.maxOutputLines}.
      *
-     * Pre-populated with recent history from the node when {@link connect} is called,
+     * Pre-populated with recent history from the node when {@link open} is called,
      * then appended to live as `console_output` SSE events arrive.
      *
      * Use as a reactive store: `$conn.output`.
@@ -79,7 +99,7 @@ export declare class ServerConnection extends ReactiveResource {
      * Populates {@link output} with recent history from the node, then begins streaming
      * live events.
      *
-     * Maintains only one instances of the stream.
+     * Only one stream is maintained at a time.
      *
      * @param onError Optional callback invoked if the connection drops unexpectedly.
      */

package/script/src/resources/servers/connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../../src/src/resources/servers/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEzD,2DAA2D;AAC3D,MAAM,WAAW,iBAAiB;IACjC,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,wDAAwD;AACxD,MAAM,WAAW,sBAAsB;IACtC,wDAAwD;IACxD,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,MAAM,EAAE,UAAU,CAAC;IACnB,oDAAoD;IACpD,KAAK,EAAE,iBAAiB,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;IAwBpD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAzBvB,0FAA0F;IAC1F,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAQ;IAE9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAGtB;IAEJ,OAAO,CAAC,GAAG,CAAC,CAAgB;IAC5B,OAAO,CAAC,SAAS,CAAS;IAE1B;;;;;;;OAOG;IACI,MAAM,EAAE,MAAM,EAAE,CAAM;IAE7B,gBAAgB;gBAEE,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM;IAK/B,sDAAsD;IACtD,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED;;;;;;;;;OASG;IACU,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAiClE,sDAAsD;IAC/C,KAAK,IAAI,IAAI;IAKpB;;;;;OAKG;IACI,EAAE,CAAC,CAAC,SAAS,MAAM,sBAAsB,EAC/C,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,KAAK,IAAI,GACnD,IAAI;IAWP;;;;;OAKG;IACI,GAAG,CAAC,CAAC,SAAS,MAAM,sBAAsB,EAChD,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,KAAK,IAAI,GACnD,IAAI;IAUP,qDAAqD;IAC9C,kBAAkB,IAAI,IAAI;IAIjC,iEAAiE;IACjE,OAAO,CAAC,QAAQ;CAyChB"}
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../../src/src/resources/servers/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,2DAA2D;AAC3D,MAAM,WAAW,iBAAiB;IACjC,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,qFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,wDAAwD;AACxD,MAAM,WAAW,sBAAsB;IACtC,wDAAwD;IACxD,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,MAAM,EAAE,UAAU,CAAC;IACnB,oDAAoD;IACpD,KAAK,EAAE,iBAAiB,CAAC;IACzB,oEAAoE;IACpE,YAAY,EAAE,gBAAgB,CAAC;IAC/B,uCAAuC;IACvC,OAAO,EAAE,WAAW,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;IAwBpD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAzBvB,0FAA0F;IAC1F,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAQ;IAE9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAGtB;IAEJ,OAAO,CAAC,GAAG,CAAC,CAAgB;IAC5B,OAAO,CAAC,SAAS,CAAS;IAE1B;;;;;;;OAOG;IACI,MAAM,EAAE,MAAM,EAAE,CAAM;IAE7B,gBAAgB;gBAEE,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM;IAK/B,sDAAsD;IACtD,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED;;;;;;;;;OASG;IACU,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAiClE,sDAAsD;IAC/C,KAAK,IAAI,IAAI;IAKpB;;;;;OAKG;IACI,EAAE,CAAC,CAAC,SAAS,MAAM,sBAAsB,EAC/C,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,KAAK,IAAI,GACnD,IAAI;IAWP;;;;;OAKG;IACI,GAAG,CAAC,CAAC,SAAS,MAAM,sBAAsB,EAChD,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,KAAK,IAAI,GACnD,IAAI;IAUP,qDAAqD;IAC9C,kBAAkB,IAAI,IAAI;IAIjC,iEAAiE;IACjE,OAAO,CAAC,QAAQ;CA0DhB"}

package/script/src/resources/servers/connection.js

@@ -10,22 +10,22 @@ const sse_js_1 = require("../../sse.js");
  * Also maintains a rolling buffer of console output lines in {@link output}, pre-populated
  * with recent history fetched from the node on {@link connect}.
  *
- * Obtain a connection via {@link import('./server.ts').Server.connect}.
+ * Obtain a connection via `Server.createConnection`.
  *
  * @example
  * ```ts ignore
- * const conn = await server.connect();
+ * const conn = await server.createConnection();
  *
  * conn.on('status', (state) => console.log('Power state:', state));
  * conn.on('stats', (stats) => console.log('CPU:', stats.cpuAbsolute + '%'));
  *
- * await conn.connect();
+ * await conn.open();
  *
  * // Reactive: $conn.output is the full rolling buffer of console lines
  * // Live lines are appended automatically as they arrive over SSE
  *
  * // Later...
- * conn.disconnect();
+ * conn.close();
  * ```
  */
 class ServerConnection extends reactive_js_1.ReactiveResource {
@@ -38,9 +38,9 @@ class ServerConnection extends reactive_js_1.ReactiveResource {
     sse;
     connected = false;
     /**
-     * Rolling buffer of console output lines, capped at {@link MAX_OUTPUT_LINES}.
+     * Rolling buffer of console output lines, capped at {@link ServerConnection.maxOutputLines}.
      *
-     * Pre-populated with recent history from the node when {@link connect} is called,
+     * Pre-populated with recent history from the node when {@link open} is called,
      * then appended to live as `console_output` SSE events arrive.
      *
      * Use as a reactive store: `$conn.output`.
@@ -63,7 +63,7 @@ class ServerConnection extends reactive_js_1.ReactiveResource {
      * Populates {@link output} with recent history from the node, then begins streaming
      * live events.
      *
-     * Maintains only one instances of the stream.
+     * Only one stream is maintained at a time.
      *
      * @param onError Optional callback invoked if the connection drops unexpectedly.
      */
@@ -159,6 +159,27 @@ class ServerConnection extends reactive_js_1.ReactiveResource {
                     uptimeMs: parsed.uptime_ms,
                 };
             }
+            else if (event === 'job_progress') {
+                if (typeof parsed?.job_id !== 'string')
+                    return;
+                payload = {
+                    jobId: parsed.job_id,
+                    type: parsed.type,
+                    status: parsed.status,
+                    progress: parsed.progress,
+                    message: parsed.message,
+                };
+            }
+            else if (event === 'job_log') {
+                if (typeof parsed?.job_id !== 'string')
+                    return;
+                payload = {
+                    jobId: parsed.job_id,
+                    type: parsed.type,
+                    group: parsed.group,
+                    message: parsed.message,
+                };
+            }
             else {
                 return;
             }