@stoatx/client 0.8.0 → 0.9.0

package/dist/index.cjs

@@ -71,7 +71,8 @@ __export(index_exports, {
   User: () => User,
   UserManager: () => UserManager,
   VoiceConnection: () => VoiceConnection,
-  VoiceManager: () => VoiceManager
+  VoiceManager: () => VoiceManager,
+  decodeTime: () => import_ulid8.decodeTime
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -526,7 +527,7 @@ var MessageMentions = class _MessageMentions {
   static parseChannelIds(content) {
     return [...content.matchAll(/<#([A-Z0-9]+)>/g)].flatMap((m) => m[1] ? [m[1]] : []);
   }
-  [import_node_util.default.inspect.custom](depth, options, inspect12) {
+  [import_node_util.default.inspect.custom](depth, options, inspect13) {
     const { client, message, ...props } = this;
     const data = {
       ...props,
@@ -535,7 +536,7 @@ var MessageMentions = class _MessageMentions {
       users: this.users,
       roles: this.roles
     };
-    return `${this.constructor.name} ${inspect12(data, { ...options, depth: depth ?? options.depth })}`;
+    return `${this.constructor.name} ${inspect13(data, { ...options, depth: depth ?? options.depth })}`;
   }
 };
 
@@ -547,7 +548,8 @@ var Message = class extends Base {
   embeds = [];
   attachments = [];
   editedAt = null;
-  createdAt = null;
+  createdAt;
+  createdTimestamp;
   flags = 0;
   interactions = null;
   masquerade = null;
@@ -559,10 +561,9 @@ var Message = class extends Base {
     super(client, data);
     this.authorId = data.author;
     this.channelId = data.channel;
-    const timestamp = (0, import_ulid.decodeTime)(this.id);
-    if (timestamp) {
-      this.createdAt = new Date(timestamp);
-    }
+    const timestamp = (0, import_ulid.decodeTime)(data._id);
+    this.createdAt = new Date(timestamp);
+    this.createdTimestamp = timestamp;
     if (data.attachments) {
       this.attachments = data.attachments.map((fileData) => new Attachment(this.client, fileData));
     }
@@ -743,7 +744,7 @@ var Message = class extends Base {
     }
   }
   // This tells Node.js exactly how to print this object in console.log()
-  [util3.inspect.custom](depth, options, inspect12) {
+  [util3.inspect.custom](depth, options, inspect13) {
     const { client, authorId, channelId, ...props } = this;
     const data = {
       ...props,
@@ -752,11 +753,12 @@ var Message = class extends Base {
       server: this.server,
       member: this.member
     };
-    return `${this.constructor.name} ${inspect12(data, { ...options, depth: depth ?? options.depth })}`;
+    return `${this.constructor.name} ${inspect13(data, { ...options, depth: depth ?? options.depth })}`;
   }
 };
 
 // src/structures/User.ts
+var import_ulid2 = require("ulid");
 var User = class extends Base {
   discriminator;
   online;
@@ -769,11 +771,17 @@ var User = class extends Base {
   flags;
   privileged;
   status;
+  createdAt;
+  createdTimestamp;
+  pronouns = null;
   constructor(client, data) {
     super(client, data);
     this.bot = false;
     this.privileged = false;
     this.flags = 0;
+    const timestamp = (0, import_ulid2.decodeTime)(data._id);
+    this.createdAt = new Date(timestamp);
+    this.createdTimestamp = timestamp;
     this._patch(data);
   }
   _patch(data, clear) {
@@ -781,6 +789,7 @@ var User = class extends Base {
     if (data.discriminator !== void 0) this.discriminator = data.discriminator;
     if (data.online !== void 0) this.online = data.online;
     if (data.relationship !== void 0) this.relationship = data.relationship;
+    if (data.pronouns !== void 0) this.pronouns = data.pronouns;
     if (data.display_name !== void 0) this.displayName = data.display_name;
     if (data.badges !== void 0) this.badges = data.badges;
     if (data.flags !== void 0) this.flags = data.flags;
@@ -794,9 +803,23 @@ var User = class extends Base {
     }
     if (clear && Array.isArray(clear)) {
       for (const field of clear) {
-        if (field === "Avatar") this.avatar = null;
-        if (field === "StatusText" && this.status) this.status.text = null;
-        if (field === "DisplayName") this.displayName = null;
+        switch (field) {
+          case "Avatar":
+            this.avatar = null;
+            break;
+          case "DisplayName":
+            this.displayName = null;
+            break;
+          case "Pronouns":
+            this.pronouns = null;
+            break;
+          case "StatusText":
+            this.status.text = null;
+            break;
+          case "StatusPresence":
+            this.status.presence = null;
+            break;
+        }
       }
     }
   }
@@ -912,11 +935,10 @@ var GatewayManager = class {
         }
         if (payload.emojis) {
           for (const rawEmoji of payload.emojis) {
-            const emoji = this.client.emojis._add(rawEmoji);
             if (rawEmoji.parent && rawEmoji.parent.type === "Server") {
               const server = this.client.servers.cache.get(rawEmoji.parent.id);
               if (server) {
-                server.emojis._add(emoji);
+                server.emojis._add(rawEmoji);
               }
             }
           }
@@ -1094,7 +1116,7 @@ var GatewayManager = class {
       case "ServerMemberJoin": {
         const server = this.client.servers.cache.get(payload.id);
         if (server) {
-          const member = server.members._add({ user: payload.user });
+          const member = server.members._add(payload.member);
           this.client.emit("serverMemberJoin", member);
         }
         break;
@@ -1112,7 +1134,7 @@ var GatewayManager = class {
         if (payload.reason === "Ban") {
           if (server) {
             const dummyBanPayload = {
-              id: payload.user,
+              _id: payload.user,
               reason: null
             };
             server.bans._add(dummyBanPayload);
@@ -1126,11 +1148,10 @@ var GatewayManager = class {
         break;
       }
       case "EmojiCreate": {
-        const emoji = this.client.emojis._add(payload);
         if (payload.parent?.type === "Server") {
           const server = this.client.servers.cache.get(payload.parent.id);
           if (server) {
-            server.emojis._add(emoji);
+            server.emojis._add(payload);
           }
         }
         break;
@@ -1530,7 +1551,7 @@ var BaseManager = class {
   _add(data) {
     const id = this.extractId(data);
     const existing = this.cache.get(id);
-    if (existing && typeof existing._patch === "function") {
+    if (existing && this.isPatchable(existing)) {
       existing._patch(data);
       return existing;
     }
@@ -1538,6 +1559,9 @@ var BaseManager = class {
     this.cache.set(id, structure);
     return structure;
   }
+  isPatchable(value) {
+    return typeof value._patch === "function";
+  }
 };
 
 // src/builders/AttachmentBuilder.ts
@@ -1981,6 +2005,7 @@ var BaseChannel = class extends Base {
 };
 
 // src/structures/TextChannel.ts
+var import_ulid3 = require("ulid");
 var TextChannel = class extends BaseChannel {
   name;
   serverId;
@@ -1991,9 +2016,14 @@ var TextChannel = class extends BaseChannel {
   nsfw;
   slowmode;
   voice;
+  createdAt;
+  createdTimestamp;
   constructor(client, data) {
     super(client, data);
     this.serverId = data.server;
+    const timestamp = (0, import_ulid3.decodeTime)(data._id);
+    this.createdTimestamp = timestamp;
+    this.createdAt = new Date(timestamp);
     this.defaultPermissions = data.default_permissions;
     this.description = data.description;
     if (data.icon !== void 0) {
@@ -2018,10 +2048,10 @@ var TextChannel = class extends BaseChannel {
             this.icon = null;
             break;
           case "DefaultPermissions":
-            this.defaultPermissions = data.default_permissions;
+            this.defaultPermissions = null;
             break;
           case "Voice":
-            this.voice = data.voice;
+            this.voice = null;
             break;
         }
       }
@@ -2216,6 +2246,7 @@ var DMChannel = class extends BaseChannel {
 
 // src/structures/GroupChannel.ts
 var util5 = __toESM(require("util"), 1);
+var import_ulid4 = require("ulid");
 var GroupChannel = class extends BaseChannel {
   name;
   ownerId;
@@ -2224,8 +2255,13 @@ var GroupChannel = class extends BaseChannel {
   icon = null;
   lastMessageId = null;
   nsfw = false;
+  createdAt;
+  createdTimestamp;
   constructor(client, data) {
     super(client, data);
+    const timestamp = (0, import_ulid4.decodeTime)(data._id);
+    this.createdAt = new Date(timestamp);
+    this.createdTimestamp = timestamp;
     this._patch(data);
   }
   _patch(data, clear) {
@@ -2241,9 +2277,6 @@ var GroupChannel = class extends BaseChannel {
     if (clear && Array.isArray(clear)) {
       for (const field of clear) {
         switch (field) {
-          case "Name":
-            this.name = "";
-            break;
           case "Description":
             this.description = null;
             break;
@@ -2275,9 +2308,9 @@ var GroupChannel = class extends BaseChannel {
   async setDefaultPermissions(permissions) {
     return await this.client.channels.setDefaultPermissions(this.id, permissions);
   }
-  [util5.inspect.custom](_depth, options, inspect12) {
+  [util5.inspect.custom](_depth, options, inspect13) {
     const { client, ...props } = this;
-    return `${this.constructor.name} ${inspect12(
+    return `${this.constructor.name} ${inspect13(
       {
         ...props,
         owner: this.owner,
@@ -2924,6 +2957,8 @@ var Member = class extends Base {
   _roles = [];
   // The date the member joined the server
   joinedAt;
+  // The timestamp the member joined the server
+  joinedTimestamp;
   // The date the member's timeout expires, or null if not timed out
   timeout = null;
   // Whatever the user can talk in Voice Chat
@@ -2932,20 +2967,53 @@ var Member = class extends Base {
   canRecieve = false;
   // Member roles manager
   roles;
+  // Member pronouns
+  pronouns = null;
   constructor(client, data, serverId) {
     super(client, { _id: data._id?.user });
     this.serverId = data._id?.server ?? serverId;
-    this.joinedAt = new Date(data.joined_at);
+    const timestamp = new Date(data.joined_at);
+    this.joinedAt = timestamp;
+    this.joinedTimestamp = timestamp.getTime();
     this.roles = new MemberRoleManager(this);
     this._patch(data);
   }
-  _patch(data) {
+  _patch(data, clear) {
     if (data.nickname !== void 0) this.nickname = data.nickname;
     if (data.avatar !== void 0) this.avatar = data.avatar ? new Attachment(this.client, data.avatar) : null;
     if (data.roles !== void 0) this._roles = data.roles;
     if (data.timeout !== void 0) this.timeout = data.timeout ? new Date(data.timeout) : null;
     if (data.can_publish !== void 0) this.canPublish = data.can_publish;
     if (data.can_receive !== void 0) this.canRecieve = data.can_receive;
+    if (data.pronouns !== void 0) this.pronouns = data.pronouns;
+    if (clear && Array.isArray(clear)) {
+      for (const field of clear) {
+        switch (field) {
+          case "Avatar":
+            this.avatar = null;
+            break;
+          case "Nickname":
+            this.nickname = null;
+            break;
+          case "Pronouns":
+            this.pronouns = null;
+            break;
+          case "CanPublish":
+            this.canPublish = false;
+            break;
+          case "Timeout":
+            this.timeout = null;
+            break;
+          case "Roles":
+            this._roles = [];
+            this.roles = new MemberRoleManager(this);
+            break;
+          case "CanReceive":
+            this.canRecieve = false;
+            break;
+        }
+      }
+    }
   }
   /**
    * Get member role IDs
@@ -3065,9 +3133,9 @@ var Member = class extends Base {
     await server.members.kick(this.id);
   }
   /** @internal */
-  [util6.inspect.custom](depth, options, inspect12) {
+  [util6.inspect.custom](depth, options, inspect13) {
     const { client, serverId, ...props } = this;
-    return `${this.constructor.name} ${inspect12(
+    return `${this.constructor.name} ${inspect13(
       {
         ...props,
         user: this.user,
@@ -3298,6 +3366,7 @@ var ServerChannelManager = class {
 
 // src/structures/Role.ts
 var util9 = __toESM(require("util"), 1);
+var import_ulid5 = require("ulid");
 var Role = class extends Base {
   serverId;
   name;
@@ -3306,16 +3375,21 @@ var Role = class extends Base {
   rank = 0;
   icon = null;
   _permissions = 0n;
+  createdAt;
+  createdTimestamp;
   constructor(client, data, serverId) {
     super(client, data);
     this.serverId = serverId;
+    const timestamp = (0, import_ulid5.decodeTime)(data._id);
+    this.createdAt = new Date(timestamp);
+    this.createdTimestamp = timestamp;
     this._patch(data);
   }
   /**
    * Updates the role instance with new data without losing the object reference.
    * @internal
    */
-  _patch(data) {
+  _patch(data, clear) {
     if (data.name !== void 0) this.name = data.name;
     if (data.colour !== void 0) this.color = data.colour;
     if (data.hoist !== void 0) this.hoist = data.hoist;
@@ -3333,6 +3407,18 @@ var Role = class extends Base {
         this._permissions = 0n;
       }
     }
+    if (clear && Array.isArray(clear)) {
+      for (const field of clear) {
+        switch (field) {
+          case "Colour":
+            this.color = null;
+            break;
+          case "Icon":
+            this.icon = null;
+            break;
+        }
+      }
+    }
   }
   /**
    * The server this role belongs to.
@@ -3828,7 +3914,7 @@ var ServerBanManager = class extends BaseManager {
     this.server = server;
   }
   extractId(data) {
-    return data._id?.user ?? data.id;
+    return data._id?.user;
   }
   construct(data) {
     return new ServerBan(data);
@@ -3840,11 +3926,6 @@ var ServerBanManager = class extends BaseManager {
    */
   async fetch() {
     const data = await this.client.rest.get(`/servers/${this.server.id}/bans`);
-    if (data.users && Array.isArray(data.users)) {
-      for (const userData of data.users) {
-        this.client.users._add(userData);
-      }
-    }
     const rawBans = data.bans || (Array.isArray(data) ? data : []);
     const fetched = new Collection();
     for (const rawBan of rawBans) {
@@ -3865,14 +3946,20 @@ var ServerBanManager = class extends BaseManager {
 };
 
 // src/structures/Emoji.ts
+var import_ulid6 = require("ulid");
 var Emoji = class extends Base {
   creatorId;
   name;
   parent;
+  createdAt;
+  createdTimestamp;
   animated = false;
   nsfw = false;
   constructor(client, data) {
     super(client, data);
+    const timestamp = (0, import_ulid6.decodeTime)(data._id);
+    this.createdAt = new Date(timestamp);
+    this.createdTimestamp = timestamp;
     this._patch(data);
   }
   _patch(data) {
@@ -4050,6 +4137,114 @@ var EmojiManager = class extends BaseManager {
   }
 };
 
+// src/structures/Server.ts
+var import_ulid7 = require("ulid");
+
+// src/structures/AuditLogEntry.ts
+var util12 = __toESM(require("util"), 1);
+function resolveTargetId(data) {
+  if (data.target) return data.target;
+  const action = data.action;
+  switch (action.type) {
+    case "ChannelCreate":
+    case "ChannelEdit":
+    case "ChannelDelete":
+    case "ChannelRolePermissionsEdit":
+      return action.channel;
+    case "RoleCreate":
+    case "RoleEdit":
+    case "RoleDelete":
+      return action.role;
+    case "InviteCreate":
+    case "InviteDelete":
+      return action.invite;
+    case "WebhookCreate":
+    case "WebhookDelete":
+      return action.webhook;
+    case "EmojiCreate":
+    case "EmojiUpdate":
+    case "EmojiDelete":
+      return action.emoji;
+    case "MessageDelete":
+      return action.channel;
+    case "MessagePin":
+    case "MessageUnpin":
+      return action.message;
+    case "MessageBulkDelete":
+      return action.channel;
+    default:
+      return null;
+  }
+}
+var AuditLogEntry = class extends Base {
+  serverId;
+  userId;
+  targetId;
+  reason;
+  action;
+  constructor(client, data) {
+    super(client, data);
+    this.serverId = data.server;
+    this.userId = data.user;
+    this.targetId = resolveTargetId(data);
+    this.reason = data.reason ?? null;
+    this.action = data.action;
+  }
+  /** The action tag, e.g. "ChannelEdit" — narrow `entry.action` on this. */
+  get type() {
+    return this.action.type;
+  }
+  get server() {
+    return this.client.servers.cache.get(this.serverId);
+  }
+  /** The user who performed this action, if cached. */
+  get executor() {
+    return this.client.users.cache.get(this.userId);
+  }
+  /**
+   * Best-effort resolve of `targetId` into the actual entity, picked by
+   * `action.type` since a bare id alone doesn't say whether it's a member,
+   * a role, a channel, etc.
+   */
+  get target() {
+    if (!this.targetId) return void 0;
+    const server = this.server;
+    switch (this.action.type) {
+      case "MemberEdit":
+      case "MemberKick":
+        return server?.members.cache.get(this.targetId);
+      case "BanCreate":
+      case "BanDelete":
+        return this.client.users.cache.get(this.targetId);
+      case "ChannelCreate":
+      case "ChannelEdit":
+      case "ChannelDelete":
+      case "ChannelRolePermissionsEdit":
+        return server?.channels.cache.get(this.targetId);
+      case "RoleCreate":
+      case "RoleEdit":
+      case "RoleDelete":
+        return server?.roles.cache.get(this.targetId);
+      default:
+        return this.targetId;
+    }
+  }
+  /**
+   * Customizer for Node.js `console.log` and `util.inspect`.
+   * Hides the cyclic client reference for a cleaner output.
+   * @internal
+   */
+  [util12.inspect.custom]() {
+    const { client, ...props } = this;
+    return `${this.constructor.name} ${util12.inspect({
+      ...props,
+      type: this.type,
+      executor: this.executor,
+      target: this.target
+    })}`;
+  }
+};
+
 // src/structures/Server.ts
 var Server = class extends Base {
   channelIds = [];
@@ -4070,6 +4265,8 @@ var Server = class extends Base {
   bans;
   invites;
   emojis;
+  createdAt;
+  createdTimestamp;
   constructor(client, data) {
     super(client, data);
     this.channels = new ServerChannelManager(client, this);
@@ -4078,6 +4275,9 @@ var Server = class extends Base {
     this.bans = new ServerBanManager(this.client, this);
     this.invites = new ServerInviteManager(this.client, this);
     this.emojis = new EmojiManager(this.client, this);
+    const timestamp = (0, import_ulid7.decodeTime)(data._id);
+    this.createdAt = new Date(timestamp);
+    this.createdTimestamp = timestamp;
     this._patch(data);
   }
   /**
@@ -4120,6 +4320,12 @@ var Server = class extends Base {
           case "Icon":
             this.icon = null;
             break;
+          case "Banner":
+            this.banner = null;
+            break;
+          case "Categories":
+            this.categories = null;
+            break;
         }
       }
     }
@@ -4138,6 +4344,27 @@ var Server = class extends Base {
   async leave() {
     return this.client.rest.delete(`/servers/${this.id}/leave`);
   }
+  /**
+   * Fetch audit logs for this server
+   * @param options Query params
+   */
+  async fetchAuditLogs(options) {
+    const query = {};
+    if (options?.user) query.user = options.user;
+    if (options?.target) query.target = options.target;
+    if (options?.type) query.type = options.type;
+    if (options?.before) query.before = options.before;
+    if (options?.after) query.after = options.after;
+    if (options?.limit) query.limit = options.limit;
+    const data = await this.client.rest.get(`/servers/${this.id}/audit_logs`, query);
+    for (const user of data.users) this.client.users._add(user);
+    for (const member of data.members) this.members._add(member);
+    const entries = new Collection();
+    for (const raw of data.audit_logs) {
+      entries.set(raw._id, new AuditLogEntry(this.client, raw));
+    }
+    return entries;
+  }
   /**
    * Fetches multiple members from this server.
    * @param options Filter options for the fetch request.
@@ -4149,7 +4376,7 @@ var Server = class extends Base {
 };
 
 // src/managers/ServerManager.ts
-var util12 = __toESM(require("util"), 1);
+var util13 = __toESM(require("util"), 1);
 var ServerManager = class extends BaseManager {
   constructor(client, limit = Infinity) {
     super(client, limit);
@@ -4220,7 +4447,7 @@ var ServerManager = class extends BaseManager {
     const data = await this.client.rest.patch(`/servers/${serverId}`, payload);
     return this._add(data);
   }
-  [util12.inspect.custom]() {
+  [util13.inspect.custom]() {
     return this.cache;
   }
 };
@@ -4790,6 +5017,7 @@ var EmbedBuilder = class {
 };
 
 // src/index.ts
+var import_ulid8 = require("ulid");
 var API = __toESM(require("stoat-api"), 1);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -4834,6 +5062,7 @@ var API = __toESM(require("stoat-api"), 1);
   User,
   UserManager,
   VoiceConnection,
-  VoiceManager
+  VoiceManager,
+  decodeTime
 });
 //# sourceMappingURL=index.cjs.map