dredless 0.7.0 → 1.0.1

package/src/network/account.js

@@ -0,0 +1,182 @@
+import {isBrowser} from "../runtime.js";
+
+export async function fetchAccountDetails(session) {
+    const response = await session.request("account/", {
+        method: "GET",
+        headers: {accept: "text/html"},
+        credentials: "include",
+        cache: "no-store"
+    });
+    session.mergeSetCookies(response);
+    if (!response.ok) throw new Error(`Account page request failed: ${response.status} ${response.statusText}`);
+    return parseAccountDetails(await response.text());
+}
+
+export async function fetchClanTag(session) {
+    return (await fetchAccountDetails(session)).clan;
+}
+
+export async function setClanTag(session, tag) {
+    if (typeof tag !== "string") throw new TypeError("tag must be a string");
+    return updateClanTag(session, tag);
+}
+
+export async function clearClanTag(session) {
+    return updateClanTag(session, "");
+}
+
+async function updateClanTag(session, tag) {
+    // The Clear form has no named fields; ordinary updates contain only `tag`.
+    const body = tag === "" ? "" : new URLSearchParams({tag}).toString();
+    await postAccountForm(session, "account/clan", body, "Clan tag update");
+    const clan = await fetchClanTag(session);
+    if ((clan.tag ?? "") !== tag) throw new Error("Clan tag update was not confirmed by the account page");
+    return clan;
+}
+
+export async function removeShipPerks(session, shipId) {
+    const id = requirePerkShipId(shipId);
+    await postAccountForm(session, "account/remove_perks", new URLSearchParams({ship: id}).toString(), "Ship perk removal");
+    const {shipsWithPerks} = await fetchAccountDetails(session);
+    if (shipsWithPerks === null || shipsWithPerks.some((ship) => ship.shipId === id)) {
+        throw new Error("Ship perk removal was not confirmed by the account page");
+    }
+    return shipsWithPerks;
+}
+
+async function postAccountForm(session, path, body, operation) {
+    const response = await session.request(path, {
+        method: "POST",
+        headers: {
+            accept: "text/html",
+            "content-type": "application/x-www-form-urlencoded",
+            ...(!isBrowser() ? {origin: new URL(session.baseUrl).origin} : {})
+        },
+        body,
+        credentials: "include",
+        referrer: `${session.baseUrl}/account/`,
+        // Node must merge cookies before following the form's redirect.
+        redirect: isBrowser() ? "follow" : "manual"
+    });
+    session.mergeSetCookies(response);
+    if (!response.ok && response.status !== 302 && response.status !== 303) {
+        throw new Error(`${operation} failed: ${response.status} ${response.statusText}`);
+    }
+    // Consume the redirect/HTML response before fetching the confirmation page.
+    await response.text();
+}
+
+export function parseAccountDetails(html) {
+    // Only extract the captured account form and labeled fields. Never execute HTML.
+    const source = String(html).replace(/<!--[\s\S]*?-->|<(script|style)\b[^>]*>[\s\S]*?<\/\1\s*>/gi, "");
+    let tag = null;
+    let found = false;
+    for (const form of source.matchAll(/<form\b((?:"[^"]*"|'[^']*'|[^'">])*)>([\s\S]*?)<\/form\s*>/gi)) {
+        const action = attributes(form[1]).get("action");
+        if (!action || new URL(action, "https://drednot.io/").pathname !== "/account/clan") continue;
+        for (const input of form[2].matchAll(/<input\b((?:"[^"]*"|'[^']*'|[^'">])*)>/gi)) {
+            const attrs = attributes(input[1]);
+            if (attrs.get("name") !== "tag") continue;
+            tag = attrs.get("value") || null;
+            found = true;
+            break;
+        }
+        if (found) break;
+    }
+    if (!found) throw new Error("Account page has no clan form; authentication may be required or the page format has changed");
+
+    const fields = new Map();
+    let name = null;
+    let color = null;
+    for (const paragraph of source.matchAll(/<p\b[^>]*>([\s\S]*?)<\/p\s*>/gi)) {
+        const label = paragraph[1].match(/<b\b[^>]*>([\s\S]*?)<\/b\s*>/i);
+        const code = paragraph[1].match(/<code\b((?:"[^"]*"|'[^']*'|[^'">])*)>([\s\S]*?)<\/code\s*>/i);
+        if (!code) continue;
+        const attrs = attributes(code[1]);
+        if (label) fields.set(text(label[1]).replace(/:\s*$/, "").toLowerCase(), attrs.get("data-info") ?? null);
+        if ((attrs.get("class") || "").split(/\s+/).includes("user") && /^You are:$/i.test(text(paragraph[1].slice(0, code.index)))) {
+            name = decodeHtml(code[2].replace(/<[^>]*>/g, ""));
+            color = parseAccountColor(attrs.get("style") || "");
+        }
+    }
+    const rawIdentity = fields.get("identity (service)") || null;
+    const identityParts = rawIdentity?.match(/^(.*?)\s*\(([^()]*)\)\s*$/);
+    const count = text(source).match(/Your current clan tag has\s+([\d,]+)\s+other users?\b/i);
+    return {
+        name,
+        color,
+        email: fields.get("email") || null,
+        identity: identityParts ? identityParts[1].trim() : rawIdentity,
+        identityService: identityParts ? identityParts[2].trim() : null,
+        clan: {tag, otherUsers: tag !== null && count ? Number(count[1].replace(/,/g, "")) : null},
+        shipsWithPerks: parseShipsWithPerks(source)
+    };
+}
+
+function parseAccountColor(style) {
+    let color = null;
+    for (const declaration of style.split(";")) {
+        const match = declaration.match(/^\s*background(?:-color)?\s*:\s*#([0-9a-f]{6}|[0-9a-f]{3})\s*(?:!important\s*)?$/i);
+        if (!match) continue;
+        const hex = match[1].length === 3 ? [...match[1]].map((digit) => digit + digit).join("") : match[1];
+        color = parseInt(hex, 16);
+    }
+    return color;
+}
+
+function parseShipsWithPerks(source) {
+    const heading = source.match(/<(b|strong)\b[^>]*>\s*Ships\s+with\s+Perks\s+Applied\s*:\s*<\/\1\s*>/i);
+    if (!heading) return null;
+    const list = source.slice(heading.index + heading[0].length).match(/^\s*(?:<\/[^>]+>\s*)*<ul\b[^>]*>([\s\S]*?)<\/ul\s*>/i);
+    if (!list) throw new Error("Account page's applied-perks list could not be parsed");
+    const ships = [];
+    for (const item of list[1].matchAll(/<li\b[^>]*>([\s\S]*?)<\/li\s*>/gi)) {
+        const form = item[1].match(/<form\b((?:"[^"]*"|'[^']*'|[^'">])*)>([\s\S]*?)<\/form\s*>/i);
+        const action = form && attributes(form[1]).get("action");
+        if (!action || new URL(action, "https://drednot.io/").pathname !== "/account/remove_perks") {
+            throw new Error("Account page's applied-perks entry has no removal form");
+        }
+        let shipId = null;
+        for (const input of form[2].matchAll(/<input\b((?:"[^"]*"|'[^']*'|[^'">])*)>/gi)) {
+            const attrs = attributes(input[1]);
+            if (attrs.get("name") === "ship") shipId = requirePerkShipId(attrs.get("value"));
+        }
+        if (shipId === null) throw new Error("Account page's applied-perks entry has no ship identifier");
+        const label = decodeHtml(item[1].slice(0, form.index).replace(/<[^>]*>/g, ""));
+        const parts = label.match(/^([\s\S]*?) \{([^{}]+)\}\s*$/);
+        ships.push({shipId, name: parts ? parts[1] : label.trim(), hexCode: parts ? parts[2] : null});
+    }
+    return ships;
+}
+
+function requirePerkShipId(value) {
+    if (typeof value === "number" && (!Number.isSafeInteger(value) || value <= 0)) {
+        throw new RangeError("shipId must be a positive safe integer or a decimal ID string from shipsWithPerks");
+    }
+    if ((typeof value !== "string" && typeof value !== "number") || !/^[1-9]\d*$/.test(String(value))) {
+        throw new TypeError("shipId must be a positive integer or a decimal ID string from shipsWithPerks");
+    }
+    return String(value);
+}
+
+function attributes(source) {
+    const result = new Map();
+    for (const match of source.matchAll(/([^\s=<>"'`/]+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+)))?/g)) {
+        result.set(match[1].toLowerCase(), decodeHtml(match[2] ?? match[3] ?? match[4] ?? ""));
+    }
+    return result;
+}
+
+function text(source) {
+    return decodeHtml(source.replace(/<[^>]*>/g, " ")).replace(/\s+/g, " ").trim();
+}
+
+function decodeHtml(value) {
+    const named = {amp: "&", lt: "<", gt: ">", quot: '"', apos: "'", nbsp: " "};
+    return value.replace(/&(#x[0-9a-f]+|#\d+|amp|lt|gt|quot|apos|nbsp);/gi, (raw, entity) => {
+        const name = entity.toLowerCase();
+        if (Object.hasOwn(named, name)) return named[name];
+        const code = name.startsWith("#x") ? parseInt(name.slice(2), 16) : Number(name.slice(1));
+        return code > 0 && code <= 0x10ffff && !(code >= 0xd800 && code <= 0xdfff) ? String.fromCodePoint(code) : "\ufffd";
+    });
+}

package/src/network/disconnect.d.ts

@@ -0,0 +1,2 @@
+export {DropReason, DisconnectError, normalizeDisconnect} from "../index.js";
+export type {DisconnectInfo, SaveShipOptions} from "../index.js";

package/src/network/disconnect.js

@@ -0,0 +1,53 @@
+// Application close codes from the official client's DropReason enum.
+export const DropReason = Object.freeze({
+    ProtocolError: 4000,
+    BadVersion: 4001,
+    ConnectLimit: 4002,
+    ConnectRate: 4003,
+    TeamLimit: 4004,
+    FullPlayers: 4005,
+    FullTeams: 4006,
+    TeamNotAvailable: 4007,
+    Kicked: 4008,
+    Banned: 4009,
+    Idle: 4010,
+    ShipDestruct: 4011,
+    JoinBlocked: 4012,
+    HardBanned: 4013,
+    NoLoad: 4014,
+    Saved: 4015,
+    InvalidInvite: 4016,
+    Shutdown: 4017,
+    ServerError: 4018,
+    GTFO: 4019
+});
+
+const reasonNames = new Map(Object.entries(DropReason).map(([name, code]) => [code, name]));
+const textDecoder = new TextDecoder();
+
+export function normalizeDisconnect(eventOrCode, reason = "") {
+    const event = eventOrCode != null && typeof eventOrCode === "object" ? eventOrCode : null;
+    const code = event?.code ?? eventOrCode;
+    const rawReason = event?.reason ?? reason;
+    let text = "";
+    if (typeof rawReason === "string") text = rawReason;
+    else if (ArrayBuffer.isView(rawReason)) {
+        text = textDecoder.decode(new Uint8Array(rawReason.buffer, rawReason.byteOffset, rawReason.byteLength));
+    } else if (rawReason instanceof ArrayBuffer) text = textDecoder.decode(rawReason);
+    const normalizedCode = Number.isInteger(code) ? code : 1006;
+    return Object.freeze({
+        code: normalizedCode,
+        name: reasonNames.get(normalizedCode) ?? null,
+        reason: text,
+        // EventEmitter close callbacks don't report whether the handshake was clean.
+        wasClean: typeof event?.wasClean === "boolean" ? event.wasClean : null
+    });
+}
+
+export class DisconnectError extends Error {
+    constructor(disconnect, message = "Disconnected") {
+        super(`${message}: ${disconnect.name ?? "Unknown"} (${disconnect.code})${disconnect.reason ? ` — ${disconnect.reason}` : ""}`);
+        this.name = "DisconnectError";
+        this.disconnect = disconnect;
+    }
+}

package/src/network/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./connection.js";
+export * from "./disconnect.js";
 export * from "./servers.js";
 export * from "./ships.js";
 export * from "./session.js";

package/src/network/index.js

@@ -1,4 +1,5 @@
 export {Connection} from "./connection.js";
+export {DropReason, DisconnectError, normalizeDisconnect} from "./disconnect.js";
 export {fetchGameVersion, fetchNoticeVersion, fetchServerStatus, fetchServerStatuses, fetchServers, resolveServer} from "./servers.js";
 export {fetchShips, fetchShipList, createShipSpec, createInviteShipSpec, shipRef} from "./ships.js";
 export {Session, AnonSession, createSession, createAnonSession, createAnonToken} from "./session.js";

package/src/network/invites.d.ts

@@ -1,15 +1,12 @@
 export interface InviteMetadata {
     shipId: string | null;
     name: string | null;
-    /** CSS RGB color sampled from the preview image's top-left pixel, when available. */
-    color?: string | null;
     previewImageUrl: string | null;
     hostname: string;
     inviteCode: string;
 }
 export interface InviteFetchOptions {
     fetchImpl?: typeof fetch;
-    includeColor?: boolean;
 }
 export function fetchInviteMetadata(invite: string | URL, options?: InviteFetchOptions): Promise<InviteMetadata>;
 export function parseInviteMetadata(html: string): InviteMetadata;

package/src/network/invites.js

@@ -1,48 +1,11 @@
-import {getFetch, isBrowser} from "../runtime.js";
+import {getFetch} from "../runtime.js";
 
-export async function fetchInviteMetadata(invite, {fetchImpl = null, includeColor = false} = {}) {
+export async function fetchInviteMetadata(invite, {fetchImpl = null} = {}) {
     const url = normalizeInviteUrl(invite);
     const fetcher = fetchImpl || getFetch();
     const response = await fetcher(url.href, {headers: {accept: "text/html"}});
     if (!response.ok) throw new Error(`Invite metadata request failed: ${response.status} ${response.statusText}`);
-    const metadata = parseInviteMetadata(await response.text());
-    if (!includeColor || !metadata.previewImageUrl) return metadata;
-    return Object.freeze({...metadata, color: await fetchTopLeftColor(metadata.previewImageUrl, fetcher)});
-}
-
-async function fetchTopLeftColor(imageUrl, fetcher) {
-    try {
-        let response = await fetcher(imageUrl, {headers: {range: "bytes=0-1023"}});
-        if (!response.ok) return null;
-        const buffer = await response.arrayBuffer();
-        try {
-            return await decodeImageColor(buffer);
-        } catch (error) {
-            if (response.status !== 206) throw error;
-            response = await fetcher(imageUrl);
-            if (!response.ok) return null;
-            return await decodeImageColor(await response.arrayBuffer());
-        }
-    } catch {
-        return null;
-    }
-}
-
-async function decodeImageColor(buffer) {
-        if (isBrowser()) {
-            const bitmap = await createImageBitmap(new Blob([buffer]));
-            const canvas = typeof OffscreenCanvas === "function" ? new OffscreenCanvas(1, 1) : document.createElement("canvas");
-            canvas.width = canvas.height = 1;
-            const context = canvas.getContext("2d");
-            context.drawImage(bitmap, 0, 0, 1, 1);
-            const [red, green, blue] = context.getImageData(0, 0, 1, 1).data;
-            bitmap.close();
-            return `rgb(${red},${green},${blue})`;
-        }
-        const sharpModule = await import("sharp");
-        const sharp = sharpModule.default || sharpModule;
-        const {data} = await sharp(buffer).extract({left: 0, top: 0, width: 1, height: 1}).raw().toBuffer({resolveWithObject: true});
-        return `rgb(${data[0]},${data[1]},${data[2]})`;
+    return parseInviteMetadata(await response.text());
 }
 
 export function parseInviteMetadata(html) {

package/src/network/session.d.ts

@@ -5,3 +5,5 @@ export {
     createAnonSession,
     createAnonToken
 } from "../index.js";
+
+export type {AccountDetails, AccountPerkShip, ClanTagDetails} from "../index.js";

package/src/network/session.js

@@ -6,6 +6,7 @@ import {fetchGameVersion, resolveServer, serverId} from "./servers.js";
 import {createInviteShipSpec, createShipSpec, fetchShipList, fetchShips, shipRef} from "./ships.js";
 import {Connection} from "./connection.js";
 import {DredlessClient} from "../client/index.js";
+import {fetchAccountDetails, fetchClanTag, setClanTag, clearClanTag, removeShipPerks} from "./account.js";
 
 export class Session {
     constructor(gameSession = null, gameVersion = null, baseUrl = DEFAULT_BASE_URL) {
@@ -61,6 +62,26 @@ export class Session {
         return raw;
     }
 
+    fetchAccountDetails() {
+        return fetchAccountDetails(this);
+    }
+
+    fetchClanTag() {
+        return fetchClanTag(this);
+    }
+
+    setClanTag(tag) {
+        return setClanTag(this, tag);
+    }
+
+    clearClanTag() {
+        return clearClanTag(this);
+    }
+
+    removeShipPerks(shipId) {
+        return removeShipPerks(this, shipId);
+    }
+
     async fetchShips(server) {
         return fetchShips(this, server);
     }

package/src/protocol/outbound/ship-management.d.ts

@@ -1,19 +1,60 @@
+export const GravityDirection: {
+    readonly Down: "down";
+    readonly Up: "up";
+    readonly Left: "left";
+    readonly Right: "right";
+};
+export type GravityDirection = typeof GravityDirection[keyof typeof GravityDirection];
+export type ShipGravityDirection = GravityDirection | 0 | 1 | 2 | 3;
+
 export type ShipPrivacy = 0 | 1 | boolean | "public" | "private";
 export type ShipPlayerRank = 0 | 1 | 3 | "guest" | "crew" | "captain";
 
+export interface CrewLogEntry {
+    icon: string | null;
+    /** Plain text; formatting, images, badges, and date tokens remain in rawText. */
+    text: string;
+    rawText: unknown;
+    count: number;
+    refId: number | null;
+    secondaryRefId: number | null;
+}
+
+export interface CrewLog {
+    /** Retained entries in server order, oldest first; at most 500. */
+    entries: CrewLogEntry[];
+    /** Entries appended by the latest message, including amended replacements. */
+    changes: CrewLogEntry[];
+    reset: boolean;
+    amend: boolean;
+}
+
 export interface ShipManagementMessage {
     type: 4;
     act: string;
     arg: unknown;
+    arg2?: unknown;
     rank?: unknown;
 }
 
+export interface ShipPatronPerk {
+    name: string;
+    /** Packed RGB color, as sent by the server. */
+    color: number;
+    /** Official tiers include bronze, silver, gold, plat, and flux. */
+    tier: string;
+}
+
+export interface PatronPerksResponse {
+    readonly failure: boolean;
+}
+
 export interface ShipConfig {
     privacy: number | null;
     privacyName: "public" | "private" | null;
     inviteKey: string | null;
     teamId: number | null;
-    patronPerks: unknown[];
+    patronPerks: ShipPatronPerk[];
 }
 
 export interface CaptainSubrank {
@@ -49,10 +90,22 @@ export function buildShipManagementMessage(act: string, arg?: unknown, extra?: R
 
 export function buildShipPrivacyMessage(privacy: ShipPrivacy): ShipManagementMessage;
 
+export function buildShipGravityMessage(direction: ShipGravityDirection): ShipManagementMessage;
+
+export function buildSetPatronPerksMessage(enabled: boolean): ShipManagementMessage;
+
+export function normalizeGravityDirection(direction: ShipGravityDirection): 0 | 1 | 2 | 3;
+
 export function buildStarterRecoveryMessage(itemId: number): ShipManagementMessage;
 
 export function buildPlayerListMessage(): ShipManagementMessage;
 
+export function buildSaveShipMessage(): ShipManagementMessage;
+
+export function buildShipRenameRequestMessage(): ShipManagementMessage;
+
+export function buildShipRenameCommitMessage(name: string, color: string): ShipManagementMessage;
+
 export function buildInviteResetMessage(): ShipManagementMessage;
 
 export function buildSetPlayerRankMessage(refId: number, rank: ShipPlayerRank): ShipManagementMessage;
@@ -61,6 +114,8 @@ export function buildKickPlayerMessage(refId: number): ShipManagementMessage;
 
 export function buildBanPlayerMessage(refId: number): ShipManagementMessage;
 
+export function buildUnbanPlayerMessage(refId: number): ShipManagementMessage;
+
 export function buildDemoteSelfMessage(): ShipManagementMessage;
 
 export function normalizePrivacy(privacy: ShipPrivacy): 0 | 1;
@@ -71,14 +126,24 @@ export function normalizeShipConfig(event: unknown): ShipConfig;
 
 export function normalizeCaptainSubrank(event: unknown): CaptainSubrank;
 
+export function normalizeCrewLog(event: unknown, previous?: CrewLog | null): CrewLog;
+
 export function normalizeShipPlayerList(event: unknown, previous?: ShipPlayerList | null, currentCaptainSubrank?: CaptainSubrank | null): ShipPlayerList;
 
+export const CREW_LOG_LENGTH: 500;
+export const GRAVITY_ACTION: "gravity";
+export const SET_PATRON_PERKS_ACTION: "set_patron_perks";
 export const BAN_ACTION: "ban";
+export const UNBAN_ACTION: "unban";
 export const DEMOTE_SELF_ACTION: "demote_self";
 export const KICK_ACTION: "kick";
 export const PLAYER_LIST_ACTION: "player_list";
+export const SAVE_SHIP_ACTION: "save_team";
 export const INVITE_RESET_ACTION: "invite_reset";
 export const SET_PRIVACY_ACTION: "set_privacy";
 export const SET_RANK_ACTION: "set_rank";
 export const SHIP_MANAGEMENT_TYPE: 4;
 export const STARTER_RECOVERY_ACTION: "starter_recovery";
+
+export const RENAME_REQUEST_ACTION: "rename_request";
+export const RENAME_COMMIT_ACTION: "rename_commit";

package/src/protocol/outbound/ship-management.js

@@ -1,12 +1,36 @@
+import {flattenRichText} from "./comms.js";
+
 const SHIP_MANAGEMENT_TYPE = 4;
+const CREW_LOG_LENGTH = 500;
 const SET_PRIVACY_ACTION = "set_privacy";
+const GRAVITY_ACTION = "gravity";
+const SET_PATRON_PERKS_ACTION = "set_patron_perks";
 const STARTER_RECOVERY_ACTION = "starter_recovery";
 const PLAYER_LIST_ACTION = "player_list";
 const INVITE_RESET_ACTION = "invite_reset";
 const SET_RANK_ACTION = "set_rank";
 const KICK_ACTION = "kick";
 const BAN_ACTION = "ban";
+const UNBAN_ACTION = "unban";
 const DEMOTE_SELF_ACTION = "demote_self";
+const SAVE_SHIP_ACTION = "save_team";
+const RENAME_REQUEST_ACTION = "rename_request";
+const RENAME_COMMIT_ACTION = "rename_commit";
+
+export const GravityDirection = Object.freeze({
+    Down: "down",
+    Up: "up",
+    Left: "left",
+    Right: "right"
+});
+
+export function normalizeGravityDirection(value) {
+    if (value === GravityDirection.Down || value === 0) return 0;
+    if (value === GravityDirection.Up || value === 1) return 1;
+    if (value === GravityDirection.Left || value === 2) return 2;
+    if (value === GravityDirection.Right || value === 3) return 3;
+    throw new RangeError('direction must be "down", "up", "left", "right", or an integer from 0 to 3');
+}
 
 function requireNonNegativeInteger(value, name) {
     const number = Number(value);
@@ -42,6 +66,15 @@ export function buildShipPrivacyMessage(privacy) {
     return buildShipManagementMessage(SET_PRIVACY_ACTION, normalizePrivacy(privacy));
 }
 
+export function buildShipGravityMessage(direction) {
+    return buildShipManagementMessage(GRAVITY_ACTION, normalizeGravityDirection(direction));
+}
+
+export function buildSetPatronPerksMessage(enabled) {
+    if (typeof enabled !== "boolean") throw new TypeError("enabled must be a boolean");
+    return buildShipManagementMessage(SET_PATRON_PERKS_ACTION, enabled);
+}
+
 export function buildStarterRecoveryMessage(itemId) {
     return buildShipManagementMessage(STARTER_RECOVERY_ACTION, requireNonNegativeInteger(itemId, "itemId"));
 }
@@ -66,10 +99,31 @@ export function buildBanPlayerMessage(refId) {
     return buildShipManagementMessage(BAN_ACTION, normalizePlayerRef(refId));
 }
 
+export function buildUnbanPlayerMessage(refId) {
+    return buildShipManagementMessage(UNBAN_ACTION, normalizePlayerRef(refId));
+}
+
 export function buildDemoteSelfMessage() {
     return buildShipManagementMessage(DEMOTE_SELF_ACTION);
 }
 
+export function buildSaveShipMessage() {
+    return buildShipManagementMessage(SAVE_SHIP_ACTION);
+}
+
+export function buildShipRenameRequestMessage() {
+    return buildShipManagementMessage(RENAME_REQUEST_ACTION);
+}
+
+export function buildShipRenameCommitMessage(name, color) {
+    if (typeof name !== "string") throw new TypeError("name must be a string");
+    if (name.length > 32) throw new RangeError("name must be at most 32 UTF-16 code units");
+    if (typeof color !== "string" || !/^#[0-9a-f]{6}$/i.test(color)) {
+        throw new TypeError("color must be a #RRGGBB hex string");
+    }
+    return buildShipManagementMessage(RENAME_COMMIT_ACTION, name, {arg2: color});
+}
+
 export function normalizeShipConfig(event = {}) {
     const source = event && typeof event === "object" ? event : {};
     const config = source.config && typeof source.config === "object" ? source.config : {};
@@ -90,6 +144,28 @@ export function normalizeCaptainSubrank(event = {}) {
     };
 }
 
+export function normalizeCrewLog(event = {}, previous = null) {
+    const source = event && typeof event === "object" ? event : {};
+    const reset = Boolean(source.reset);
+    const amend = Boolean(source.amend);
+    const entries = reset ? [] : (previous?.entries || []).slice();
+    if (amend) entries.pop();
+    const changes = Array.isArray(source.entries) ? source.entries.map((entry) => {
+        const value = entry && typeof entry === "object" ? entry : {};
+        return {
+            icon: value.icon ?? null,
+            text: flattenRichText(value.text),
+            rawText: value.text ?? null,
+            count: value.count ?? 1,
+            refId: value.ref ?? null,
+            secondaryRefId: value.ref2 ?? null
+        };
+    }) : [];
+    for (const entry of changes) entries.push(entry);
+    if (entries.length > CREW_LOG_LENGTH) entries.splice(0, entries.length - CREW_LOG_LENGTH);
+    return {entries, changes, reset, amend};
+}
+
 export 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) : [];
@@ -208,10 +284,17 @@ function playerCanBeManagedBy(player, currentRank) {
 
 export {
     BAN_ACTION,
+    CREW_LOG_LENGTH,
+    GRAVITY_ACTION,
+    SET_PATRON_PERKS_ACTION,
+    UNBAN_ACTION,
     DEMOTE_SELF_ACTION,
     INVITE_RESET_ACTION,
     KICK_ACTION,
     PLAYER_LIST_ACTION,
+    RENAME_REQUEST_ACTION,
+    RENAME_COMMIT_ACTION,
+    SAVE_SHIP_ACTION,
     SET_PRIVACY_ACTION,
     SET_RANK_ACTION,
     SHIP_MANAGEMENT_TYPE,