@meowpanel/api 0.1.0-alpha.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 - Present HostVenom, LLC. DBA 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
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/esm/api.d.ts

@@ -0,0 +1,76 @@
+import { AuthApi } from './components/auth.js';
+import { ServerGroup } from './components/group.js';
+import { Member, type MemberInclude } from './components/member_2.js';
+import { Node, type NodeInclude } from './components/node.js';
+import { Server, type ServerInclude } from './components/server/server.js';
+import { type EventFunction, EventManager, type EventManagerListener } from './utils/event.js';
+export declare class ApiError extends Error {
+    readonly error: string;
+    readonly status: number;
+    constructor(response: Response, error: string);
+}
+export interface MainEvents {
+    error: ApiError;
+}
+export interface MeowPanelApiRequestData {
+    body?: Record<string, unknown> | FormData | ArrayBuffer | string;
+    params?: Record<string, string | undefined>;
+}
+export declare class MeowPanelApi implements EventManagerListener<MainEvents> {
+    private static isPlainJson;
+    protected readonly url: string | URL;
+    protected readonly token: string | undefined;
+    protected readonly fetch: typeof fetch;
+    protected readonly eventManager: EventManager<MainEvents>;
+    on<K extends keyof MainEvents>(event: K, func: EventFunction<MainEvents, K>): number;
+    off<K extends keyof MainEvents>(event: K, func: number | EventFunction<MainEvents, K>): boolean;
+    requestUrl(method: string, url: URL | string, data?: MeowPanelApiRequestData): Promise<Response>;
+    request<T>(method: string, endpoint: `/${string}`, init?: {
+        body?: Record<string, unknown>;
+        pagination?: Pagination;
+        params?: Record<string, string | undefined>;
+    }): Promise<ApiResponse<T>>;
+    constructor(options: Options);
+    /**
+     * Fetches the current logged in account
+     */
+    me(include?: MemberInclude[]): Promise<Member>;
+    readonly members: {
+        list: (pagination: Pagination) => Promise<{
+            data: Member[];
+            page: Page | undefined;
+        }>;
+        get: (id: string) => Promise<Member>;
+    };
+    readonly getNode: (id: string, include?: NodeInclude[]) => Promise<Node>;
+    readonly getServers: (page: number, include?: ServerInclude[], query?: string) => Promise<{
+        servers: Server[];
+        page: Page;
+    }>;
+    readonly getServer: (id: string, include?: ServerInclude[]) => Promise<Server>;
+    readonly getServerGroups: (page: number) => Promise<{
+        groups: ServerGroup[];
+        page: Page;
+    }>;
+    readonly getServerGroup: (id: string) => Promise<ServerGroup>;
+    readonly auth: AuthApi;
+}
+export interface Options {
+    url: string | URL;
+    token?: string;
+    fetch?: typeof fetch;
+}
+export interface ApiResponse<T> {
+    data: T;
+    page?: Page;
+}
+export interface Pagination {
+    page: number;
+    perPage?: number;
+}
+export interface Page {
+    total: number;
+    from: number;
+    to: number;
+}
+//# sourceMappingURL=api.d.ts.map

package/esm/api.d.ts.map

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

package/esm/api.js

