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

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 - Present HostVenom, LLC. DBA WinterNode
+Copyright (c) 2024 - Present WinterNode
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -0,0 +1,40 @@
+# @meowpanel/api
+
+TypeScript client library for the MeowPanel platform.
+Provides typed access to MeowPanel API endpoints.
+
+## Quick start
+
+```typescript
+import { MeowPanelApi } from "@meowpanel/api";
+
+const api = new MeowPanelApi({
+  url: "https://panel.example.com",
+  token: "your-api-key",
+});
+
+// List servers with type-safe includes
+const { data: servers } = await api.servers.list({ include: ["group", "status"] });
+for (const server of servers) {
+  console.log(server.name, server.group.nodeId, server.status.state);
+}
+
+// Manage files on a server
+const server = await api.servers.get(servers[0].id);
+const entries = await server.files.list("/");
+await server.files.write("/motd.txt", "Hello World");
+
+// Real-time console via SSE
+const conn = await server.createConnection();
+conn.on("console_output", (line) => console.log(line));
+conn.on("stats", (stats) => console.log(`CPU: ${stats.cpuAbsolute}%`));
+await conn.open();
+```
+
+## Features
+
+- **Type-safe includes** - `list({ include: ["group"] })` narrows the return type so included fields are guaranteed non-undefined.
+- **Reactive stores** - All namespaces and resources implement a `subscribe()` contract for use in Svelte or other reactive frameworks.
+- **Typed events** - Listen for mutations with `api.servers.on("created", (server) => ...)`.
+- **File management** - Full CRUD, compression, chmod, and multipart upload via the node daemon.
+- **SSE connections** - Real-time console output, power state, and resource utilization streaming.

package/esm/mod.d.ts

