@meowpanel/api 0.3.0 → 0.5.0

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

@@ -2,10 +2,9 @@ import type { HttpClient } from '../../http.js';
 import { ResourceNamespace } from '../../namespace.js';
 import type { IncludeOptions, ListOptions, NanoID, Paginated } from '../../types.js';
 import type { ResourceWith } from '../../types.js';
-import type { ServerBuild, ServerStartup, ServerStatus } from './server.js';
+import type { ServerBuild, ServerStatus } from './server.js';
 import { Server } from './server.js';
 import type { ServerAllocationsData, ServerProfileData, UpdateServerPayload } from './types.js';
-import type { Egg } from '../eggs.js';
 import type { ServerGroup } from '../server-groups.js';
 export type { UpdateServerPayload };
 /**
@@ -15,7 +14,7 @@ export type { UpdateServerPayload };
  * When an include is requested, the corresponding field on {@link Server} is guaranteed
  * to be populated (non-undefined).
  */
-export type ServerInclude = 'group' | 'egg' | 'status' | 'build' | 'startup' | 'allocations' | 'profiles';
+export type ServerInclude = 'group' | 'status' | 'build' | 'allocations' | 'profiles';
 /**
  * Maps each {@link ServerInclude} key to the field(s) it guarantees on the {@link Server} instance.
  *
@@ -25,18 +24,12 @@ interface ServerIncludeMap {
     group: {
         group: ServerGroup;
     };
-    egg: {
-        egg: Egg;
-    };
     status: {
         status: ServerStatus;
     };
     build: {
         build: ServerBuild;
     };
-    startup: {
-        startup: ServerStartup;
-    };
     allocations: {
         allocationPorts: ServerAllocationsData;
     };
@@ -54,32 +47,49 @@ interface ServerIncludeMap {
  * ```
  */
 export type ServerWith<I extends readonly ServerInclude[] = []> = ResourceWith<Server, ServerIncludeMap, I>;