@@ -0,0 +1,187 @@
+import { AuthApi } from './components/auth.js';
+import { ServerGroup } from './components/group.js';
+import { Member } from './components/member_2.js';
+import { Node } from './components/node.js';
+import { Server } from './components/server/server.js';
+import { EventManager } from './utils/event.js';
+export class ApiError extends Error {
+    constructor(response, error) {
+        super(`${response.status}: ${error}`);
+        Object.defineProperty(this, "error", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: error
+        });
+        Object.defineProperty(this, "status", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.status = response.status;
+    }
+}
+export class MeowPanelApi {
+    static isPlainJson(value) {
+        return typeof value === 'object' && value !== null &&
+            value.constructor === Object;
+    }
+    on(event, func) {
+        return this.eventManager.on(event, func);
+    }
+    off(event, func) {
+        return this.eventManager.off(event, func);
+    }
+    async requestUrl(method, url, data = {}) {
+        const headers = {};
+        if (this.token) {
+            headers.Authorization = `Bearer ${this.token}`;
+        }
+        const requestUrl = new URL(url.toString());
+        if (data.params) {
+            for (const [key, value] of Object.entries(data.params)) {
+                if (value !== undefined) {
+                    requestUrl.searchParams.set(key, value);
+                }
+            }
+        }
+        const response = await this.fetch(requestUrl, {
+            body: MeowPanelApi.isPlainJson(data.body) ? JSON.stringify(data.body) : data.body,
+            credentials: 'include',
+            headers,
+            method,
+        });
+        if (!response.ok) {
+            let message;
+            try {
+                const json = await response.json();
+                message = json.error;
+            }
+            catch (_) {
+                console.warn('Failed to parse error response');
+                message = 'Unknown error';
+            }
+            const error = new ApiError(response, message);
+            this.eventManager.dispatch('error', error);
+            throw error;
+        }
+        return response;
+    }
+    async request(method, endpoint, init = {}) {
+        const url = new URL(this.url.toString());
+        url.pathname = `${url.pathname}/${endpoint}`.replace(/\/+/g, '/');
+        if (init.params) {
+            Object.entries(init.params).forEach(([key, value]) => value !== undefined && url.searchParams.set(key, value));
+        }
+        init.pagination &&
+            url.searchParams.set('page', `${init.pagination.page}`);
+        init.pagination?.perPage &&
+            url.searchParams.set('perPage', `${init.pagination.perPage}`);
+        const response = await this.requestUrl(method, url.toString(), init);
+        if (response.status === 204)
+            return {};
+        const json = await response.json();
+        let page = undefined;
+        if (init.pagination) {
+            const contentRange = response.headers.get('content-range');
+            if (!contentRange) {
+                throw new Error('Expected content-range header not found');
+            }
+            const [range, total] = contentRange.split('/') ??
+                ['items 0-0', '0'];
+            const [from, to] = range.split(' ')[1].split('-').map(Number);
+            page = { total: Number(total), from, to };
+        }
+        return {
+            page,
+            data: json,
+        };
+    }
+    constructor(options) {
+        Object.defineProperty(this, "url", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "token", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "fetch", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "eventManager", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new EventManager()
+        });
+        Object.defineProperty(this, "members", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: {
+                list: (pagination) => Member.list(this, pagination),
+                get: (id) => Member.get(this, id),
+            }
+        });
+        Object.defineProperty(this, "getNode", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: (id, include) => Node.get(this, id, include)
+        });
+        Object.defineProperty(this, "getServers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: (page, include, query) => Server.getPaged(this, page, include, query)
+        });
+        Object.defineProperty(this, "getServer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: (id, include) => Server.get(this, id, include)
+        });
+        Object.defineProperty(this, "getServerGroups", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: (page) => ServerGroup.getPaged(this, page)
+        });
+        Object.defineProperty(this, "getServerGroup", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: (id) => ServerGroup.get(this, id)
+        });
+        Object.defineProperty(this, "auth", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new AuthApi(this)
+        });
+        this.url = options.url;
+        this.token = options.token;
+        this.fetch = options.fetch ?? fetch;
+    }
+    /**
+     * Fetches the current logged in account
+     */
+    // TODO: update to accept API key response
+    async me(include) {
+        const response = await this.request('GET', '/v1/account', {
+            params: {
+                include: include?.join(','),
+            },
+        });
+        return new Member(this, response.data);
+    }
+}

package/esm/components/auth.d.ts

