@erinjs/core 1.0.0 → 1.2.4

package/core/packages/fluxer-core/src/structures/GuildBan.ts

@@ -1,35 +0,0 @@
-import { Client } from '../client/Client.js';
-import { Base } from './Base.js';
-import { APIBan } from '@erinjs/types';
-import { Routes } from '@erinjs/types';
-import { User } from './User.js';
-
-/** Represents a ban in a guild. */
-export class GuildBan extends Base {
-  readonly client: Client;
-  readonly guildId: string;
-  readonly user: User;
-  readonly reason: string | null;
-  /** ISO timestamp when a temporary ban expires. Null for permanent bans. */
-  readonly expiresAt: string | null;
-
-  /** @param data - API ban from GET /guilds/{id}/bans or gateway GUILD_BAN_ADD */
-  constructor(client: Client, data: APIBan & { guild_id?: string }, guildId: string) {
-    super();
-    this.client = client;
-    this.guildId = data.guild_id ?? guildId;
-    this.user = client.getOrCreateUser(data.user);
-    this.reason = data.reason ?? null;
-    this.expiresAt = data.expires_at ?? null;
-  }
-
-  /**
-   * Remove this ban (unban the user).
-   * Requires Ban Members permission.
-   */
-  async unban(): Promise<void> {
-    await this.client.rest.delete(Routes.guildBan(this.guildId, this.user.id), {
-      auth: true,
-    });
-  }
-}

package/core/packages/fluxer-core/src/structures/GuildEmoji.ts

@@ -1,57 +0,0 @@
-import { Client } from '../client/Client.js';
-import { Base } from './Base.js';
-import { APIEmoji } from '@erinjs/types';
-import { Routes } from '@erinjs/types';
-import { CDN_URL } from '../util/Constants.js';
-
-/** Represents a custom emoji in a guild. */
-export class GuildEmoji extends Base {
-  readonly client: Client;
-  readonly id: string;
-  readonly guildId: string;
-  name: string;
-  readonly animated: boolean;
-
-  /** @param data - API emoji from GET /guilds/{id}/emojis or guild emoji events */
-  constructor(client: Client, data: APIEmoji & { guild_id?: string }, guildId: string) {
-    super();
-    this.client = client;
-    this.id = data.id;
-    this.guildId = data.guild_id ?? guildId;
-    this.name = data.name;
-    this.animated = data.animated ?? false;
-  }
-
-  /** CDN URL for this emoji image. */
-  get url(): string {
-    const ext = this.animated ? 'gif' : 'png';
-    return `${CDN_URL}/emojis/${this.id}.${ext}`;
-  }
-
-  /** Emoji identifier for use in reactions: `name:id` */
-  get identifier(): string {
-    return `${this.name}:${this.id}`;
-  }
-
-  /** Delete this emoji. Requires Manage Emojis and Stickers permission. */
-  async delete(): Promise<void> {
-    await this.client.rest.delete(Routes.guildEmoji(this.guildId, this.id), {
-      auth: true,
-    });
-    const guild = this.client.guilds.get(this.guildId);
-    if (guild) guild.emojis.delete(this.id);
-  }
-
-  /**
-   * Edit this emoji's name.
-   * Requires Manage Emojis and Stickers permission.
-   */
-  async edit(options: { name: string }): Promise<GuildEmoji> {
-    const data = await this.client.rest.patch(Routes.guildEmoji(this.guildId, this.id), {
-      body: options,
-      auth: true,
-    });
-    this.name = (data as APIEmoji).name;
-    return this;
-  }
-}

package/core/packages/fluxer-core/src/structures/GuildMember.test.ts