@@ -1,2 +1,88 @@
-export { MeowPanelApi } from './api.js';
+/**
+ * # @meowpanel/api
+ *
+ * TypeScript client library for the MeowPanel platform.
+ * Provides typed access to MeowPanel API endpoints.
+ *
+ * ## Quick start
+ *
+ * ```typescript
+ * import { MeowPanelApi } from "@meowpanel/api";
+ *
+ * const api = new MeowPanelApi({
+ *   url: "https://panel.example.com",
+ *   token: "your-api-key",
+ * });
+ *
+ * // List servers with type-safe includes
+ * const { data: servers } = await api.servers.list({ include: ["group", "status"] });
+ * for (const server of servers) {
+ *   console.log(server.name, server.group.nodeId, server.status.state);
+ * }
+ *
+ * // Manage files on a server
+ * const server = await api.servers.get(servers[0].id);
+ * const entries = await server.files.list("/");
+ * await server.files.write("/motd.txt", "Hello World");
+ *
+ * // Real-time console via SSE
+ * const conn = await server.createConnection();
+ * conn.on("console_output", (line) => console.log(line));
+ * conn.on("stats", (stats) => console.log(`CPU: ${stats.cpuAbsolute}%`));
+ * await conn.open();
+ * ```
+ *
+ * ## Features
+ *
+ * - **Type-safe includes** - `list({ include: ["group"] })` narrows the return type so included fields are guaranteed non-undefined.
+ * - **Reactive stores** - All namespaces and resources implement a `subscribe()` contract for use in Svelte or other reactive frameworks.
+ * - **Typed events** - Listen for mutations with `api.servers.on("created", (server) => ...)`.
+ * - **File management** - Full CRUD, compression, chmod, and multipart upload via the node daemon.
+ * - **SSE connections** - Real-time console output, power state, and resource utilization streaming.
+ *
+ * @module
+ */
+export { MeowPanelApi } from './src/client.js';
+export type { MeowPanelApiOptions } from './src/client.js';
+export { AuthResource } from './src/resources/auth.js';
+export type { AuthMeta, AuthProvider } from './src/resources/auth.js';
+export { ReactiveResource } from './src/reactive.js';
+export { ApiError } from './src/errors.js';
+export type { ApiErrorOptions } from './src/errors.js';
+export { HttpClient } from './src/http.js';
+export type { HttpClientOptions, HttpLogCode, HttpLogEvent, HttpLogger, HttpRequestErrorLogEvent, HttpRequestStartLogEvent, HttpRequestSuccessLogEvent, RequestOptions, } from './src/http.js';
+export { TypedEmitter } from './src/emitter.js';
+export type { EventHandler } from './src/emitter.js';
+export { SseConnection } from './src/sse.js';
+export type { SseState } from './src/sse.js';
+export { joinIncludes, toNanoID } from './src/types.js';
+export type { IncludeOptions, ISODate, ListOptions, NanoID, Paginated, PowerSignal, PowerState, ResourceWith, ServerRestrictedState, SftpPermission, UnionToIntersection, } from './src/types.js';
+export { Account, AccountResource, ApiKeyAccount, UserAccount } from './src/resources/account.js';
+export type { AccountInclude, UpdateAccountPayload } from './src/resources/account.js';
+export { ApiKey, ApiKeysNamespace } from './src/resources/api-keys.js';
+export type { ApiKeyEvents, CreateApiKeyPayload, CreateApiKeyResult } from './src/resources/api-keys.js';
+export { Member, MembersNamespace } from './src/resources/members.js';
+export type { MemberData, MemberDisplay, MemberEvents, MemberInclude, MemberWith, UpdateMemberPayload, } from './src/resources/members.js';
+export { Node, NodeAllocationIp, NodeAllocationPort, NodeAllocationsManager, NodeLocation, NodesNamespace, NodeType, } from './src/resources/nodes.js';
+export type { CreateNodeAllocationIpPayload, CreateNodeAllocationPortsPayload, CreateNodePayload, LogNodeActivityPayload, NodeAllocationIpData, NodeAllocationPortData, NodeConnection, NodeData, NodeEvents, NodeHostData, NodeInclude, NodeLimits, NodeLocationData, NodeTypeData, NodeWith, UpdateNodeAllocationIpPayload, UpdateNodeAllocationPortPayload, } from './src/resources/nodes.js';
+export { Egg, EggNest, EggsNamespace } from './src/resources/eggs.js';
+export type { EggData, EggEvents, EggImage, EggImageData, EggInclude, EggInstaller, EggInstallerData, EggNestData, EggProcess, EggWith, UpdateEggPayload, } from './src/resources/eggs.js';
+export { Host, HostsNamespace } from './src/resources/hosts.js';
+export type { HostData } from './src/resources/hosts.js';
+export { ServerGroup, ServerGroupsNamespace } from './src/resources/server-groups.js';
+export type { CreateServerGroupPayload, ServerGroupData, ServerGroupEvents, ServerGroupLimits, ServerGroupLimitsData, } from './src/resources/server-groups.js';
+export { ServersNamespace } from './src/resources/servers/index.js';
+export type { CreateServerPayload, ServerEvents, ServerInclude, ServerWith, UpdateServerPayload, } from './src/resources/servers/index.js';
+export { Server } from './src/resources/servers/server.js';
+export type { ServerBuild, ServerStartup, ServerStatus, StartupVariable } from './src/resources/servers/server.js';
+export { ServerConnection } from './src/resources/servers/connection.js';
+export type { ServerConnectionEvents, ServerUtilization } from './src/resources/servers/connection.js';
+export { FileEntry, ServerFilesManager } from './src/resources/servers/files.js';
+export { ServerSftpManager, SftpUser } from './src/resources/servers/sftp.js';
+export type { AddAllocationEntry } from './src/resources/servers/allocations.js';
+export type { SftpConnection, SftpDetails, SftpUserInclude, SftpUserWith } from './src/resources/servers/sftp.js';
+export { ServerAllocationPort, ServerAllocationsManager } from './src/resources/servers/allocations.js';
+export type { AllocationPortMeta } from './src/resources/servers/allocations.js';
+export { ServerProfile, ServerProfilesManager } from './src/resources/servers/profiles.js';
+export { ActivityJob, ActivityJobLog, ActivityLog, ServerActivityManager } from './src/resources/servers/activity.js';
 //# sourceMappingURL=mod.d.ts.map

package/esm/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"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"}

package/esm/mod.js