@@ -0,0 +1,15 @@
+import type { MeowPanelApi } from '../mod.js';
+import type { ApiResponse } from '../api.js';
+export interface AuthProvider {
+    fields: Record<string, string>;
+    url: string;
+}
+export interface AuthGetMeta {
+    providers: Record<string, AuthProvider>;
+}
+export declare class AuthApi {
+    protected readonly api: MeowPanelApi;
+    getMeta(): Promise<ApiResponse<AuthGetMeta>>;
+    constructor(api: MeowPanelApi);
+}
+//# sourceMappingURL=auth.d.ts.map

package/esm/components/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/components/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,WAAW;IAC3B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACxC;AAED,qBAAa,OAAO;IAKA,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,YAAY;IAJ1C,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;gBAInB,GAAG,EAAE,YAAY;CACvD"}

package/esm/components/auth.js

@@ -0,0 +1,13 @@
+export class AuthApi {
+    async getMeta() {
+        return await this.api.request('GET', '/v1/auth');
+    }
+    constructor(api) {
+        Object.defineProperty(this, "api", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: api
+        });
+    }
+}

package/esm/components/connection/abstract.d.ts

@@ -0,0 +1,23 @@
+import { type EventFunction, EventManager, type EventManagerListener } from '../../utils/event.js';
+import type { Server } from '../server/server.js';
+import type { NodeServerEvents } from './node';
+export declare abstract class ServerConnection implements EventManagerListener<NodeServerEvents> {
+    protected readonly subSystemName: string;
+    protected readonly server: Server;
+    constructor(subSystemName: string, server: Server);
+    readonly eventManager: EventManager<NodeServerEvents>;
+    on<K extends keyof NodeServerEvents>(event: K, func: EventFunction<NodeServerEvents, K>): number;
+    off<K extends keyof NodeServerEvents>(event: K | number, func?: EventFunction<NodeServerEvents, K> | number): boolean;
+    abstract connect(): Promise<void> | void;
+    abstract disconnect(): Promise<void> | void;
+    abstract isConnected: boolean;
+    logger: Logger;
+    private log;
+}
+export interface Logger {
+    debug: (message: string) => void;
+    info: (message: string) => void;
+    warn: (message: string) => void;
+    error: (message: string) => void;
+}
+//# sourceMappingURL=abstract.d.ts.map

package/esm/components/connection/abstract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../src/components/connection/abstract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACnG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAE/C,8BAAsB,gBAAiB,YAAW,oBAAoB,CAAC,gBAAgB,CAAC;IAEtF,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM;IACxC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM;gBADd,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM;IAGlC,SAAgB,YAAY,iCAAwC;IAC7D,EAAE,CAAC,CAAC,SAAS,MAAM,gBAAgB,EACzC,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,aAAa,CAAC,gBAAgB,EAAE,CAAC,CAAC,GACtC,MAAM;IAIF,GAAG,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAC1C,KAAK,EAAE,CAAC,GAAG,MAAM,EACjB,IAAI,CAAC,EAAE,aAAa,CAAC,gBAAgB,EAAE,CAAC,CAAC,GAAG,MAAM,GAChD,OAAO;aAIM,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;aAC/B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAClD,SAAgB,WAAW,EAAE,OAAO,CAAC;IAE9B,MAAM,EAAE,MAAM,CAKnB;IAEF,OAAO,CAAC,GAAG;CAGX;AAED,MAAM,WAAW,MAAM;IACtB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC"}

package/esm/components/connection/abstract.js

@@ -0,0 +1,43 @@
+import { EventManager } from '../../utils/event.js';
+export class ServerConnection {
+    constructor(subSystemName, server) {
+        Object.defineProperty(this, "subSystemName", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: subSystemName
+        });
+        Object.defineProperty(this, "server", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: server
+        });
+        Object.defineProperty(this, "eventManager", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new EventManager()
+        });
+        Object.defineProperty(this, "logger", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: {
+                debug: (message) => this.log('debug', message),
+                info: (message) => this.log('info', message),
+                warn: (message) => this.log('warn', message),
+                error: (message) => this.log('error', message),
+            }
+        });
+    }
+    on(event, func) {
+        return this.eventManager.on(event, func);
+    }
+    off(event, func) {
+        return this.eventManager.off(event, func);
+    }
+    log(level, message) {
+        console[level](`[${this.server.id}/${this.subSystemName}] ${message}`);
+    }
+}

