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

package/script/src/resources/servers/types.d.ts

@@ -0,0 +1,199 @@
+import type { ISODate, NanoID, PowerState, ServerRestrictedState, SftpPermission } from '../../types.js';
+import type { EggData } from '../eggs.js';
+import type { MemberData } from '../members.js';
+import type { ServerGroupData } from '../server-groups.js';
+/** A single egg environment variable and its value for a server. @internal */
+export interface StartupVariableData {
+    name: string;
+    description: string;
+    value: string;
+    default: string;
+    /** Laravel validation rules string. */
+    rules: string;
+}
+/** Raw API shape for server status/utilization from the node. @internal */
+export interface ServerStatusData {
+    state: PowerState;
+    utilization?: {
+        memory_bytes: number;
+        memory_limit_bytes: number;
+        cpu_absolute: number;
+        network: {
+            rx_bytes: number;
+            tx_bytes: number;
+        };
+        uptime: number;
+        disk_bytes: number;
+    } | null;
+}
+/** Raw API shape for server build configuration. @internal */
+export interface ServerBuildData {
+    cpu_threads?: number | null;
+    io_weight?: number | null;
+    oom_type?: string | null;
+    skip_install_scripts?: boolean;
+    limits?: {
+        cpu_percent?: number | null;
+        ram_mb?: number | null;
+        swap_mb?: number | null;
+        storage_mb?: number | null;
+        allocation?: number | null;
+        database?: number | null;
+        backup?: number | null;
+    } | null;
+}
+/** Raw API shape for a single allocation port record. @internal */
+export interface ServerAllocationPortData {
+    id: string;
+    description?: string | null;
+    port_id?: string;
+    meta?: {
+        id: string;
+        ip: string;
+        port: number;
+        ready_protocols?: string[];
+        is_in_use?: boolean;
+        notes?: string | null;
+        created_at: ISODate;
+        updated_at: ISODate;
+    } | null;
+    is_primary: boolean;
+    created_at: ISODate;
+    updated_at: ISODate;
+}
+/** Raw API shape for the full allocations block. @internal */
+export interface ServerAllocationsData {
+    force_outgoing_ip?: boolean;
+    primary_id?: string | null;
+    ports: ServerAllocationPortData[];
+}
+/** Raw API shape for a server profile. @internal */
+export interface ServerProfileData {
+    id: string;
+    name: string;
+    description?: string | null;
+    notes?: string | null;
+    folder?: string | null;
+    is_active: boolean;
+    created_at: ISODate;
+    updated_at: ISODate;
+}
+/** Raw API shape for an activity log job log entry. @internal */
+export interface ActivityJobLogData {
+    type: string;
+    metadata: Record<string, unknown>;
+    created_at: ISODate;
+}
+/** Raw API shape for an activity job. @internal */
+export interface ActivityJobData {
+    id: string;
+    status: 'in_progress' | 'completed' | 'failed';
+    logs: ActivityJobLogData[];
+    completed_at: ISODate | null;
+    created_at: ISODate;
+    updated_at: ISODate;
+}
+/** Raw API shape for an activity log entry. @internal */
+export interface ActivityLogData {
+    id: string;
+    event: string;
+    server_id?: string | null;
+    node_id?: string | null;
+    issuer_id?: string | null;
+    issuer?: MemberData | null;
+    ip?: string | null;
+    metadata: Record<string, unknown>;
+    job_id?: string | null;
+    job?: ActivityJobData | null;
+    created_at: ISODate;
+}
+/** Raw API shape for an SFTP user. @internal */
+export interface SftpUserData {
+    id: string;
+    name: string;
+    username: string;
+    /** Only returned once at creation time. */
+    password?: string;
+    paths: Record<string, SftpPermission[]>;
+    owner_id: string;
+    owner?: MemberData | null;
+    last_login_at: ISODate | null;
+    created_at: ISODate;
+    updated_at: ISODate;
+}
+/** Raw API shape for the SFTP connection + users block. @internal */
+export interface SftpDetailsData {
+    connection: {
+        url: string;
+        fqdn: string;
+        port: number;
+    };
+    users: SftpUserData[];
+}
+/** Raw API shape for a file or directory entry from the Whisker node. @internal */
+export interface FileEntryData {
+    name: string;
+    created: ISODate;
+    modified: ISODate;
+    mode: string;
+    mode_bits: string;
+    size: number;
+    type: 'file' | 'directory';
+    symlink: boolean;
+    mime: string;
+}
+/** Raw API shape for a directory listing from the Whisker node. @internal */
+export interface DirectoryListingData {
+    entries: FileEntryData[];
+}
+/** Raw API shape for a server. @internal */
+export interface ServerData {
+    id: string;
+    name: string;
+    description: string | null;
+    notes?: string | null;
+    restricted_state: ServerRestrictedState;
+    group_id: string;
+    group?: ServerGroupData;
+    egg_id: string;
+    egg?: EggData;
+    egg_image_id?: string;
+    egg_image?: {
+        id: string;
+        image: string;
+    };
+    egg_image_override?: string | null;
+    status?: ServerStatusData | null;
+    build?: ServerBuildData | null;
+    startup?: {
+        command: string;
+        variables: Record<string, StartupVariableData>;
+    } | null;
+    allocations?: ServerAllocationsData | null;
+    profiles?: ServerProfileData[] | null;
+    created_at: ISODate;
+    updated_at: ISODate;
+}
+/** Payload for updating an existing server. All fields are optional. */
+export interface UpdateServerPayload {
+    /** New display name. */
+    name?: string;
+    /** New description, or `null` to clear. */
+    description?: string | null;
+    /** New internal notes, or `null` to clear. */
+    notes?: string | null;
+    /** Reassign the primary port allocation. */
+    allocationPrimary?: {
+        ip: string;
+        port: number;
+    };
+    /** Update startup command and/or environment variables. */
+    startup?: {
+        /** New startup command override, or `null` to reset to the egg default. */
+        command?: string | null;
+        /** Map of env variable keys to new values (or `null` to reset to default). */
+        variables?: Record<string, string | null>;
+    };
+}
+export type { ISODate, NanoID, PowerState, ServerRestrictedState, SftpPermission };
+//# sourceMappingURL=types.d.ts.map

