@meowpanel/api 0.3.0 → 0.5.0

package/esm/src/resources/eggs.js

@@ -7,8 +7,6 @@ import { joinIncludes, toNanoID } from '../types.js';
 export class EggNest extends ReactiveResource {
     /** Unique NanoID of this nest. */
     id;
-    /** The issuer type. */
-    issuerType;
     /** Display name of the nest, e.g. `"Minecraft"`. */
     name;
     /** Description of the nest. */
@@ -21,13 +19,65 @@ export class EggNest extends ReactiveResource {
     constructor(data) {
         super();
         this.id = toNanoID(data.id);
-        this.issuerType = data.issuer_type;
         this.name = data.name;
         this.description = data.description;
         this.createdAt = new Date(data.created_at);
         this.updatedAt = new Date(data.updated_at);
     }
 }
+function makeEggImage(data) {
+    return {
+        id: toNanoID(data.id),
+        name: data.name,
+        image: data.image,
+        createdAt: new Date(data.created_at),
+        updatedAt: new Date(data.updated_at),
+    };
+}
+/**
+ * An egg environment variable.
+ *
+ * Retrieved via {@link EggVariablesManager.list} or {@link EggVariablesManager.get}.
+ */
+export class EggVariable extends ReactiveResource {
+    /** The variable's unique NanoID. */
+    id;
+    /** Display name, e.g. `"Server Jar File"`. */
+    name;
+    /** Description shown to the user. */
+    description;
+    /** The environment variable name, e.g. `"SERVER_JARFILE"`. */
+    envVariable;
+    /** The default value. */
+    defaultValue;
+    /** Whether the value is visible to the server user. */
+    userViewable;
+    /** Whether the server user may change the value. */
+    userEditable;
+    /** Validation rules string, e.g. `"required|string"`. */
+    rules;
+    /** When this variable was created. */
+    createdAt;
+    /** When this variable was last updated. */
+    updatedAt;
+    /** @internal */
+    constructor(data) {
+        super();
+        this.id = toNanoID(data.id);
+        this.name = data.name;
+        this.description = data.description;
+        this.envVariable = data.env_variable;
+        this.defaultValue = data.default_value;
+        this.userViewable = data.user_viewable;
+        this.userEditable = data.user_editable;
+        this.rules = data.rules;
+        this.createdAt = new Date(data.created_at);
+        this.updatedAt = new Date(data.updated_at);
+    }
+}
+function makeFeatureGrant(data) {
+    return { name: data.name, defaultEnabled: data.default_enabled, locked: data.locked, obsolete: data.obsolete };
+}
 /**
  * An egg - a game or application configuration template that defines how a server
  * is installed, started, and stopped.
@@ -37,8 +87,6 @@ export class EggNest extends ReactiveResource {
 export class Egg extends ReactiveResource {
     /** The egg's unique NanoID. */
     id;
-    /** The issuer type. */
-    issuerType;
     /** Display name of the egg, e.g. `"Vanilla Minecraft"`. */
     name;
     /** Description of the egg. */
@@ -59,11 +107,13 @@ export class Egg extends ReactiveResource {
     stopCommand;
     /** When `true`, the server's outgoing IP is forced to match the allocation IP. */
     forceOutgoingIp;
-    /** Installer configuration for this egg. */
+    /** URL of the egg's background image. Requires `?include=app_background_url`. */
+    appBackgroundUrl;
+    /** Installer configuration for this egg. Requires `?include=installer`. */
     installer;
-    /** Process configuration (startup, stop, logging). */
+    /** Process configuration. Requires `?include=process` and `egg.config.process.read`. */
     process;
-    /** Docker image variants for this egg. */
+    /** Docker image variants for this egg. Requires `?include=images`. */
     images;
     /** When this egg was created. */
     createdAt;
@@ -73,7 +123,6 @@ export class Egg extends ReactiveResource {
     constructor(data) {
         super();
         this.id = toNanoID(data.id);
-        this.issuerType = data.issuer_type;
         this.name = data.name;
         this.description = data.description;
         this.nestId = toNanoID(data.nest_id);
@@ -81,6 +130,7 @@ export class Egg extends ReactiveResource {
         this.startupCommand = data.startup_command;
         this.stopCommand = data.stop_command;
         this.forceOutgoingIp = data.force_outgoing_ip;
+        this.appBackgroundUrl = data.app_background_url;
         this.installer = data.installer
             ? {
                 image: data.installer.image,
@@ -97,17 +147,158 @@ export class Egg extends ReactiveResource {
                 fileBlacklistRegex: data.process.file_blacklist_regex,
             }
             : data.process;
-        this.images = data.images?.map((img) => ({
-            id: toNanoID(img.id),
-            name: img.name,
-            image: img.image,
-            createdAt: new Date(img.created_at),
-            updatedAt: new Date(img.updated_at),
-        }));
+        this.images = data.images?.map(makeEggImage);
         this.createdAt = new Date(data.created_at);
         this.updatedAt = new Date(data.updated_at);
     }
 }
+function configStartupBody(startup) {
+    return { done: startup.done, user_interaction: startup.userInteraction, strip_ansi: startup.stripAnsi };
+}
+/**
+ * Manages egg nests (categories).
+ *
+ * Access via `api.eggs.nests`.
+ */
+export class EggNestsManager {
+    http;
+    /** @internal */
+    constructor(http) {
+        this.http = http;
+    }
+    /** Fetch all nests readable by the caller. */
+    async list() {
+        const data = await this.http.get('/eggs/nests');
+        return data.map((d) => new EggNest(d));
+    }
+    /** Fetch a single nest by ID. */
+    async get(id) {
+        return new EggNest(await this.http.get(`/eggs/nests/${id}`));
+    }
+    /** Create a nest. Omit `hostId` for a global nest. */
+    async create(payload) {
+        const data = await this.http.post('/eggs/nests', {
+            name: payload.name,
+            description: payload.description,
+            host_id: payload.hostId,
+        });
+        return new EggNest(data);
+    }
+    /** Update a nest's name or description. */
+    async update(id, payload) {
+        return new EggNest(await this.http.patch(`/eggs/nests/${id}`, payload));
+    }
+    /** Delete a nest. Fails if it still contains eggs. */
+    async delete(id) {
+        await this.http.delete(`/eggs/nests/${id}`);
+    }
+}
+function variableBody(payload) {
+    return {
+        name: payload.name,
+        description: payload.description,
+        env_variable: payload.envVariable,
+        default_value: payload.defaultValue,
+        user_viewable: payload.userViewable,
+        user_editable: payload.userEditable,
+        rules: payload.rules,
+    };
+}
+/**
+ * Manages the environment variables of a specific egg.
+ *
+ * Access via `api.eggs.variables(eggId)`.
+ */
+export class EggVariablesManager {
+    eggId;
+    http;
+    /** @internal */
+    constructor(eggId, http) {
+        this.eggId = eggId;
+        this.http = http;
+    }
+    /** List the egg's variables. */
+    async list() {
+        const data = await this.http.get(`/eggs/${this.eggId}/variables`);
+        return data.map((d) => new EggVariable(d));
+    }
+    /** Fetch a single variable by ID. */
+    async get(variableId) {
+        return new EggVariable(await this.http.get(`/eggs/${this.eggId}/variables/${variableId}`));
+    }
+    /** Create a variable. */
+    async create(payload) {
+        return new EggVariable(await this.http.post(`/eggs/${this.eggId}/variables`, variableBody(payload)));
+    }
+    /** Update a variable. */
+    async update(variableId, payload) {
+        return new EggVariable(await this.http.patch(`/eggs/${this.eggId}/variables/${variableId}`, variableBody(payload)));
+    }
+    /** Delete a variable. */
+    async delete(variableId) {
+        await this.http.delete(`/eggs/${this.eggId}/variables/${variableId}`);
+    }
+}
+/**
+ * Manages the Docker image variants of a specific egg.
+ *
+ * Access via `api.eggs.images(eggId)`.
+ */
+export class EggImagesManager {
+    eggId;
+    http;
+    /** @internal */
+    constructor(eggId, http) {
+        this.eggId = eggId;
+        this.http = http;
+    }
+    /** List the egg's images. */
+    async list() {
+        const data = await this.http.get(`/eggs/${this.eggId}/images`);
+        return data.map(makeEggImage);
+    }
+    /** Add an image to the egg. */
+    async create(payload) {
+        return makeEggImage(await this.http.post(`/eggs/${this.eggId}/images`, payload));
+    }
+    /** Remove an image. Fails if it is in use or is the egg's last image. */
+    async delete(imageId) {
+        await this.http.delete(`/eggs/${this.eggId}/images/${imageId}`);
+    }
+}
+/**
+ * Manages the feature grants attached to a specific egg.
+ *
+ * Access via `api.eggs.features(eggId)`.
+ */
+export class EggFeaturesManager {
+    eggId;
+    http;
+    /** @internal */
+    constructor(eggId, http) {
+        this.eggId = eggId;
+        this.http = http;
+    }
+    /** List the egg's feature grants. */
+    async list() {
+        const data = await this.http.get(`/eggs/${this.eggId}/features`);
+        return data.map(makeFeatureGrant);
+    }
+    /**
+     * Grant a feature on the egg, or update its policy (upsert).
+     *
+     * @param feature The feature key.
+     * @param policy  Defaults to `defaultEnabled: true`, `locked: false`.
+     */
+    async set(feature, policy = {}) {
+        const data = await this.http.put(`/eggs/${this.eggId}/features/${encodeURIComponent(feature)}`, JSON.stringify({ default_enabled: policy.defaultEnabled, locked: policy.locked }), 'application/json');
+        return makeFeatureGrant(data);
+    }
+    /** Remove a feature grant from the egg. */
+    async remove(feature) {
+        await this.http.delete(`/eggs/${this.eggId}/features/${encodeURIComponent(feature)}`);
+    }
+}
 /**
  * Namespace for egg management.
  *
@@ -118,13 +309,16 @@ export class Egg extends ReactiveResource {
  * 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);
+ * await api.eggs.variables(id).create({ name: 'Jar', description: '', envVariable: 'JAR', defaultValue: 'server.jar' });
  * ```
  */
 export class EggsNamespace extends ResourceNamespace {
+    /** Manage egg nests (categories). */
+    nests;
     /** @internal */
     constructor(http) {
         super(http);
+        this.nests = new EggNestsManager(http);
     }
     /**
      * Fetch a paginated list of eggs.
@@ -155,6 +349,32 @@ export class EggsNamespace extends ResourceNamespace {
         const data = await this.http.get(`/eggs/${id}`, { params });
         return new Egg(data);
     }
+    /** Create a new egg. */
+    async create(payload) {
+        const body = {
+            nest_id: payload.nestId,
+            name: payload.name,
+            description: payload.description,
+            startup_command: payload.startupCommand,
+            stop_command: payload.stopCommand,
+            installer: {
+                image: payload.installer.image,
+                entry_command: payload.installer.entryCommand,
+                script: payload.installer.script,
+            },
+            images: payload.images,
+            force_outgoing_ip: payload.forceOutgoingIp,
+            file_blacklist_regex: payload.fileBlacklistRegex,
+            config_files: payload.configFiles,
+            config_startup: payload.configStartup ? configStartupBody(payload.configStartup) : undefined,
+            config_logs: payload.configLogs,
+        };
+        const data = await this.http.post('/eggs', body);
+        const egg = new Egg(data);
+        this.addToCache(egg);
+        this.emit('created', egg);
+        return egg;
+    }
     /**
      * Update an egg's configuration.
      *
@@ -165,20 +385,16 @@ export class EggsNamespace extends ResourceNamespace {
         const body = {};
         if (payload.name !== undefined)
             body['name'] = payload.name;
-        if (payload.description !== undefined) {
+        if (payload.description !== undefined)
             body['description'] = payload.description;
-        }
         if (payload.nestId !== undefined)
             body['nest_id'] = payload.nestId;
-        if (payload.startupCommand !== undefined) {
+        if (payload.startupCommand !== undefined)
             body['startup_command'] = payload.startupCommand;
-        }
-        if (payload.stopCommand !== undefined) {
+        if (payload.stopCommand !== undefined)
             body['stop_command'] = payload.stopCommand;
-        }
-        if (payload.forceOutgoingIp !== undefined) {
+        if (payload.forceOutgoingIp !== undefined)
             body['force_outgoing_ip'] = payload.forceOutgoingIp;
-        }
         if (payload.installer) {
             body['installer'] = {
                 image: payload.installer.image,
@@ -186,6 +402,14 @@ export class EggsNamespace extends ResourceNamespace {
                 script: payload.installer.script,
             };
         }
+        if (payload.configFiles !== undefined)
+            body['config_files'] = payload.configFiles;
+        if (payload.configStartup !== undefined)
+            body['config_startup'] = configStartupBody(payload.configStartup);
+        if (payload.configLogs !== undefined)
+            body['config_logs'] = payload.configLogs;
+        if (payload.fileBlacklistRegex !== undefined)
+            body['file_blacklist_regex'] = payload.fileBlacklistRegex;
         const data = await this.http.patch(`/eggs/${id}`, body);
         const egg = new Egg(data);
         this.upsertCache(egg);
@@ -202,4 +426,16 @@ export class EggsNamespace extends ResourceNamespace {
         this.removeFromCache(id);
         this.emit('deleted', id);
     }
+    /** Manage a specific egg's variables. */
+    variables(eggId) {
+        return new EggVariablesManager(eggId, this.http);
+    }
+    /** Manage a specific egg's images. */
+    images(eggId) {
+        return new EggImagesManager(eggId, this.http);
+    }
+    /** Manage a specific egg's feature grants. */
+    features(eggId) {
+        return new EggFeaturesManager(eggId, this.http);
+    }
 }

package/esm/src/resources/features.d.ts

@@ -0,0 +1,35 @@
+import type { HttpClient } from '../http.js';
+/** The variant options a feature offers. */
+export interface FeatureVariants {
+    /** The allowed variant values. */
+    options: string[];
+    /** The default variant. */
+    default: string;
+}
+/** A code-defined feature in the catalog. */
+export interface FeatureCatalogEntry {
+    /** The feature key, e.g. `"minecraft.players"`. */
+    name: string;
+    /** The feature's settings and their default values, keyed by setting name. */
+    settings: Record<string, unknown>;
+    /** The variant options, or `null` when the feature has none. */
+    variants: FeatureVariants | null;
+}
+/**
+ * The code-defined feature catalog.
+ *
+ * Access via `api.features`. Per-server feature state is managed via `server.features`.
+ *
+ * @example
+ * ```ts ignore
+ * const catalog = await api.features.list();
+ * ```
+ */
+export declare class FeaturesResource {
+    private readonly http;
+    /** @internal */
+    constructor(http: HttpClient);
+    /** List the available features and their defaults. */
+    list(): Promise<FeatureCatalogEntry[]>;
+}
+//# sourceMappingURL=features.d.ts.map

package/esm/src/resources/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../../src/src/resources/features.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC/B,kCAAkC;IAClC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IACnC,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,gEAAgE;IAChE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;CACjC;AAED;;;;;;;;;GASG;AACH,qBAAa,gBAAgB;IAET,OAAO,CAAC,QAAQ,CAAC,IAAI;IADxC,gBAAgB;gBACoB,IAAI,EAAE,UAAU;IAEpD,sDAAsD;IAC/C,IAAI,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;CAG7C"}

package/esm/src/resources/features.js

@@ -0,0 +1,21 @@
+/**
+ * The code-defined feature catalog.
+ *
+ * Access via `api.features`. Per-server feature state is managed via `server.features`.
+ *
+ * @example
+ * ```ts ignore
+ * const catalog = await api.features.list();
+ * ```
+ */
+export class FeaturesResource {
+    http;
+    /** @internal */
+    constructor(http) {
+        this.http = http;
+    }
+    /** List the available features and their defaults. */
+    list() {
+        return this.http.get('/features');
+    }
+}

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

@@ -1,48 +1,158 @@
 import type { HttpClient } from '../http.js';
 import { ResourceNamespace } from '../namespace.js';
 import { ReactiveResource } from '../reactive.js';
+import type { IncludeOptions, ListOptions, ResourceColor, ResourceWith } from '../types.js';
 import { type ISODate, type NanoID, type Paginated } from '../types.js';
-import type { MemberData } from './members.js';
-import { Member } from './members.js';
+import type { UserData } from './users.js';
+import { User } from './users.js';
+import { type ActivityFeedOptions, type ActivityLog } from './servers/activity.js';
 /** Raw API shape for a physical host. @internal */
 export interface HostData {
     id: string;
     hostname: string;
-    name?: string | null;
-    color?: string | null;
+    name: string;
+    color: ResourceColor | null;
     owner_id: string;
-    owner?: MemberData;
-    notes?: string | null;
+    owner?: UserData;
+    notes: string | null;
     created_at: ISODate;
     updated_at: ISODate;
+    deleted_at: ISODate | null;
 }
 /**
  * A physical host machine on which nodes are deployed.
  *
- * Retrieved via {@link HostsNamespace.list}.
+ * Retrieved via {@link HostsNamespace.list} or {@link HostsNamespace.get}.
  */
 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;
-    /** The owner's NanoID. Always present. */
+    /** Display name for the host. */
+    name: string;
+    /** Color used in the UI for grouping, or `null`. */
+    color: ResourceColor | null;
+    /** The owner's bare NanoID (parsed from the namespaced `owner_id`). Always present. */
     readonly ownerId: NanoID;
+    /** The owner's issuer type, e.g. `'user'` or `'system'`. */
+    readonly ownerType: string;
     /** The full owner object. Requires `?include=owner`. */
-    owner: Member | undefined;
+    owner: User | undefined;
     /** Internal notes. */
-    notes: string | null | undefined;
+    notes: string | null;
     /** When this host was registered. */
     createdAt: Date;
     /** When this host was last updated. */
     updatedAt: Date;
+    /** When this host was soft-deleted, or `null` if active. */
+    deletedAt: Date | null;
     /** @internal */
     constructor(data: HostData);
 }
+/** Fields accepted when creating a host. */
+export interface CreateHostPayload {
+    name: string;
+    hostname: string;
+    color?: ResourceColor;
+    notes?: string;
+}
+/** Fields accepted when updating a host. All optional. */
+export interface UpdateHostPayload {
+    name?: string;
+    hostname?: string;
+    color?: ResourceColor;
+    notes?: string;
+}
+/** Valid include keys for host endpoints. */
+export type HostInclude = 'owner';
+/** Maps each {@link HostInclude} key to the field(s) it guarantees on the {@link Host} instance. */
+interface HostIncludeMap {
+    owner: {
+        owner: User;
+    };
+}
+/** A {@link Host} with specific include fields guaranteed to be populated. */
+export type HostWith<I extends readonly HostInclude[] = []> = ResourceWith<Host, HostIncludeMap, I>;
+/** Options for {@link HostsNamespace.list}. */
+export interface HostListOptions extends ListOptions {
+    /**
+     * Soft-delete visibility.
+     * - `none` (the default) - returns only active hosts
+     * - `all` - also includes soft-deleted hosts you can access
+     * - `only` - returns just those
+     *
+     * Soft-deleted hosts require the `host.read.deleted` permission.
+     */
+    deleted?: 'none' | 'all' | 'only';
+}
+/** Typed events emitted by {@link HostsNamespace}. */
+export interface HostEvents {
+    created: Host;
+    updated: Host;
+    deleted: NanoID;
+}
+/** A host's WHMCS billing configuration. Credentials are never returned. */
+export interface WhmcsBillingConfig {
+    /** The WHMCS base URL. */
+    baseUrl: string;
+    /** Whether billing is enabled for this host. */
+    enabled: boolean;
+    /** Whether a Basic-Auth header is configured. The value itself is never returned. */
+    basicAuthSet: boolean;
+    /** When the config was created. */
+    createdAt: Date;
+    /** When the config was last updated. */
+    updatedAt: Date;
+}
+/** Fields accepted when saving a host's WHMCS billing config. */
+export interface SaveWhmcsBillingPayload {
+    /** The WHMCS base URL (http or https). Required on first configuration. */
+    baseUrl?: string;
+    /** WHMCS API identifier (write-only). Required on first configuration. */
+    apiIdentifier?: string;
+    /** WHMCS API secret (write-only). Required on first configuration. */
+    apiSecret?: string;
+    /** Basic-Auth header value. `null` clears it; omit to leave unchanged. */
+    basicAuthBase64?: string | null;
+    /** Enable or disable billing for this host. */
+    enabled?: boolean;
+}
+/**
+ * Manages a host's billing provider configuration.
+ *
+ * Access via `api.hosts.billing(hostId)`.
+ */
+export declare class HostBillingManager {
+    private readonly hostId;
+    private readonly http;
+    /** @internal */
+    constructor(hostId: NanoID, http: HttpClient);
+    /** Fetch all configured billing providers for this host. */
+    providers(): Promise<{
+        whmcs: WhmcsBillingConfig | null;
+    }>;
+    /**
+     * Fetch this host's WHMCS billing config.
+     *
+     * @throws {@link ApiError} with `isNotFound === true` if billing is not configured.
+     */
+    getWhmcs(): Promise<WhmcsBillingConfig>;
+    /**
+     * Save this host's WHMCS billing config. Does not call WHMCS; use {@link testWhmcs} to verify.
+     *
+     * First-time configuration requires `baseUrl`, `apiIdentifier`, and `apiSecret`.
+     */
+    saveWhmcs(payload: SaveWhmcsBillingPayload): Promise<WhmcsBillingConfig>;
+    /**
+     * Verify the stored WHMCS credentials against the live WHMCS API.
+     *
+     * @throws {@link ApiError} if billing is not configured (404) or WHMCS rejects the credentials (502).
+     */
+    testWhmcs(): Promise<void>;
+    /** Remove this host's WHMCS billing config. */
+    deleteWhmcs(): Promise<void>;
+}
 /**
  * Namespace for host management.
  *
@@ -51,20 +161,40 @@ export declare class Host extends ReactiveResource {
  * @example
  * ```ts ignore
  * const hosts = await api.hosts.list();
+ * const host = await api.hosts.create({ name: 'DC1', hostname: 'host.example.com' });
  * ```
  */
-export declare class HostsNamespace extends ResourceNamespace<Host> {
+export declare class HostsNamespace extends ResourceNamespace<Host, HostEvents> {
     /** @internal */
     constructor(http: HttpClient);
     /**
      * Fetch a paginated list of physical hosts.
      *
-     * @param opts Pagination and search options.
+     * @param opts Pagination, search, soft-delete visibility, and include options.
+     */
+    list<const I extends readonly HostInclude[] = []>(opts?: HostListOptions & IncludeOptions<HostInclude, I>): Promise<Paginated<HostWith<I>>>;
+    /**
+     * Fetch a single host by ID.
+     *
+     * @param id   The host's NanoID.
+     * @param opts Include options. A soft-deleted host resolves when the caller holds `host.read.deleted`.
+     */
+    get<const I extends readonly HostInclude[] = []>(id: NanoID, opts?: IncludeOptions<HostInclude, I>): Promise<HostWith<I>>;
+    /** Create a new host. The caller becomes its owner. */
+    create(payload: CreateHostPayload): Promise<Host>;
+    /** Update a host's name, hostname, color, or notes. */
+    update(id: NanoID, payload: UpdateHostPayload): Promise<Host>;
+    /** Soft-delete a host. Fails if it still owns nodes, locations, types, or nests. */
+    delete(id: NanoID): Promise<void>;
+    /** Manage a host's billing provider configuration. */
+    billing(hostId: NanoID): HostBillingManager;
+    /**
+     * Fetch a host's activity feed (activity on the host and its servers, groups, and nodes).
+     *
+     * @param hostId The host's NanoID.
+     * @param opts   Pagination and filter options.
      */
-    list(opts?: {
-        page?: number;
-        perPage?: number;
-        search?: string;
-    }): Promise<Paginated<Host>>;
+    activities(hostId: NanoID, opts?: ActivityFeedOptions): Promise<Paginated<ActivityLog>>;
 }
+export {};
 //# sourceMappingURL=hosts.d.ts.map

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

@@ -1 +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;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,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,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,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,0CAA0C;IAC1C,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,wDAAwD;IACjD,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,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;CAYjC;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"}
+{"version":3,"file":"hosts.d.ts","sourceRoot":"","sources":["../../../src/src/resources/hosts.ts"],"names":[],"mappings":"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"}