@@ -1,203 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { Guild, Client, User, GuildMember } from '../';
-
-function createMockClient() {
-  const client = {
-    getOrCreateUser: (data: {
-      id: string;
-      username: string;
-      discriminator: string;
-      global_name?: string | null;
-    }) => new User(client as Client, data),
-  };
-  return client as Client;
-}
-
-function createMockGuild(client: ReturnType<typeof createMockClient>) {
-  return new Guild(client as never, {
-    id: 'guild123',
-    name: 'Test Guild',
-    icon: null,
-    banner: null,
-    owner_id: 'owner1',
-    features: [],
-    afk_timeout: 0,
-    nsfw_level: 0,
-    verification_level: 0,
-    mfa_level: 0,
-    explicit_content_filter: 0,
-    default_message_notifications: 0,
-  });
-}
-
-function createMember(
-  overrides: {
-    nick?: string | null;
-    user?: { username?: string; global_name?: string | null };
-  } = {},
-) {
-  const client = createMockClient();
-  const guild = createMockGuild(client);
-  return new GuildMember(
-    client as never,
-    {
-      user: {
-        id: 'user1',
-        username: overrides.user?.username ?? 'TestUser',
-        discriminator: '0',
-        global_name: overrides.user?.global_name ?? null,
-      },
-      nick: overrides.nick ?? null,
-      roles: [],
-      joined_at: new Date().toISOString(),
-    },
-    guild,
-  );
-}
-
-describe('GuildMember', () => {
-  describe('displayName', () => {
-    it('returns nickname when set', () => {
-      const member = createMember({ nick: 'ServerNick' });
-      expect(member.displayName).toBe('ServerNick');
-    });
-
-    it('returns global name when no nick', () => {
-      const member = createMember({
-        nick: null,
-        user: { username: 'alice', global_name: 'Alice Display' },
-      });
-      expect(member.displayName).toBe('Alice Display');
-    });
-
-    it('returns username when no nick or global name', () => {
-      const member = createMember({
-        nick: null,
-        user: { username: 'bob', global_name: null },
-      });
-      expect(member.displayName).toBe('bob');
-    });
-  });
-
-  describe('avatarURL()', () => {
-    it('returns null when member has no guild avatar', () => {
-      const member = createMember();
-      expect(member.avatar).toBeNull();
-      expect(member.avatarURL()).toBeNull();
-    });
-
-    it('builds member avatar URL when avatar is set', () => {
-      const client = createMockClient();
-      const guild = createMockGuild(client);
-      const member = new GuildMember(
-        client as never,
-        {
-          user: { id: 'u1', username: 'Test', discriminator: '0' },
-          nick: null,
-          avatar: 'memberavatar',
-          roles: [],
-          joined_at: new Date().toISOString(),
-        },
-        guild,
-      );
-      const url = member.avatarURL();
-      expect(url).toContain('guilds/guild123/users/u1/avatars/memberavatar');
-    });
-  });
-
-  describe('displayAvatarURL()', () => {
-    it('falls back to user avatar when no guild avatar', () => {
-      const client = createMockClient();
-      const guild = createMockGuild(client);
-      const member = new GuildMember(
-        client as never,
-        {
-          user: {
-            id: 'u1',
-            username: 'Test',
-            discriminator: '0',
-            avatar: 'useravatar',
-          },
-          nick: null,
-          avatar: null,
-          roles: [],
-          joined_at: new Date().toISOString(),
-        },
-        guild,
-      );
-      const url = member.displayAvatarURL();
-      expect(url).toContain('avatars/u1/useravatar');
-    });
-  });
-
-  describe('move()', () => {
-    it('calls edit with channel_id to move member', async () => {
-      const member = createMember();
-      let editCalled: boolean = false;
-      let editParams: { channel_id: string | null; connection_id?: string | null } | undefined;
-
-      member.edit = async (params: {
-        channel_id: string | null;
-        connection_id?: string | null;
-      }) => {
-        editCalled = true;
-        editParams = params;
-        return member;
-      };
-
-      await member.move('voicechannel123');
-
-      expect(editCalled).toBe(true);
-      expect(editParams).toEqual({
-        channel_id: 'voicechannel123',
-        connection_id: undefined,
-      });
-    });
-
-    it('calls edit with null to disconnect member', async () => {
-      const member = createMember();
-      let editCalled: boolean = false;
-      let editParams: { channel_id: string | null; connection_id?: string | null } | undefined;
-
-      member.edit = async (params: {
-        channel_id: string | null;
-        connection_id?: string | null;
-      }) => {
-        editCalled = true;
-        editParams = params;
-        return member;
-      };
-
-      await member.move(null);
-
-      expect(editCalled).toBe(true);
-      expect(editParams).toEqual({
-        channel_id: null,
-        connection_id: undefined,
-      });
-    });
-
-    it('calls edit with connection_id when provided', async () => {
-      const member = createMember();
-      let editCalled: boolean = false;
-      let editParams: { channel_id: string | null; connection_id?: string | null } | undefined;
-
-      member.edit = async (params: {
-        channel_id: string | null;
-        connection_id?: string | null;
-      }) => {
-        editCalled = true;
-        editParams = params;
-        return member;
-      };
-
-      await member.move('voicechannel123', 'connection456');
-
-      expect(editCalled).toBe(true);
-      expect(editParams).toEqual({
-        channel_id: 'voicechannel123',
-        connection_id: 'connection456',
-      });
-    });
-  });
-});

