@meowpanel/api 0.3.0 → 0.4.0

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

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ServerProfilesManager = exports.ServerProfile = void 0;
 const reactive_js_1 = require("../../reactive.js");
 const types_js_1 = require("../../types.js");
+const eggs_js_1 = require("../eggs.js");
 /**
  * A named configuration profile for a server.
  *
@@ -22,6 +23,18 @@ class ServerProfile extends reactive_js_1.ReactiveResource {
     description;
     /** Internal notes for this profile. */
     notes;
+    /** The egg this profile runs. Requires `server.egg.read`. */
+    eggId;
+    /** Populated with `include=egg`. */
+    egg;
+    /** The egg image (Docker image) id this profile uses. */
+    eggImageId;
+    /** A custom Docker image overriding the egg's default. */
+    eggImageOverride;
+    /** Whether the egg install scripts are skipped for this profile. */
+    skipInstallScripts;
+    /** Startup command and variables. Populated with `include=startup`. */
+    startup;
     /** The folder name used to store this profile's files on disk. */
     folder;
     /** `true` if this is the currently active profile for the server. */
@@ -50,6 +63,20 @@ class ServerProfile extends reactive_js_1.ReactiveResource {
         this.name = data.name;
         this.description = data.description ?? null;
         this.notes = data.notes;
+        this.eggId = data.egg_id ? (0, types_js_1.toNanoID)(data.egg_id) : undefined;
+        this.eggImageId = data.egg_image_id ? (0, types_js_1.toNanoID)(data.egg_image_id) : undefined;
+        this.eggImageOverride = data.egg_image_override;
+        this.skipInstallScripts = data.skip_install_scripts;
+        if (data.egg)
+            this.egg = new eggs_js_1.Egg(data.egg);
+        if (data.startup !== undefined) {
+            this.startup = data.startup
+                ? {
+                    command: data.startup.command,
+                    variables: Object.fromEntries(Object.entries(data.startup.variables).map(([key, v]) => [key, { key, ...v }])),
+                }
+                : undefined;
+        }
         this.folder = data.folder;
         this.isActive = data.is_active;
         this.updatedAt = new Date(data.updated_at);
@@ -135,12 +162,38 @@ class ServerProfilesManager {
         return this.makeProfile(data);
     }
     /**
-     * Create a new profile for this server.
+     * Create a new profile for this server. A profile binds an egg and image.
      *
      * @param payload Profile creation parameters.
      */
     async create(payload) {
-        const data = await this.http.post(`/servers/${this.serverId}/profiles`, payload);
+        const data = await this.http.post(`/servers/${this.serverId}/profiles`, {
+            name: payload.name,
+            description: payload.description,
+            notes: payload.notes,
+            egg_id: payload.eggId,
+            egg_image_id: payload.eggImageId,
+            egg_image_override: payload.eggImageOverride,
+            startup_command_override: payload.startupCommandOverride,
+            skip_install_scripts: payload.skipInstallScripts,
+        });
+        return this.makeProfile(data);
+    }
+    /**
+     * Change a profile's egg, reselecting a valid image and re-basing its variables.
+     *
+     * @param profileId The profile's NanoID.
+     * @param eggId     The egg to switch to.
+     * @param opts      `keep: true` carries over all compatible variable overrides;
+     *                  an array keeps only the named variables.
+     */
+    async changeEgg(profileId, eggId, opts = {}) {
+        const params = {};
+        if (opts.keep === true)
+            params['keep'] = 'true';
+        else if (Array.isArray(opts.keep))
+            params['keep'] = opts.keep.join(',');
+        const data = await this.http.put(`/servers/${this.serverId}/profiles/${profileId}/egg`, JSON.stringify({ egg_id: eggId }), 'application/json', { params });
         return this.makeProfile(data);
     }
     /**

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

@@ -1,25 +1,18 @@
 import type { HttpClient } from '../../http.js';
 import { ReactiveResource } from '../../reactive.js';
 import type { NanoID, PowerAction, PowerState, ServerRestrictedState } from '../../types.js';
-import { Egg } from '../eggs.js';
 import { ServerGroup } from '../server-groups.js';
 import { ServerActivityManager } from './activity.js';
 import { ServerAllocationsManager } from './allocations.js';
+import { ServerBackupsManager } from './backups.js';
 import { ServerConnection } from './connection.js';
+import { ServerFeaturesManager } from './features.js';
 import { ServerFilesManager } from './files.js';
+import { ServerJobsManager } from './jobs.js';
 import { ServerProfilesManager } from './profiles.js';
 import { ServerSftpManager } from './sftp.js';
+import { ServerUserManager } from './sub-users.js';
 import type { ServerAllocationsData, ServerData, UpdateServerPayload } from './types.js';
-/** An egg environment variable configured for a server. */
-export interface StartupVariable {
-    key: string;
-    name: string;
-    description: string;
-    value: string;
-    default: string;
-    /** Laravel validation rules, e.g. `"required|numeric|min:1"`. */
-    rules: string;
-}
 /** Real-time power state and utilization. Populated via `include=status`. */
 export interface ServerStatus {
     state: PowerState;
@@ -52,17 +45,12 @@ export interface ServerBuild {
         backup: number | null | undefined;
     } | null | undefined;
 }
-/** Startup command and egg variables. Populated via `include=startup`. */
-export interface ServerStartup {
-    command: string;
-    variables: Record<string, StartupVariable>;
-}
 /**
  * A MeowPanel game server.
  *
  * @example
  * ```ts ignore
- * const server = await api.servers.get(id, { include: ['status', 'startup'] });
+ * const server = await api.servers.get(id, { include: ['status'] });
  * server.status; // ServerStatus (guaranteed by include)
  *
  * await server.sendPower('start');
@@ -85,19 +73,12 @@ export declare class Server extends ReactiveResource {
     /** When non-null, overrides the node's reported power state for display. */
     restrictedState: ServerRestrictedState;
     readonly groupId: NanoID;
-    readonly eggId: NanoID;
-    eggImageId: NanoID | undefined;
     /** Populated with `include=group`. */
     group: ServerGroup | undefined;
-    /** Populated with `include=egg`. */
-    egg: Egg | undefined;
-    eggImageOverride: string | null | undefined;
     /** Populated with `include=status`. Use {@link getStatus} to fetch on demand. */
     status: ServerStatus | undefined;
     /** Populated with `include=build`. */
     build: ServerBuild | undefined;
-    /** Populated with `include=startup`. */
-    startup: ServerStartup | undefined;
     /** Populated with `include=allocations`. */
     allocationPorts: ServerAllocationsData | undefined;
     createdAt: Date;
@@ -107,11 +88,15 @@ export declare class Server extends ReactiveResource {
     readonly profiles: ServerProfilesManager;
     readonly activity: ServerActivityManager;
     readonly files: ServerFilesManager;
+    readonly backups: ServerBackupsManager;
+    readonly jobs: ServerJobsManager;
+    readonly subUsers: ServerUserManager;
+    readonly features: ServerFeaturesManager;
     /** @internal */
     constructor(data: ServerData, http: HttpClient, resolveNodeUrl: () => Promise<string>, onMutated: () => void);
     /** Apply raw API data, updating all mutable fields. */
     applyData(data: ServerData): void;
-    /** Update this server's details, startup config, or primary allocation. */
+    /** Update this server's details or primary allocation. */
     update(payload: UpdateServerPayload): Promise<void>;
     /** Fetch current power state and utilization from the node. */
     getStatus(): Promise<ServerStatus>;

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/src/resources/servers/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/src/resources/servers/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE7F,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EACX,qBAAqB,EAErB,UAAU,EAEV,mBAAmB,EACnB,MAAM,YAAY,CAAC;AAEpB,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,yCAAyC;IACzC,WAAW,EAAE;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI,CAAC;CACT;AAED,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACtC,gCAAgC;IAChC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,sCAAsC;IACtC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACnC,kBAAkB,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,MAAM,EACH;QACD,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;QACtC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;QACjC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;QAClC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;QACrC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;QACtC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;QACpC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;KAClC,GACC,IAAI,GACJ,SAAS,CAAC;CACb;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,MAAO,SAAQ,gBAAgB;IAmC1C,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS;IApC3B,SAAgB,EAAE,EAAE,MAAM,CAAC;IACpB,IAAI,EAAG,MAAM,CAAC;IACd,WAAW,EAAG,MAAM,GAAG,IAAI,CAAC;IACnC,wDAAwD;IACjD,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxC,4EAA4E;IACrE,eAAe,EAAG,qBAAqB,CAAC;IAE/C,SAAgB,OAAO,EAAE,MAAM,CAAC;IAEhC,sCAAsC;IAC/B,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,iFAAiF;IAC1E,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;IACxC,sCAAsC;IAC/B,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,4CAA4C;IACrC,eAAe,EAAE,qBAAqB,GAAG,SAAS,CAAC;IACnD,SAAS,EAAG,IAAI,CAAC;IACjB,SAAS,EAAG,IAAI,CAAC;IAExB,SAAgB,WAAW,EAAE,wBAAwB,CAAC;IACtD,SAAgB,IAAI,EAAE,iBAAiB,CAAC;IACxC,SAAgB,QAAQ,EAAE,qBAAqB,CAAC;IAChD,SAAgB,QAAQ,EAAE,qBAAqB,CAAC;IAChD,SAAgB,KAAK,EAAE,kBAAkB,CAAC;IAC1C,SAAgB,OAAO,EAAE,oBAAoB,CAAC;IAC9C,SAAgB,IAAI,EAAE,iBAAiB,CAAC;IACxC,SAAgB,QAAQ,EAAE,iBAAiB,CAAC;IAC5C,SAAgB,QAAQ,EAAE,qBAAqB,CAAC;IAEhD,gBAAgB;gBAEf,IAAI,EAAE,UAAU,EACC,IAAI,EAAE,UAAU,EAChB,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EACrC,SAAS,EAAE,MAAM,IAAI;IAqBvC,uDAAuD;IAChD,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAuBxC,0DAA0D;IAC7C,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBhE,+DAA+D;IAClD,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC;IAO/C,yCAAyC;IAC5B,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D,yCAAyC;IAC5B,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnE;;;;;;;;;;;OAWG;IACU,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,CAAC;CAI1D"}

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

@@ -3,20 +3,24 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Server = void 0;
 const reactive_js_1 = require("../../reactive.js");
 const types_js_1 = require("../../types.js");
-const eggs_js_1 = require("../eggs.js");
 const server_groups_js_1 = require("../server-groups.js");
 const activity_js_1 = require("./activity.js");
 const allocations_js_1 = require("./allocations.js");
+const backups_js_1 = require("./backups.js");
 const connection_js_1 = require("./connection.js");
+const features_js_1 = require("./features.js");
 const files_js_1 = require("./files.js");
+const jobs_js_1 = require("./jobs.js");
+const node_client_js_1 = require("./node-client.js");
 const profiles_js_1 = require("./profiles.js");
 const sftp_js_1 = require("./sftp.js");
+const sub_users_js_1 = require("./sub-users.js");
 /**
  * A MeowPanel game server.
  *
  * @example
  * ```ts ignore
- * const server = await api.servers.get(id, { include: ['status', 'startup'] });
+ * const server = await api.servers.get(id, { include: ['status'] });
  * server.status; // ServerStatus (guaranteed by include)
  *
  * await server.sendPower('start');
@@ -39,19 +43,12 @@ class Server extends reactive_js_1.ReactiveResource {
     /** When non-null, overrides the node's reported power state for display. */
     restrictedState;
     groupId;
-    eggId;
-    eggImageId;
     /** Populated with `include=group`. */
     group;
-    /** Populated with `include=egg`. */
-    egg;
-    eggImageOverride;
     /** Populated with `include=status`. Use {@link getStatus} to fetch on demand. */
     status;
     /** Populated with `include=build`. */
     build;
-    /** Populated with `include=startup`. */
-    startup;
     /** Populated with `include=allocations`. */
     allocationPorts;
     createdAt;
@@ -61,6 +58,10 @@ class Server extends reactive_js_1.ReactiveResource {
     profiles;
     activity;
     files;
+    backups;
+    jobs;
+    subUsers;
+    features;
     /** @internal */
     constructor(data, http, resolveNodeUrl, onMutated) {
         super();
@@ -69,12 +70,16 @@ class Server extends reactive_js_1.ReactiveResource {
         this.onMutated = onMutated;
         this.id = (0, types_js_1.toNanoID)(data.id);
         this.groupId = (0, types_js_1.toNanoID)(data.group_id);
-        this.eggId = (0, types_js_1.toNanoID)(data.egg_id);
         this.allocations = new allocations_js_1.ServerAllocationsManager(this.id, http);
         this.sftp = new sftp_js_1.ServerSftpManager(this.id, http);
         this.profiles = new profiles_js_1.ServerProfilesManager(this.id, http);
         this.activity = new activity_js_1.ServerActivityManager(this.id, http);
-        this.files = new files_js_1.ServerFilesManager(this.id, http.getToken(), resolveNodeUrl);
+        this.subUsers = new sub_users_js_1.ServerUserManager(`/servers/${this.id}`, http);
+        this.features = new features_js_1.ServerFeaturesManager(this.id, http);
+        const node = new node_client_js_1.NodeClient(this.id, http.getToken(), resolveNodeUrl);
+        this.files = new files_js_1.ServerFilesManager(node);
+        this.backups = new backups_js_1.ServerBackupsManager(node);
+        this.jobs = new jobs_js_1.ServerJobsManager(node);
         this.applyData(data);
     }
     /** Apply raw API data, updating all mutable fields. */
@@ -83,30 +88,15 @@ class Server extends reactive_js_1.ReactiveResource {
         this.description = data.description;
         this.notes = data.notes;
         this.restrictedState = data.restricted_state;
-        this.eggImageId = data.egg_image_id ? (0, types_js_1.toNanoID)(data.egg_image_id) : undefined;
-        this.eggImageOverride = data.egg_image_override;
         // Include-gated fields: only overwrite if present in response
         if (data.group)
             this.group = new server_groups_js_1.ServerGroup(data.group);
-        if (data.egg)
-            this.egg = new eggs_js_1.Egg(data.egg);
         if (data.status !== undefined) {
             this.status = data.status ? parseStatus(data.status) : undefined;
         }
         if (data.build !== undefined) {
             this.build = data.build ? parseBuild(data.build) : undefined;
         }
-        if (data.startup !== undefined) {
-            this.startup = data.startup
-                ? {
-                    command: data.startup.command,
-                    variables: Object.fromEntries(Object.entries(data.startup.variables).map(([k, v]) => [
-                        k,
-                        { key: k, ...v, default: v.default },
-                    ])),
-                }
-                : undefined;
-        }
         if (data.allocations !== undefined) {
             this.allocationPorts = data.allocations ?? undefined;
         }
@@ -114,7 +104,7 @@ class Server extends reactive_js_1.ReactiveResource {
         this.updatedAt = new Date(data.updated_at);
         this.notify();
     }
-    /** Update this server's details, startup config, or primary allocation. */
+    /** Update this server's details or primary allocation. */
     async update(payload) {
         const body = {};
         if (payload.name !== undefined)
@@ -127,12 +117,6 @@ class Server extends reactive_js_1.ReactiveResource {
         if (payload.allocationPrimary) {
             body['allocation_primary'] = payload.allocationPrimary;
         }
-        if (payload.startup) {
-            body['startup'] = {
-                command: payload.startup.command,
-                variables: payload.startup.variables,
-            };
-        }
         const data = await this.http.patch(`/servers/${this.id}`, body);
         this.applyData(data);
         this.onMutated();
@@ -179,7 +163,7 @@ function parseStatus(data) {
                 cpuAbsolute: data.utilization.cpu_absolute,
                 networkRxBytes: data.utilization.network.rx_bytes,
                 networkTxBytes: data.utilization.network.tx_bytes,
-                uptimeMs: data.utilization.uptime_ms,
+                uptimeMs: data.utilization.uptime,
                 diskBytes: data.utilization.disk_bytes,
             }
             : null,

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

@@ -1,7 +1,7 @@
 import type { HttpClient } from '../../http.js';
 import { ReactiveResource } from '../../reactive.js';
 import type { IncludeOptions, ListOptions, NanoID, Paginated, ResourceWith, SftpPermission } from '../../types.js';
-import { Member } from '../members.js';
+import { User } from '../users.js';
 import type { SftpUserData } from './types.js';
 /**
  * Connection details for the SFTP server on a node.
@@ -19,8 +19,8 @@ export interface SftpConnection {
  *
  * Retrieved via {@link ServerSftpManager.list} or {@link ServerSftpManager.create}.
  *
- * > **Note:** The `password` field is automatically included in the creation response.
- * > On subsequent fetches it requires `include=password` to be populated.
+ * The plaintext password is returned only when the user is created or its password
+ * is reset. It is never retrievable afterward.
  */
 export declare class SftpUser extends ReactiveResource {
     /** The SFTP user's unique NanoID. */
@@ -29,11 +29,7 @@ export declare class SftpUser extends ReactiveResource {
     name: string;
     /** The SFTP login username (typically prefixed with the server ID). */
     username: string;
-    /**
-     * The plaintext password.
-     *
-     * Automatically included on creation. Requires `include=password` on subsequent fetches.
-     */
+    /** The plaintext password. Present only in the creation response. */
     password: string | undefined;
     /**
      * A map of path glob patterns to the set of permissions granted for that path.
@@ -44,8 +40,8 @@ export declare class SftpUser extends ReactiveResource {
     paths: Record<string, SftpPermission[]>;
     /** NanoID of the member who owns this SFTP user. */
     ownerId: NanoID;
-    /** The owner member. */
-    owner: Member | null | undefined;
+    /** The owner. */
+    owner: User | null | undefined;
     /** When this SFTP user last logged in, or `null` if never. */
     lastLoginAt: Date | null;
     /** When this SFTP user was created. */
@@ -56,14 +52,11 @@ export declare class SftpUser extends ReactiveResource {
     constructor(data: SftpUserData);
 }
 /** Valid include keys for SFTP user endpoints. */
-export type SftpUserInclude = 'password' | 'owner';
+export type SftpUserInclude = 'owner';
 /** Maps each {@link SftpUserInclude} key to the field(s) it guarantees on the {@link SftpUser} instance. */
 interface SftpUserIncludeMap {
-    password: {
-        password: string;
-    };
     owner: {
-        owner: Member;
+        owner: User;
     };
 }
 /** A {@link SftpUser} with specific include fields guaranteed to be populated. */
@@ -88,8 +81,8 @@ export interface SftpDetails {
  * console.log(`Connect to: ${details.connection.url}`);
  *
  * const user = await server.sftp.create('deploy', {
- *   '/': ['sftp.content.list', 'sftp.content.read'],
- *   '/logs': ['sftp.content.list', 'sftp.content.read', 'sftp.content.delete'],
+ *   '/': ['server.file.list', 'server.file.read'],
+ *   '/logs': ['server.file.list', 'server.file.read', 'server.file.delete'],
  * });
  * console.log(user.password); // Save this!
  * ```
@@ -119,8 +112,8 @@ export declare class ServerSftpManager {
     /**
      * Create a new SFTP user for this server.
      *
-     * The returned {@link SftpUser} includes the `password` field automatically.
-     * On subsequent fetches, request it explicitly with `include=password`.
+     * The returned {@link SftpUser} carries the one-time `password`. It is never
+     * retrievable afterward, so store it now.
      *
      * @param name  Display name for the SFTP user.
      * @param paths A map of path glob patterns to an array of {@link SftpPermission} scopes.

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

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

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

@@ -3,14 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ServerSftpManager = exports.SftpUser = void 0;
 const reactive_js_1 = require("../../reactive.js");
 const types_js_1 = require("../../types.js");
-const members_js_1 = require("../members.js");
+const users_js_1 = require("../users.js");
 /**
  * An SFTP user credential scoped to a specific server with path-level permissions.
  *
  * Retrieved via {@link ServerSftpManager.list} or {@link ServerSftpManager.create}.
  *
- * > **Note:** The `password` field is automatically included in the creation response.
- * > On subsequent fetches it requires `include=password` to be populated.
+ * The plaintext password is returned only when the user is created or its password
+ * is reset. It is never retrievable afterward.
  */
 class SftpUser extends reactive_js_1.ReactiveResource {
     /** The SFTP user's unique NanoID. */
@@ -19,11 +19,7 @@ class SftpUser extends reactive_js_1.ReactiveResource {
     name;
     /** The SFTP login username (typically prefixed with the server ID). */
     username;
-    /**
-     * The plaintext password.
-     *
-     * Automatically included on creation. Requires `include=password` on subsequent fetches.
-     */
+    /** The plaintext password. Present only in the creation response. */
     password;
     /**
      * A map of path glob patterns to the set of permissions granted for that path.
@@ -34,7 +30,7 @@ class SftpUser extends reactive_js_1.ReactiveResource {
     paths;
     /** NanoID of the member who owns this SFTP user. */
     ownerId;
-    /** The owner member. */
+    /** The owner. */
     owner;
     /** When this SFTP user last logged in, or `null` if never. */
     lastLoginAt;
@@ -51,7 +47,7 @@ class SftpUser extends reactive_js_1.ReactiveResource {
         this.password = data.password;
         this.paths = data.paths;
         this.ownerId = (0, types_js_1.toNanoID)(data.owner_id);
-        this.owner = data.owner ? new members_js_1.Member(data.owner) : data.owner;
+        this.owner = data.owner ? new users_js_1.User(data.owner) : data.owner;
         this.lastLoginAt = data.last_login_at ? new Date(data.last_login_at) : null;
         this.createdAt = new Date(data.created_at);
         this.updatedAt = new Date(data.updated_at);
@@ -69,8 +65,8 @@ exports.SftpUser = SftpUser;
  * console.log(`Connect to: ${details.connection.url}`);
  *
  * const user = await server.sftp.create('deploy', {
- *   '/': ['sftp.content.list', 'sftp.content.read'],
- *   '/logs': ['sftp.content.list', 'sftp.content.read', 'sftp.content.delete'],
+ *   '/': ['server.file.list', 'server.file.read'],
+ *   '/logs': ['server.file.list', 'server.file.read', 'server.file.delete'],
  * });
  * console.log(user.password); // Save this!
  * ```
@@ -123,8 +119,8 @@ class ServerSftpManager {
     /**
      * Create a new SFTP user for this server.
      *
-     * The returned {@link SftpUser} includes the `password` field automatically.
-     * On subsequent fetches, request it explicitly with `include=password`.
+     * The returned {@link SftpUser} carries the one-time `password`. It is never
+     * retrievable afterward, so store it now.
      *
      * @param name  Display name for the SFTP user.
      * @param paths A map of path glob patterns to an array of {@link SftpPermission} scopes.

package/script/src/resources/servers/sub-users.d.ts

@@ -0,0 +1,99 @@
+import type { HttpClient } from '../../http.js';
+import type { ISODate, NanoID } from '../../types.js';
+import { User, type UserData } from '../users.js';
+/**
+ * How a sub-user is attached to the resource.
+ *
+ * - `owner`: the resource owner (implicit, read-only, no grants).
+ * - `direct`: granted at this resource's own scope.
+ * - `inherited`: granted at the parent group's scope.
+ */
+export type ServerUserKind = 'owner' | 'direct' | 'inherited';
+/** Raw API shape for a sub-user's scoped grant. @internal */
+interface ServerUserGrantData {
+    name: string;
+    granted_at: ISODate;
+    expires_at: ISODate | null;
+}
+/** Raw API shape for a sub-user entry. @internal */
+export interface ServerUserData {
+    user: UserData;
+    permissions: ServerUserGrantData[];
+    kind: ServerUserKind;
+}
+/** A permission granted to a sub-user at the resource scope. */
+export interface ServerUserGrant {
+    /** The permission name, e.g. `"server.file.read"`. */
+    name: string;
+    /** When the grant was created. */
+    grantedAt: Date;
+    /** When the grant expires, or `null` if it never expires. */
+    expiresAt: Date | null;
+}
+/**
+ * A user granted access to a server (or server group), with their scoped grants.
+ *
+ * Retrieved via {@link ServerUserManager.list} or {@link ServerUserManager.get}.
+ */
+export declare class ServerUser {
+    /** The underlying user. */
+    readonly user: User;
+    /** The permissions granted to this user at the resource scope. */
+    readonly permissions: ServerUserGrant[];
+    /** How this user is attached. See {@link ServerUserKind}. */
+    readonly kind: ServerUserKind;
+    /** @internal */
+    constructor(data: ServerUserData);
+}
+/** Parameters for adding a sub-user, by existing user id or by email (which may invite a new user). */
+export type AddServerUserInput = {
+    userId: NanoID;
+    permissions: string[];
+    expiresAt?: Date | null;
+} | {
+    email: string;
+    permissions: string[];
+    expiresAt?: Date | null;
+};
+/**
+ * Manages the sub-users of a server or server group.
+ *
+ * Access via `server.subUsers`.
+ *
+ * @example
+ * ```ts ignore
+ * await server.subUsers.add({ email: 'teammate@example.com', permissions: ['server.console.read'] });
+ * const subUsers = await server.subUsers.list();
+ * ```
+ */
+export declare class ServerUserManager {
+    private readonly basePath;
+    private readonly http;
+    /** @internal */
+    constructor(basePath: string, http: HttpClient);
+    /** List the resource's sub-users. */
+    list(): Promise<ServerUser[]>;
+    /** Fetch a single sub-user by user ID. */
+    get(userId: NanoID): Promise<ServerUser>;
+    /**
+     * Add a sub-user, or add permissions to an existing one.
+     *
+     * Identify the user by `userId`, or by `email` (an unknown email invites a new user,
+     * which requires `user.manage` and a configured email transport). Existing grants are kept.
+     */
+    add(input: AddServerUserInput): Promise<ServerUser>;
+    /**
+     * Replace a sub-user's permission set. Grants not listed are revoked.
+     *
+     * @param userId  The sub-user's NanoID.
+     * @param payload The exact permission set to grant, and an optional expiry.
+     */
+    update(userId: NanoID, payload: {
+        permissions: string[];
+        expiresAt?: Date | null;
+    }): Promise<ServerUser>;
+    /** Remove a sub-user, revoking all their grants at the resource scope. */
+    remove(userId: NanoID): Promise<void>;
+}
+export {};
+//# sourceMappingURL=sub-users.d.ts.map

package/script/src/resources/servers/sub-users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-users.d.ts","sourceRoot":"","sources":["../../../../src/src/resources/servers/sub-users.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE9D,6DAA6D;AAC7D,UAAU,mBAAmB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3B;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,IAAI,EAAE,cAAc,CAAC;CACrB;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC/B,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,SAAS,EAAE,IAAI,CAAC;IAChB,6DAA6D;IAC7D,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;CACvB;AAED;;;;GAIG;AACH,qBAAa,UAAU;IACtB,2BAA2B;IAC3B,SAAgB,IAAI,EAAE,IAAI,CAAC;IAC3B,kEAAkE;IAClE,SAAgB,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/C,6DAA6D;IAC7D,SAAgB,IAAI,EAAE,cAAc,CAAC;IAErC,gBAAgB;gBACG,IAAI,EAAE,cAAc;CASvC;AAED,uGAAuG;AACvG,MAAM,MAAM,kBAAkB,GAC3B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;CAAE,GAClE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;CAAE,CAAC;AAOrE;;;;;;;;;;GAUG;AACH,qBAAa,iBAAiB;IAG5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHtB,gBAAgB;gBAEE,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU;IAGlC,qCAAqC;IACxB,IAAI,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAK1C,0CAA0C;IAC7B,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAKrD;;;;;OAKG;IACU,GAAG,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAWhE;;;;;OAKG;IACU,MAAM,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;KAAE,GACzD,OAAO,CAAC,UAAU,CAAC;IAQtB,0EAA0E;IAC7D,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGlD"}