lunibee 0.1.8 → 0.2.0

package/dist/core/permissions.d.ts

@@ -52,8 +52,11 @@ export declare const Permission: {
     readonly createEvents: bigint;
     readonly useExternalSounds: bigint;
     readonly sendVoiceMessages: bigint;
+    readonly setVoiceChannelStatus: bigint;
     readonly sendPolls: bigint;
     readonly useExternalApps: bigint;
+    readonly pinMessages: bigint;
+    readonly bypassSlowmode: bigint;
 };
 /** Canonical PascalCase permission constants. */
 export declare const Permissions: {
@@ -104,8 +107,11 @@ export declare const Permissions: {
     readonly CreateEvents: bigint;
     readonly UseExternalSounds: bigint;
     readonly SendVoiceMessages: bigint;
+    readonly SetVoiceChannelStatus: bigint;
     readonly SendPolls: bigint;
     readonly UseExternalApps: bigint;
+    readonly PinMessages: bigint;
+    readonly BypassSlowmode: bigint;
 };
 /**
  * Permission flag bits with **bigint** values matching Discord's permission bit
@@ -163,8 +169,11 @@ export declare const PermissionFlagsBits: {
     readonly CreateEvents: bigint;
     readonly UseExternalSounds: bigint;
     readonly SendVoiceMessages: bigint;
+    readonly SetVoiceChannelStatus: bigint;
     readonly SendPolls: bigint;
     readonly UseExternalApps: bigint;
+    readonly PinMessages: bigint;
+    readonly BypassSlowmode: bigint;
 };
 /** Union of {@link PermissionFlagsBits} values (all bigint). */
 export type PermissionFlagsBits = (typeof PermissionFlagsBits)[keyof typeof PermissionFlagsBits];
@@ -230,6 +239,8 @@ export declare class PermissionSet {
     has(...permissions: PermissionResolvable[]): boolean;
     /** Checks whether any supplied permission is present (OR). @param permissions Permission names or raw bits. @returns True when at least one requested permission is present. */
     any(...permissions: PermissionResolvable[]): boolean;
+    /** Returns the known permission names from `permissions` that this set lacks. @param permissions Permission names or raw bits. */
+    missing(...permissions: PermissionResolvable[]): PermissionName[];
     /** Returns a new set with permissions added. @param permissions Permission names or raw bits. @returns A new permission set. */
     add(...permissions: PermissionResolvable[]): PermissionSet;
     /** Returns a new set with permissions removed. @param permissions Permission names or raw bits. @returns A new permission set. */
@@ -292,8 +303,11 @@ export declare class PermissionsBitField extends PermissionSet {
         readonly CreateEvents: bigint;
         readonly UseExternalSounds: bigint;
         readonly SendVoiceMessages: bigint;
+        readonly SetVoiceChannelStatus: bigint;
         readonly SendPolls: bigint;
         readonly UseExternalApps: bigint;
+        readonly PinMessages: bigint;
+        readonly BypassSlowmode: bigint;
     };
     /** Permission flags constants. */
     static readonly All: {
@@ -344,9 +358,43 @@ export declare class PermissionsBitField extends PermissionSet {
         readonly createEvents: bigint;
         readonly useExternalSounds: bigint;
         readonly sendVoiceMessages: bigint;
+        readonly setVoiceChannelStatus: bigint;
         readonly sendPolls: bigint;
         readonly useExternalApps: bigint;
+        readonly pinMessages: bigint;
+        readonly bypassSlowmode: bigint;
     };
     /** Creates a permissions bitfield. @param value Initial permission bitfield or array of permissions. */
     constructor(value?: PermissionResolvable);
 }
+/** A role as needed for permission resolution. */
+export interface PermissionRole {
+    id: string;
+    permissions: PermissionResolvable;
+}
+/** A channel permission overwrite (Discord's `permission_overwrites` entry). */
+export interface PermissionOverwrite {
+    id: string;
+    type: PermissionOverwriteType | number;
+    allow: PermissionResolvable;
+    deny: PermissionResolvable;
+}
+/** Everything needed to resolve a member's permissions. */
+export interface PermissionContext {
+    guildId: string;
+    /** Guild owner ID; the owner has every permission. */
+    ownerId?: string;
+    memberId: string;
+    memberRoleIds: readonly string[];
+    /** Guild roles, including `@everyone` (whose ID is the guild ID). */
+    roles: readonly PermissionRole[];
+    /** Channel overwrites; omit for guild-level permissions. */
+    overwrites?: readonly PermissionOverwrite[];
+}
+/**
+ * Resolves a member's effective permissions the way Discord does: base
+ * permissions from `@everyone` and the member's roles (owner and
+ * administrator get everything), then the channel's `@everyone` overwrite,
+ * the combined role overwrites, and finally the member overwrite.
+ */
+export declare function computePermissions(context: PermissionContext): PermissionSet;