@@ -1 +1,85 @@
-export { MeowPanelApi } from './api.js';
+/**
+ * # @meowpanel/api
+ *
+ * TypeScript client library for the MeowPanel platform.
+ * Provides typed access to MeowPanel API endpoints.
+ *
+ * ## Quick start
+ *
+ * ```typescript
+ * import { MeowPanelApi } from "@meowpanel/api";
+ *
+ * const api = new MeowPanelApi({
+ *   url: "https://panel.example.com",
+ *   token: "your-api-key",
+ * });
+ *
+ * // List servers with type-safe includes
+ * const { data: servers } = await api.servers.list({ include: ["group", "status"] });
+ * for (const server of servers) {
+ *   console.log(server.name, server.group.nodeId, server.status.state);
+ * }
+ *
+ * // Manage files on a server
+ * const server = await api.servers.get(servers[0].id);
+ * const entries = await server.files.list("/");
+ * await server.files.write("/motd.txt", "Hello World");
+ *
+ * // Real-time console via SSE
+ * const conn = await server.createConnection();
+ * conn.on("console_output", (line) => console.log(line));
+ * conn.on("stats", (stats) => console.log(`CPU: ${stats.cpuAbsolute}%`));
+ * await conn.open();
+ * ```
+ *
+ * ## Features
+ *
+ * - **Type-safe includes** - `list({ include: ["group"] })` narrows the return type so included fields are guaranteed non-undefined.
+ * - **Reactive stores** - All namespaces and resources implement a `subscribe()` contract for use in Svelte or other reactive frameworks.
+ * - **Typed events** - Listen for mutations with `api.servers.on("created", (server) => ...)`.
+ * - **File management** - Full CRUD, compression, chmod, and multipart upload via the node daemon.
+ * - **SSE connections** - Real-time console output, power state, and resource utilization streaming.
+ *
+ * @module
+ */
+// Main client
+export { MeowPanelApi } from './src/client.js';
+// Auth
+export { AuthResource } from './src/resources/auth.js';
+export { ReactiveResource } from './src/reactive.js';
+// Core primitives
+export { ApiError } from './src/errors.js';
+export { HttpClient } from './src/http.js';
+export { TypedEmitter } from './src/emitter.js';
+export { SseConnection } from './src/sse.js';
+// Common types
+export { joinIncludes, toNanoID } from './src/types.js';
+// Account
+export { Account, AccountResource, ApiKeyAccount, UserAccount } from './src/resources/account.js';
+// API Keys
+export { ApiKey, ApiKeysNamespace } from './src/resources/api-keys.js';
+// Members
+export { Member, MembersNamespace } from './src/resources/members.js';
+// Nodes
+export { Node, NodeAllocationIp, NodeAllocationPort, NodeAllocationsManager, NodeLocation, NodesNamespace, NodeType, } from './src/resources/nodes.js';
+// Eggs
+export { Egg, EggNest, EggsNamespace } from './src/resources/eggs.js';
+// Hosts
+export { Host, HostsNamespace } from './src/resources/hosts.js';
+// Server Groups
+export { ServerGroup, ServerGroupsNamespace } from './src/resources/server-groups.js';
+// Servers
+export { ServersNamespace } from './src/resources/servers/index.js';
+export { Server } from './src/resources/servers/server.js';
+// Server connection (SSE)
+export { ServerConnection } from './src/resources/servers/connection.js';
+// Server files
+export { FileEntry, ServerFilesManager } from './src/resources/servers/files.js';
+// Server SFTP
+export { ServerSftpManager, SftpUser } from './src/resources/servers/sftp.js';
+// Server allocations
+export { ServerAllocationPort, ServerAllocationsManager } from './src/resources/servers/allocations.js';
+// Server profiles
+export { ServerProfile, ServerProfilesManager } from './src/resources/servers/profiles.js';
+// Server activity
+export { ActivityJob, ActivityJobLog, ActivityLog, ServerActivityManager } from './src/resources/servers/activity.js';

package/esm/src/client.d.ts