package/core/packages/fluxer-core/src/structures/GuildMember.ts

@@ -1,213 +0,0 @@
-import { Client } from '../client/Client.js';
-import { Base } from './Base.js';
-import { User } from './User.js';
-import { Guild } from './Guild.js';
-import { GuildChannel } from './Channel.js';
-import { APIGuildMember } from '@erinjs/types';
-import { BitField, PermissionFlags } from '@erinjs/util';
-import { Routes } from '@erinjs/types';
-import { cdnMemberAvatarURL, cdnMemberBannerURL } from '../util/cdn.js';
-import { computePermissions } from '../util/permissions.js';
-import { GuildMemberRoleManager } from './GuildMemberRoleManager.js';
-
-/** Represents a member of a guild. */
-export class GuildMember extends Base {
-  readonly client: Client;
-  readonly id: string;
-  readonly user: User;
-  readonly guild: Guild;
-  nick: string | null;
-  /**
-   * Role manager with add/remove/set and cache. Discord.js parity: member.roles.add(), member.roles.cache
-   * @discordJsCompat https://discord.js.org/docs/packages/discord.js/main/GuildMemberRoleManager
-   */
-  readonly roles: GuildMemberRoleManager;
-  readonly joinedAt: Date;
-  communicationDisabledUntil: Date | null;
-  readonly mute: boolean;
-  readonly deaf: boolean;
-  readonly avatar: string | null;
-  readonly banner: string | null;
-  readonly accentColor: number | null;
-  readonly profileFlags: number | null;
-
-  /** @param data - API guild member from GET /guilds/{id}/members or GET /guilds/{id}/members/{user_id} */
-  constructor(client: Client, data: APIGuildMember & { guild_id?: string }, guild: Guild) {
-    super();
-    this.client = client;
-    this.user = client.getOrCreateUser(data.user);
-    this.id = data.user.id;
-    this.guild = guild;
-    this.nick = data.nick ?? null;
-    this.roles = new GuildMemberRoleManager(this, data.roles ?? []);
-    this.joinedAt = new Date(data.joined_at);
-    this.communicationDisabledUntil = data.communication_disabled_until
-      ? new Date(data.communication_disabled_until)
-      : null;
-    this.mute = data.mute ?? false;
-    this.deaf = data.deaf ?? false;
-    this.avatar = data.avatar ?? null;
-    this.banner = data.banner ?? null;
-    this.accentColor = data.accent_color ?? null;
-    this.profileFlags = data.profile_flags ?? null;
-  }
-
-  /** Nickname, or global name, or username. */
-  get displayName(): string {
-    return this.nick ?? this.user.globalName ?? this.user.username;
-  }
-
-  /**
-   * Get the guild-specific avatar URL for this member.
-   * Returns null if the member has no guild avatar (use displayAvatarURL for fallback).
-   */
-  avatarURL(options?: { size?: number; extension?: string }): string | null {
-    return cdnMemberAvatarURL(this.guild.id, this.id, this.avatar, options);
-  }
-
-  /**
-   * Get the avatar URL to display for this member.
-   * Uses guild-specific avatar if set, otherwise falls back to the user's avatar.
-   */
-  displayAvatarURL(options?: { size?: number; extension?: string }): string {
-    return this.avatarURL(options) ?? this.user.displayAvatarURL(options);
-  }
-
-  /**
-   * Get the guild-specific banner URL for this member.
-   * Returns null if the member has no guild banner.
-   */
-  bannerURL(options?: { size?: number; extension?: string }): string | null {
-    return cdnMemberBannerURL(this.guild.id, this.id, this.banner, options);
-  }
-
-  /**
-   * Add a role to this member.
-   * Prefer member.roles.add(roleId) for Discord.js parity.
-   * @param roleId - The role ID to add
-   * Requires Manage Roles permission.
-   */
-  async addRole(roleId: string): Promise<void> {
-    await this.roles.add(roleId);
-  }
-
-  /**
-   * Remove a role from this member.
-   * Prefer member.roles.remove(roleId) for Discord.js parity.
-   * @param roleId - The role ID to remove
-   * Requires Manage Roles permission.
-   */
-  async removeRole(roleId: string): Promise<void> {
-    await this.roles.remove(roleId);
-  }
-
-  /**
-   * Edit this guild member. PATCH /guilds/{id}/members/{userId} or /members/@me for the bot.
-   * For @me: nick, avatar, banner, bio, pronouns, accent_color, profile_flags, mute, deaf,
-   * communication_disabled_until, timeout_reason, channel_id, connection_id.
-   * For other members: same plus roles (array of role IDs).
-   */
-  async edit(options: {
-    nick?: string | null;
-    roles?: string[];
-    avatar?: string | null;
-    banner?: string | null;
-    bio?: string | null;
-    pronouns?: string | null;
-    accent_color?: number | null;
-    profile_flags?: number | null;
-    mute?: boolean;
-    deaf?: boolean;
-    communication_disabled_until?: string | null;
-    timeout_reason?: string | null;
-    channel_id?: string | null;
-    connection_id?: string | null;
-  }): Promise<this> {
-    const isMe = this.client.user?.id === this.id;
-    const route = isMe
-      ? `/guilds/${this.guild.id}/members/@me`
-      : Routes.guildMember(this.guild.id, this.id);
-    const data = await this.client.rest.patch<APIGuildMember>(route, {
-      body: options,
-      auth: true,
-    });
-    this.nick = data.nick ?? this.nick;
-    if (data.roles) this.roles._patch(data.roles);
-    if (data.communication_disabled_until != null) {
-      (this as { communicationDisabledUntil: Date | null }).communicationDisabledUntil =
-        data.communication_disabled_until ? new Date(data.communication_disabled_until) : null;
-    }
-    return this;
-  }
-
-  /**
-   * Get the member's guild-level permissions (from roles only, no channel overwrites).
-   * Use this for server-wide permission checks (e.g. ban, kick, manage roles).
-   * @returns Object with has(permission) to check specific permissions
-   * @example
-   * const perms = member.permissions;
-   * if (perms.has(PermissionFlags.BanMembers)) { ... }
-   */
-  get permissions() {
-    const base = this._computeBasePermissions();
-    const ownerId = this.guild.ownerId;
-    const isOwner = ownerId != null && ownerId !== '' && String(ownerId) === String(this.id);
-    const perms = computePermissions(base, [], [], this.id, isOwner);
-    return new BitField<keyof typeof PermissionFlags>(perms);
-  }
-
-  /**
-   * Compute the member's effective permissions in a guild channel.
-   * Applies role permissions and channel overwrites.
-   * @param channel - The guild channel to check permissions for
-   * @returns Object with has(permission) to check specific permissions
-   * @example
-   * const perms = member.permissionsIn(channel);
-   * if (perms.has(PermissionFlags.SendMessages)) { ... }
-   */
-  permissionsIn(channel: GuildChannel) {
-    const base = this._computeBasePermissions();
-    const ownerId = this.guild.ownerId;
-    const isOwner = ownerId != null && ownerId !== '' && String(ownerId) === String(this.id);
-    const perms = computePermissions(
-      base,
-      channel.permissionOverwrites,
-      [...this.roles.roleIds],
-      this.id,
-      isOwner,
-    );
-    return new BitField<keyof typeof PermissionFlags>(perms);
-  }
-
-  /**
-   * Move this member to a different voice channel or disconnect them from voice.
-   * Requires Move Members permission.
-   * @param channelId - The voice channel ID to move the member to, or null to disconnect
-   * @param connectionId - Optional connection ID for the specific voice session (usually not needed)
-   * @returns Promise that resolves when the member has been moved
-   * @example
-   * // Move member to a different voice channel
-   * await member.move('123456789012345678');
-   *
-   * // Disconnect member from voice
-   * await member.move(null);
-   */
-  async move(channelId: string | null, connectionId?: string | null): Promise<void> {
-    await this.edit({
-      channel_id: channelId,
-      connection_id: connectionId,
-    });
-  }
-
-  private _computeBasePermissions(): bigint {
-    let base = 0n;
-    const everyone = this.guild.roles.get(this.guild.id);
-    if (everyone) base |= everyone.permissions.bitfield;
-    for (const roleId of this.roles.roleIds) {
-      if (roleId === this.guild.id) continue;
-      const role = this.guild.roles.get(roleId);
-      if (role) base |= role.permissions.bitfield;
-    }
-    return base;
-  }
-}

