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

package/script/src/resources/eggs.d.ts

@@ -0,0 +1,238 @@
+import type { HttpClient } from '../http.js';
+import { ResourceNamespace } from '../namespace.js';
+import { ReactiveResource } from '../reactive.js';
+import type { IncludeOptions, ResourceWith } from '../types.js';
+import { type ISODate, type NanoID, type Paginated } from '../types.js';
+/** Raw API shape for an egg nest (category). @internal */
+export interface EggNestData {
+    id: string;
+    name: string;
+}
+/** Raw API shape for an egg installer. @internal */
+export interface EggInstallerData {
+    image: string | null;
+    entry_command: string | null;
+    script: string | null;
+}
+/** Raw API shape for an egg image. @internal */
+export interface EggImageData {
+    id: string;
+    name: string;
+    image: string;
+    created_at: ISODate;
+    updated_at: ISODate;
+}
+/** Raw API shape for egg process configuration. @internal */
+interface EggProcessData {
+    startup: Record<string, unknown>;
+    stop: {
+        type: 'signal' | 'command';
+        value: string;
+    };
+    logs: Record<string, unknown>;
+    files: unknown[];
+    file_blacklist_regex: string;
+}
+/** Raw API shape for an egg. @internal */
+export interface EggData {
+    id: string;
+    name: string;
+    description: string | null;
+    nest?: EggNestData | null;
+    startup_command: string;
+    stop_command: string;
+    force_outgoing_ip: boolean;
+    installer?: EggInstallerData | null;
+    process?: EggProcessData | null;
+    images?: EggImageData[];
+    created_at: ISODate;
+    updated_at: ISODate;
+}
+/**
+ * A category (nest) that groups related eggs.
+ */
+export declare class EggNest extends ReactiveResource {
+    /** Unique NanoID of this nest. */
+    readonly id: NanoID;
+    /** Display name of the nest, e.g. `"Minecraft"`. */
+    name: string;
+    /** @internal */
+    constructor(data: EggNestData);
+}
+/**
+ * An egg image (Docker image variant) associated with an egg.
+ */
+export interface EggImage {
+    /** The egg image's unique NanoID. */
+    id: NanoID;
+    /** Display name of this image variant. */
+    name: string;
+    /** Docker image reference, e.g. `"ghcr.io/parkervcp/yolks:java_21"`. */
+    image: string;
+    /** When this image was created. */
+    createdAt: Date;
+    /** When this image was last updated. */
+    updatedAt: Date;
+}
+/**
+ * Process configuration for an egg (startup, stop, logging).
+ */
+export interface EggProcess {
+    /** Startup configuration. */
+    startup: Record<string, unknown>;
+    /** Stop configuration. */
+    stop: {
+        type: 'signal' | 'command';
+        value: string;
+    };
+    /** Log configuration. */
+    logs: Record<string, unknown>;
+    /** File configuration. */
+    files: unknown[];
+    /** Regex pattern for blacklisted files. */
+    fileBlacklistRegex: string;
+}
+/**
+ * The installation script configuration for an egg.
+ */
+export interface EggInstaller {
+    /** Docker image used to run the installer script. */
+    image: string | null;
+    /** Entry command for the installer container. */
+    entryCommand: string | null;
+    /** The install script content. */
+    script: string | null;
+}
+/**
+ * An egg - a game or application configuration template that defines how a server
+ * is installed, started, and stopped.
+ *
+ * Retrieved via {@link EggsNamespace.get} or {@link EggsNamespace.list}.
+ */
+export declare class Egg extends ReactiveResource {
+    /** The egg's unique NanoID. */
+    readonly id: NanoID;
+    /** Display name of the egg, e.g. `"Vanilla Minecraft"`. */
+    name: string;
+    /** Description of the egg. */
+    description: string | null;
+    /** The nest (category) this egg belongs to. */
+    nest: EggNest | null | undefined;
+    /**
+     * The startup command template, e.g.
+     * `"java -Xms128M -Xmx{{SERVER_MEMORY}}M -jar {{SERVER_JARFILE}}"`.
+     */
+    startupCommand: string;
+    /**
+     * The stop command sent to the server to shut it down gracefully,
+     * e.g. `"stop"` or `"^C"`.
+     */
+    stopCommand: string;
+    /** When `true`, the server's outgoing IP is forced to match the allocation IP. */
+    forceOutgoingIp: boolean;
+    /** Installer configuration for this egg. */
+    installer: EggInstaller | null | undefined;
+    /** Process configuration (startup, stop, logging). */
+    process: EggProcess | null | undefined;
+    /** Docker image variants for this egg. */
+    images: EggImage[] | undefined;
+    /** When this egg was created. */
+    createdAt: Date;
+    /** When this egg was last updated. */
+    updatedAt: Date;
+    /** @internal */
+    constructor(data: EggData);
+}
+/** Fields that can be updated on an egg. All fields are optional. */
+export interface UpdateEggPayload {
+    /** New display name. */
+    name?: string;
+    /** New description. */
+    description?: string;
+    /** NanoID of a different nest to move the egg to. */
+    nestId?: NanoID;
+    /** New startup command template. */
+    startupCommand?: string;
+    /** New stop command. */
+    stopCommand?: string;
+    /** Update `force_outgoing_ip` setting. */
+    forceOutgoingIp?: boolean;
+    /** Installer configuration updates. */
+    installer?: {
+        image?: string;
+        entryCommand?: string;
+        script?: string;
+    };
+}
+/** Valid include keys for egg endpoints. */
+export type EggInclude = 'installer' | 'process' | 'images';
+/** Maps each {@link EggInclude} key to the field(s) it guarantees on the {@link Egg} instance. */
+interface EggIncludeMap {
+    installer: {
+        installer: EggInstaller | null;
+    };
+    process: {
+        process: EggProcess | null;
+    };
+    images: {
+        images: EggImageData[];
+    };
+}
+/** A {@link Egg} with specific include fields guaranteed to be populated. */
+export type EggWith<I extends readonly EggInclude[] = []> = ResourceWith<Egg, EggIncludeMap, I>;
+/** Typed events emitted by {@link EggsNamespace}. */
+export interface EggEvents {
+    /** Fired after an egg is successfully updated. */
+    updated: Egg;
+    /** Fired after an egg is deleted. Payload is the deleted egg's NanoID. */
+    deleted: NanoID;
+}
+/**
+ * Namespace for egg management.
+ *
+ * Access via `api.eggs`.
+ *
+ * @example
+ * ```ts ignore
+ * const eggs = await api.eggs.list();
+ * const egg = await api.eggs.get(id);
+ * await api.eggs.update(id, { name: 'Paper Minecraft' });
+ * await api.eggs.delete(id);
+ * ```
+ */
+export declare class EggsNamespace extends ResourceNamespace<Egg, EggEvents> {
+    /** @internal */
+    constructor(http: HttpClient);
+    /**
+     * Fetch a paginated list of eggs.
+     *
+     * @param opts Pagination, search, and include options.
+     */
+    list<const I extends readonly EggInclude[] = []>(opts?: {
+        page?: number;
+        perPage?: number;
+        search?: string;
+    } & IncludeOptions<EggInclude, I>): Promise<Paginated<EggWith<I>>>;
+    /**
+     * Fetch a single egg by ID.
+     *
+     * @param id   The egg's NanoID.
+     * @param opts Include options.
+     */
+    get<const I extends readonly EggInclude[] = []>(id: NanoID, opts?: IncludeOptions<EggInclude, I>): Promise<EggWith<I>>;
+    /**
+     * Update an egg's configuration.
+     *
+     * @param id      The egg's NanoID.
+     * @param payload The fields to update.
+     */
+    update(id: NanoID, payload: UpdateEggPayload): Promise<Egg>;
+    /**
+     * Delete an egg permanently.
+     *
+     * @param id The egg's NanoID.
+     */
+    delete(id: NanoID): Promise<void>;
+}
+export {};
+//# sourceMappingURL=eggs.d.ts.map