-/** Payload for creating a new server. */
+/** Resource limits for a server or server group. */
+export interface ServerLimits {
+    ramMb: number;
+    swapMb: number;
+    storageMb: number;
+    /** IO weight (1–1000). */
+    weightIo: number;
+    cpuPercent: number;
+    cpuThreads?: string;
+    backup?: number;
+    database?: number;
+    allocation?: number;
+}
+/** The initial profile (egg binding) created alongside a server. */
+export interface CreateServerProfile {
+    name: string;
+    description?: string;
+    notes?: string;
+    eggId: NanoID;
+    eggImageId: NanoID;
+    eggImageOverride?: string;
+    startupCommandOverride?: string;
+    skipInstallScripts?: boolean;
+}
+/** Payload for creating a new server (also creates its server group). */
 export interface CreateServerPayload {
     name: string;
     nodeId: NanoID;
+    /** Owner issuer reference, e.g. `"user:<id>"` or a bare id. Defaults to the caller. */
+    ownerId?: string;
     description?: string;
     notes?: string;
-    limits: {
-        ramMb: number;
-        swapMb: number;
-        storageMb: number;
-        /** IO weight (1–1000). */
-        weightIo: number;
-        cpuPercent: number;
-        cpuThreads?: string;
-        backup?: number;
-        database?: number;
-        allocation?: number;
+    limits: ServerLimits;
+    /** Primary allocation to bind, by IP and port. */
+    allocation: {
+        ip: string;
+        port: number;
     };
-    eggId: NanoID;
-    allocationPrimaryId: NanoID;
-    imageOverride?: string;
     forceOutgoingIp?: boolean;
     oomType?: 'docker';
-    shouldSkipEggScripts?: boolean;
-    startupCommandOverride?: string;
     expiresAt?: Date;
+    /** The server's initial profile. Omit to create the server without one. */
+    profile?: CreateServerProfile;
 }
 export interface ServerEvents {
     created: Server;
@@ -120,7 +130,16 @@ export declare class ServersNamespace extends ResourceNamespace<Server, ServerEv
     get<const I extends readonly ServerInclude[] = []>(id: NanoID, opts?: IncludeOptions<ServerInclude, I>): Promise<ServerWith<I>>;
     /** Create a new server (also creates its server group). */
     create(payload: CreateServerPayload): Promise<Server>;
-    /** Update a server's details, startup config, or primary allocation. */
+    /** Update a server's details or primary allocation. */
     update(id: NanoID, payload: UpdateServerPayload): Promise<Server>;
+    /**
+     * Delete a server.
+     *
+     * @param id   The server's NanoID.
+     * @param opts `force: true` deletes even when the node cannot be reached to clean up.
+     */
+    delete(id: NanoID, opts?: {
+        force?: boolean;
+    }): Promise<void>;
 }
 //# sourceMappingURL=index.d.ts.map

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

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

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

@@ -74,6 +74,7 @@ export class ServersNamespace extends ResourceNamespace {
         const body = {
             name: payload.name,
             node_id: payload.nodeId,
+            owner_id: payload.ownerId,
             description: payload.description,
             notes: payload.notes,
             limits: {
@@ -87,22 +88,30 @@ export class ServersNamespace extends ResourceNamespace {
                 database: payload.limits.database,
                 allocation: payload.limits.allocation,
             },
-            egg_id: payload.eggId,
-            allocation_primary_id: payload.allocationPrimaryId,
-            image_override: payload.imageOverride,
+            allocation: payload.allocation,
             force_outgoing_ip: payload.forceOutgoingIp,
             oom_type: payload.oomType,
-            should_skip_egg_scripts: payload.shouldSkipEggScripts,
-            startup_command_override: payload.startupCommandOverride,
             expires_at: payload.expiresAt,
         };
+        if (payload.profile) {
+            body['profile'] = {
+                name: payload.profile.name,
+                description: payload.profile.description,
+                notes: payload.profile.notes,
+                egg_id: payload.profile.eggId,
+                egg_image_id: payload.profile.eggImageId,
+                egg_image_override: payload.profile.eggImageOverride,
+                startup_command_override: payload.profile.startupCommandOverride,
+                skip_install_scripts: payload.profile.skipInstallScripts,
+            };
+        }
         const data = await this.http.post('/servers', body);
         const server = this.makeServer(data);
         this.addToCache(server);
         this.emit('created', server);
         return server;
     }
-    /** Update a server's details, startup config, or primary allocation. */
+    /** Update a server's details or primary allocation. */
     async update(id, payload) {
         const body = {};
         if (payload.name !== undefined)
@@ -113,12 +122,6 @@ export class ServersNamespace extends ResourceNamespace {
             body['notes'] = payload.notes;
         if (payload.allocationPrimary)
             body['allocation_primary'] = payload.allocationPrimary;
-        if (payload.startup) {
-            body['startup'] = {
-                command: payload.startup.command,
-                variables: payload.startup.variables,
-            };
-        }
         const data = await this.http.patch(`/servers/${id}`, body);
         const existing = this.cache.find((s) => s.id === id);
         if (existing) {
@@ -132,4 +135,15 @@ export class ServersNamespace extends ResourceNamespace {
         this.emit('updated', server);
         return server;
     }
+    /**
+     * Delete a server.
+     *
+     * @param id   The server's NanoID.
+     * @param opts `force: true` deletes even when the node cannot be reached to clean up.
+     */
+    async delete(id, opts = {}) {
+        await this.http.delete(`/servers/${id}`, opts.force ? { params: { force: 'true' } } : {});
+        this.removeFromCache(id);
+        this.emit('deleted', id);
+    }
 }

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

@@ -0,0 +1,88 @@
+import type { ISODate } from '../../types.js';
+import type { NodeClient } from './node-client.js';
+/** Lifecycle state of a daemon job. */
+export type JobStatus = 'running' | 'completed' | 'failed' | 'canceled';
+/** Raw job shape returned by the daemon. @internal */
+export interface JobData {
+    id: string;
+    server_id: string;
+    type: string;
+    status: JobStatus;
+    progress: number;
+    message: string;
+    error?: string;
+    metadata?: Record<string, unknown>;
+    created_at: ISODate;
+    updated_at: ISODate;
+}
+/** Options for {@link ServerJob.wait}. */
+export interface JobWaitOptions {
+    /** Poll interval in milliseconds. Defaults to 1000. */
+    intervalMs?: number;
+    /** Reject after this many milliseconds. Unlimited by default. */
+    timeoutMs?: number;
+    /** Abort the wait early. */
+    signal?: AbortSignal;
+}
+/**
+ * A tracked long-running operation on a server's node daemon (compress, decompress,
+ * backup, restore, install).
+ *
+ * Returned by the async file/backup operations (on the `202` path) and by
+ * {@link ServerJobsManager}. Note the daemon only reports `message`, not fine-grained
+ * `progress`, for these ops, so `progress` stays `0` until completion. Poll on
+ * {@link status} via {@link wait}, not on `progress`.
+ */
+export declare class ServerJob {
+    private readonly node;
+    readonly id: string;
+    type: string;
+    status: JobStatus;
+    progress: number;
+    message: string;
+    /** Populated when {@link status} is `failed`. */
+    error: string | undefined;
+    metadata: Record<string, unknown> | undefined;
+    createdAt: Date | undefined;
+    updatedAt: Date | undefined;
+    /** @internal */
+    constructor(data: JobData | {
+        id: string;
+    }, node: NodeClient);
+    private apply;
+    /** `true` once the job has left the `running` state. */
+    get isDone(): boolean;
+    /** Re-fetch this job's current state from the daemon. */
+    refresh(): Promise<this>;
+    /** Fetch the job's stored log output as plain text. */
+    getLog(): Promise<string>;
+    /** Request cancellation. Resolves even if the job has already finished. */
+    cancel(): Promise<void>;
+    /**
+     * Poll until the job leaves the `running` state. Resolves with this job; inspect
+     * {@link status} and {@link error} to tell completion from failure/cancellation.
+     */
+    wait(opts?: JobWaitOptions): Promise<this>;
+}
+/**
+ * Lists and tracks a server's daemon jobs.
+ *
+ * Access via `server.jobs`.
+ *
+ * @example
+ * ```ts ignore
+ * const jobs = await server.jobs.list();
+ * const job = await server.jobs.get(id);
+ * await job.wait();
+ * ```
+ */
+export declare class ServerJobsManager {
+    private readonly node;
+    /** @internal */
+    constructor(node: NodeClient);
+    /** List the server's jobs, most recent first (includes finished history). */
+    list(): Promise<ServerJob[]>;
+    /** Fetch a single job by id. */
+    get(id: string): Promise<ServerJob>;
+}
+//# sourceMappingURL=jobs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../../../src/src/resources/servers/jobs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,uCAAuC;AACvC,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAExE,sDAAsD;AACtD,MAAM,WAAW,OAAO;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;CACpB;AAED,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC9B,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,qBAAa,SAAS;IAa8B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAZxE,SAAgB,EAAE,EAAE,MAAM,CAAC;IACpB,IAAI,SAAM;IACV,MAAM,EAAE,SAAS,CAAa;IAC9B,QAAQ,SAAK;IACb,OAAO,SAAM;IACpB,iDAAiD;IAC1C,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC9C,SAAS,EAAE,IAAI,GAAG,SAAS,CAAC;IAC5B,SAAS,EAAE,IAAI,GAAG,SAAS,CAAC;IAEnC,gBAAgB;gBACG,IAAI,EAAE,OAAO,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAmB,IAAI,EAAE,UAAU;IAKpF,OAAO,CAAC,KAAK;IAWb,wDAAwD;IACxD,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED,yDAAyD;IAC5C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrC,uDAAuD;IAC1C,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAKtC,2EAA2E;IAC9D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAUpC;;;OAGG;IACU,IAAI,CAAC,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAc3D;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAiB;IAEV,OAAO,CAAC,QAAQ,CAAC,IAAI;IADxC,gBAAgB;gBACoB,IAAI,EAAE,UAAU;IAEpD,6EAA6E;IAChE,IAAI,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAMzC,gCAAgC;IACnB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;CAIhD"}

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

@@ -0,0 +1,115 @@
+import { ApiError } from '../../errors.js';
+/**
+ * A tracked long-running operation on a server's node daemon (compress, decompress,
+ * backup, restore, install).
+ *
+ * Returned by the async file/backup operations (on the `202` path) and by
+ * {@link ServerJobsManager}. Note the daemon only reports `message`, not fine-grained
+ * `progress`, for these ops, so `progress` stays `0` until completion. Poll on
+ * {@link status} via {@link wait}, not on `progress`.
+ */
+export class ServerJob {
+    node;
+    id;
+    type = '';
+    status = 'running';
+    progress = 0;
+    message = '';
+    /** Populated when {@link status} is `failed`. */
+    error;
+    metadata;
+    createdAt;
+    updatedAt;
+    /** @internal */
+    constructor(data, node) {
+        this.node = node;
+        this.id = data.id;
+        if ('status' in data)
+            this.apply(data);
+    }
+    apply(data) {
+        this.type = data.type;
+        this.status = data.status;
+        this.progress = data.progress;
+        this.message = data.message;
+        this.error = data.error;
+        this.metadata = data.metadata;
+        this.createdAt = new Date(data.created_at);
+        this.updatedAt = new Date(data.updated_at);
+    }
+    /** `true` once the job has left the `running` state. */
+    get isDone() {
+        return this.status !== 'running';
+    }
+    /** Re-fetch this job's current state from the daemon. */
+    async refresh() {
+        const res = await this.node.fetch(`/jobs/${this.id}`);
+        this.apply(await res.json());
+        return this;
+    }
+    /** Fetch the job's stored log output as plain text. */
+    async getLog() {
+        const res = await this.node.fetch(`/jobs/${this.id}/log`);
+        return res.text();
+    }
+    /** Request cancellation. Resolves even if the job has already finished. */
+    async cancel() {
+        try {
+            await this.node.fetch(`/jobs/${this.id}`, { method: 'DELETE' });
+        }
+        catch (err) {
+            // 409 means the job is no longer running, which is the state we wanted.
+            if (err instanceof ApiError && err.status === 409)
+                return;
+            throw err;
+        }
+    }
+    /**
+     * Poll until the job leaves the `running` state. Resolves with this job; inspect
+     * {@link status} and {@link error} to tell completion from failure/cancellation.
+     */
+    async wait(opts = {}) {
+        const interval = opts.intervalMs ?? 1000;
+        const deadline = opts.timeoutMs !== undefined ? Date.now() + opts.timeoutMs : undefined;
+        while (this.status === 'running') {
+            if (opts.signal?.aborted)
+                throw new DOMException('Job wait aborted', 'AbortError');
+            if (deadline !== undefined && Date.now() >= deadline) {
+                throw new Error(`Timed out waiting for job ${this.id}`);
+            }
+            await new Promise((resolve) => setTimeout(resolve, interval));
+            await this.refresh();
+        }
+        return this;
+    }
+}
+/**
+ * Lists and tracks a server's daemon jobs.
+ *
+ * Access via `server.jobs`.
+ *
+ * @example
+ * ```ts ignore
+ * const jobs = await server.jobs.list();
+ * const job = await server.jobs.get(id);
+ * await job.wait();
+ * ```
+ */
+export class ServerJobsManager {
+    node;
+    /** @internal */
+    constructor(node) {
+        this.node = node;
+    }
+    /** List the server's jobs, most recent first (includes finished history). */
+    async list() {
+        const res = await this.node.fetch('/jobs');
+        const data = await res.json();
+        return data.map((d) => new ServerJob(d, this.node));
+    }
+    /** Fetch a single job by id. */
+    async get(id) {
+        const res = await this.node.fetch(`/jobs/${id}`);
+        return new ServerJob(await res.json(), this.node);
+    }
+}

package/esm/src/resources/servers/node-client.d.ts

@@ -0,0 +1,33 @@
+import type { NanoID } from '../../types.js';
+/**
+ * Transport for direct calls to a server's Whisker node daemon.
+ *
+ * File operations, backups, jobs, and the live connection all bypass Nexus and talk
+ * to the node that hosts the server. The node URL is resolved lazily on first use and
+ * cached. All requests carry the scoped bearer token and throw {@link ApiError} on
+ * non-2xx responses.
+ *
+ * @internal
+ */
+export declare class NodeClient {
+    private readonly serverId;
+    private readonly token;
+    private readonly resolveNodeUrl;
+    private nodeUrl?;
+    constructor(serverId: NanoID, token: string, resolveNodeUrl: () => Promise<string>);
+    /** Base URL for this server on its node, e.g. `https://node:8080/api/servers/<id>`. */
+    private base;
+    /**
+     * Perform a request against the server's node daemon.
+     *
+     * @param endpoint Path under the server base, e.g. `/files/compress` or `/jobs`.
+     * @param init     Standard `RequestInit`; the bearer header is added automatically.
+     */
+    fetch(endpoint: string, init?: RequestInit): Promise<Response>;
+    /** Shorthand for a JSON POST that returns the parsed body. */
+    postJson<T>(endpoint: string, body: unknown): Promise<{
+        status: number;
+        data: T;
+    }>;
+}
+//# sourceMappingURL=node-client.d.ts.map

package/esm/src/resources/servers/node-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-client.d.ts","sourceRoot":"","sources":["../../../../src/src/resources/servers/node-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;;;GASG;AACH,qBAAa,UAAU;IAIrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,cAAc;IALhC,OAAO,CAAC,OAAO,CAAC,CAAS;gBAGP,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC;IAGvD,uFAAuF;YACzE,IAAI;IAKlB;;;;;OAKG;IACU,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAiB/E,8DAA8D;IACjD,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC;CAQ/F"}

package/esm/src/resources/servers/node-client.js

@@ -0,0 +1,61 @@
+import { ApiError } from '../../errors.js';
+/**
+ * Transport for direct calls to a server's Whisker node daemon.
+ *
+ * File operations, backups, jobs, and the live connection all bypass Nexus and talk
+ * to the node that hosts the server. The node URL is resolved lazily on first use and
+ * cached. All requests carry the scoped bearer token and throw {@link ApiError} on
+ * non-2xx responses.
+ *
+ * @internal
+ */
+export class NodeClient {
+    serverId;
+    token;
+    resolveNodeUrl;
+    nodeUrl;
+    constructor(serverId, token, resolveNodeUrl) {
+        this.serverId = serverId;
+        this.token = token;
+        this.resolveNodeUrl = resolveNodeUrl;
+    }
+    /** Base URL for this server on its node, e.g. `https://node:8080/api/servers/<id>`. */
+    async base() {
+        if (!this.nodeUrl)
+            this.nodeUrl = await this.resolveNodeUrl();
+        return `${this.nodeUrl}/api/servers/${this.serverId}`;
+    }
+    /**
+     * Perform a request against the server's node daemon.
+     *
+     * @param endpoint Path under the server base, e.g. `/files/compress` or `/jobs`.
+     * @param init     Standard `RequestInit`; the bearer header is added automatically.
+     */
+    async fetch(endpoint, init = {}) {
+        const url = (await this.base()) + endpoint;
+        const res = await globalThis.fetch(url, {
+            ...init,
+            headers: { 'Authorization': `Bearer ${this.token}`, ...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 non-JSON error bodies */ }
+            throw new ApiError({ message, status: res.status });
+        }
+        return res;
+    }
+    /** Shorthand for a JSON POST that returns the parsed body. */
+    async postJson(endpoint, body) {
+        const res = await this.fetch(endpoint, {
+            method: 'POST',
+            body: JSON.stringify(body),
+            headers: { 'Content-Type': 'application/json' },
+        });
+        return { status: res.status, data: (res.status === 204 ? undefined : await res.json()) };
+    }
+}