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

package/esm/src/resources/nodes.js

@@ -0,0 +1,352 @@
+import { ResourceNamespace } from '../namespace.js';
+import { ReactiveResource } from '../reactive.js';
+import { joinIncludes, toNanoID } from '../types.js';
+import { Member } from './members.js';
+import { ActivityLog } from './servers/activity.js';
+/**
+ * A geographic location associated with one or more nodes.
+ */
+export class NodeLocation extends ReactiveResource {
+    /** Unique NanoID of this location. */
+    id;
+    /** Full display name of the location, e.g. `"US East"`. */
+    name;
+    /** Short code used in node name generation, e.g. `"use"`. */
+    short;
+    /** Internal notes. */
+    notes;
+    /** Owner of this location record. */
+    owner;
+    /** When this location was created. */
+    createdAt;
+    /** When this location was last updated. */
+    updatedAt;
+    /** @internal */
+    constructor(data) {
+        super();
+        this.id = toNanoID(data.id);
+        this.name = data.name;
+        this.short = data.short;
+        this.notes = data.notes;
+        this.owner = data.owner ? new Member(data.owner) : undefined;
+        this.createdAt = new Date(data.created_at);
+        this.updatedAt = new Date(data.updated_at);
+    }
+}
+/**
+ * A classification type for nodes (e.g. `"Apex"`, `"Shared"`).
+ */
+export class NodeType extends ReactiveResource {
+    /** Unique NanoID of this node type. */
+    id;
+    /** Full display name of the node type, e.g. `"Apex"`. */
+    name;
+    /** Short code used in node name generation, e.g. `"a"`. */
+    short;
+    /** Internal notes. */
+    notes;
+    /** Owner of this type record. */
+    owner;
+    /** When this type was created. */
+    createdAt;
+    /** When this type was last updated. */
+    updatedAt;
+    /** @internal */
+    constructor(data) {
+        super();
+        this.id = toNanoID(data.id);
+        this.name = data.name;
+        this.short = data.short;
+        this.notes = data.notes;
+        this.owner = data.owner ? new Member(data.owner) : undefined;
+        this.createdAt = new Date(data.created_at);
+        this.updatedAt = new Date(data.updated_at);
+    }
+}
+/**
+ * A single port on a node allocation IP.
+ */
+export class NodeAllocationPort extends ReactiveResource {
+    id;
+    ip;
+    port;
+    readyProtocols;
+    isInUse;
+    notes;
+    createdAt;
+    updatedAt;
+    /** @internal */
+    constructor(data) {
+        super();
+        this.id = toNanoID(data.id);
+        this.ip = data.ip;
+        this.port = data.port;
+        this.readyProtocols = data.ready_protocols;
+        this.isInUse = data.is_in_use;
+        this.notes = data.notes;
+        this.createdAt = new Date(data.created_at);
+        this.updatedAt = new Date(data.updated_at);
+    }
+}
+/**
+ * An allocation IP assigned to a node, including its available ports.
+ */
+export class NodeAllocationIp extends ReactiveResource {
+    id;
+    ip;
+    ipAlias;
+    ports;
+    node;
+    notes;
+    createdAt;
+    updatedAt;
+    /** @internal */
+    constructor(data) {
+        super();
+        this.id = toNanoID(data.id);
+        this.ip = data.ip;
+        this.ipAlias = data.ipAlias;
+        this.ports = data.ports.map((port) => new NodeAllocationPort(port));
+        this.node = new Node(data.node);
+        this.notes = data.notes;
+        this.createdAt = new Date(data.created_at);
+        this.updatedAt = new Date(data.updated_at);
+    }
+}
+/**
+ * A MeowPanel daemon node (physical or virtual server hosting game servers).
+ *
+ * Retrieved via {@link NodesNamespace.get} or {@link NodesNamespace.list}.
+ */
+export class Node extends ReactiveResource {
+    /** The node's unique NanoID. */
+    id;
+    /**
+     * Auto-generated display name in the format `{type}{num}{location}.{hostname}`,
+     * e.g. `"a001use.host.example.com"`.
+     */
+    name;
+    /** Optional description of the node. */
+    description;
+    /** Owner of this node record. */
+    owner;
+    /** Geographic location of this node. */
+    location;
+    /** Classification type of this node. */
+    type;
+    /** Sequential number of this node within its type and location. */
+    num;
+    /** Resource limits configured for this node. */
+    limits;
+    /**
+    /** Direct connection details for the node daemon API. */
+    connection;
+    /** `true` when the node is in maintenance mode (no new servers will be started). */
+    isMaintenanceMode;
+    /** `true` when the node can be auto-deployed to. */
+    canAutoDeploy;
+    /** `true` when the node is behind a reverse proxy. */
+    isBehindProxy;
+    /** Internal notes visible to administrators. */
+    notes;
+    /** When this node was registered. */
+    createdAt;
+    /** When this node was last updated. */
+    updatedAt;
+    /** @internal */
+    constructor(data) {
+        super();
+        this.id = toNanoID(data.id);
+        this.name = data.name;
+        this.description = data.description;
+        this.owner = data.owner ? new Member(data.owner) : undefined;
+        this.location = new NodeLocation(data.location);
+        this.type = new NodeType(data.type);
+        this.num = data.num;
+        this.limits = {
+            memoryMb: data.limits.memory_mb,
+            memoryOverallocateMb: data.limits.memory_overallocate_mb,
+            diskMb: data.limits.disk_mb,
+            diskOverallocateMb: data.limits.disk_overallocate_mb,
+            uploadSizeMb: data.limits.upload_size_mb,
+        };
+        this.connection = data.connection ?? undefined;
+        this.isMaintenanceMode = data.is_maintenance_mode;
+        this.canAutoDeploy = data.can_auto_deploy;
+        this.isBehindProxy = data.is_behind_proxy;
+        this.notes = data.notes;
+        this.createdAt = new Date(data.created_at);
+        this.updatedAt = new Date(data.updated_at);
+    }
+}
+/**
+ * Manage allocation IPs and ports on a specific node.
+ */
+export class NodeAllocationsManager {
+    nodeId;
+    http;
+    /** @internal */
+    constructor(nodeId, http) {
+        this.nodeId = nodeId;
+        this.http = http;
+    }
+    async list() {
+        const data = await this.http.get(`/nodes/${this.nodeId}/allocations`);
+        return data.map((allocation) => new NodeAllocationIp(allocation));
+    }
+    async get(allocationIp) {
+        const data = await this.http.get(`/nodes/${this.nodeId}/allocations/${encodeURIComponent(allocationIp)}`);
+        return new NodeAllocationIp(data);
+    }
+    async create(payload) {
+        const data = await this.http.post(`/nodes/${this.nodeId}/allocations`, {
+            ip: payload.ip,
+            ip_alias: payload.ipAlias,
+            notes: payload.notes,
+        });
+        return new NodeAllocationIp(data);
+    }
+    async update(allocationIp, payload) {
+        const data = await this.http.patch(`/nodes/${this.nodeId}/allocations/${encodeURIComponent(allocationIp)}`, {
+            ip_alias: payload.ipAlias,
+            notes: payload.notes,
+        });
+        return new NodeAllocationIp(data);
+    }
+    async delete(allocationIp) {
+        await this.http.delete(`/nodes/${this.nodeId}/allocations/${encodeURIComponent(allocationIp)}`);
+    }
+    async createPorts(allocationIp, payload) {
+        const data = await this.http.post(`/nodes/${this.nodeId}/allocations/${encodeURIComponent(allocationIp)}/ports`, payload);
+        return new NodeAllocationIp(data);
+    }
+    async updatePort(allocationIp, port, payload) {
+        const data = await this.http.patch(`/nodes/${this.nodeId}/allocations/${encodeURIComponent(allocationIp)}/ports/${port}`, payload);
+        return new NodeAllocationIp(data);
+    }
+    async deletePort(allocationIp, port) {
+        await this.http.delete(`/nodes/${this.nodeId}/allocations/${encodeURIComponent(allocationIp)}/ports/${port}`);
+    }
+}
+/**
+ * Namespace for node management.
+ *
+ * Access via `api.nodes`.
+ *
+ * @example
+ * ```ts ignore
+ * const nodes = await api.nodes.list();
+ * const node = await api.nodes.get(id, { includeConnection: true });
+ * console.log(node.connection?.url); // "http://1.2.3.4:8080"
+ * ```
+ */
+export class NodesNamespace extends ResourceNamespace {
+    /** @internal */
+    constructor(http) {
+        super(http);
+    }
+    /**
+     * Fetch a paginated list of nodes.
+     *
+     * @param opts Pagination, search, and include options.
+     */
+    async list(opts = {}) {
+        const extra = {};
+        const include = joinIncludes(opts);
+        if (include)
+            extra['include'] = include;
+        const result = await this.http.list('/nodes', opts, extra);
+        const nodes = result.data.map((d) => new Node(d));
+        this.setCache(nodes);
+        return { ...result, data: nodes };
+    }
+    /**
+     * Fetch a single node by ID.
+     *
+     * @param id   The node's NanoID.
+     * @param opts Include options (e.g. `{ include: ['connection'] }`).
+     */
+    async get(id, opts = {}) {
+        const params = {};
+        const include = joinIncludes(opts);
+        if (include)
+            params['include'] = include;
+        const data = await this.http.get(`/nodes/${id}`, { params });
+        return new Node(data);
+    }
+    /**
+     * Create a new node.
+     *
+     * @param payload Node creation parameters.
+     */
+    async create(payload) {
+        const body = {
+            fqdn: payload.fqdn,
+            scheme: payload.scheme,
+            api_port: payload.apiPort,
+            sftp_port: payload.sftpPort,
+            host_id: payload.hostId,
+            location_id: payload.locationId,
+            type_id: payload.typeId,
+            description: payload.description,
+            notes: payload.notes,
+            num: payload.num,
+            is_maintenance_mode: payload.isMaintenanceMode,
+            can_auto_deploy: payload.canAutoDeploy,
+            is_behind_proxy: payload.isBehindProxy,
+            limits: {
+                memory_mb: payload.limits.memoryMb,
+                memory_overallocate_mb: payload.limits.memoryOverallocateMb,
+                disk_mb: payload.limits.diskMb,
+                disk_overallocate_mb: payload.limits.diskOverallocateMb,
+                upload_size_mb: payload.limits.uploadSizeMb,
+            },
+        };
+        const data = await this.http.post('/nodes', body);
+        const node = new Node(data);
+        this.addToCache(node);
+        this.emit('created', node);
+        return node;
+    }
+    /**
+     * Fetch all servers deployed on a specific node.
+     *
+     * @param id The node's NanoID.
+     * @returns An array of minimal server data. Use `api.servers.get()` to fetch full server details.
+     */
+    async servers(id) {
+        const data = await this.http.get(`/nodes/${id}/servers`);
+        return data.map((s) => ({ id: toNanoID(s.id) }));
+    }
+    /**
+     * Access allocation management for a specific node.
+     */
+    allocations(id) {
+        return new NodeAllocationsManager(id, this.http);
+    }
+    /**
+     * Log activity on behalf of a node daemon.
+     *
+     * This endpoint is intended for node-authenticated clients.
+     */
+    async logActivity(entries) {
+        await this.http.post('/nodes/activity', {
+            data: entries.map((entry) => ({
+                user_id: entry.userId,
+                server_id: entry.serverId,
+                event: entry.event,
+                metadata: entry.metadata,
+                ip: entry.ip,
+                timestamp: entry.timestamp instanceof Date ? entry.timestamp.toISOString() : entry.timestamp,
+            })),
+        });
+    }
+    /**
+     * Create an activity log model from a raw payload.
+     *
+     * Useful when consuming activity data returned from other endpoints.
+     */
+    toActivityLog(data) {
+        return new ActivityLog(data);
+    }
+}