@@ -0,0 +1,233 @@
+import type { HttpLogger } from './http.js';
+import { SseConnection } from './sse.js';
+import { AccountResource } from './resources/account.js';
+import { AuthResource } from './resources/auth.js';
+import { ApiKeysNamespace } from './resources/api-keys.js';
+import { EggsNamespace } from './resources/eggs.js';
+import { HostsNamespace } from './resources/hosts.js';
+import { MembersNamespace } from './resources/members.js';
+import { NodesNamespace } from './resources/nodes.js';
+import { ServerGroupsNamespace } from './resources/server-groups.js';
+import { ServersNamespace } from './resources/servers/index.js';
+/**
+ * Configuration options for {@link MeowPanelApi}.
+ */
+export interface MeowPanelApiOptions {
+    /**
+     * Base URL of the MeowPanel Nexus API.
+     *
+     * Should not include `/v1` - that is appended automatically.
+     *
+     * @example `"https://panel.example.com"`
+     */
+    url: string | URL;
+    /**
+     * Bearer token for authentication.
+     *
+     * Can be a user session token or an API key token.
+     */
+    token?: string;
+    /**
+     * Custom fetch implementation to use for all HTTP requests.
+     *
+     * Defaults to `globalThis.fetch`.
+     */
+    fetch?: typeof globalThis.fetch;
+    /**
+     * Optional callback invoked for every outgoing request.
+     *
+     * Useful for integrating API request visibility into your app's debug/info logger.
+     */
+    logger?: HttpLogger;
+    /**
+     * The `credentials` mode for all fetch requests.
+     *
+     * Set to `'include'` for browser apps that rely on cookie-based authentication.
+     * Defaults to `undefined` (browser default is `'same-origin'`).
+     */
+    credentials?: RequestCredentials;
+}
+/**
+ * The root MeowPanel API client.
+ *
+ * Instantiate once and reuse across your application. All namespaces implement the
+ * readable store contract so they can be used directly in reactive templates.
+ *
+ * @example
+ * ```ts ignore
+ * import { MeowPanelApi } from '@meowpanel/api';
+ *
+ * const api = new MeowPanelApi({
+ *   url: 'https://panel.example.com',
+ *   token: 'your-bearer-token',
+ * });
+ *
+ * // Fetch resources
+ * const me = await api.account.get();
+ * const servers = await api.servers.list({ include: ['status'] });
+ * const members = await api.members.list();
+ *
+ * // Reactive store: {#each $api.servers as server} ... {/each}
+ *
+ * // Listen for mutations
+ * api.servers.on('created', (server) => console.log('New server:', server.name));
+ * api.members.on('updated', (member) => console.log('Member updated:', member.nickname));
+ *
+ * // Panel-level SSE
+ * const sse = api.connectSse();
+ * sse.connect((event, data) => console.log('Panel event:', event, data));
+ * ```
+ */
+export declare class MeowPanelApi {
+    private readonly http;
+    /**
+     * Fetch authentication configuration (available login providers).
+     *
+     * @example
+     * ```ts ignore
+     * const { providers } = await api.auth.getMeta();
+     * if (providers.whmcs) console.log(providers.whmcs.fields.display_name);
+     * ```
+     */
+    readonly auth: AuthResource;
+    /**
+     * Access and update the currently authenticated account (me).
+     *
+     * @example
+     * ```ts ignore
+     * const me = await api.account.get();
+     * await api.account.update({ display: { theme: 'dark' } });
+     * await api.account.uploadAvatar(imageBlob, 'image/png');
+     * ```
+     */
+    readonly account: AccountResource;
+    /**
+     * Manage API keys for the current account.
+     *
+     * @example
+     * ```ts ignore
+     * const key = await api.apiKeys.create('CI/CD Pipeline');
+     * console.log(key.token); // Save this!
+     * ```
+     */
+    readonly apiKeys: ApiKeysNamespace;
+    /**
+     * Manage member (user) accounts.
+     *
+     * Supports reactive subscriptions via `$api.members`.
+     *
+     * @example
+     * ```ts ignore
+     * const members = await api.members.list();
+     * const member = await api.members.get(id);
+     * await api.members.update(id, { nickname: 'newname' });
+     * ```
+     */
+    readonly members: MembersNamespace;
+    /**
+     * Manage nodes (daemon servers).
+     *
+     * Supports reactive subscriptions via `$api.nodes`.
+     *
+     * @example
+     * ```ts ignore
+     * const nodes = await api.nodes.list();
+     * const node = await api.nodes.get(id, { includeConnection: true });
+     * ```
+     */
+    readonly nodes: NodesNamespace;
+    /**
+     * Manage eggs (game/application configuration templates).
+     *
+     * Supports reactive subscriptions via `$api.eggs`.
+     *
+     * @example
+     * ```ts ignore
+     * const eggs = await api.eggs.list();
+     * await api.eggs.update(id, { name: 'Paper Minecraft' });
+     * await api.eggs.delete(id);
+     * ```
+     */
+    readonly eggs: EggsNamespace;
+    /**
+     * View physical host machines.
+     *
+     * Supports reactive subscriptions via `$api.hosts`.
+     *
+     * @example
+     * ```ts ignore
+     * const hosts = await api.hosts.list();
+     * ```
+     */
+    readonly hosts: HostsNamespace;
+    /**
+     * Manage server groups (node + resource limits containers).
+     *
+     * Supports reactive subscriptions via `$api.serverGroups`.
+     *
+     * @example
+     * ```ts ignore
+     * const groups = await api.serverGroups.list();
+     * const group = await api.serverGroups.create({ nodeId, limits: { ramMb: 1024 } });
+     * ```
+     */
+    readonly serverGroups: ServerGroupsNamespace;
+    /**
+     * Manage game servers.
+     *
+     * Supports reactive subscriptions via `$api.servers`.
+     *
+     * @example
+     * ```ts ignore
+     * const servers = await api.servers.list({ include: ['status'] });
+     * const server = await api.servers.get(id);
+     * await server.sendPower('start');
+     * await server.sendCommand('say Hello!');
+     *
+     * // File management
+     * const entries = await server.files.list('/');
+     * await server.files.write('/motd.txt', 'Hello World');
+     *
+     * // Real-time events
+     * const conn = await server.createConnection();
+     * conn.on('console_output', (line) => console.log(line));
+     * conn.on('stats', (stats) => console.log(`CPU: ${stats.cpuAbsolute}%`));
+     * await conn.open();
+     * ```
+     */
+    readonly servers: ServersNamespace;
+    constructor(options: MeowPanelApiOptions);
+    /**
+     * Update the bearer token used for all subsequent API requests.
+     *
+     * Useful when a session token is refreshed.
+     *
+     * @param token The new bearer token.
+     */
+    setToken(token: string): void;
+    /**
+     * Create a panel-level Server-Sent Events connection to Nexus.
+     *
+     * The panel SSE stream (`GET /v1/sse`) broadcasts events for mutations
+     * across the panel (e.g. server updates, member changes).
+     *
+     * The connection is not opened until you call `.connect()` on the returned object.
+     *
+     * @example
+     * ```ts ignore
+     * const sse = api.connectSse();
+     * sse.connect(
+     *   (event, data) => {
+     *     const payload = JSON.parse(data);
+     *     console.log('Panel event:', event, payload);
+     *   },
+     *   (err) => console.error('SSE error:', err),
+     * );
+     *
+     * // Later...
+     * sse.disconnect();
+     * ```
+     */
+    connectSse(): SseConnection;
+}
+//# sourceMappingURL=client.d.ts.map

