dredless 0.6.2 → 0.6.3

package/README.md

@@ -37,6 +37,20 @@ const ship = client.currentShip();
 const loader = ship?.machines.loaders()[0];
 loader?.configure({ cycle: 5, stack: 12 });
 
+const door = ship?.machines.doors()[0];
+if (door) await door.setRank("crew");
+const spawn = ship?.machines.spawnPoints()[0];
+if (spawn) await spawn.setRank("captain");
+
+// Other context-menu actions can be selected by their displayed text.
+const cannon = ship?.machines.cannons()[0];
+if (cannon) await client.tips.choose(cannon, "Unload Cannon");
+
+if (door) {
+  console.log((await door.openTips()).options);
+  await client.tips.close();
+}
+
 const sign = ship?.machines.signs()[0];
 sign?.open();
 sign?.setText("Dock here", SignDisplayMode.WhenNear);

package/dist/browser/dredless.global.js

@@ -588,6 +588,367 @@
     }
   };
 
+  // src/protocol/outbound/ship-management.js
+  var SHIP_MANAGEMENT_TYPE = 4;
+  var SET_PRIVACY_ACTION = "set_privacy";
+  var STARTER_RECOVERY_ACTION = "starter_recovery";
+  var PLAYER_LIST_ACTION = "player_list";
+  var INVITE_RESET_ACTION = "invite_reset";
+  var SET_RANK_ACTION = "set_rank";
+  var KICK_ACTION = "kick";
+  var BAN_ACTION = "ban";
+  var DEMOTE_SELF_ACTION = "demote_self";
+  function requireNonNegativeInteger(value, name) {
+    const number = Number(value);
+    if (!Number.isInteger(number) || number < 0) throw new RangeError(`${name} must be a non-negative integer`);
+    return number;
+  }
+  function normalizePrivacy(value) {
+    if (value === true || value === 1 || value === "private") return 1;
+    if (value === false || value === 0 || value === "public") return 0;
+    throw new RangeError(`privacy must be 0, 1, true, false, "public", or "private"`);
+  }
+  function normalizePlayerRef(value) {
+    return requireNonNegativeInteger(value, "refId");
+  }
+  function normalizePlayerRank(value) {
+    if (value === 0 || value === "guest") return 0;
+    if (value === 1 || value === "crew") return 1;
+    if (value === 3 || value === "captain") return 3;
+    throw new RangeError(`rank must be 0, 1, 3, "guest", "crew", or "captain"`);
+  }
+  function buildShipManagementMessage(act, arg = null, extra = null) {
+    if (typeof act !== "string" || !act) throw new TypeError(`act must be a non-empty string`);
+    const message = { type: SHIP_MANAGEMENT_TYPE, act, arg };
+    if (extra && typeof extra === "object") Object.assign(message, extra);
+    return message;
+  }
+  function buildShipPrivacyMessage(privacy) {
+    return buildShipManagementMessage(SET_PRIVACY_ACTION, normalizePrivacy(privacy));
+  }
+  function buildStarterRecoveryMessage(itemId) {
+    return buildShipManagementMessage(STARTER_RECOVERY_ACTION, requireNonNegativeInteger(itemId, "itemId"));
+  }
+  function buildPlayerListMessage() {
+    return buildShipManagementMessage(PLAYER_LIST_ACTION);
+  }
+  function buildInviteResetMessage() {
+    return buildShipManagementMessage(INVITE_RESET_ACTION);
+  }
+  function buildSetPlayerRankMessage(refId, rank) {
+    return buildShipManagementMessage(SET_RANK_ACTION, normalizePlayerRef(refId), { rank: normalizePlayerRank(rank) });
+  }
+  function buildKickPlayerMessage(refId) {
+    return buildShipManagementMessage(KICK_ACTION, normalizePlayerRef(refId));
+  }
+  function buildBanPlayerMessage(refId) {
+    return buildShipManagementMessage(BAN_ACTION, normalizePlayerRef(refId));
+  }
+  function buildDemoteSelfMessage() {
+    return buildShipManagementMessage(DEMOTE_SELF_ACTION);
+  }
+  function normalizeShipConfig(event = {}) {
+    const source = event && typeof event === "object" ? event : {};
+    const config = source.config && typeof source.config === "object" ? source.config : {};
+    return {
+      privacy: config.privacy ?? null,
+      privacyName: config.privacy === 0 ? "public" : config.privacy === 1 ? "private" : null,
+      inviteKey: config.invite_key ?? null,
+      teamId: source.team_id ?? null,
+      patronPerks: Array.isArray(source.patron_perks) ? source.patron_perks.slice() : []
+    };
+  }
+  function normalizeCaptainSubrank(event = {}) {
+    const source = event && typeof event === "object" ? event : {};
+    return {
+      subrank: source.subrank ?? null,
+      enableCheats: Boolean(source.enable_cheats)
+    };
+  }
+  function normalizeShipPlayerList(event = {}, previous = null, currentCaptainSubrank = null) {
+    const source = event && typeof event === "object" ? event : {};
+    const changes = Array.isArray(source.player_list) ? source.player_list.map(normalizePlayerListChange) : [];
+    const removedPlayers = changes.filter((change) => change.remove && Number.isFinite(Number(change.refId))).map((change) => Number(change.refId));
+    const changedPlayers = changes.filter((change) => !change.remove).map(({ remove: _remove, ...change }) => change);
+    const players = mergePlayerListChanges(previous?.players, changes);
+    const ownerCaptainRank = ownerRankForPlayers(players);
+    applyPlayerControlState(players, currentCaptainSubrank);
+    applyPlayerControlState(changedPlayers, currentCaptainSubrank);
+    return {
+      ownerCaptainRank,
+      shipOwners: players.filter((player) => player.isShipOwner),
+      players,
+      changes: changedPlayers,
+      removedPlayers
+    };
+  }
+  function mergePlayerListChanges(previousPlayers, changes) {
+    if (!Array.isArray(previousPlayers) || !previousPlayers.length) return changes.filter((change) => !change.remove).map(({
+      remove: _remove,
+      ...player
+    }) => ({ ...player }));
+    const existing = /* @__PURE__ */ new Map();
+    for (const player of previousPlayers) {
+      if (player?.refId == null) continue;
+      existing.set(player.refId, { ...player, isShipOwner: false });
+    }
+    const changedRefs = /* @__PURE__ */ new Set();
+    const merged = [];
+    for (const change of changes) {
+      if (change.refId == null) {
+        if (!change.remove) {
+          const { remove: _remove2, ...player2 } = change;
+          merged.push({ ...player2, isShipOwner: false });
+        }
+        continue;
+      }
+      changedRefs.add(change.refId);
+      if (change.remove) {
+        existing.delete(change.refId);
+        continue;
+      }
+      const { remove: _remove, ...changePlayer } = change;
+      const player = { ...existing.get(change.refId) || {}, ...changePlayer, isShipOwner: false };
+      existing.set(change.refId, player);
+      merged.push(player);
+    }
+    for (const player of previousPlayers) {
+      if (player?.refId == null || changedRefs.has(player.refId)) continue;
+      const retained = existing.get(player.refId);
+      if (retained) merged.push(retained);
+    }
+    return merged;
+  }
+  function normalizePlayerListChange(entry = {}) {
+    const source = entry && typeof entry === "object" ? entry : {};
+    if (source._removed) return { refId: source.ref_id ?? null, remove: true };
+    return {
+      refId: source.ref_id ?? null,
+      remove: false,
+      discrim: source.discrim ?? null,
+      discrimColor: source.discrim_color ?? null,
+      teamRank: source.team_rank ?? null,
+      captainRank: source.captain_rank ?? null,
+      isCaptain: Number(source.captain_rank) > 0,
+      isShipOwner: false,
+      canBeManaged: false,
+      time: source.time ?? null,
+      items: Array.isArray(source.items) ? source.items.slice() : [],
+      aliasDiscrims: Array.isArray(source.alias_discrims) ? source.alias_discrims.slice() : [],
+      extraAliasCount: normalizeNonNegativeNumber(source.extra_aliases),
+      onlineCount: source.online_count ?? null
+    };
+  }
+  function normalizeNonNegativeNumber(value) {
+    const number = Number(value);
+    return Number.isFinite(number) && number > 0 ? number : 0;
+  }
+  function ownerRankForPlayers(players) {
+    const ranks = players.filter((player) => Number(player.captainRank) > 0).map((player) => Number(player.captainRank)).filter(Number.isFinite);
+    if (!ranks.length) return null;
+    const ownerRank = Math.min(...ranks);
+    for (const player of players) player.isShipOwner = Number(player.captainRank) === ownerRank;
+    return ownerRank;
+  }
+  function applyPlayerControlState(players, currentCaptainSubrank) {
+    const currentRank = currentCaptainRank(currentCaptainSubrank);
+    for (const player of players) player.canBeManaged = playerCanBeManagedBy(player, currentRank);
+  }
+  function currentCaptainRank(currentCaptainSubrank) {
+    const rank = Number(currentCaptainSubrank?.subrank);
+    return Number.isFinite(rank) && rank > 0 ? rank : null;
+  }
+  function playerCanBeManagedBy(player, currentRank) {
+    if (!Number.isFinite(currentRank) || !player) return false;
+    const targetCaptainRank = Number(player.captainRank);
+    if (Number.isFinite(targetCaptainRank) && targetCaptainRank > 0) return currentRank < targetCaptainRank;
+    const targetTeamRank = Number(player.teamRank);
+    return targetTeamRank === 0 || targetTeamRank === 1;
+  }
+
+  // src/client/domains/tips.js
+  function timeoutValue(options) {
+    const timeout = options.timeout ?? 5e3;
+    if (!Number.isFinite(timeout) || timeout <= 0) throw new RangeError("timeout must be positive milliseconds");
+    return timeout;
+  }
+  function waitFor(client, eventType, read, timeout, label, send = null) {
+    return new Promise((resolve, reject) => {
+      const cleanup = () => {
+        clearTimeout(timer);
+        client.off(eventType, check);
+        client.off("close", closed);
+      };
+      const check = (...args) => {
+        const value = read(...args);
+        if (value) {
+          cleanup();
+          resolve(value);
+        }
+      };
+      const closed = () => {
+        cleanup();
+        reject(new Error(`Disconnected while waiting for ${label}`));
+      };
+      const timer = setTimeout(() => {
+        cleanup();
+        reject(new Error(`Timed out waiting for ${label}`));
+      }, timeout);
+      client.on(eventType, check);
+      client.on("close", closed);
+      if (send) {
+        try {
+          send();
+        } catch (error) {
+          cleanup();
+          reject(error);
+          return;
+        }
+      }
+      check();
+    });
+  }
+  var TipDomain = class {
+    #busy = false;
+    #target = null;
+    #current = null;
+    constructor(client) {
+      this.client = client;
+      client.on("close", () => {
+        this.#current = null;
+        this.#target = null;
+      });
+    }
+    get current() {
+      return this.#current;
+    }
+    receive(event, world) {
+      const options = Array.isArray(event.options) ? event.options.map(String) : [];
+      const entity = this.#target?.world === world?.id ? this.#target.entity : null;
+      const menu = Object.freeze({
+        entity,
+        world: world?.id ?? null,
+        filter: event.filter ?? null,
+        x: event.x ?? 0,
+        y: event.y ?? 0,
+        options: Object.freeze(options)
+      });
+      this.#current = options.length ? menu : null;
+      this.client.emit("tip-list", menu, world);
+    }
+    async #exclusive(action) {
+      if (this.#busy) throw new Error("A tip menu operation is already in progress");
+      this.#busy = true;
+      try {
+        return await action();
+      } catch (error) {
+        this.#current = null;
+        this.#target = null;
+        throw error;
+      } finally {
+        this.#busy = false;
+      }
+    }
+    async #open(entity, options) {
+      if (!this.client.ready || !this.client.connected) throw new Error("Client must be connected and ready to open tips");
+      const timeout = timeoutValue(options);
+      const handle = typeof entity === "number" ? this.client.currentShip()?.entities.get(entity) : entity;
+      if (!handle || handle.client !== this.client || !handle.exists()) throw new Error("Tip target must be an existing entity on this client");
+      const world = this.client.worlds.currentWorldId;
+      const scopeWorld = handle.scope === "ship" ? this.client.worlds.shipWorld() : handle.scope === "current" ? this.client.worlds.worlds.get(world) : handle.scope === "overworld" ? this.client.worlds.overworld() : this.client.worlds.worlds.get(Number(handle.scope));
+      if (scopeWorld?.id !== world) {
+        throw new Error("Tip target must be in the current world");
+      }
+      const position = handle.position;
+      if (!position) throw new Error("Tip target has no position");
+      this.#current = null;
+      this.#target = { entity: handle.id, world, command: {
+        ...options.command,
+        focus_ent: handle.id,
+        mx: position.x,
+        my: position.y
+      } };
+      return waitFor(this.client, "tip-list", () => {
+        return this.#current?.entity === handle.id && this.#current.world === world ? this.#current : null;
+      }, timeout, "tip menu", () => {
+        this.client.send({ ...this.#target.command, act1: false, act2: true, tip_select: null });
+      });
+    }
+    open(entity, options = {}) {
+      return this.#exclusive(() => this.#open(entity, options));
+    }
+    close(options = {}) {
+      return this.#exclusive(async () => {
+        const timeout = timeoutValue(options);
+        const menu = this.#current;
+        if (!menu) return this.client;
+        if (!this.client.connected || !this.client.ready) throw new Error("Client must be connected and ready to close tips");
+        if (menu.world !== this.client.worlds.currentWorldId) throw new Error("Tip menu belongs to another world");
+        await waitFor(this.client, "tip-list", (update) => update?.world === menu.world && update.options.length === 0, timeout, "tip menu dismissal", () => {
+          this.client.send({
+            ...options.command,
+            focus_ent: null,
+            config_ent: null,
+            act1: true,
+            act1_held: true,
+            act2: false,
+            tip_select: null
+          });
+        });
+        this.#target = null;
+        return this.client;
+      });
+    }
+    select(option, command = {}) {
+      if (this.#busy) throw new Error("A tip menu operation is already in progress");
+      return this.#select(option, command);
+    }
+    #select(option, command = {}) {
+      if (!this.client.connected || !this.client.ready) throw new Error("Client must be connected and ready to select tips");
+      const menu = this.#current;
+      if (!menu || menu.entity == null || !this.#target) throw new Error("Open an entity's tip menu before selecting an option");
+      if (menu.world !== this.client.worlds.currentWorldId) throw new Error("Tip menu belongs to another world");
+      const index = typeof option === "string" ? menu.options.indexOf(option) : option;
+      if (!Number.isInteger(index) || index < 0 || index >= menu.options.length) throw new RangeError("Tip option is not in the current menu");
+      this.client.send({
+        ...this.#target.command,
+        ...command,
+        focus_ent: menu.entity,
+        act1: false,
+        act2: false,
+        tip_select: index
+      });
+      this.#current = null;
+      this.#target = null;
+      return this.client;
+    }
+    choose(entity, option, options = {}) {
+      return this.#exclusive(async () => {
+        await this.#open(entity, options);
+        return this.#select(option);
+      });
+    }
+    setRank(handle, rank, options = {}) {
+      return this.#exclusive(async () => {
+        const value = normalizePlayerRank(rank);
+        const timeout = timeoutValue(options);
+        if (!handle.exists()) throw new Error("Rank target no longer exists");
+        if (handle.rank === value) return this.client;
+        const text = { 0: "Restrict to Guests", 1: "Restrict to Crew", 3: "Restrict to Captains" }[value];
+        await this.#open(handle, options);
+        await waitFor(
+          this.client,
+          "model",
+          () => handle.rank === value,
+          timeout,
+          "access rank update",
+          () => this.#select(text)
+        );
+        return this.client;
+      });
+    }
+  };
+
   // src/client/core.js
   init_cookies();
   init_servers();