package/script/src/resources/eggs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eggs.d.ts","sourceRoot":"","sources":["../../../src/src/resources/eggs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,KAAK,OAAO,EAAgB,KAAK,MAAM,EAAE,KAAK,SAAS,EAAY,MAAM,aAAa,CAAC;AAEhG,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACb;AAED,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,gDAAgD;AAChD,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;CACpB;AAED,6DAA6D;AAC7D,UAAU,cAAc;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,EAAE;QAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,oBAAoB,EAAE,MAAM,CAAC;CAC7B;AAED,0CAA0C;AAC1C,MAAM,WAAW,OAAO;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,OAAQ,SAAQ,gBAAgB;IAC5C,kCAAkC;IAClC,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,oDAAoD;IAC7C,IAAI,EAAE,MAAM,CAAC;IAEpB,gBAAgB;gBACG,IAAI,EAAE,WAAW;CAKpC;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,SAAS,EAAE,IAAI,CAAC;IAChB,wCAAwC;IACxC,SAAS,EAAE,IAAI,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,0BAA0B;IAC1B,IAAI,EAAE;QAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,0BAA0B;IAC1B,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,2CAA2C;IAC3C,kBAAkB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,qDAAqD;IACrD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,iDAAiD;IACjD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kCAAkC;IAClC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,GAAI,SAAQ,gBAAgB;IACxC,+BAA+B;IAC/B,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IACpD,IAAI,EAAE,MAAM,CAAC;IACpB,8BAA8B;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,+CAA+C;IACxC,IAAI,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IACxC;;;OAGG;IACI,cAAc,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACI,WAAW,EAAE,MAAM,CAAC;IAC3B,kFAAkF;IAC3E,eAAe,EAAE,OAAO,CAAC;IAChC,4CAA4C;IACrC,SAAS,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,CAAC;IAClD,sDAAsD;IAC/C,OAAO,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC;IAC9C,0CAA0C;IACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;IACtC,iCAAiC;IAC1B,SAAS,EAAE,IAAI,CAAC;IACvB,sCAAsC;IAC/B,SAAS,EAAE,IAAI,CAAC;IAEvB,gBAAgB;gBACG,IAAI,EAAE,OAAO;CAmChC;AAED,qEAAqE;AACrE,MAAM,WAAW,gBAAgB;IAChC,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,uCAAuC;IACvC,SAAS,CAAC,EAAE;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACF;AAED,4CAA4C;AAC5C,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE5D,kGAAkG;AAClG,UAAU,aAAa;IACtB,SAAS,EAAE;QAAE,SAAS,EAAE,YAAY,GAAG,IAAI,CAAA;KAAE,CAAC;IAC9C,OAAO,EAAE;QAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAAA;KAAE,CAAC;IACxC,MAAM,EAAE;QAAE,MAAM,EAAE,YAAY,EAAE,CAAA;KAAE,CAAC;CACnC;AAED,6EAA6E;AAC7E,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,SAAS,UAAU,EAAE,GAAG,EAAE,IAAI,YAAY,CACvE,GAAG,EACH,aAAa,EACb,CAAC,CACD,CAAC;AAEF,qDAAqD;AACrD,MAAM,WAAW,SAAS;IACzB,kDAAkD;IAClD,OAAO,EAAE,GAAG,CAAC;IACb,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAc,SAAQ,iBAAiB,CAAC,GAAG,EAAE,SAAS,CAAC;IACnE,gBAAgB;gBACG,IAAI,EAAE,UAAU;IAInC;;;;OAIG;IACU,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,UAAU,EAAE,GAAG,EAAE,EAC3D,IAAI,GACD;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACpD,cAAc,CACf,UAAU,EACV,CAAC,CAK+B,GAChC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAWjC;;;;;OAKG;IACU,GAAG,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,UAAU,EAAE,GAAG,EAAE,EAC1D,EAAE,EAAE,MAAM,EACV,IAAI,GAAE,cAAc,CAAC,UAAU,EAAE,CAAC,CAAM,GACtC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAQtB;;;;;OAKG;IACU,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC;IA+BxE;;;;OAIG;IACU,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAK9C"}