package/esm/src/resources/server-groups.d.ts

@@ -0,0 +1,150 @@
+import type { HttpClient } from '../http.js';
+import { ResourceNamespace } from '../namespace.js';
+import { ReactiveResource } from '../reactive.js';
+import { type ISODate, type NanoID, type Paginated } from '../types.js';
+import type { NodeData } from './nodes.js';
+import { Node } from './nodes.js';
+/** Resource limit values for a server group. @internal */
+export interface ServerGroupLimitsData {
+    cpu_percent?: number | null;
+    ram_mb?: number | null;
+    swap_mb?: number | null;
+    storage_mb?: number | null;
+    backup?: number | null;
+    database?: number | null;
+    allocation?: number | null;
+}
+/** Raw API shape for a server group. @internal */
+export interface ServerGroupData {
+    id: string;
+    /** Always present. */
+    node_id: string;
+    /** @see NodeData */
+    node?: NodeData;
+    build?: {
+        cpu_threads?: number | null;
+        io_weight?: number | null;
+    } | null;
+    limits?: ServerGroupLimitsData | null;
+    created_at: ISODate;
+    updated_at: ISODate;
+}
+/**
+ * Resource allocation limits for a server group.
+ *
+ * Each field is the maximum value allowed for all servers in the group combined.
+ * `null` means unlimited.
+ */
+export interface ServerGroupLimits {
+    /** Maximum CPU usage percentage across all servers. */
+    cpuPercent: number | null | undefined;
+    /** Maximum RAM in megabytes across all servers. */
+    ramMb: number | null | undefined;
+    /** Maximum swap in megabytes across all servers. */
+    swapMb: number | null | undefined;
+    /** Maximum storage in megabytes across all servers. */
+    storageMb: number | null | undefined;
+    /** Maximum number of backups across all servers. */
+    backup: number | null | undefined;
+    /** Maximum number of databases across all servers. */
+    database: number | null | undefined;
+    /** Maximum number of port allocations across all servers. */
+    allocation: number | null | undefined;
+}
+/**
+ * A server group that ties one or more servers to a specific node with shared resource limits.
+ *
+ * Retrieved via {@link ServerGroupsNamespace.get} or {@link ServerGroupsNamespace.list}.
+ */
+export declare class ServerGroup extends ReactiveResource {
+    /** The server group's unique NanoID. */
+    readonly id: NanoID;
+    /** The ID of the node this group is deployed on. Always present. */
+    readonly nodeId: NanoID;
+    /** The full node object. */
+    node: Node | undefined;
+    /** Build settings inherited by all servers in this group. */
+    build: {
+        cpuThreads: number | null | undefined;
+        ioWeight: number | null | undefined;
+    } | undefined;
+    /** Resource limits that apply to this group as a whole. */
+    limits: ServerGroupLimits | undefined;
+    /** When this server group was created. */
+    createdAt: Date;
+    /** When this server group was last updated. */
+    updatedAt: Date;
+    /** @internal */
+    constructor(data: ServerGroupData);
+}
+/** Payload for creating a new server group. */
+export interface CreateServerGroupPayload {
+    /** NanoID of the node to deploy this group on. */
+    nodeId: NanoID;
+    /** Optional expiry date for the group. */
+    expiresAt?: Date;
+    /** Resource limits for this group. */
+    limits: {
+        /** Maximum RAM in megabytes. */
+        ramMb: number;
+        /** Maximum swap in megabytes. */
+        swapMb: number;
+        /** Maximum storage in megabytes. */
+        storageMb: number;
+        /** IO weight (1–1000). */
+        weightIo: number;
+        /** Maximum CPU usage percentage. */
+        cpuPercent: number;
+        /** CPU thread pinning, or `undefined` for no restriction. */
+        cpuThreads?: string;
+        /** Maximum number of backups. */
+        backup?: number;
+        /** Maximum number of databases. */
+        database?: number;
+        /** Maximum number of port allocations. */
+        allocation?: number;
+    };
+}
+/** Typed events emitted by {@link ServerGroupsNamespace}. */
+export interface ServerGroupEvents {
+    /** Fired after a server group is created. */
+    created: ServerGroup;
+}
+/**
+ * Namespace for server group management.
+ *
+ * Access via `api.serverGroups`.
+ *
+ * @example
+ * ```ts ignore
+ * const groups = await api.serverGroups.list();
+ * const group = await api.serverGroups.get(id);
+ * const newGroup = await api.serverGroups.create({ nodeId, limits: { ramMb: 1024 } });
+ * ```
+ */
+export declare class ServerGroupsNamespace extends ResourceNamespace<ServerGroup, ServerGroupEvents> {
+    /** @internal */
+    constructor(http: HttpClient);
+    /**
+     * Fetch a paginated list of server groups.
+     *
+     * @param opts Pagination and search options.
+     */
+    list(opts?: {
+        page?: number;
+        perPage?: number;
+    }): Promise<Paginated<ServerGroup>>;
+    /**
+     * Fetch a single server group by ID.
+     *
+     * @param id The server group's NanoID.
+     */
+    get(id: NanoID): Promise<ServerGroup>;
+    /**
+     * Create a new server group.
+     *
+     * @param payload Server group creation parameters.
+     */
+    create(payload: CreateServerGroupPayload): Promise<ServerGroup>;
+}
+//# sourceMappingURL=server-groups.d.ts.map