package/script/src/resources/servers/types.d.ts.map

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

package/script/src/resources/servers/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/script/src/sse.d.ts

@@ -0,0 +1,53 @@
+/** State of an {@link SseConnection}. */
+export type SseState = 'disconnected' | 'connecting' | 'connected' | 'error';
+/**
+ * A generic, `fetch`-based Server-Sent Events client.
+ *
+ * Unlike the browser's native `EventSource`, this implementation sends an `Authorization`
+ * header, making it compatible with bearer token auth in all environments
+ * (browser, Deno, Node.js).
+ *
+ * @example
+ * ```ts ignore
+ * const sse = new SseConnection('https://panel.example.com/v1/sse', token);
+ * sse.connect(
+ *   (event, data) => console.log(event, data),
+ *   (err) => console.error('SSE error:', err),
+ * );
+ * // Later...
+ * sse.disconnect();
+ * ```
+ */
+export declare class SseConnection {
+    private readonly url;
+    private token;
+    private abortController?;
+    private _state;
+    /**
+     * @param url   The full URL to connect to.
+     * @param token Bearer token used in the `Authorization` header.
+     */
+    constructor(url: string, token: string);
+    /** Update the bearer token for subsequent reconnections. */
+    updateToken(token: string): void;
+    /** Current connection state. */
+    get state(): SseState;
+    /** `true` when the connection is actively open. */
+    get isConnected(): boolean;
+    /**
+     * Open the SSE connection and begin streaming events.
+     *
+     * This method is **non-blocking**: it starts the connection and returns immediately
+     * after the HTTP response headers are received. Events are delivered asynchronously
+     * via the `onEvent` callback.
+     *
+     * @param onEvent Callback invoked for each received SSE event, with the event name and raw data string.
+     * @param onError Optional callback invoked if the connection fails or is lost (not called on intentional disconnect).
+     */
+    connect(onEvent: (event: string, data: string) => void, onError?: (error: Error) => void): void;
+    /** Close the SSE connection and stop receiving events. */
+    disconnect(): void;
+    /** Parse the raw `ReadableStream` body into SSE frames, calling `onEvent` for each complete frame. */
+    private readStream;
+}
+//# sourceMappingURL=sse.d.ts.map