@@ -8433,184 +8794,6 @@
     return number === 0 && count === 0 ? null : number;
   }
 
-  // src/protocol/outbound/ship-management.js
-  var SHIP_MANAGEMENT_TYPE = 4;
-  var SET_PRIVACY_ACTION = "set_privacy";
-  var STARTER_RECOVERY_ACTION = "starter_recovery";
-  var PLAYER_LIST_ACTION = "player_list";
-  var INVITE_RESET_ACTION = "invite_reset";
-  var SET_RANK_ACTION = "set_rank";
-  var KICK_ACTION = "kick";
-  var BAN_ACTION = "ban";
-  var DEMOTE_SELF_ACTION = "demote_self";
-  function requireNonNegativeInteger(value, name) {
-    const number = Number(value);
-    if (!Number.isInteger(number) || number < 0) throw new RangeError(`${name} must be a non-negative integer`);
-    return number;
-  }
-  function normalizePrivacy(value) {
-    if (value === true || value === 1 || value === "private") return 1;
-    if (value === false || value === 0 || value === "public") return 0;
-    throw new RangeError(`privacy must be 0, 1, true, false, "public", or "private"`);
-  }
-  function normalizePlayerRef(value) {
-    return requireNonNegativeInteger(value, "refId");
-  }
-  function normalizePlayerRank(value) {
-    if (value === 0 || value === "guest") return 0;
-    if (value === 1 || value === "crew") return 1;
-    if (value === 3 || value === "captain") return 3;
-    throw new RangeError(`rank must be 0, 1, 3, "guest", "crew", or "captain"`);
-  }
-  function buildShipManagementMessage(act, arg = null, extra = null) {
-    if (typeof act !== "string" || !act) throw new TypeError(`act must be a non-empty string`);
-    const message = { type: SHIP_MANAGEMENT_TYPE, act, arg };
-    if (extra && typeof extra === "object") Object.assign(message, extra);
-    return message;
-  }
-  function buildShipPrivacyMessage(privacy) {
-    return buildShipManagementMessage(SET_PRIVACY_ACTION, normalizePrivacy(privacy));
-  }
-  function buildStarterRecoveryMessage(itemId) {
-    return buildShipManagementMessage(STARTER_RECOVERY_ACTION, requireNonNegativeInteger(itemId, "itemId"));
-  }
-  function buildPlayerListMessage() {
-    return buildShipManagementMessage(PLAYER_LIST_ACTION);
-  }
-  function buildInviteResetMessage() {
-    return buildShipManagementMessage(INVITE_RESET_ACTION);
-  }
-  function buildSetPlayerRankMessage(refId, rank) {
-    return buildShipManagementMessage(SET_RANK_ACTION, normalizePlayerRef(refId), { rank: normalizePlayerRank(rank) });
-  }
-  function buildKickPlayerMessage(refId) {
-    return buildShipManagementMessage(KICK_ACTION, normalizePlayerRef(refId));
-  }
-  function buildBanPlayerMessage(refId) {
-    return buildShipManagementMessage(BAN_ACTION, normalizePlayerRef(refId));
-  }
-  function buildDemoteSelfMessage() {
-    return buildShipManagementMessage(DEMOTE_SELF_ACTION);
-  }
-  function normalizeShipConfig(event = {}) {
-    const source = event && typeof event === "object" ? event : {};
-    const config = source.config && typeof source.config === "object" ? source.config : {};
-    return {
-      privacy: config.privacy ?? null,
-      privacyName: config.privacy === 0 ? "public" : config.privacy === 1 ? "private" : null,
-      inviteKey: config.invite_key ?? null,
-      teamId: source.team_id ?? null,
-      patronPerks: Array.isArray(source.patron_perks) ? source.patron_perks.slice() : []
-    };
-  }
-  function normalizeCaptainSubrank(event = {}) {
-    const source = event && typeof event === "object" ? event : {};
-    return {
-      subrank: source.subrank ?? null,
-      enableCheats: Boolean(source.enable_cheats)
-    };
-  }
-  function normalizeShipPlayerList(event = {}, previous = null, currentCaptainSubrank = null) {
-    const source = event && typeof event === "object" ? event : {};
-    const changes = Array.isArray(source.player_list) ? source.player_list.map(normalizePlayerListChange) : [];
-    const removedPlayers = changes.filter((change) => change.remove && Number.isFinite(Number(change.refId))).map((change) => Number(change.refId));
-    const changedPlayers = changes.filter((change) => !change.remove).map(({ remove: _remove, ...change }) => change);
-    const players = mergePlayerListChanges(previous?.players, changes);
-    const ownerCaptainRank = ownerRankForPlayers(players);
-    applyPlayerControlState(players, currentCaptainSubrank);
-    applyPlayerControlState(changedPlayers, currentCaptainSubrank);
-    return {
-      ownerCaptainRank,
-      shipOwners: players.filter((player) => player.isShipOwner),
-      players,
-      changes: changedPlayers,
-      removedPlayers
-    };
-  }
-  function mergePlayerListChanges(previousPlayers, changes) {
-    if (!Array.isArray(previousPlayers) || !previousPlayers.length) return changes.filter((change) => !change.remove).map(({
-      remove: _remove,
-      ...player
-    }) => ({ ...player }));
-    const existing = /* @__PURE__ */ new Map();
-    for (const player of previousPlayers) {
-      if (player?.refId == null) continue;
-      existing.set(player.refId, { ...player, isShipOwner: false });
-    }
-    const changedRefs = /* @__PURE__ */ new Set();
-    const merged = [];
-    for (const change of changes) {
-      if (change.refId == null) {
-        if (!change.remove) {
-          const { remove: _remove2, ...player2 } = change;
-          merged.push({ ...player2, isShipOwner: false });
-        }
-        continue;
-      }
-      changedRefs.add(change.refId);
-      if (change.remove) {
-        existing.delete(change.refId);
-        continue;
-      }
-      const { remove: _remove, ...changePlayer } = change;
-      const player = { ...existing.get(change.refId) || {}, ...changePlayer, isShipOwner: false };
-      existing.set(change.refId, player);
-      merged.push(player);
-    }
-    for (const player of previousPlayers) {
-      if (player?.refId == null || changedRefs.has(player.refId)) continue;
-      const retained = existing.get(player.refId);
-      if (retained) merged.push(retained);
-    }
-    return merged;
-  }
-  function normalizePlayerListChange(entry = {}) {
-    const source = entry && typeof entry === "object" ? entry : {};
-    if (source._removed) return { refId: source.ref_id ?? null, remove: true };
-    return {
-      refId: source.ref_id ?? null,
-      remove: false,
-      discrim: source.discrim ?? null,
-      discrimColor: source.discrim_color ?? null,
-      teamRank: source.team_rank ?? null,
-      captainRank: source.captain_rank ?? null,
-      isCaptain: Number(source.captain_rank) > 0,
-      isShipOwner: false,
-      canBeManaged: false,
-      time: source.time ?? null,
-      items: Array.isArray(source.items) ? source.items.slice() : [],
-      aliasDiscrims: Array.isArray(source.alias_discrims) ? source.alias_discrims.slice() : [],
-      extraAliasCount: normalizeNonNegativeNumber(source.extra_aliases),
-      onlineCount: source.online_count ?? null
-    };
-  }
-  function normalizeNonNegativeNumber(value) {
-    const number = Number(value);
-    return Number.isFinite(number) && number > 0 ? number : 0;
-  }
-  function ownerRankForPlayers(players) {
-    const ranks = players.filter((player) => Number(player.captainRank) > 0).map((player) => Number(player.captainRank)).filter(Number.isFinite);
-    if (!ranks.length) return null;
-    const ownerRank = Math.min(...ranks);
-    for (const player of players) player.isShipOwner = Number(player.captainRank) === ownerRank;
-    return ownerRank;
-  }
-  function applyPlayerControlState(players, currentCaptainSubrank) {
-    const currentRank = currentCaptainRank(currentCaptainSubrank);
-    for (const player of players) player.canBeManaged = playerCanBeManagedBy(player, currentRank);
-  }
-  function currentCaptainRank(currentCaptainSubrank) {
-    const rank = Number(currentCaptainSubrank?.subrank);
-    return Number.isFinite(rank) && rank > 0 ? rank : null;
-  }
-  function playerCanBeManagedBy(player, currentRank) {
-    if (!Number.isFinite(currentRank) || !player) return false;
-    const targetCaptainRank = Number(player.captainRank);
-    if (Number.isFinite(targetCaptainRank) && targetCaptainRank > 0) return currentRank < targetCaptainRank;
-    const targetTeamRank = Number(player.teamRank);
-    return targetTeamRank === 0 || targetTeamRank === 1;
-  }
-
   // src/protocol/outbound/sign.js
   var SIGN_TEXT_COMMAND = "sign_text";
   var SignDisplayMode = Object.freeze({
@@ -9800,6 +9983,9 @@
     use(options = {}, command = {}) {
       return this.client.player.useEntity(this.id, options, command);
     }
+    openTips(options = {}) {
+      return this.client.tips.open(this, options);
+    }
   };
   var MachineHandle = class extends EntityHandle {
     open(options = {}, command = {}) {
@@ -10102,6 +10288,9 @@
     }
   };
   var DoorHandle = class extends MachineHandle {
+    setRank(rank, options = {}) {
+      return this.client.tips.setRank(this, rank, options);
+    }
     get state() {
       return summaryForEntity(this.client, this.scope, this.id)?.contents?.door || null;
     }
@@ -10113,6 +10302,9 @@
     }
   };
   var SpawnPointHandle = class extends MachineHandle {
+    setRank(rank, options = {}) {
+      return this.client.tips.setRank(this, rank, options);
+    }
     get state() {
       return summaryForEntity(this.client, this.scope, this.id)?.contents?.spawnPoint || null;
     }
@@ -10657,6 +10849,7 @@
       this.debug = new ClientDebugDomain(this);
       this.player = new PlayerDomain(this);
       this.inventory = new InventoryDomain(this);
+      this.tips = new TipDomain(this);
       this.management = new ShipManagementDomain(this);
       this.cpuLoad = null;
       this.inventoryState = normalizeInventoryEvent({ type: "inventory", general_slots: 5 });
@@ -11410,6 +11603,7 @@
     }
     #handleSideEvent(event, world) {
       if (!event || typeof event !== "object") return;
+      if (event.type === "tip_list") this.tips.receive(event, world);
       if (event.type === "inventory") {
         this.inventoryState = normalizeInventoryEvent(event);
         this.emit("inventory", this.inventoryState, world);