package/esm/components/connection/sse.d.ts

@@ -0,0 +1,20 @@
+import type { EventFunction } from '../../utils/event.js';
+import type { Server } from '../server/server.js';
+import { ServerConnection } from './abstract.js';
+import type { NodeServerEvents } from './node';
+export declare class SseServerConnection extends ServerConnection {
+    private eventSource;
+    constructor(server: Server);
+    connect(): Promise<void>;
+    disconnect(): void;
+    get isConnected(): boolean;
+    protected readonly eventSourceListenerTracker: Array<{
+        id: number;
+        func: EventFunction<NodeServerEvents, keyof NodeServerEvents>;
+        wrapper: (message: MessageEvent) => unknown;
+    }>;
+    protected registerEventToSource<K extends keyof NodeServerEvents>(event: K, id: number, func: (value: NodeServerEvents[K]) => unknown): void;
+    on<K extends keyof NodeServerEvents>(event: K, func: EventFunction<NodeServerEvents, K>): number;
+    off<K extends keyof NodeServerEvents>(event: K, func: number | EventFunction<NodeServerEvents, K>): boolean;
+}
+//# sourceMappingURL=sse.d.ts.map

package/esm/components/connection/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../src/components/connection/sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAE/C,qBAAa,mBAAoB,SAAQ,gBAAgB;IACxD,OAAO,CAAC,WAAW,CAA0B;gBAE1B,MAAM,EAAE,MAAM;IAIpB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB9B,UAAU,IAAI,IAAI;IAOzB,IAAoB,WAAW,YAG9B;IAED,SAAS,CAAC,QAAQ,CAAC,0BAA0B,EAAE,KAAK,CAAC;QACpD,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,aAAa,CAAC,gBAAgB,EAAE,MAAM,gBAAgB,CAAC,CAAC;QAC9D,OAAO,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC;KAC5C,CAAC,CAAM;IAER,SAAS,CAAC,qBAAqB,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAC/D,KAAK,EAAE,CAAC,EACR,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,OAAO,GAC3C,IAAI;IASS,EAAE,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAClD,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,aAAa,CAAC,gBAAgB,EAAE,CAAC,CAAC,GACtC,MAAM;IAMO,GAAG,CAAC,CAAC,SAAS,MAAM,gBAAgB,EACnD,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC,gBAAgB,EAAE,CAAC,CAAC,GAC/C,OAAO;CAUV"}

package/esm/components/connection/sse.js