package/esm/src/resources/server-groups.d.ts.map

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

package/esm/src/resources/server-groups.js

@@ -0,0 +1,111 @@
+import { ResourceNamespace } from '../namespace.js';
+import { ReactiveResource } from '../reactive.js';
+import { toNanoID } from '../types.js';
+import { Node } from './nodes.js';
+/**
+ * A server group that ties one or more servers to a specific node with shared resource limits.
+ *
+ * Retrieved via {@link ServerGroupsNamespace.get} or {@link ServerGroupsNamespace.list}.
+ */
+export class ServerGroup extends ReactiveResource {
+    /** The server group's unique NanoID. */
+    id;
+    /** The ID of the node this group is deployed on. Always present. */
+    nodeId;
+    /** The full node object. */
+    node;
+    /** Build settings inherited by all servers in this group. */
+    build;
+    /** Resource limits that apply to this group as a whole. */
+    limits;
+    /** When this server group was created. */
+    createdAt;
+    /** When this server group was last updated. */
+    updatedAt;
+    /** @internal */
+    constructor(data) {
+        super();
+        this.id = toNanoID(data.id);
+        this.nodeId = toNanoID(data.node_id);
+        this.node = data.node ? new Node(data.node) : undefined;
+        this.build = data.build ? { cpuThreads: data.build.cpu_threads, ioWeight: data.build.io_weight } : undefined;
+        this.limits = data.limits
+            ? {
+                cpuPercent: data.limits.cpu_percent,
+                ramMb: data.limits.ram_mb,
+                swapMb: data.limits.swap_mb,
+                storageMb: data.limits.storage_mb,
+                backup: data.limits.backup,
+                database: data.limits.database,
+                allocation: data.limits.allocation,
+            }
+            : undefined;
+        this.createdAt = new Date(data.created_at);
+        this.updatedAt = new Date(data.updated_at);
+    }
+}
+/**
+ * Namespace for server group management.
+ *
+ * Access via `api.serverGroups`.
+ *
+ * @example
+ * ```ts ignore
+ * const groups = await api.serverGroups.list();
+ * const group = await api.serverGroups.get(id);
+ * const newGroup = await api.serverGroups.create({ nodeId, limits: { ramMb: 1024 } });
+ * ```
+ */
+export class ServerGroupsNamespace extends ResourceNamespace {
+    /** @internal */
+    constructor(http) {
+        super(http);
+    }
+    /**
+     * Fetch a paginated list of server groups.
+     *
+     * @param opts Pagination and search options.
+     */
+    async list(opts = {}) {
+        const result = await this.http.list('/servers/groups', opts);
+        const groups = result.data.map((d) => new ServerGroup(d));
+        this.setCache(groups);
+        return { ...result, data: groups };
+    }
+    /**
+     * Fetch a single server group by ID.
+     *
+     * @param id The server group's NanoID.
+     */
+    async get(id) {
+        const data = await this.http.get(`/servers/groups/${id}`);
+        return new ServerGroup(data);
+    }
+    /**
+     * Create a new server group.
+     *
+     * @param payload Server group creation parameters.
+     */
+    async create(payload) {
+        const body = {
+            node_id: payload.nodeId,
+            expires_at: payload.expiresAt,
+            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,
+            },
+        };
+        const data = await this.http.post('/servers/groups', body);
+        const group = new ServerGroup(data);
+        this.addToCache(group);
+        this.emit('created', group);
+        return group;
+    }
+}