package/script/src/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/src/sse.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,OAAO,CAAC;AAE7E;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,aAAa;IASxB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,KAAK;IATd,OAAO,CAAC,eAAe,CAAC,CAAkB;IAC1C,OAAO,CAAC,MAAM,CAA4B;IAE1C;;;OAGG;gBAEe,GAAG,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM;IAGtB,4DAA4D;IACrD,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIvC,gCAAgC;IAChC,IAAW,KAAK,IAAI,QAAQ,CAE3B;IAED,mDAAmD;IACnD,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED;;;;;;;;;OASG;IACI,OAAO,CACb,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,EAC9C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAC9B,IAAI;IAyCP,0DAA0D;IACnD,UAAU,IAAI,IAAI;IAMzB,sGAAsG;YACxF,UAAU;CAmCxB"}

package/script/src/sse.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SseConnection = void 0;
+/**
+ * A generic, `fetch`-based Server-Sent Events client.
+ *
+ * Unlike the browser's native `EventSource`, this implementation sends an `Authorization`
+ * header, making it compatible with bearer token auth in all environments
+ * (browser, Deno, Node.js).
+ *
+ * @example
+ * ```ts ignore
+ * const sse = new SseConnection('https://panel.example.com/v1/sse', token);
+ * sse.connect(
+ *   (event, data) => console.log(event, data),
+ *   (err) => console.error('SSE error:', err),
+ * );
+ * // Later...
+ * sse.disconnect();
+ * ```
+ */
+class SseConnection {
+    url;
+    token;
+    abortController;
+    _state = 'disconnected';
+    /**
+     * @param url   The full URL to connect to.
+     * @param token Bearer token used in the `Authorization` header.
+     */
+    constructor(url, token) {
+        this.url = url;
+        this.token = token;
+    }
+    /** Update the bearer token for subsequent reconnections. */
+    updateToken(token) {
+        this.token = token;
+    }
+    /** Current connection state. */
+    get state() {
+        return this._state;
+    }
+    /** `true` when the connection is actively open. */
+    get isConnected() {
+        return this._state === 'connected';
+    }
+    /**
+     * Open the SSE connection and begin streaming events.
+     *
+     * This method is **non-blocking**: it starts the connection and returns immediately
+     * after the HTTP response headers are received. Events are delivered asynchronously
+     * via the `onEvent` callback.
+     *
+     * @param onEvent Callback invoked for each received SSE event, with the event name and raw data string.
+     * @param onError Optional callback invoked if the connection fails or is lost (not called on intentional disconnect).
+     */
+    connect(onEvent, onError) {
+        this.disconnect();
+        this._state = 'connecting';
+        const controller = new AbortController();
+        this.abortController = controller;
+        (async () => {
+            try {
+                const response = await globalThis.fetch(this.url, {
+                    headers: {
+                        'Authorization': `Bearer ${this.token}`,
+                        'Accept': 'text/event-stream',
+                        'Cache-Control': 'no-cache',
+                    },
+                    signal: controller.signal,
+                });
+                // Guard against a concurrent connect() that replaced our controller.
+                if (this.abortController !== controller)
+                    return;
+                if (!response.ok || !response.body) {
+                    throw new Error(`SSE connection failed: HTTP ${response.status}`);
+                }
+                this._state = 'connected';
+                await this.readStream(response.body, onEvent);
+            }
+            catch (err) {
+                if (err.name !== 'AbortError') {
+                    // Only update state if this is still the active connection.
+                    if (this.abortController !== controller)
+                        return;
+                    this._state = 'error';
+                    onError?.(err instanceof Error ? err : new Error(String(err)));
+                    return;
+                }
+            }
+            if (this.abortController === controller) {
+                this._state = 'disconnected';
+            }
+        })();
+    }
+    /** Close the SSE connection and stop receiving events. */
+    disconnect() {
+        this.abortController?.abort();
+        this.abortController = undefined;
+        this._state = 'disconnected';
+    }
+    /** Parse the raw `ReadableStream` body into SSE frames, calling `onEvent` for each complete frame. */
+    async readStream(body, onEvent) {
+        const reader = body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        let eventName = 'message';
+        let eventData = '';
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split('\n');
+                buffer = lines.pop() ?? '';
+                for (const line of lines) {
+                    if (line.startsWith('event:')) {
+                        eventName = line.slice(6).trim();
+                    }
+                    else if (line.startsWith('data:')) {
+                        eventData += (eventData ? '\n' : '') + line.slice(5).trim();
+                    }
+                    else if (line === '' && eventData) {
+                        onEvent(eventName, eventData);
+                        eventName = 'message';
+                        eventData = '';
+                    }
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+}
+exports.SseConnection = SseConnection;

package/script/src/types.d.ts

@@ -0,0 +1,126 @@
+/**
+ * A 12-character NanoID string used as the primary identifier for all MeowPanel resources.
+ *
+ * Branded to prevent accidental assignment of arbitrary strings where typed IDs are expected.
+ *
+ * @example
+ * ```ts ignore
+ * const id: NanoID = toNanoID('abc123def456');
+ * ```
+ */
+export type NanoID = string & {
+    readonly __nanoid: unique symbol;
+};
+/**
+ * Cast a raw string from the API to a {@link NanoID}.
+ *
+ * Only use this when you can guarantee the string is a valid NanoID
+ * (i.e., it came directly from an API response).
+ *
+ * @param raw The raw ID string from an API response.
+ */
+export declare function toNanoID(raw: string): NanoID;
+/** ISO 8601 date-time string as returned by the MeowPanel API, e.g. `"2024-01-15T12:00:00.000Z"`. */
+export type ISODate = string;
+/** Options for paginated list requests. */
+export interface ListOptions {
+    /** Page number (1-based). Defaults to 1. */
+    page?: number;
+    /** Number of items per page. Defaults to the server default. */
+    perPage?: number;
+    /** Full-text search or filter string. */
+    search?: string;
+}
+/**
+ * A paginated list of resources returned by a list endpoint.
+ *
+ * @template T The resource type returned in the list.
+ */
+export interface Paginated<T> {
+    /** Resources on the current page. */
+    data: T[];
+    /** Total number of resources matching the query across all pages. */
+    total: number;
+    /** Current page number (1-based). */
+    page: number;
+    /** Number of items per page. */
+    perPage: number;
+}
+/** Helper: merge a union of object types into a single intersection. */
+export type UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+/**
+ * Narrows a resource type `T` by intersecting it with the guaranteed fields
+ * from `IncludeMap` for each requested include key.
+ *
+ * @typeParam T - The base resource type.
+ * @typeParam IncludeMap - Maps each include key to the fields it guarantees.
+ * @typeParam I - Tuple of requested include keys.
+ *
+ * @example
+ * ```ts ignore
+ * type ServerWith<I> = ResourceWith<Server, ServerIncludeMap, I>;
+ * ```
+ */
+export type ResourceWith<T, IncludeMap, I extends readonly (keyof IncludeMap)[] = []> = T & UnionToIntersection<I[number] extends infer K ? K extends keyof IncludeMap ? IncludeMap[K] : never : never>;
+/**
+ * Options for selecting which related data to include in a resource response.
+ *
+ * @typeParam Include - The union of valid type-safe include keys for the resource.
+ * @typeParam I - Tuple of requested include keys (inferred from usage).
+ */
+export interface IncludeOptions<Include extends string, I extends readonly Include[] = []> {
+    /**
+     * Type-safe include keys. Each key guarantees the corresponding field
+     * on the returned resource is populated (non-undefined).
+     */
+    include?: I;
+    /**
+     * Additional include keys forwarded to the API without type narrowing.
+     *
+     * Use this for nested or less common includes that the type system doesn't
+     * track. The fields will be populated by the API but typed as optional.
+     */
+    rawInclude?: string[];
+}
+/**
+ * Joins the `include` and `rawInclude` arrays into a single comma-separated string
+ * suitable for the `?include=` query parameter.
+ *
+ * @returns The joined string, or `undefined` if there are no includes.
+ */
+export declare function joinIncludes(opts: {
+    include?: readonly string[];
+    rawInclude?: string[];
+}): string | undefined;
+/**
+ * A power control signal that can be sent to a server.
+ *
+ * - `start` – Start the server process.
+ * - `stop` – Send the configured stop command to the server.
+ * - `restart` – Stop and then start the server.
+ * - `kill` – Forcefully terminate the server process immediately.
+ */
+export type PowerSignal = 'start' | 'stop' | 'restart' | 'kill';
+/**
+ * The real-time operational power state of a server, as reported by its host node.
+ *
+ * - `online` – Server is running normally.
+ * - `offline` – Server is stopped.
+ * - `starting` – Server is in the process of starting.
+ * - `stopping` – Server is in the process of stopping.
+ * - `error` – Server encountered an error state.
+ * - `connecting` – The client is establishing a connection to the node.
+ */
+export type PowerState = 'online' | 'offline' | 'starting' | 'stopping' | 'error' | 'connecting';
+/**
+ * The restricted/operation state of a server as tracked by Nexus.
+ *
+ * When set, this overrides the node power state for display purposes.
+ * `null` means the server is in a normal operational state.
+ */
+export type ServerRestrictedState = 'installing' | 'install_failed' | 'restoring_backup' | 'maintenance' | 'transferring' | 'restricted' | 'expired' | 'overdue' | null;
+/**
+ * An SFTP permission scope that can be assigned to a path pattern for an SFTP user.
+ */
+export type SftpPermission = 'sftp.content.list' | 'sftp.content.read' | 'sftp.content.create' | 'sftp.content.manage' | 'sftp.content.delete';
+//# sourceMappingURL=types.d.ts.map

package/script/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,MAAM,CAAA;CAAE,CAAC;AAEnE;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,qGAAqG;AACrG,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC3B,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC;IAC3B,qCAAqC;IACrC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,wEAAwE;AACxE,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,IAAI,GAAG,CAAC,GAC/G,KAAK,CAAC;AAET;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,YAAY,CACvB,CAAC,EACD,UAAU,EACV,CAAC,SAAS,SAAS,CAAC,MAAM,UAAU,CAAC,EAAE,GAAG,EAAE,IAE1C,CAAC,GACD,mBAAmB,CACpB,CAAC,CAAC,MAAM,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC,SAAS,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,KAAK,CACtF,CAAC;AAEH;;;;;GAKG;AACH,MAAM,WAAW,cAAc,CAAC,OAAO,SAAS,MAAM,EAAE,CAAC,SAAS,SAAS,OAAO,EAAE,GAAG,EAAE;IACxF;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAAE,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAG7G;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAEhE;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,YAAY,CAAC;AAEjG;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAC9B,YAAY,GACZ,gBAAgB,GAChB,kBAAkB,GAClB,aAAa,GACb,cAAc,GACd,YAAY,GACZ,SAAS,GACT,SAAS,GACT,IAAI,CAAC;AAER;;GAEG;AACH,MAAM,MAAM,cAAc,GACvB,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB,GACrB,qBAAqB,GACrB,qBAAqB,CAAC"}

package/script/src/types.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toNanoID = toNanoID;
+exports.joinIncludes = joinIncludes;
+/**
+ * Cast a raw string from the API to a {@link NanoID}.
+ *
+ * Only use this when you can guarantee the string is a valid NanoID
+ * (i.e., it came directly from an API response).
+ *
+ * @param raw The raw ID string from an API response.
+ */
+function toNanoID(raw) {
+    return raw;
+}
+/**
+ * Joins the `include` and `rawInclude` arrays into a single comma-separated string
+ * suitable for the `?include=` query parameter.
+ *
+ * @returns The joined string, or `undefined` if there are no includes.
+ */
+function joinIncludes(opts) {
+    const parts = [...(opts.include ?? []), ...(opts.rawInclude ?? [])];
+    return parts.length ? parts.join(',') : undefined;
+}

package/esm/api.d.ts

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

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