Permissions System

import { Permissions } from '@fluxer/constants';

// Combine multiple permissions with bitwise OR
const basicPermissions = 
  Permissions.VIEW_CHANNEL | 
  Permissions.SEND_MESSAGES | 
  Permissions.READ_MESSAGE_HISTORY;

console.log(basicPermissions); // 67584n

// Check if permissions include a specific permission
function hasPermission(permissions: bigint, permission: bigint): boolean {
  return (permissions & permission) === permission;
}

const userPerms = Permissions.SEND_MESSAGES | Permissions.VIEW_CHANNEL;

console.log(hasPermission(userPerms, Permissions.SEND_MESSAGES)); // true
console.log(hasPermission(userPerms, Permissions.ADMINISTRATOR));  // false

// Add a permission
let permissions = Permissions.VIEW_CHANNEL;
permissions |= Permissions.SEND_MESSAGES;

console.log(hasPermission(permissions, Permissions.SEND_MESSAGES)); // true

// Remove a permission
let permissions = Permissions.VIEW_CHANNEL | Permissions.SEND_MESSAGES;
permissions &= ~Permissions.SEND_MESSAGES;

console.log(hasPermission(permissions, Permissions.SEND_MESSAGES)); // false

export const DEFAULT_PERMISSIONS =
  Permissions.CREATE_INSTANT_INVITE |
  Permissions.ADD_REACTIONS |
  Permissions.STREAM |
  Permissions.VIEW_CHANNEL |
  Permissions.SEND_MESSAGES |
  Permissions.EMBED_LINKS |
  Permissions.ATTACH_FILES |
  Permissions.READ_MESSAGE_HISTORY |
  Permissions.USE_EXTERNAL_EMOJIS |
  Permissions.CONNECT |
  Permissions.SPEAK |
  Permissions.USE_VAD |
  Permissions.CHANGE_NICKNAME |
  Permissions.USE_EXTERNAL_STICKERS |
  Permissions.CREATE_EXPRESSIONS;

export const ElevatedPermissions =
  Permissions.KICK_MEMBERS |
  Permissions.BAN_MEMBERS |
  Permissions.ADMINISTRATOR |
  Permissions.MANAGE_CHANNELS |
  Permissions.MANAGE_GUILD |
  Permissions.MANAGE_ROLES |
  Permissions.MANAGE_MESSAGES |
  Permissions.MANAGE_WEBHOOKS |
  Permissions.MANAGE_EXPRESSIONS |
  Permissions.MODERATE_MEMBERS;

import { requirePermission, hasPermission } from '@fluxer/api';
import { Permissions } from '@fluxer/constants';

// Require permission (throws error if missing)
await requirePermission(gatewayService, {
  guildId,
  userId,
  permission: Permissions.MANAGE_MESSAGES,
  channelId // optional - for channel-specific permissions
});

// Check permission (returns boolean)
const canManage = await hasPermission(gatewayService, {
  guildId,
  userId,
  permission: Permissions.MANAGE_CHANNELS
});

import { computePermissionsDiff } from '@fluxer/api';

const oldPerms = Permissions.VIEW_CHANNEL | Permissions.SEND_MESSAGES;
const newPerms = Permissions.VIEW_CHANNEL | Permissions.MANAGE_MESSAGES;

const diff = computePermissionsDiff(oldPerms, newPerms);
console.log(diff);
// {
//   added: ['MANAGE_MESSAGES'],
//   removed: ['SEND_MESSAGES']
// }

export const ChannelOverwriteTypes = {
  ROLE: 0,    // Overwrite applies to a role
  MEMBER: 1   // Overwrite applies to a member
} as const;

import { MissingPermissionsError } from '@fluxer/errors';

try {
  await requirePermission(gatewayService, {
    guildId,
    userId,
    permission: Permissions.BAN_MEMBERS
  });
} catch (error) {
  if (error instanceof MissingPermissionsError) {
    // Handle missing permissions
    console.log('User lacks required permissions');
  }
}

// Bitwise OR of all permissions
export const ALL_PERMISSIONS = Object.values(Permissions)
  .reduce((acc, p) => acc | p, 0n);