package/script/src/resources/eggs.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EggsNamespace = exports.Egg = exports.EggNest = void 0;
+const namespace_js_1 = require("../namespace.js");
+const reactive_js_1 = require("../reactive.js");
+const types_js_1 = require("../types.js");
+/**
+ * A category (nest) that groups related eggs.
+ */
+class EggNest extends reactive_js_1.ReactiveResource {
+    /** Unique NanoID of this nest. */
+    id;
+    /** Display name of the nest, e.g. `"Minecraft"`. */
+    name;
+    /** @internal */
+    constructor(data) {
+        super();
+        this.id = (0, types_js_1.toNanoID)(data.id);
+        this.name = data.name;
+    }
+}
+exports.EggNest = EggNest;
+/**
+ * An egg - a game or application configuration template that defines how a server
+ * is installed, started, and stopped.
+ *
+ * Retrieved via {@link EggsNamespace.get} or {@link EggsNamespace.list}.
+ */
+class Egg extends reactive_js_1.ReactiveResource {
+    /** The egg's unique NanoID. */
+    id;
+    /** Display name of the egg, e.g. `"Vanilla Minecraft"`. */
+    name;
+    /** Description of the egg. */
+    description;
+    /** The nest (category) this egg belongs to. */
+    nest;
+    /**
+     * The startup command template, e.g.
+     * `"java -Xms128M -Xmx{{SERVER_MEMORY}}M -jar {{SERVER_JARFILE}}"`.
+     */
+    startupCommand;
+    /**
+     * The stop command sent to the server to shut it down gracefully,
+     * e.g. `"stop"` or `"^C"`.
+     */
+    stopCommand;
+    /** When `true`, the server's outgoing IP is forced to match the allocation IP. */
+    forceOutgoingIp;
+    /** Installer configuration for this egg. */
+    installer;
+    /** Process configuration (startup, stop, logging). */
+    process;
+    /** Docker image variants for this egg. */
+    images;
+    /** When this egg was created. */
+    createdAt;
+    /** When this egg was last updated. */
+    updatedAt;
+    /** @internal */
+    constructor(data) {
+        super();
+        this.id = (0, types_js_1.toNanoID)(data.id);
+        this.name = data.name;
+        this.description = data.description;
+        this.nest = data.nest ? new EggNest(data.nest) : data.nest;
+        this.startupCommand = data.startup_command;
+        this.stopCommand = data.stop_command;
+        this.forceOutgoingIp = data.force_outgoing_ip;
+        this.installer = data.installer
+            ? {
+                image: data.installer.image,
+                entryCommand: data.installer.entry_command,
+                script: data.installer.script,
+            }
+            : data.installer;
+        this.process = data.process
+            ? {
+                startup: data.process.startup,
+                stop: data.process.stop,
+                logs: data.process.logs,
+                files: data.process.files,
+                fileBlacklistRegex: data.process.file_blacklist_regex,
+            }
+            : data.process;
+        this.images = data.images?.map((img) => ({
+            id: (0, types_js_1.toNanoID)(img.id),
+            name: img.name,
+            image: img.image,
+            createdAt: new Date(img.created_at),
+            updatedAt: new Date(img.updated_at),
+        }));
+        this.createdAt = new Date(data.created_at);
+        this.updatedAt = new Date(data.updated_at);
+    }
+}
+exports.Egg = Egg;
+/**
+ * Namespace for egg management.
+ *
+ * Access via `api.eggs`.
+ *
+ * @example
+ * ```ts ignore
+ * const eggs = await api.eggs.list();
+ * const egg = await api.eggs.get(id);
+ * await api.eggs.update(id, { name: 'Paper Minecraft' });
+ * await api.eggs.delete(id);
+ * ```
+ */
+class EggsNamespace extends namespace_js_1.ResourceNamespace {
+    /** @internal */
+    constructor(http) {
+        super(http);
+    }
+    /**
+     * Fetch a paginated list of eggs.
+     *
+     * @param opts Pagination, search, and include options.
+     */
+    async list(opts = {}) {
+        const extra = {};
+        const include = (0, types_js_1.joinIncludes)(opts);
+        if (include)
+            extra['include'] = include;
+        const result = await this.http.list('/eggs', opts, extra);
+        const eggs = result.data.map((d) => new Egg(d));
+        this.setCache(eggs);
+        return { ...result, data: eggs };
+    }
+    /**
+     * Fetch a single egg by ID.
+     *
+     * @param id   The egg's NanoID.
+     * @param opts Include options.
+     */
+    async get(id, opts = {}) {
+        const params = {};
+        const include = (0, types_js_1.joinIncludes)(opts);
+        if (include)
+            params['include'] = include;
+        const data = await this.http.get(`/eggs/${id}`, { params });
+        return new Egg(data);
+    }
+    /**
+     * Update an egg's configuration.
+     *
+     * @param id      The egg's NanoID.
+     * @param payload The fields to update.
+     */
+    async update(id, payload) {
+        const body = {};
+        if (payload.name !== undefined)
+            body['name'] = payload.name;
+        if (payload.description !== undefined) {
+            body['description'] = payload.description;
+        }
+        if (payload.nestId !== undefined)
+            body['nest_id'] = payload.nestId;
+        if (payload.startupCommand !== undefined) {
+            body['startup_command'] = payload.startupCommand;
+        }
+        if (payload.stopCommand !== undefined) {
+            body['stop_command'] = payload.stopCommand;
+        }
+        if (payload.forceOutgoingIp !== undefined) {
+            body['force_outgoing_ip'] = payload.forceOutgoingIp;
+        }
+        if (payload.installer) {
+            body['installer'] = {
+                image: payload.installer.image,
+                entry_command: payload.installer.entryCommand,
+                script: payload.installer.script,
+            };
+        }
+        const data = await this.http.patch(`/eggs/${id}`, body);
+        const egg = new Egg(data);
+        this.upsertCache(egg);
+        this.emit('updated', egg);
+        return egg;
+    }
+    /**
+     * Delete an egg permanently.
+     *
+     * @param id The egg's NanoID.
+     */
+    async delete(id) {
+        await this.http.delete(`/eggs/${id}`);
+        this.removeFromCache(id);
+        this.emit('deleted', id);
+    }
+}
+exports.EggsNamespace = EggsNamespace;

