@meowpanel/api 0.1.0-alpha.11 → 1.0.0-beta.2

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

@@ -0,0 +1,126 @@
+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 { 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 };
+/**
+ * Valid include keys for server endpoints.
+ *
+ * Each include adds extra data to the response (at a small performance cost).
+ * 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';
+/**
+ * Maps each {@link ServerInclude} key to the field(s) it guarantees on the {@link Server} instance.
+ *
+ * Used by {@link ServerWith} to narrow the return type based on the requested includes.
+ */
+interface ServerIncludeMap {
+    group: {
+        group: ServerGroup;
+    };
+    egg: {
+        egg: Egg;
+    };
+    status: {
+        status: ServerStatus;
+    };
+    build: {
+        build: ServerBuild;
+    };
+    startup: {
+        startup: ServerStartup;
+    };
+    allocations: {
+        allocationPorts: ServerAllocationsData;
+    };
+    profiles: {
+        profiles: ServerProfileData[];
+    };
+}
+/**
+ * A {@link Server} with specific include fields guaranteed to be populated.
+ *
+ * @example
+ * ```ts ignore
+ * // server.group is `ServerGroup`, not `ServerGroup | undefined`
+ * type S = ServerWith<['group', 'status']>;
+ * ```
+ */
+export type ServerWith<I extends readonly ServerInclude[] = []> = ResourceWith<Server, ServerIncludeMap, I>;
+/** Payload for creating a new server. */
+export interface CreateServerPayload {
+    name: string;
+    nodeId: NanoID;
+    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;
+    };
+    eggId: NanoID;
+    allocationPrimaryId: NanoID;
+    imageOverride?: string;
+    forceOutgoingIp?: boolean;
+    oomType?: 'docker';
+    shouldSkipEggScripts?: boolean;
+    startupCommandOverride?: string;
+    expiresAt?: Date;
+}
+export interface ServerEvents {
+    created: Server;
+    updated: Server;
+    deleted: NanoID;
+}
+/**
+ * Namespace for server management.
+ *
+ * Access via `api.servers`.
+ *
+ * @example
+ * ```ts ignore
+ * // Type-safe includes: group and status are guaranteed on the result
+ * const servers = await api.servers.list({ include: ['group', 'status'] });
+ * servers.data[0].group; // ServerGroup (not undefined)
+ * servers.data[0].status; // ServerStatus (not undefined)
+ *
+ * // Without includes: include-gated fields are undefined
+ * const bare = await api.servers.list();
+ * bare.data[0].groupId; // NanoID (always present)
+ * bare.data[0].group;   // ServerGroup | undefined
+ *
+ * // Events
+ * api.servers.on('created', (server) => console.log('New server:', server.name));
+ * ```
+ */
+export declare class ServersNamespace extends ResourceNamespace<Server, ServerEvents> {
+    private readonly nodeUrlCache;
+    /** @internal */
+    constructor(http: HttpClient);
+    /** Resolve the node daemon URL: groupId → nodeId → node connection URL. */
+    private resolveNodeUrl;
+    private makeServer;
+    /** Fetch a paginated list of servers. */
+    list<const I extends readonly ServerInclude[] = []>(opts?: ListOptions & IncludeOptions<ServerInclude, I>): Promise<Paginated<ServerWith<I>>>;
+    /** Fetch a single server by ID. */
+    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(id: NanoID, payload: UpdateServerPayload): Promise<Server>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,135 @@
+import { ResourceNamespace } from '../../namespace.js';
+import { joinIncludes, toNanoID } from '../../types.js';
+import { Server } from './server.js';
+/**
+ * Namespace for server management.
+ *
+ * Access via `api.servers`.
+ *
+ * @example
+ * ```ts ignore
+ * // Type-safe includes: group and status are guaranteed on the result
+ * const servers = await api.servers.list({ include: ['group', 'status'] });
+ * servers.data[0].group; // ServerGroup (not undefined)
+ * servers.data[0].status; // ServerStatus (not undefined)
+ *
+ * // Without includes: include-gated fields are undefined
+ * const bare = await api.servers.list();
+ * bare.data[0].groupId; // NanoID (always present)
+ * bare.data[0].group;   // ServerGroup | undefined
+ *
+ * // Events
+ * api.servers.on('created', (server) => console.log('New server:', server.name));
+ * ```
+ */
+export class ServersNamespace extends ResourceNamespace {
+    nodeUrlCache = new Map();
+    /** @internal */
+    constructor(http) {
+        super(http);
+    }
+    /** Resolve the node daemon URL: groupId → nodeId → node connection URL. */
+    resolveNodeUrl(serverId, groupId) {
+        return async () => {
+            if (this.nodeUrlCache.has(serverId))
+                return this.nodeUrlCache.get(serverId);
+            // Fetch the group to get the nodeId, then the node connection URL
+            const groupData = await this.http.get(`/servers/groups/${groupId}`);
+            const nodeId = toNanoID(groupData.node_id);
+            const nodeData = await this.http.get(`/nodes/${nodeId}`, { params: { include: 'connection' } });
+            const url = nodeData.connection?.url;
+            if (!url)
+                throw new Error(`Node connection URL is not available for server ${serverId}`);
+            this.nodeUrlCache.set(serverId, url);
+            return url;
+        };
+    }
+    makeServer(data) {
+        const id = toNanoID(data.id);
+        const groupId = toNanoID(data.group_id);
+        return new Server(data, this.http, this.resolveNodeUrl(id, groupId), () => this.notifySubs());
+    }
+    /** Fetch a paginated list of servers. */
+    async list(opts = {}) {
+        const extra = {};
+        const include = joinIncludes(opts);
+        if (include)
+            extra['include'] = include;
+        const result = await this.http.list('/servers', opts, extra);
+        const servers = result.data.map((d) => this.makeServer(d));
+        this.setCache(servers);
+        return { ...result, data: servers };
+    }
+    /** Fetch a single server by ID. */
+    async get(id, opts = {}) {
+        const params = {};
+        const include = joinIncludes(opts);
+        if (include)
+            params['include'] = include;
+        const data = await this.http.get(`/servers/${id}`, { params });
+        return this.makeServer(data);
+    }
+    /** Create a new server (also creates its server group). */
+    async create(payload) {
+        const body = {
+            name: payload.name,
+            node_id: payload.nodeId,
+            description: payload.description,
+            notes: payload.notes,
+            limits: {
+                ram_mb: payload.limits.ramMb,
+                swap_mb: payload.limits.swapMb,
+                storage_mb: payload.limits.storageMb,
+                weight_io: payload.limits.weightIo,
+                cpu_percent: payload.limits.cpuPercent,
+                cpu_threads: payload.limits.cpuThreads,
+                backup: payload.limits.backup,
+                database: payload.limits.database,
+                allocation: payload.limits.allocation,
+            },
+            egg_id: payload.eggId,
+            allocation_primary_id: payload.allocationPrimaryId,
+            image_override: payload.imageOverride,
+            force_outgoing_ip: payload.forceOutgoingIp,
+            oom_type: payload.oomType,
+            should_skip_egg_scripts: payload.shouldSkipEggScripts,
+            startup_command_override: payload.startupCommandOverride,
+            expires_at: payload.expiresAt,
+        };
+        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. */
+    async update(id, payload) {
+        const body = {};
+        if (payload.name !== undefined)
+            body['name'] = payload.name;
+        if (payload.description !== undefined)
+            body['description'] = payload.description;
+        if (payload.notes !== undefined)
+            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) {
+            existing.applyData(data);
+            this.upsertCache(existing);
+            this.emit('updated', existing);
+            return existing;
+        }
+        const server = this.makeServer(data);
+        this.upsertCache(server);
+        this.emit('updated', server);
+        return server;
+    }
+}

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

@@ -0,0 +1,138 @@
+import type { HttpClient } from '../../http.js';
+import { ReactiveResource } from '../../reactive.js';
+import type { ListOptions, NanoID, Paginated } from '../../types.js';
+import type { ServerProfileData } from './types.js';
+/**
+ * A named configuration profile for a server.
+ *
+ * Profiles allow a server to switch between different file sets (e.g. different
+ * game versions or configurations) stored in separate folders.
+ *
+ * Retrieved via {@link ServerProfilesManager.list} or {@link ServerProfilesManager.get}.
+ */
+export declare class ServerProfile extends ReactiveResource {
+    private readonly serverId;
+    private readonly http;
+    /** The profile's unique NanoID. */
+    readonly id: NanoID;
+    /** Display name for this profile, e.g. `"1.20.4 Vanilla"`. */
+    name: string;
+    /** Optional description of this profile. */
+    description: string | null;
+    /** Internal notes for this profile. */
+    notes: string | null | undefined;
+    /** The folder name used to store this profile's files on disk. */
+    folder: string | null | undefined;
+    /** `true` if this is the currently active profile for the server. */
+    isActive: boolean;
+    /** When this profile was created. */
+    readonly createdAt: Date;
+    /** When this profile was last updated. */
+    updatedAt: Date;
+    /** @internal */
+    constructor(data: ServerProfileData, serverId: NanoID, http: HttpClient);
+    /**
+     * Apply raw API data to this profile instance, updating all mutable fields.
+     *
+     * Called by the constructor and by instance methods after server responses.
+     *
+     * @param data The raw API response data.
+     */
+    applyData(data: ServerProfileData): void;
+    /**
+     * Set this profile as the active profile for the server.
+     *
+     * Triggers the node to sync the server's container to this profile's folder.
+     */
+    setAsActive(): Promise<void>;
+    /**
+     * Update this profile's name, description, or notes.
+     *
+     * @param payload Fields to update.
+     */
+    update(payload: {
+        name?: string;
+        description?: string | null;
+        notes?: string | null;
+    }): Promise<void>;
+    /**
+     * Delete this profile permanently.
+     */
+    delete(): Promise<void>;
+}
+/**
+ * Manages configuration profiles for a specific server.
+ *
+ * Access via `server.profiles`.
+ *
+ * @example
+ * ```ts ignore
+ * const profiles = await server.profiles.list();
+ * const active = await server.profiles.getActive();
+ *
+ * const profile = await server.profiles.create({ name: '1.20.4', description: 'Latest stable' });
+ * await server.profiles.setActive(profile.id);
+ * ```
+ */
+export declare class ServerProfilesManager {
+    private readonly serverId;
+    private readonly http;
+    /** @internal */
+    constructor(serverId: NanoID, http: HttpClient);
+    /** Create a {@link ServerProfile} with the correct server context wired in. @internal */
+    private makeProfile;
+    /**
+     * Fetch all profiles for this server.
+     *
+     * @param opts Pagination options.
+     */
+    list(opts?: ListOptions): Promise<Paginated<ServerProfile>>;
+    /**
+     * Fetch the currently active profile.
+     *
+     * @throws {@link ApiError} with `isNotFound === true` if no profile is active.
+     */
+    getActive(): Promise<ServerProfile>;
+    /**
+     * Fetch a single profile by ID.
+     *
+     * @param profileId The profile's NanoID.
+     */
+    get(profileId: NanoID): Promise<ServerProfile>;
+    /**
+     * Create a new profile for this server.
+     *
+     * @param payload Profile creation parameters.
+     */
+    create(payload: {
+        name: string;
+        description?: string;
+        notes?: string;
+    }): Promise<ServerProfile>;
+    /**
+     * Update a profile's name, description, or notes.
+     *
+     * @param profileId The profile's NanoID.
+     * @param payload   Fields to update.
+     */
+    update(profileId: NanoID, payload: {
+        name?: string;
+        description?: string;
+        notes?: string;
+    }): Promise<ServerProfile>;
+    /**
+     * Set a profile as the active profile for this server.
+     *
+     * Triggers the node to sync the server's container to the new profile folder.
+     *
+     * @param profileId The profile's NanoID, or `null` to clear the active profile.
+     */
+    setActive(profileId: NanoID | null): Promise<ServerProfile | null>;
+    /**
+     * Delete a profile permanently.
+     *
+     * @param profileId The profile's NanoID.
+     */
+    delete(profileId: NanoID): Promise<void>;
+}
+//# sourceMappingURL=profiles.d.ts.map

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

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

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

@@ -0,0 +1,177 @@
+import { ReactiveResource } from '../../reactive.js';
+import { toNanoID } from '../../types.js';
+/**
+ * A named configuration profile for a server.
+ *
+ * Profiles allow a server to switch between different file sets (e.g. different
+ * game versions or configurations) stored in separate folders.
+ *
+ * Retrieved via {@link ServerProfilesManager.list} or {@link ServerProfilesManager.get}.
+ */
+export class ServerProfile extends ReactiveResource {
+    serverId;
+    http;
+    /** The profile's unique NanoID. */
+    id;
+    /** Display name for this profile, e.g. `"1.20.4 Vanilla"`. */
+    name;
+    /** Optional description of this profile. */
+    description;
+    /** Internal notes for this profile. */
+    notes;
+    /** The folder name used to store this profile's files on disk. */
+    folder;
+    /** `true` if this is the currently active profile for the server. */
+    isActive;
+    /** When this profile was created. */
+    createdAt;
+    /** When this profile was last updated. */
+    updatedAt;
+    /** @internal */
+    constructor(data, serverId, http) {
+        super();
+        this.serverId = serverId;
+        this.http = http;
+        this.id = toNanoID(data.id);
+        this.createdAt = new Date(data.created_at);
+        this.applyData(data);
+    }
+    /**
+     * Apply raw API data to this profile instance, updating all mutable fields.
+     *
+     * Called by the constructor and by instance methods after server responses.
+     *
+     * @param data The raw API response data.
+     */
+    applyData(data) {
+        this.name = data.name;
+        this.description = data.description ?? null;
+        this.notes = data.notes;
+        this.folder = data.folder;
+        this.isActive = data.is_active;
+        this.updatedAt = new Date(data.updated_at);
+        this.notify();
+    }
+    /**
+     * Set this profile as the active profile for the server.
+     *
+     * Triggers the node to sync the server's container to this profile's folder.
+     */
+    async setAsActive() {
+        const data = await this.http.patch(`/servers/${this.serverId}/profiles/active`, { id: this.id });
+        this.applyData(data);
+    }
+    /**
+     * Update this profile's name, description, or notes.
+     *
+     * @param payload Fields to update.
+     */
+    async update(payload) {
+        const data = await this.http.patch(`/servers/${this.serverId}/profiles/${this.id}`, payload);
+        this.applyData(data);
+    }
+    /**
+     * Delete this profile permanently.
+     */
+    async delete() {
+        await this.http.delete(`/servers/${this.serverId}/profiles/${this.id}`);
+    }
+}
+/**
+ * Manages configuration profiles for a specific server.
+ *
+ * Access via `server.profiles`.
+ *
+ * @example
+ * ```ts ignore
+ * const profiles = await server.profiles.list();
+ * const active = await server.profiles.getActive();
+ *
+ * const profile = await server.profiles.create({ name: '1.20.4', description: 'Latest stable' });
+ * await server.profiles.setActive(profile.id);
+ * ```
+ */
+export class ServerProfilesManager {
+    serverId;
+    http;
+    /** @internal */
+    constructor(serverId, http) {
+        this.serverId = serverId;
+        this.http = http;
+    }
+    /** Create a {@link ServerProfile} with the correct server context wired in. @internal */
+    makeProfile(data) {
+        return new ServerProfile(data, this.serverId, this.http);
+    }
+    /**
+     * Fetch all profiles for this server.
+     *
+     * @param opts Pagination options.
+     */
+    async list(opts = {}) {
+        const result = await this.http.list(`/servers/${this.serverId}/profiles`, opts);
+        return { ...result, data: result.data.map((d) => this.makeProfile(d)) };
+    }
+    /**
+     * Fetch the currently active profile.
+     *
+     * @throws {@link ApiError} with `isNotFound === true` if no profile is active.
+     */
+    async getActive() {
+        const data = await this.http.get(`/servers/${this.serverId}/profiles/active`);
+        return this.makeProfile(data);
+    }
+    /**
+     * Fetch a single profile by ID.
+     *
+     * @param profileId The profile's NanoID.
+     */
+    async get(profileId) {
+        const data = await this.http.get(`/servers/${this.serverId}/profiles/${profileId}`);
+        return this.makeProfile(data);
+    }
+    /**
+     * Create a new profile for this server.
+     *
+     * @param payload Profile creation parameters.
+     */
+    async create(payload) {
+        const data = await this.http.post(`/servers/${this.serverId}/profiles`, payload);
+        return this.makeProfile(data);
+    }
+    /**
+     * Update a profile's name, description, or notes.
+     *
+     * @param profileId The profile's NanoID.
+     * @param payload   Fields to update.
+     */
+    async update(profileId, payload) {
+        const data = await this.http.patch(`/servers/${this.serverId}/profiles/${profileId}`, payload);
+        return this.makeProfile(data);
+    }
+    /**
+     * Set a profile as the active profile for this server.
+     *
+     * Triggers the node to sync the server's container to the new profile folder.
+     *
+     * @param profileId The profile's NanoID, or `null` to clear the active profile.
+     */
+    async setActive(profileId) {
+        if (profileId === null) {
+            await this.http.delete(`/servers/${this.serverId}/profiles/active`);
+            return null;
+        }
+        const data = await this.http.patch(`/servers/${this.serverId}/profiles/active`, {
+            id: profileId,
+        });
+        return this.makeProfile(data);
+    }
+    /**
+     * Delete a profile permanently.
+     *
+     * @param profileId The profile's NanoID.
+     */
+    async delete(profileId) {
+        await this.http.delete(`/servers/${this.serverId}/profiles/${profileId}`);
+    }
+}