package/core/packages/fluxer-core/src/structures/GuildMemberRoleManager.ts

@@ -1,121 +0,0 @@
-import { Collection } from '@erinjs/collection';
-import { Routes } from '@erinjs/types';
-import type { GuildMember } from './GuildMember.js';
-import type { Role } from './Role.js';
-
-/** Role ID or Role object for add/remove. */
-export type RoleResolvable = string | Role;
-
-/**
- * Manages a guild member's roles with add/remove/set and a cache of Role objects.
- * Discord.js parity: member.roles.add(), member.roles.remove(), member.roles.set(), member.roles.cache
- *
- * @discordJsCompat https://discord.js.org/docs/packages/discord.js/main/GuildMemberRoleManager
- * @example
- * // Add a role (Discord.js style)
- * await member.roles.add(roleId);
- *
- * @example
- * // Remove a role
- * await member.roles.remove(roleId);
- *
- * @example
- * // Replace all roles
- * await member.roles.set(['roleId1', 'roleId2']);
- *
- * @example
- * // Check if member has a role
- * if (member.roles.cache.has(roleId)) { ... }
- */
-export class GuildMemberRoleManager {
-  private _roleIds: string[] = [];
-
-  constructor(
-    private readonly member: GuildMember,
-    initialRoleIds: string[] = [],
-  ) {
-    this._roleIds = [...initialRoleIds];
-  }
-
-  /** Role IDs for this member. Used by permissions; prefer cache for Role objects. */
-  get roleIds(): readonly string[] {
-    return this._roleIds;
-  }
-
-  /** Check if the member has a role. Discord.js parity: member.roles.cache.has(roleId) */
-  has(roleOrId: RoleResolvable): boolean {
-    return this._roleIds.includes(this._resolveId(roleOrId));
-  }
-
-  /**
-   * Collection of Role objects for this member's roles (from guild.roles).
-   * Discord.js parity: member.roles.cache
-   * @discordJsCompat https://discord.js.org/docs/packages/discord.js/main/GuildMemberRoleManager
-   */
-  get cache(): Collection<string, Role> {
-    const coll = new Collection<string, Role>();
-    for (const id of this._roleIds) {
-      const role = this.member.guild.roles.get(id);
-      if (role) coll.set(id, role);
-    }
-    return coll;
-  }
-
-  /** Resolve role ID from RoleResolvable. */
-  private _resolveId(roleOrId: RoleResolvable): string {
-    return typeof roleOrId === 'string' ? roleOrId : roleOrId.id;
-  }
-
-  /**
-   * Add a role to this member.
-   * Discord.js parity: member.roles.add(roleId)
-   * Requires Manage Roles permission.
-   * @discordJsCompat https://discord.js.org/docs/packages/discord.js/main/GuildMemberRoleManager
-   */
-  async add(roleOrId: RoleResolvable): Promise<void> {
-    const roleId = this._resolveId(roleOrId);
-    if (this._roleIds.includes(roleId)) return;
-    await this.member.client.rest.put(
-      Routes.guildMemberRole(this.member.guild.id, this.member.id, roleId),
-    );
-    this._roleIds.push(roleId);
-  }
-
-  /**
-   * Remove a role from this member.
-   * Discord.js parity: member.roles.remove(roleId)
-   * Requires Manage Roles permission.
-   * @discordJsCompat https://discord.js.org/docs/packages/discord.js/main/GuildMemberRoleManager
-   */
-  async remove(roleOrId: RoleResolvable): Promise<void> {
-    const roleId = this._resolveId(roleOrId);
-    const idx = this._roleIds.indexOf(roleId);
-    if (idx === -1) return;
-    await this.member.client.rest.delete(
-      Routes.guildMemberRole(this.member.guild.id, this.member.id, roleId),
-    );
-    this._roleIds.splice(idx, 1);
-  }
-
-  /**
-   * Replace all roles for this member. PATCH /guilds/{id}/members/{userId}
-   * Discord.js parity: member.roles.set(roleIds)
-   * Requires Manage Roles permission.
-   * @discordJsCompat https://discord.js.org/docs/packages/discord.js/main/GuildMemberRoleManager
-   */
-  async set(roleIds: string[]): Promise<void> {
-    const data = await this.member.client.rest.patch<import('@erinjs/types').APIGuildMember>(
-      Routes.guildMember(this.member.guild.id, this.member.id),
-      { body: { roles: roleIds }, auth: true },
-    );
-    this._roleIds = data.roles ? [...data.roles] : [];
-  }
-
-  /**
-   * Update internal role IDs from API response. Called by GuildMember.edit().
-   * @internal
-   */
-  _patch(roleIds: string[]): void {
-    this._roleIds = [...roleIds];
-  }
-}