package/script/src/resources/hosts.d.ts

@@ -0,0 +1,62 @@
+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';
+/** Raw API shape for a physical host. @internal */
+export interface HostData {
+    id: string;
+    hostname: string;
+    name?: string | null;
+    color?: string | null;
+    notes?: string | null;
+    created_at: ISODate;
+    updated_at: ISODate;
+}
+/**
+ * A physical host machine on which nodes are deployed.
+ *
+ * Retrieved via {@link HostsNamespace.list}.
+ */
+export declare class Host extends ReactiveResource {
+    /** The host's unique NanoID. */
+    readonly id: NanoID;
+    /** The host's hostname, e.g. `"host.example.com"`. */
+    hostname: string;
+    /** Optional display name for the host. */
+    name: string | null | undefined;
+    /** Optional color used in the UI for grouping. */
+    color: string | null | undefined;
+    /** Internal notes. */
+    notes: string | null | undefined;
+    /** When this host was registered. */
+    createdAt: Date;
+    /** When this host was last updated. */
+    updatedAt: Date;
+    /** @internal */
+    constructor(data: HostData);
+}
+/**
+ * Namespace for host management.
+ *
+ * Access via `api.hosts`.
+ *
+ * @example
+ * ```ts ignore
+ * const hosts = await api.hosts.list();
+ * ```
+ */
+export declare class HostsNamespace extends ResourceNamespace<Host> {
+    /** @internal */
+    constructor(http: HttpClient);
+    /**
+     * Fetch a paginated list of physical hosts.
+     *
+     * @param opts Pagination and search options.
+     */
+    list(opts?: {
+        page?: number;
+        perPage?: number;
+        search?: string;
+    }): Promise<Paginated<Host>>;
+}
+//# sourceMappingURL=hosts.d.ts.map

