Seyfert v4.1.0: Polishing the Details

The Follow-Up

After the modal revolution of v4.0.0, we're back with a release focused on refinement. Seyfert v4.1.0 adds the utilities you've been asking for, expands API coverage, and squashes some sneaky bugs.

New: Deferred Context Check

How many times have you wondered "did I already defer this interaction?" Now you can just ask:

async run(ctx: AnyContext) {
  if (!ctx.deferred) {
    await ctx.deferReply();
  }
  
  // Safe to continue — we know it's deferred
  await ctx.editOrReply({ content: 'Processing complete!' });
}

Simple, but essential. No more tracking defer state manually.

Invite Management Gets Serious

Discord's invite system is more powerful than most realize. We've added full support for target user invites — those special invites that highlight a specific user streaming or in an activity.

// Get users targeted by invites
const targetUsers = await client.invites.getTargetUsers(inviteCode);

// Update target users
await client.invites.updateTargetUsers(inviteCode, ['366779196975874049', '1377618137645842533']);

// Check job status for bulk operations
const status = await client.invites.jobStatus(jobId);

Build invite analytics, stream promotion systems, or activity-based invite campaigns.

Role Member Counts

Ever needed to know how many members have a specific role without fetching the entire member list?

const data = await guild.roles.memberCounts(guildId);
for (const [roleId, count] of Object.entries(data)) {
    console.log(`${roleId} has ${count} members`);
}

Perfect for role-based analytics, permission audits, or just satisfying curiosity.

Regex for Modal Commands

In v3.2.0, we added regex support to ComponentCommand. Now ModalCommand gets the same treatment:

import { ModalCommand } from 'seyfert';

export default class FeedbackHandler extends ModalCommand {
  customId = /^feedback-\w+$/;  // Matches feedback-bug, feedback-suggestion, etc.

  async run(ctx: ModalContext) {
    const type = ctx.customId.split('-')[1];
    // Handle different feedback types with one handler
  }
}

One handler, infinite modal variations.

Discord API Updates

New Guild Features

The GuildFeatures enum now includes the latest Discord additions. Stay current with server capabilities.

New Permissions

import { PermissionFlagsBits } from 'seyfert';

// Pin messages without Manage Messages
PermissionFlagsBits.PinMessages

// Bypass slow mode in channels  
PermissionFlagsBits.BypassSlowmode

More granular permission control for your bot's requirements.

Bug Fixes

Double Camelization

Some API responses were being camelized twice, leading to properties like guildId becoming guildid. Fixed.

Thread Edit Ghost Channels

Editing a thread was incorrectly creating a new channel object. Threads now update in place as expected.

AttachmentBuilder in ImageResolve

AttachmentBuilder now works properly with image resolution utilities. Build attachments, use them in embeds — it just works.

Removals

ActiveDeveloper Flag

The ActiveDeveloper user flag has been removed. Discord deprecated this flag as part of their badge system changes. If you were checking for it, you'll need to update your code.

- if (user.flags?.has('ActiveDeveloper')) {
-   // ...
- }
+ // This flag no longer exists

Upgrade

npm install [email protected]

Not every release needs fireworks. Sometimes the best updates are the ones that make your existing code work better.

Seyfert v4.1.0 — less friction, more flow.