@@ -0,0 +1,65 @@
+import { ServerConnection } from './abstract.js';
+export class SseServerConnection extends ServerConnection {
+    constructor(server) {
+        super('sse', server);
+        Object.defineProperty(this, "eventSource", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "eventSourceListenerTracker", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+    }
+    async connect() {
+        this.disconnect();
+        this.logger.debug('Connecting to SSE');
+        const group = await this.server.group.get();
+        const node = await group.node.get();
+        const { connection } = node; // TODO: use Cache Relation for connection
+        if (!connection)
+            throw new Error('No permission to connect to server');
+        const url = new URL(connection.url);
+        url.pathname = `/api/servers/${this.server.id}/sse`;
+        this.eventSource = new EventSource(url, { withCredentials: true });
+        this.logger.info('Connected to SSE');
+        this.eventManager.assignAllEvents((event, id, func) => this.registerEventToSource(event, id, func));
+    }
+    disconnect() {
+        if (!this.eventSource)
+            return;
+        this.logger.info('Closing SSE connection');
+        this.eventSource.close();
+        this.eventSource = undefined;
+    }
+    get isConnected() {
+        return !!this.eventSource &&
+            this.eventSource.readyState === EventSource.OPEN;
+    }
+    registerEventToSource(event, id, func) {
+        if (!this.eventSource)
+            return;
+        const wrapper = (message) => func(JSON.parse(message.data));
+        this.eventSource.addEventListener(event, wrapper);
+        this.eventSourceListenerTracker.push({ id, func, wrapper });
+        this.logger.debug(`Registered: ${event}`);
+    }
+    on(event, func) {
+        const id = super.on(event, func);
+        this.registerEventToSource(event, id, func);
+        return id;
+    }
+    off(event, func) {
+        const i = this.eventSourceListenerTracker.findIndex((v) => v.id === func || v.func === func);
+        if (i >= 0) {
+            const { wrapper } = this.eventSourceListenerTracker[i];
+            this.eventSource?.removeEventListener(event, wrapper);
+            this.eventSourceListenerTracker.splice(i, 1);
+        }
+        return super.off(event, func);
+    }
+}

package/esm/components/egg/egg.d.ts

@@ -0,0 +1,32 @@
+import type { MeowPanelApi, Page } from '../../api.js';
+import { CachedRelation } from '../../utils/cache.js';
+import { UpdatableObject } from '../../utils/object.js';
+import type { Subscription } from '../../utils/subscribe.js';
+import type { Extended } from '../../utils/types';
+export type EggInclude = 'app_background_url';
+interface Modified {
+    app_background_url: CachedRelation<string | null>;
+}
+export declare class Egg extends UpdatableObject<EggResponse, Modified, EggInclude> implements Subscription<Egg> {
+    static getPaged(api: MeowPanelApi, page: number, include?: EggInclude[]): Promise<{
+        groups: Egg[];
+        page: Page;
+    }>;
+    static get(api: MeowPanelApi, id: string, include?: EggInclude[]): Promise<Egg>;
+    constructor(api: MeowPanelApi, data: EggResponse);
+    protected applyResponse(oldData: Extended<EggResponse, Modified> | undefined, _newData: EggResponse): Modified;
+    subscribe(_fn: (value: Egg) => void): () => void;
+    get id(): string;
+    get name(): string;
+    get description(): string;
+    get appBackgroundUrl(): CachedRelation<string | null>;
+    get nest(): string;
+    get images(): EggDockerImage[];
+    get startupCommand(): string;
+    get stopCommand(): string;
+    get forceOutgoingIp(): boolean;
+    get createdAt(): string;
+    get updatedAt(): string;
+}
+export {};
+//# sourceMappingURL=egg.d.ts.map

package/esm/components/egg/egg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"egg.d.ts","sourceRoot":"","sources":["../../../src/components/egg/egg.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,MAAM,UAAU,GAAG,oBAAoB,CAAC;AAE9C,UAAU,QAAQ;IACjB,kBAAkB,EAAE,cAAc,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAClD;AAED,qBAAa,GAAI,SAAQ,eAAe,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAE,YAAW,YAAY,CAAC,GAAG,CAAC;WACnF,QAAQ,CAC3B,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,UAAU,EAAO,GACxB,OAAO,CAAC;QAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC;WAYrB,GAAG,CACtB,GAAG,EAAE,YAAY,EACjB,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,UAAU,EAAO,GACxB,OAAO,CAAC,GAAG,CAAC;gBAQI,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW;cAIpC,aAAa,CAC/B,OAAO,EAAE,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,SAAS,EACpD,QAAQ,EAAE,WAAW,GACnB,QAAQ;IAWJ,SAAS,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAIvD,IAAW,EAAE,IAAI,MAAM,CAEtB;IAED,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,IAAW,gBAAgB,IAAI,cAAc,CAAC,MAAM,GAAG,IAAI,CAAC,CAE3D;IAED,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,MAAM,IAAI,cAAc,EAAE,CAEpC;IAED,IAAW,cAAc,IAAI,MAAM,CAElC;IAED,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,IAAW,eAAe,IAAI,OAAO,CAEpC;IAED,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED,IAAW,SAAS,IAAI,MAAM,CAE7B;CACD"}

package/esm/components/egg/egg.js

@@ -0,0 +1,70 @@
+/// <reference path="./egg.d.ts" />
+import { CachedRelation } from '../../utils/cache.js';
+import { UpdatableObject } from '../../utils/object.js';
+export class Egg extends UpdatableObject {
+    static async getPaged(api, page, include = []) {
+        const response = await api.request('GET', `/v1/eggs`, {
+            pagination: { page },
+            params: { include: include?.join(',') },
+        });
+        return {
+            groups: response.data.map((data) => new Egg(api, data)),
+            page: response.page,
+        };
+    }
+    static async get(api, id, include = []) {
+        const response = await api.request('GET', `/v1/eggs/${id}`, {
+            params: { include: include?.join(',') },
+        });
+        return new Egg(api, response.data);
+    }
+    constructor(api, data) {
+        super(api, data, `/v1/eggs/${data.id}`);
+    }
+    applyResponse(oldData, _newData) {
+        const response = {
+            app_background_url: oldData?.app_background_url ??
+                new CachedRelation(async () => {
+                    const response = await this.fetchSelf(['app_background_url']);
+                    return response.app_background_url;
+                }),
+        };
+        return response;
+    }
+    subscribe(_fn) {
+        throw new Error('Method not implemented.');
+    }
+    get id() {
+        return this.response.id;
+    }
+    get name() {
+        return this.response.name;
+    }
+    get description() {
+        return this.response.description;
+    }
+    get appBackgroundUrl() {
+        return this.response.app_background_url;
+    }
+    get nest() {
+        return this.response.nest;
+    }
+    get images() {
+        return this.response.images;
+    }
+    get startupCommand() {
+        return this.response.startup_command;
+    }
+    get stopCommand() {
+        return this.response.stop_command;
+    }
+    get forceOutgoingIp() {
+        return this.response.force_outgoing_ip;
+    }
+    get createdAt() {
+        return this.response.created_at;
+    }
+    get updatedAt() {
+        return this.response.updated_at;
+    }
+}

package/esm/components/group.d.ts

@@ -0,0 +1,14 @@
+import type { MeowPanelApi, Page } from '../api.js';
+import { CachedRelation } from '../utils/cache.js';
+import { Node } from './node.js';
+export declare class ServerGroup {
+    protected readonly api: MeowPanelApi;
+    static getPaged(api: MeowPanelApi, page: number): Promise<{
+        groups: ServerGroup[];
+        page: Page;
+    }>;
+    static get(api: MeowPanelApi, id: string): Promise<ServerGroup>;
+    constructor(api: MeowPanelApi, data: Record<string, never>);
+    readonly node: CachedRelation<Node>;
+}
+//# sourceMappingURL=group.d.ts.map

package/esm/components/group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../../src/components/group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,qBAAa,WAAW;IA0BtB,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,YAAY;WAzBjB,QAAQ,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC;WAezF,GAAG,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;gBAUxD,GAAG,EAAE,YAAY,EACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAM5B,SAAgB,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;CAC3C"}

package/esm/components/group.js

@@ -0,0 +1,33 @@
+import { CachedRelation } from '../utils/cache.js';
+import { Node } from './node.js';
+export class ServerGroup {
+    static async getPaged(api, page) {
+        const response = await api.request('GET', `/v1/servers/groups`, {
+            pagination: { page },
+        });
+        return {
+            groups: response.data.map((data) => new ServerGroup(api, data)),
+            page: response.page,
+        };
+    }
+    static async get(api, id) {
+        const response = await api.request('GET', `/v1/servers/groups/${id}`);
+        return new ServerGroup(api, response.data);
+    }
+    constructor(api, data) {
+        Object.defineProperty(this, "api", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: api
+        });
+        Object.defineProperty(this, "node", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.node = new CachedRelation(() => Node.get(api, data.node_id, ['connection']));
+        this.node.setCache(data.node);
+    }
+}