package/core/packages/fluxer-core/src/structures/GuildSticker.ts

@@ -1,56 +0,0 @@
-import { Client } from '../client/Client.js';
-import { Base } from './Base.js';
-import { APISticker } from '@erinjs/types';
-import { Routes } from '@erinjs/types';
-import { CDN_URL } from '../util/Constants.js';
-
-/** Represents a custom sticker in a guild. */
-export class GuildSticker extends Base {
-  readonly client: Client;
-  readonly id: string;
-  readonly guildId: string;
-  name: string;
-  description: string;
-  readonly tags: string[];
-  readonly animated: boolean;
-
-  /** @param data - API sticker from GET /guilds/{id}/stickers or guild sticker events */
-  constructor(client: Client, data: APISticker & { guild_id?: string }, guildId: string) {
-    super();
-    this.client = client;
-    this.id = data.id;
-    this.guildId = data.guild_id ?? guildId;
-    this.name = data.name;
-    this.description = data.description ?? '';
-    this.tags = data.tags ?? [];
-    this.animated = data.animated ?? false;
-  }
-
-  /** CDN URL for this sticker image. */
-  get url(): string {
-    const ext = this.animated ? 'gif' : 'png';
-    return `${CDN_URL}/stickers/${this.id}.${ext}`;
-  }
-
-  /** Delete this sticker. Requires Manage Emojis and Stickers permission. */
-  async delete(): Promise<void> {
-    await this.client.rest.delete(Routes.guildSticker(this.guildId, this.id), {
-      auth: true,
-    });
-  }
-
-  /**
-   * Edit this sticker's name and/or description.
-   * Requires Manage Emojis and Stickers permission.
-   */
-  async edit(options: { name?: string; description?: string }): Promise<GuildSticker> {
-    const data = await this.client.rest.patch(Routes.guildSticker(this.guildId, this.id), {
-      body: options,
-      auth: true,
-    });
-    const s = data as APISticker;
-    this.name = s.name;
-    this.description = s.description ?? '';
-    return this;
-  }
-}