package/esm/src/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC;;;;;;OAMG;IACH,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAElC;;;;;;;;OAQG;IACH,SAAgB,IAAI,EAAE,YAAY,CAAC;IAEnC;;;;;;;;;OASG;IACH,SAAgB,OAAO,EAAE,eAAe,CAAC;IAEzC;;;;;;;;OAQG;IACH,SAAgB,OAAO,EAAE,gBAAgB,CAAC;IAE1C;;;;;;;;;;;OAWG;IACH,SAAgB,OAAO,EAAE,gBAAgB,CAAC;IAE1C;;;;;;;;;;OAUG;IACH,SAAgB,KAAK,EAAE,cAAc,CAAC;IAEtC;;;;;;;;;;;OAWG;IACH,SAAgB,IAAI,EAAE,aAAa,CAAC;IAEpC;;;;;;;;;OASG;IACH,SAAgB,KAAK,EAAE,cAAc,CAAC;IAEtC;;;;;;;;;;OAUG;IACH,SAAgB,YAAY,EAAE,qBAAqB,CAAC;IAEpD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,SAAgB,OAAO,EAAE,gBAAgB,CAAC;gBAEvB,OAAO,EAAE,mBAAmB;IAoB/C;;;;;;OAMG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACI,UAAU,IAAI,aAAa;CAIlC"}