package/script/src/resources/hosts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosts.d.ts","sourceRoot":"","sources":["../../../src/src/resources/hosts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,SAAS,EAAY,MAAM,aAAa,CAAC;AAElF,mDAAmD;AACnD,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,qBAAa,IAAK,SAAQ,gBAAgB;IACzC,gCAAgC;IAChC,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACxB,0CAA0C;IACnC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACvC,kDAAkD;IAC3C,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxC,sBAAsB;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxC,qCAAqC;IAC9B,SAAS,EAAE,IAAI,CAAC;IACvB,uCAAuC;IAChC,SAAS,EAAE,IAAI,CAAC;IAEvB,gBAAgB;gBACG,IAAI,EAAE,QAAQ;CAUjC;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAe,SAAQ,iBAAiB,CAAC,IAAI,CAAC;IAC1D,gBAAgB;gBACG,IAAI,EAAE,UAAU;IAInC;;;;OAIG;IACU,IAAI,CAAC,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;CAM5G"}

package/script/src/resources/hosts.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HostsNamespace = exports.Host = void 0;
+const namespace_js_1 = require("../namespace.js");
+const reactive_js_1 = require("../reactive.js");
+const types_js_1 = require("../types.js");
+/**
+ * A physical host machine on which nodes are deployed.
+ *
+ * Retrieved via {@link HostsNamespace.list}.
+ */
+class Host extends reactive_js_1.ReactiveResource {
+    /** The host's unique NanoID. */
+    id;
+    /** The host's hostname, e.g. `"host.example.com"`. */
+    hostname;
+    /** Optional display name for the host. */
+    name;
+    /** Optional color used in the UI for grouping. */
+    color;
+    /** Internal notes. */
+    notes;
+    /** When this host was registered. */
+    createdAt;
+    /** When this host was last updated. */
+    updatedAt;
+    /** @internal */
+    constructor(data) {
+        super();
+        this.id = (0, types_js_1.toNanoID)(data.id);
+        this.hostname = data.hostname;
+        this.name = data.name;
+        this.color = data.color;
+        this.notes = data.notes;
+        this.createdAt = new Date(data.created_at);
+        this.updatedAt = new Date(data.updated_at);
+    }
+}
+exports.Host = Host;
+/**
+ * Namespace for host management.
+ *
+ * Access via `api.hosts`.
+ *
+ * @example
+ * ```ts ignore
+ * const hosts = await api.hosts.list();
+ * ```
+ */
+class HostsNamespace extends namespace_js_1.ResourceNamespace {
+    /** @internal */
+    constructor(http) {
+        super(http);
+    }
+    /**
+     * Fetch a paginated list of physical hosts.
+     *
+     * @param opts Pagination and search options.
+     */
+    async list(opts = {}) {
+        const result = await this.http.list('/hosts', opts);
+        const hosts = result.data.map((d) => new Host(d));
+        this.setCache(hosts);
+        return { ...result, data: hosts };
+    }
+}
+exports.HostsNamespace = HostsNamespace;