@developer.krd/discord-dashboard 0.1.2 → 0.1.3

package/dist/index.js

@@ -1,88 +1,90 @@
-// src/dashboard.ts
+// src/index.ts
 import compression from "compression";
 import express from "express";
 import session from "express-session";
 import helmet from "helmet";
-import { createServer } from "http";
 import { randomBytes } from "crypto";
+import { createServer } from "http";
 
-// src/discord-helpers.ts
-var DISCORD_API = "https://discord.com/api/v10";
-async function fetchDiscordWithBot(botToken, path) {
-  const response = await fetch(`${DISCORD_API}${path}`, {
-    headers: {
-      Authorization: `Bot ${botToken}`
+// src/handlers/DiscordHelpers.ts
+var DiscordHelpers = class {
+  botToken;
+  DISCORD_API = "https://discord.com/api/v10";
+  constructor(botToken) {
+    this.botToken = botToken;
+  }
+  async fetchDiscordWithBot(path) {
+    const response = await fetch(`${this.DISCORD_API}${path}`, {
+      headers: {
+        Authorization: `Bot ${this.botToken}`
+      }
+    });
+    if (!response.ok) {
+      return null;
     }
-  });
-  if (!response.ok) {
-    return null;
+    return await response.json();
   }
-  return await response.json();
-}
-function createDiscordHelpers(botToken) {
-  return {
-    async getChannel(channelId) {
-      return await fetchDiscordWithBot(botToken, `/channels/${channelId}`);
-    },
-    async getGuildChannels(guildId) {
-      return await fetchDiscordWithBot(botToken, `/guilds/${guildId}/channels`) ?? [];
-    },
-    async searchGuildChannels(guildId, query, options) {
-      const channels = await fetchDiscordWithBot(botToken, `/guilds/${guildId}/channels`) ?? [];
-      const normalizedQuery = query.trim().toLowerCase();
-      const limit = Math.max(1, Math.min(options?.limit ?? 10, 50));
-      return channels.filter((channel) => {
-        if (options?.nsfw !== void 0 && Boolean(channel.nsfw) !== options.nsfw) {
-          return false;
-        }
-        if (options?.channelTypes && options.channelTypes.length > 0 && !options.channelTypes.includes(channel.type)) {
-          return false;
-        }
-        if (!normalizedQuery) {
-          return true;
-        }
-        return channel.name.toLowerCase().includes(normalizedQuery);
-      }).slice(0, limit);
-    },
-    async getRole(guildId, roleId) {
-      const roles = await fetchDiscordWithBot(botToken, `/guilds/${guildId}/roles`);
-      if (!roles) {
-        return null;
+  async getChannel(channelId) {
+    return await this.fetchDiscordWithBot(`/channels/${channelId}`);
+  }
+  async getGuildChannels(guildId) {
+    return await this.fetchDiscordWithBot(`/guilds/${guildId}/channels`) ?? [];
+  }
+  async searchGuildChannels(guildId, query, options) {
+    const channels = await this.fetchDiscordWithBot(`/guilds/${guildId}/channels`) ?? [];
+    const normalizedQuery = query.trim().toLowerCase();
+    const limit = Math.max(1, Math.min(options?.limit ?? 10, 50));
+    return channels.filter((channel) => {
+      if (options?.nsfw !== void 0 && Boolean(channel.nsfw) !== options.nsfw) {
+        return false;
       }
-      return roles.find((role) => role.id === roleId) ?? null;
-    },
-    async getGuildRoles(guildId) {
-      return await fetchDiscordWithBot(botToken, `/guilds/${guildId}/roles`) ?? [];
-    },
-    async searchGuildRoles(guildId, query, options) {
-      const roles = await fetchDiscordWithBot(botToken, `/guilds/${guildId}/roles`) ?? [];
-      const normalizedQuery = query.trim().toLowerCase();
-      const limit = Math.max(1, Math.min(options?.limit ?? 10, 50));
-      return roles.filter((role) => {
-        if (!options?.includeManaged && role.managed) {
-          return false;
-        }
-        if (!normalizedQuery) {
-          return true;
-        }
-        return role.name.toLowerCase().includes(normalizedQuery);
-      }).sort((a, b) => b.position - a.position).slice(0, limit);
-    },
-    async searchGuildMembers(guildId, query, options) {
-      const limit = Math.max(1, Math.min(options?.limit ?? 10, 1e3));
-      const params = new URLSearchParams({
-        query: query.trim(),
-        limit: String(limit)
-      });
-      return await fetchDiscordWithBot(botToken, `/guilds/${guildId}/members/search?${params.toString()}`) ?? [];
-    },
-    async getGuildMember(guildId, userId) {
-      return await fetchDiscordWithBot(botToken, `/guilds/${guildId}/members/${userId}`);
+      if (options?.channelTypes && options.channelTypes.length > 0 && !options.channelTypes.includes(channel.type)) {
+        return false;
+      }
+      if (!normalizedQuery) {
+        return true;
+      }
+      return channel.name.toLowerCase().includes(normalizedQuery);
+    }).slice(0, limit);
+  }
+  async getRole(guildId, roleId) {
+    const roles = await this.fetchDiscordWithBot(`/guilds/${guildId}/roles`);
+    if (!roles) {
+      return null;
     }
-  };
-}
+    return roles.find((role) => role.id === roleId) ?? null;
+  }
+  async getGuildRoles(guildId) {
+    return await this.fetchDiscordWithBot(`/guilds/${guildId}/roles`) ?? [];
+  }
+  async searchGuildRoles(guildId, query, options) {
+    const roles = await this.fetchDiscordWithBot(`/guilds/${guildId}/roles`) ?? [];
+    const normalizedQuery = query.trim().toLowerCase();
+    const limit = Math.max(1, Math.min(options?.limit ?? 10, 50));
+    return roles.filter((role) => {
+      if (!options?.includeManaged && role.managed) {
+        return false;
+      }
+      if (!normalizedQuery) {
+        return true;
+      }
+      return role.name.toLowerCase().includes(normalizedQuery);
+    }).sort((a, b) => b.position - a.position).slice(0, limit);
+  }
+  async searchGuildMembers(guildId, query, options) {
+    const limit = Math.max(1, Math.min(options?.limit ?? 10, 1e3));
+    const params = new URLSearchParams({
+      query: query.trim(),
+      limit: String(limit)
+    });
+    return await this.fetchDiscordWithBot(`/guilds/${guildId}/members/search?${params.toString()}`) ?? [];
+  }
+  async getGuildMember(guildId, userId) {
+    return await this.fetchDiscordWithBot(`/guilds/${guildId}/members/${userId}`);
+  }
+};
 
-// src/templates.ts
+// src/templates/templates.ts
 var appCss = `
 :root {
   color-scheme: dark;
@@ -136,7 +138,6 @@ body {
   font-weight: 700;
   display: grid;
   place-items: center;
-  cursor: pointer;
   transition: border-radius .15s ease, background .15s ease, transform .15s ease;
 }
 .server-item:hover { border-radius: 16px; background: #404249; }
@@ -251,7 +252,6 @@ button {
   color: var(--text);
   border-radius: 8px;
   padding: 8px 12px;
-  cursor: pointer;
 }
 button.primary {
   background: var(--primary);
@@ -407,7 +407,6 @@ button.danger { background: #3a1e27; border-color: rgba(255,107,107,.45); }
 .drag-handle {
   color: var(--muted);
   user-select: none;
-  cursor: grab;
   font-size: 0.9rem;
 }
 .list-input {
@@ -421,6 +420,7 @@ button.danger { background: #3a1e27; border-color: rgba(255,107,107,.45); }
   justify-self: start;
 }
 .empty { color: var(--muted); font-size: 0.9rem; }
+.cursor-pointer { cursor: pointer; }
 `;
 function escapeHtml(value) {
   return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#039;");
@@ -428,13 +428,15 @@ function escapeHtml(value) {
 function renderDashboardHtml(name, basePath, setupDesign) {
   const safeName = escapeHtml(name);
   const scriptData = JSON.stringify({ basePath, setupDesign: setupDesign ?? {} });
+  const customCssBlock = setupDesign?.customCss ? `
+  <style>${setupDesign.customCss}</style>` : "";
   return `<!DOCTYPE html>
 <html lang="en">
 <head>
   <meta charset="UTF-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
   <title>${safeName}</title>
-  <style>${appCss}</style>
+  <style>${appCss}</style>${customCssBlock}
 </head>
 <body>
   <div class="layout">
@@ -451,8 +453,8 @@ function renderDashboardHtml(name, basePath, setupDesign) {
 
       <div class="container">
         <div class="main-tabs">
-          <button id="tabHome" class="main-tab active">Home</button>
-          <button id="tabPlugins" class="main-tab">Plugins</button>
+          <button id="tabHome" class="main-tab active cursor-pointer">Home</button>
+          <button id="tabPlugins" class="main-tab cursor-pointer">Plugins</button>
         </div>
 
         <section id="homeArea">
@@ -563,7 +565,9 @@ function renderDashboardHtml(name, basePath, setupDesign) {
     const makeButton = (action, pluginId, panelId, panelElement) => {
       const button = document.createElement("button");
       button.textContent = action.label;
-      button.className = action.variant === "primary" ? "primary" : action.variant === "danger" ? "danger" : "";
+      const variantClass = action.variant === "primary" ? "primary" : action.variant === "danger" ? "danger" : "";
+      button.className = [variantClass, "cursor-pointer"].filter(Boolean).join(" ");
+      
       button.addEventListener("click", async () => {
         button.disabled = true;
         try {
@@ -668,7 +672,7 @@ function renderDashboardHtml(name, basePath, setupDesign) {
       el.serverRail.innerHTML = "";
       items.forEach((item) => {
         const button = document.createElement("button");
-        button.className = "server-item" + (item.id === state.selectedGuildId ? " active" : "");
+        button.className = "server-item cursor-pointer" + (item.id === state.selectedGuildId ? " active" : "");
         button.title = item.id && !item.botInGuild ? (item.name + " \u2022 Invite bot") : item.name;
 
         const activeIndicator = document.createElement("span");
@@ -705,8 +709,8 @@ function renderDashboardHtml(name, basePath, setupDesign) {
       const homeActive = state.activeMainTab === "home";
       el.homeArea.style.display = homeActive ? "block" : "none";
       el.pluginsArea.style.display = homeActive ? "none" : "block";
-      el.tabHome.className = "main-tab" + (homeActive ? " active" : "");
-      el.tabPlugins.className = "main-tab" + (!homeActive ? " active" : "");
+      el.tabHome.className = "main-tab cursor-pointer" + (homeActive ? " active" : "");
+      el.tabPlugins.className = "main-tab cursor-pointer" + (!homeActive ? " active" : "");
     };
 
     const updateContextLabel = () => {
@@ -728,7 +732,7 @@ function renderDashboardHtml(name, basePath, setupDesign) {
       el.homeCategories.innerHTML = "";
       state.homeCategories.forEach((category) => {
         const button = document.createElement("button");
-        button.className = "home-category-btn" + (state.selectedHomeCategoryId === category.id ? " active" : "");
+        button.className = "home-category-btn cursor-pointer" + (state.selectedHomeCategoryId === category.id ? " active" : "");
         button.textContent = category.label;
         button.title = category.description || category.label;
         button.addEventListener("click", async () => {
@@ -789,7 +793,7 @@ function renderDashboardHtml(name, basePath, setupDesign) {
       itemsWrap.className = "list-items";
       const addButton = document.createElement("button");
       addButton.type = "button";
-      addButton.className = "list-add";
+      addButton.className = "list-add cursor-pointer";
       addButton.textContent = "Add Button";
 
       const normalizeValues = () => {
@@ -805,7 +809,7 @@ function renderDashboardHtml(name, basePath, setupDesign) {
         row.draggable = true;
 
         const handle = document.createElement("span");
-        handle.className = "drag-handle";
+        handle.className = "drag-handle cursor-pointer";
         handle.textContent = "\u22EE\u22EE";
 
         const textInput = document.createElement("input");
@@ -817,6 +821,7 @@ function renderDashboardHtml(name, basePath, setupDesign) {
 
         const removeButton = document.createElement("button");
         removeButton.type = "button";
+        removeButton.className = "cursor-pointer";
         removeButton.textContent = "\xD7";
         removeButton.addEventListener("click", () => {
           row.remove();
@@ -894,7 +899,7 @@ function renderDashboardHtml(name, basePath, setupDesign) {
       items.forEach((item) => {
         const btn = document.createElement("button");
         btn.type = "button";
-        btn.className = "lookup-item";
+        btn.className = "lookup-item cursor-pointer";
         btn.textContent = labelResolver(item);
         btn.addEventListener("click", () => {
           onSelect(item);
@@ -1050,7 +1055,7 @@ function renderDashboardHtml(name, basePath, setupDesign) {
               input.value = field.value == null ? "" : String(field.value);
             } else if (field.type === "select") {
               input = document.createElement("select");
-              input.className = "home-select";
+              input.className = "home-select cursor-pointer";
               (field.options || []).forEach((option) => {
                 const optionEl = document.createElement("option");
                 optionEl.value = option.value;
@@ -1065,7 +1070,7 @@ function renderDashboardHtml(name, basePath, setupDesign) {
               row.className = "home-field-row";
               input = document.createElement("input");
               input.type = "checkbox";
-              input.className = "home-checkbox";
+              input.className = "home-checkbox cursor-pointer";
               input.checked = Boolean(field.value);
               const stateText = document.createElement("span");
               stateText.textContent = input.checked ? "Enabled" : "Disabled";
@@ -1120,7 +1125,9 @@ function renderDashboardHtml(name, basePath, setupDesign) {
           section.actions.forEach((action) => {
             const button = document.createElement("button");
             button.textContent = action.label;
-            button.className = action.variant === "primary" ? "primary" : action.variant === "danger" ? "danger" : "";
+            const variantClass = action.variant === "primary" ? "primary" : action.variant === "danger" ? "danger" : "";
+            button.className = [variantClass, "cursor-pointer"].filter(Boolean).join(" ");
+            
             button.addEventListener("click", async () => {
               button.disabled = true;
               try {
@@ -1234,7 +1241,7 @@ function renderDashboardHtml(name, basePath, setupDesign) {
                 input.value = field.value == null ? "" : String(field.value);
               } else if (field.type === "select") {
                 input = document.createElement("select");
-                input.className = "home-select";
+                input.className = "home-select cursor-pointer";
                 (field.options || []).forEach((option) => {
                   const optionEl = document.createElement("option");
                   optionEl.value = option.value;
@@ -1249,7 +1256,7 @@ function renderDashboardHtml(name, basePath, setupDesign) {
                 row.className = "home-field-row";
                 input = document.createElement("input");
                 input.type = "checkbox";
-                input.className = "home-checkbox";
+                input.className = "home-checkbox cursor-pointer";
                 input.checked = Boolean(field.value);
                 const stateText = document.createElement("span");
                 stateText.textContent = input.checked ? "Enabled" : "Disabled";
@@ -1459,7 +1466,6 @@ body {
   background: var(--panel);
   color: #fff;
   font-weight: 700;
-  cursor: pointer;
   transition: transform .15s ease, background .15s ease;
 }
 .server-item:hover { transform: translateY(-1px); background: #323b5f; }
@@ -1510,7 +1516,6 @@ button {
   color: var(--text);
   border-radius: 8px;
   padding: 7px 10px;
-  cursor: pointer;
 }
 button.primary { background: var(--primary); border: none; }
 button.danger { background: #4a2230; border-color: rgba(255,111,145,.45); }
@@ -1601,29 +1606,28 @@ button.danger { background: #4a2230; border-color: rgba(255,111,145,.45); }
   background: var(--panel);
 }
 .list-item.dragging { opacity: .6; }
-.drag-handle { color: var(--muted); user-select: none; cursor: grab; font-size: .9rem; }
+.drag-handle { color: var(--muted); user-select: none; font-size: .9rem; }
 .list-input { width: 100%; border: none; outline: none; background: transparent; color: var(--text); }
 .list-add { justify-self: start; }
 .empty { color: var(--muted); font-size: .9rem; }
+.cursor-pointer { cursor: pointer; }
 @media (max-width: 980px) {
   .layout { grid-template-columns: 70px 1fr; }
   .home-width-50, .home-width-33, .home-width-20 { flex-basis: 100%; max-width: 100%; }
 }
 `;
-var compactDashboardTemplateRenderer = ({
-  dashboardName,
-  basePath,
-  setupDesign
-}) => {
+var compactDashboardTemplateRenderer = ({ dashboardName, basePath, setupDesign }) => {
   const script = extractDashboardScript(renderDashboardHtml(dashboardName, basePath, setupDesign));
   const safeName = escapeHtml2(dashboardName);
+  const customCssBlock = setupDesign?.customCss ? `
+  <style>${setupDesign.customCss}</style>` : "";
   return `<!DOCTYPE html>
 <html lang="en">
 <head>
   <meta charset="UTF-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
   <title>${safeName}</title>
-  <style>${compactCss}</style>
+  <style>${compactCss}</style>${customCssBlock}
 </head>
 <body>
   <div class="shell">
@@ -1641,8 +1645,8 @@ var compactDashboardTemplateRenderer = ({
       <main class="content">
         <div class="container">
           <div class="main-tabs">
-            <button id="tabHome" class="main-tab active">Home</button>
-            <button id="tabPlugins" class="main-tab">Plugins</button>
+            <button id="tabHome" class="main-tab active cursor-pointer">Home</button>
+            <button id="tabPlugins" class="main-tab cursor-pointer">Plugins</button>
           </div>
 
           <section id="homeArea">
@@ -1671,11 +1675,7 @@ var compactDashboardTemplateRenderer = ({
 };
 
 // src/templates/default.ts
-var defaultDashboardTemplateRenderer = ({
-  dashboardName,
-  basePath,
-  setupDesign
-}) => renderDashboardHtml(dashboardName, basePath, setupDesign);
+var defaultDashboardTemplateRenderer = ({ dashboardName, basePath, setupDesign }) => renderDashboardHtml(dashboardName, basePath, setupDesign);
 
 // src/templates/index.ts
 var builtinTemplateRenderers = {
@@ -1686,565 +1686,7 @@ function getBuiltinTemplateRenderer(templateId) {
   return builtinTemplateRenderers[templateId];
 }
 
-// src/dashboard.ts
-var DISCORD_API2 = "https://discord.com/api/v10";
-var MANAGE_GUILD_PERMISSION = 0x20n;
-var ADMIN_PERMISSION = 0x8n;
-function normalizeBasePath(basePath) {
-  if (!basePath || basePath === "/") {
-    return "/dashboard";
-  }
-  return basePath.startsWith("/") ? basePath : `/${basePath}`;
-}
-function canManageGuild(permissions) {
-  const value = BigInt(permissions);
-  return (value & MANAGE_GUILD_PERMISSION) === MANAGE_GUILD_PERMISSION || (value & ADMIN_PERMISSION) === ADMIN_PERMISSION;
-}
-function toQuery(params) {
-  const url = new URLSearchParams();
-  for (const [key, value] of Object.entries(params)) {
-    url.set(key, value);
-  }
-  return url.toString();
-}
-async function fetchDiscord(path, token) {
-  const response = await fetch(`${DISCORD_API2}${path}`, {
-    headers: {
-      Authorization: `Bearer ${token}`
-    }
-  });
-  if (!response.ok) {
-    throw new Error(`Discord API request failed (${response.status})`);
-  }
-  return await response.json();
-}
-async function exchangeCodeForToken(options, code) {
-  const response = await fetch(`${DISCORD_API2}/oauth2/token`, {
-    method: "POST",
-    headers: {
-      "Content-Type": "application/x-www-form-urlencoded"
-    },
-    body: toQuery({
-      client_id: options.clientId,
-      client_secret: options.clientSecret,
-      grant_type: "authorization_code",
-      code,
-      redirect_uri: options.redirectUri
-    })
-  });
-  if (!response.ok) {
-    const text = await response.text();
-    throw new Error(`Failed token exchange: ${response.status} ${text}`);
-  }
-  return await response.json();
-}
-function createContext(req, options) {
-  const auth = req.session.discordAuth;
-  if (!auth) {
-    throw new Error("Not authenticated");
-  }
-  const selectedGuildId = typeof req.query.guildId === "string" ? req.query.guildId : void 0;
-  return {
-    user: auth.user,
-    guilds: auth.guilds,
-    accessToken: auth.accessToken,
-    selectedGuildId,
-    helpers: createDiscordHelpers(options.botToken)
-  };
-}
-function ensureAuthenticated(req, res, next) {
-  if (!req.session.discordAuth) {
-    res.status(401).json({ authenticated: false, message: "Authentication required" });
-    return;
-  }
-  next();
-}
-async function resolveOverviewCards(options, context) {
-  if (options.getOverviewCards) {
-    return await options.getOverviewCards(context);
-  }
-  const manageableGuildCount = context.guilds.filter((guild) => guild.owner || canManageGuild(guild.permissions)).length;
-  return [
-    {
-      id: "user",
-      title: "Logged-in User",
-      value: context.user.global_name || context.user.username,
-      subtitle: `ID: ${context.user.id}`,
-      intent: "info"
-    },
-    {
-      id: "guilds",
-      title: "Manageable Guilds",
-      value: manageableGuildCount,
-      subtitle: "Owner or Manage Server permissions",
-      intent: "success"
-    },
-    {
-      id: "plugins",
-      title: "Plugins Loaded",
-      value: options.plugins?.length ?? 0,
-      subtitle: "Dynamic server modules",
-      intent: "neutral"
-    }
-  ];
-}
-async function resolveHomeSections(options, context) {
-  const customSections = options.home?.getSections ? await options.home.getSections(context) : [];
-  const overviewSections = options.home?.getOverviewSections ? await options.home.getOverviewSections(context) : [];
-  if (customSections.length > 0 || overviewSections.length > 0) {
-    const normalizedOverview = overviewSections.map((section) => ({
-      ...section,
-      categoryId: section.categoryId ?? "overview"
-    }));
-    return [...normalizedOverview, ...customSections];
-  }
-  const selectedGuild = context.selectedGuildId ? context.guilds.find((guild) => guild.id === context.selectedGuildId) : void 0;
-  return [
-    {
-      id: "setup",
-      title: "Setup Details",
-      description: "Core dashboard setup information",
-      scope: "setup",
-      categoryId: "setup",
-      fields: [
-        {
-          id: "dashboardName",
-          label: "Dashboard Name",
-          type: "text",
-          value: options.dashboardName ?? "Discord Dashboard",
-          readOnly: true
-        },
-        {
-          id: "basePath",
-          label: "Base Path",
-          type: "text",
-          value: options.basePath ?? "/dashboard",
-          readOnly: true
-        }
-      ]
-    },
-    {
-      id: "context",
-      title: "Dashboard Context",
-      description: selectedGuild ? `Managing ${selectedGuild.name}` : "Managing user dashboard",
-      scope: resolveScope(context),
-      categoryId: "overview",
-      fields: [
-        {
-          id: "mode",
-          label: "Mode",
-          type: "text",
-          value: selectedGuild ? "Guild" : "User",
-          readOnly: true
-        },
-        {
-          id: "target",
-          label: "Target",
-          type: "text",
-          value: selectedGuild ? selectedGuild.name : context.user.username,
-          readOnly: true
-        }
-      ]
-    }
-  ];
-}
-function resolveScope(context) {
-  return context.selectedGuildId ? "guild" : "user";
-}
-async function resolveHomeCategories(options, context) {
-  if (options.home?.getCategories) {
-    const categories = await options.home.getCategories(context);
-    return [...categories].sort((a, b) => {
-      if (a.id === "overview") return -1;
-      if (b.id === "overview") return 1;
-      return 0;
-    });
-  }
-  return [
-    { id: "overview", label: "Overview", scope: resolveScope(context) },
-    { id: "setup", label: "Setup", scope: "setup" }
-  ];
-}
-function getUserAvatarUrl(user) {
-  if (user.avatar) {
-    const ext = user.avatar.startsWith("a_") ? "gif" : "png";
-    return `https://cdn.discordapp.com/avatars/${user.id}/${user.avatar}.${ext}?size=256`;
-  }
-  const fallbackIndex = Number((BigInt(user.id) >> 22n) % 6n);
-  return `https://cdn.discordapp.com/embed/avatars/${fallbackIndex}.png`;
-}
-function getGuildIconUrl(guild) {
-  if (!guild.icon) {
-    return null;
-  }
-  const ext = guild.icon.startsWith("a_") ? "gif" : "png";
-  return `https://cdn.discordapp.com/icons/${guild.id}/${guild.icon}.${ext}?size=128`;
-}
-function createGuildInviteUrl(options, guildId) {
-  const scopes = options.botInviteScopes && options.botInviteScopes.length > 0 ? options.botInviteScopes : ["bot", "applications.commands"];
-  return `https://discord.com/oauth2/authorize?${toQuery({
-    client_id: options.clientId,
-    scope: scopes.join(" "),
-    permissions: options.botInvitePermissions ?? "8",
-    guild_id: guildId,
-    disable_guild_select: "true"
-  })}`;
-}
-async function fetchBotGuildIds(botToken) {
-  const response = await fetch(`${DISCORD_API2}/users/@me/guilds`, {
-    headers: {
-      Authorization: `Bot ${botToken}`
-    }
-  });
-  if (!response.ok) {
-    return /* @__PURE__ */ new Set();
-  }
-  const guilds = await response.json();
-  return new Set(guilds.map((guild) => guild.id));
-}
-function resolveTemplateRenderer(options) {
-  const selectedTemplate = options.uiTemplate ?? "default";
-  const defaultRenderer = ({ dashboardName, basePath, setupDesign }) => renderDashboardHtml(dashboardName, basePath, setupDesign);
-  const customRenderer = options.uiTemplates?.[selectedTemplate];
-  if (customRenderer) {
-    return customRenderer;
-  }
-  const builtinRenderer = getBuiltinTemplateRenderer(selectedTemplate);
-  if (builtinRenderer) {
-    return builtinRenderer;
-  }
-  if (selectedTemplate !== "default") {
-    throw new Error(`Unknown uiTemplate '${selectedTemplate}'. Register it in uiTemplates.`);
-  }
-  return defaultRenderer;
-}
-function createDashboard(options) {
-  const app = options.app ?? express();
-  const basePath = normalizeBasePath(options.basePath);
-  const dashboardName = options.dashboardName ?? "Discord Dashboard";
-  const templateRenderer = resolveTemplateRenderer(options);
-  const plugins = options.plugins ?? [];
-  if (!options.botToken) throw new Error("botToken is required");
-  if (!options.clientId) throw new Error("clientId is required");
-  if (!options.clientSecret) throw new Error("clientSecret is required");
-  if (!options.redirectUri) throw new Error("redirectUri is required");
-  if (!options.sessionSecret) throw new Error("sessionSecret is required");
-  if (!options.app && options.trustProxy !== void 0) {
-    app.set("trust proxy", options.trustProxy);
-  }
-  const router = express.Router();
-  const sessionMiddleware = session({
-    name: options.sessionName ?? "discord_dashboard.sid",
-    secret: options.sessionSecret,
-    resave: false,
-    saveUninitialized: false,
-    cookie: {
-      httpOnly: true,
-      sameSite: "lax",
-      maxAge: options.sessionMaxAgeMs ?? 1e3 * 60 * 60 * 24 * 7
-    }
-  });
-  router.use(compression());
-  router.use(
-    helmet({
-      contentSecurityPolicy: false
-    })
-  );
-  router.use(express.json());
-  router.use(sessionMiddleware);
-  router.get("/", (req, res) => {
-    if (!req.session.discordAuth) {
-      res.redirect(`${basePath}/login`);
-      return;
-    }
-    res.setHeader("Cache-Control", "no-store");
-    res.type("html").send(templateRenderer({
-      dashboardName,
-      basePath,
-      setupDesign: options.setupDesign
-    }));
-  });
-  router.get("/login", (req, res) => {
-    const state = randomBytes(16).toString("hex");
-    req.session.oauthState = state;
-    const scope = (options.scopes && options.scopes.length > 0 ? options.scopes : ["identify", "guilds"]).join(" ");
-    const query = toQuery({
-      client_id: options.clientId,
-      redirect_uri: options.redirectUri,
-      response_type: "code",
-      scope,
-      state,
-      prompt: "none"
-    });
-    res.redirect(`https://discord.com/oauth2/authorize?${query}`);
-  });
-  router.get("/callback", async (req, res) => {
-    try {
-      const code = typeof req.query.code === "string" ? req.query.code : void 0;
-      const state = typeof req.query.state === "string" ? req.query.state : void 0;
-      if (!code || !state) {
-        res.status(400).send("Missing OAuth2 code/state");
-        return;
-      }
-      if (!req.session.oauthState || req.session.oauthState !== state) {
-        res.status(403).send("Invalid OAuth2 state");
-        return;
-      }
-      const tokenData = await exchangeCodeForToken(options, code);
-      const [user, guilds] = await Promise.all([
-        fetchDiscord("/users/@me", tokenData.access_token),
-        fetchDiscord("/users/@me/guilds", tokenData.access_token)
-      ]);
-      req.session.discordAuth = {
-        accessToken: tokenData.access_token,
-        refreshToken: tokenData.refresh_token,
-        expiresAt: tokenData.expires_in ? Date.now() + tokenData.expires_in * 1e3 : void 0,
-        user,
-        guilds
-      };
-      req.session.oauthState = void 0;
-      res.redirect(basePath);
-    } catch (error) {
-      const message = error instanceof Error ? error.message : "OAuth callback failed";
-      res.status(500).send(message);
-    }
-  });
-  router.post("/logout", (req, res) => {
-    req.session.destroy((sessionError) => {
-      if (sessionError) {
-        res.status(500).json({ ok: false, message: "Failed to destroy session" });
-        return;
-      }
-      res.clearCookie(options.sessionName ?? "discord_dashboard.sid");
-      res.json({ ok: true });
-    });
-  });
-  router.get("/api/session", (req, res) => {
-    const auth = req.session.discordAuth;
-    if (!auth) {
-      res.status(200).json({ authenticated: false });
-      return;
-    }
-    const manageableGuildCount = auth.guilds.filter((guild) => guild.owner || canManageGuild(guild.permissions)).length;
-    res.json({
-      authenticated: true,
-      user: {
-        ...auth.user,
-        avatarUrl: getUserAvatarUrl(auth.user)
-      },
-      guildCount: manageableGuildCount,
-      expiresAt: auth.expiresAt
-    });
-  });
-  router.get("/api/guilds", ensureAuthenticated, async (req, res) => {
-    const context = createContext(req, options);
-    if (options.ownerIds && options.ownerIds.length > 0 && !options.ownerIds.includes(context.user.id)) {
-      res.status(403).json({ message: "You are not allowed to access this dashboard." });
-      return;
-    }
-    let manageableGuilds = context.guilds.filter((guild) => guild.owner || canManageGuild(guild.permissions));
-    if (options.guildFilter) {
-      const filtered = [];
-      for (const guild of manageableGuilds) {
-        const allowed = await options.guildFilter(guild, context);
-        if (allowed) {
-          filtered.push(guild);
-        }
-      }
-      manageableGuilds = filtered;
-    }
-    const botGuildIds = await fetchBotGuildIds(options.botToken);
-    const enrichedGuilds = manageableGuilds.map((guild) => {
-      const botInGuild = botGuildIds.has(guild.id);
-      return {
-        ...guild,
-        iconUrl: getGuildIconUrl(guild),
-        botInGuild,
-        inviteUrl: botInGuild ? void 0 : createGuildInviteUrl(options, guild.id)
-      };
-    });
-    res.json({ guilds: enrichedGuilds });
-  });
-  router.get("/api/overview", ensureAuthenticated, async (req, res) => {
-    const context = createContext(req, options);
-    const cards = await resolveOverviewCards(options, context);
-    res.json({ cards });
-  });
-  router.get("/api/home/categories", ensureAuthenticated, async (req, res) => {
-    const context = createContext(req, options);
-    const activeScope = resolveScope(context);
-    const categories = await resolveHomeCategories(options, context);
-    const visible = categories.filter((item) => item.scope === "setup" || item.scope === activeScope);
-    res.json({ categories: visible, activeScope });
-  });
-  router.get("/api/home", ensureAuthenticated, async (req, res) => {
-    const context = createContext(req, options);
-    const activeScope = resolveScope(context);
-    const categoryId = typeof req.query.categoryId === "string" ? req.query.categoryId : void 0;
-    let sections = await resolveHomeSections(options, context);
-    sections = sections.filter((section) => {
-      const sectionScope = section.scope ?? activeScope;
-      if (sectionScope !== "setup" && sectionScope !== activeScope) {
-        return false;
-      }
-      if (!categoryId) {
-        return true;
-      }
-      return section.categoryId === categoryId;
-    });
-    res.json({ sections, activeScope });
-  });
-  router.get("/api/lookup/roles", ensureAuthenticated, async (req, res) => {
-    const context = createContext(req, options);
-    const guildId = typeof req.query.guildId === "string" && req.query.guildId.length > 0 ? req.query.guildId : context.selectedGuildId;
-    if (!guildId) {
-      res.status(400).json({ message: "guildId is required" });
-      return;
-    }
-    const query = typeof req.query.q === "string" ? req.query.q : "";
-    const limit = typeof req.query.limit === "string" ? Number(req.query.limit) : void 0;
-    const includeManaged = typeof req.query.includeManaged === "string" ? req.query.includeManaged === "true" : void 0;
-    const roles = await context.helpers.searchGuildRoles(guildId, query, {
-      limit: Number.isFinite(limit) ? limit : void 0,
-      includeManaged
-    });
-    res.json({ roles });
-  });
-  router.get("/api/lookup/channels", ensureAuthenticated, async (req, res) => {
-    const context = createContext(req, options);
-    const guildId = typeof req.query.guildId === "string" && req.query.guildId.length > 0 ? req.query.guildId : context.selectedGuildId;
-    if (!guildId) {
-      res.status(400).json({ message: "guildId is required" });
-      return;
-    }
-    const query = typeof req.query.q === "string" ? req.query.q : "";
-    const limit = typeof req.query.limit === "string" ? Number(req.query.limit) : void 0;
-    const nsfw = typeof req.query.nsfw === "string" ? req.query.nsfw === "true" : void 0;
-    const channelTypes = typeof req.query.channelTypes === "string" ? req.query.channelTypes.split(",").map((item) => Number(item.trim())).filter((item) => Number.isFinite(item)) : void 0;
-    const channels = await context.helpers.searchGuildChannels(guildId, query, {
-      limit: Number.isFinite(limit) ? limit : void 0,
-      nsfw,
-      channelTypes
-    });
-    res.json({ channels });
-  });
-  router.get("/api/lookup/members", ensureAuthenticated, async (req, res) => {
-    const context = createContext(req, options);
-    const guildId = typeof req.query.guildId === "string" && req.query.guildId.length > 0 ? req.query.guildId : context.selectedGuildId;
-    if (!guildId) {
-      res.status(400).json({ message: "guildId is required" });
-      return;
-    }
-    const query = typeof req.query.q === "string" ? req.query.q : "";
-    const limit = typeof req.query.limit === "string" ? Number(req.query.limit) : void 0;
-    const members = await context.helpers.searchGuildMembers(guildId, query, {
-      limit: Number.isFinite(limit) ? limit : void 0
-    });
-    res.json({ members });
-  });
-  router.post("/api/home/:actionId", ensureAuthenticated, async (req, res) => {
-    const context = createContext(req, options);
-    const action = options.home?.actions?.[req.params.actionId];
-    if (!action) {
-      res.status(404).json({ ok: false, message: "Home action not found" });
-      return;
-    }
-    const payload = req.body;
-    if (!payload || typeof payload.sectionId !== "string" || !payload.values || typeof payload.values !== "object") {
-      res.status(400).json({ ok: false, message: "Invalid home action payload" });
-      return;
-    }
-    let result;
-    try {
-      result = await action(context, {
-        sectionId: payload.sectionId,
-        values: payload.values
-      });
-    } catch (error) {
-      const message = error instanceof Error ? error.message : "Home action failed";
-      res.status(500).json({ ok: false, message });
-      return;
-    }
-    res.json(result);
-  });
-  router.get("/api/plugins", ensureAuthenticated, async (req, res) => {
-    const context = createContext(req, options);
-    const activeScope = context.selectedGuildId ? "guild" : "user";
-    const payload = [];
-    for (const plugin of plugins) {
-      const pluginScope = plugin.scope ?? "both";
-      if (pluginScope !== "both" && pluginScope !== activeScope) {
-        continue;
-      }
-      const panels = await plugin.getPanels(context);
-      payload.push({
-        id: plugin.id,
-        name: plugin.name,
-        description: plugin.description,
-        panels
-      });
-    }
-    res.json({ plugins: payload });
-  });
-  router.post("/api/plugins/:pluginId/:actionId", ensureAuthenticated, async (req, res) => {
-    const context = createContext(req, options);
-    const plugin = plugins.find((item) => item.id === req.params.pluginId);
-    if (!plugin) {
-      res.status(404).json({ ok: false, message: "Plugin not found" });
-      return;
-    }
-    const action = plugin.actions?.[req.params.actionId];
-    if (!action) {
-      res.status(404).json({ ok: false, message: "Action not found" });
-      return;
-    }
-    let result;
-    try {
-      result = await action(context, req.body);
-    } catch (error) {
-      const message = error instanceof Error ? error.message : "Plugin action failed";
-      res.status(500).json({ ok: false, message });
-      return;
-    }
-    res.json(result);
-  });
-  app.use(basePath, router);
-  let server;
-  return {
-    app,
-    async start() {
-      if (options.app) {
-        return;
-      }
-      if (server) {
-        return;
-      }
-      const port = options.port ?? 3e3;
-      const host = options.host ?? "0.0.0.0";
-      server = createServer(app);
-      await new Promise((resolve) => {
-        server.listen(port, host, () => resolve());
-      });
-    },
-    async stop() {
-      if (!server) {
-        return;
-      }
-      await new Promise((resolve, reject) => {
-        server.close((error) => {
-          if (error) {
-            reject(error);
-            return;
-          }
-          resolve();
-        });
-      });
-      server = void 0;
-    }
-  };
-}
-
-// src/designer.ts
+// src/handlers/DashboardDesigner.ts
 var CategoryBuilder = class {
   constructor(scope, categoryId, categoryLabel) {
     this.scope = scope;
@@ -2266,11 +1708,7 @@ var CategoryBuilder = class {
     return this;
   }
   buildCategory() {
-    return {
-      id: this.categoryId,
-      label: this.categoryLabel,
-      scope: this.scope
-    };
+    return { id: this.categoryId, label: this.categoryLabel, scope: this.scope };
   }
   buildSections() {
     return [...this.sections];
@@ -2287,12 +1725,7 @@ var DashboardDesigner = class {
     this.partialOptions = { ...baseOptions };
   }
   setup(input) {
-    if (input.ownerIds) this.partialOptions.ownerIds = input.ownerIds;
-    if (input.botInvitePermissions) this.partialOptions.botInvitePermissions = input.botInvitePermissions;
-    if (input.botInviteScopes) this.partialOptions.botInviteScopes = input.botInviteScopes;
-    if (input.dashboardName) this.partialOptions.dashboardName = input.dashboardName;
-    if (input.basePath) this.partialOptions.basePath = input.basePath;
-    if (input.uiTemplate) this.partialOptions.uiTemplate = input.uiTemplate;
+    Object.assign(this.partialOptions, input);
     return this;
   }
   useTemplate(templateId) {
@@ -2336,11 +1769,7 @@ var DashboardDesigner = class {
     const categoryId = input.categoryId ?? input.id;
     this.pages.push({
       pageId: input.id,
-      category: {
-        id: categoryId,
-        label: input.label ?? input.title,
-        scope
-      },
+      category: { id: categoryId, label: input.label ?? input.title, scope },
       section: {
         id: input.id,
         title: input.title,
@@ -2354,10 +1783,6 @@ var DashboardDesigner = class {
     });
     return this;
   }
-  onHomeAction(actionId, handler) {
-    this.homeActions[actionId] = handler;
-    return this;
-  }
   onLoad(pageId, handler) {
     this.loadHandlers[pageId] = handler;
     return this;
@@ -2372,6 +1797,17 @@ var DashboardDesigner = class {
   onsave(pageId, handler) {
     return this.onSave(pageId, handler);
   }
+  onHomeAction(actionId, handler) {
+    this.homeActions[actionId] = handler;
+    return this;
+  }
+  customCss(cssString) {
+    this.partialOptions.setupDesign = {
+      ...this.partialOptions.setupDesign ?? {},
+      customCss: cssString
+    };
+    return this;
+  }
   build() {
     const staticCategories = this.categories.map((item) => item.buildCategory());
     const staticSections = this.categories.flatMap((item) => item.buildSections());
@@ -2380,20 +1816,14 @@ var DashboardDesigner = class {
     const categoryMap = /* @__PURE__ */ new Map();
     for (const category of [...staticCategories, ...pageCategories]) {
       const key = `${category.scope}:${category.id}`;
-      if (!categoryMap.has(key)) {
-        categoryMap.set(key, category);
-      }
+      if (!categoryMap.has(key)) categoryMap.set(key, category);
     }
     const categories = [...categoryMap.values()];
     const saveActionIds = {};
     for (const section of baseSections) {
-      if (this.saveHandlers[section.id]) {
-        saveActionIds[section.id] = `save:${section.id}`;
-      }
+      if (this.saveHandlers[section.id]) saveActionIds[section.id] = `save:${section.id}`;
     }
-    const resolvedActions = {
-      ...this.homeActions
-    };
+    const resolvedActions = { ...this.homeActions };
     for (const [sectionId, handler] of Object.entries(this.saveHandlers)) {
       resolvedActions[saveActionIds[sectionId]] = handler;
     }
@@ -2409,11 +1839,7 @@ var DashboardDesigner = class {
           };
           const saveActionId = saveActionIds[section.id];
           if (saveActionId && !section.actions?.some((action) => action.id === saveActionId)) {
-            section.actions = [...section.actions ?? [], {
-              id: saveActionId,
-              label: "Save",
-              variant: "primary"
-            }];
+            section.actions = [...section.actions ?? [], { id: saveActionId, label: "Save", variant: "primary" }];
           }
           const loadHandler = this.loadHandlers[section.id];
           if (loadHandler) {
@@ -2438,16 +1864,451 @@ var DashboardDesigner = class {
       home
     };
   }
+  /**
+   * Builds the configuration and immediately instantiates the Dashboard.
+   */
+  createDashboard() {
+    const options = this.build();
+    return new DiscordDashboard(options);
+  }
 };
-function createDashboardDesigner(baseOptions) {
-  return new DashboardDesigner(baseOptions);
+
+// src/index.ts
+var DISCORD_API = "https://discord.com/api/v10";
+var MANAGE_GUILD_PERMISSION = 0x20n;
+var ADMIN_PERMISSION = 0x8n;
+function normalizeBasePath(basePath) {
+  if (!basePath || basePath === "/") return "/dashboard";
+  return basePath.startsWith("/") ? basePath : `/${basePath}`;
+}
+function canManageGuild(permissions) {
+  const value = BigInt(permissions);
+  return (value & MANAGE_GUILD_PERMISSION) === MANAGE_GUILD_PERMISSION || (value & ADMIN_PERMISSION) === ADMIN_PERMISSION;
+}
+function toQuery(params) {
+  const url = new URLSearchParams();
+  for (const [key, value] of Object.entries(params)) {
+    url.set(key, value);
+  }
+  return url.toString();
+}
+async function fetchDiscord(path, token) {
+  const response = await fetch(`${DISCORD_API}${path}`, {
+    headers: { Authorization: `Bearer ${token}` }
+  });
+  if (!response.ok) throw new Error(`Discord API request failed (${response.status})`);
+  return await response.json();
+}
+function getUserAvatarUrl(user) {
+  if (user.avatar) {
+    const ext = user.avatar.startsWith("a_") ? "gif" : "png";
+    return `https://cdn.discordapp.com/avatars/${user.id}/${user.avatar}.${ext}?size=256`;
+  }
+  const fallbackIndex = Number((BigInt(user.id) >> 22n) % 6n);
+  return `https://cdn.discordapp.com/embed/avatars/${fallbackIndex}.png`;
 }
+function getGuildIconUrl(guild) {
+  if (!guild.icon) return null;
+  const ext = guild.icon.startsWith("a_") ? "gif" : "png";
+  return `https://cdn.discordapp.com/icons/${guild.id}/${guild.icon}.${ext}?size=128`;
+}
+var DiscordDashboard = class {
+  app;
+  options;
+  helpers;
+  router;
+  server;
+  basePath;
+  templateRenderer;
+  plugins;
+  constructor(options) {
+    this.validateOptions(options);
+    this.options = options;
+    this.app = options.app ?? express();
+    this.router = express.Router();
+    this.helpers = new DiscordHelpers(options.botToken);
+    this.basePath = normalizeBasePath(options.basePath);
+    this.templateRenderer = this.resolveTemplateRenderer();
+    this.plugins = options.plugins ?? [];
+    if (!options.app && options.trustProxy !== void 0) {
+      this.app.set("trust proxy", options.trustProxy);
+    }
+    this.setupMiddleware();
+    this.setupRoutes();
+    this.app.use(this.basePath, this.router);
+  }
+  validateOptions(options) {
+    if (!options.botToken) throw new Error("botToken is required");
+    if (!options.clientId) throw new Error("clientId is required");
+    if (!options.clientSecret) throw new Error("clientSecret is required");
+    if (!options.redirectUri) throw new Error("redirectUri is required");
+    if (!options.sessionSecret) throw new Error("sessionSecret is required");
+  }
+  setupMiddleware() {
+    this.router.use(compression());
+    this.router.use(helmet({ contentSecurityPolicy: false }));
+    this.router.use(express.json());
+    this.router.use(
+      session({
+        name: this.options.sessionName ?? "discord_dashboard.sid",
+        secret: this.options.sessionSecret,
+        resave: false,
+        saveUninitialized: false,
+        cookie: {
+          httpOnly: true,
+          sameSite: "lax",
+          maxAge: this.options.sessionMaxAgeMs ?? 1e3 * 60 * 60 * 24 * 7
+        }
+      })
+    );
+  }
+  setupRoutes() {
+    this.router.get("/", this.handleRoot.bind(this));
+    this.router.get("/login", this.handleLogin.bind(this));
+    this.router.get("/callback", this.handleCallback.bind(this));
+    this.router.post("/logout", this.handleLogout.bind(this));
+    this.router.get("/api/session", this.handleSession.bind(this));
+    this.router.get("/api/guilds", this.ensureAuthenticated, this.handleGuilds.bind(this));
+    this.router.get("/api/overview", this.ensureAuthenticated, this.handleOverview.bind(this));
+    this.router.get("/api/home/categories", this.ensureAuthenticated, this.handleHomeCategories.bind(this));
+    this.router.get("/api/home", this.ensureAuthenticated, this.handleHome.bind(this));
+    this.router.get("/api/lookup/roles", this.ensureAuthenticated, this.handleLookupRoles.bind(this));
+    this.router.get("/api/lookup/channels", this.ensureAuthenticated, this.handleLookupChannels.bind(this));
+    this.router.get("/api/lookup/members", this.ensureAuthenticated, this.handleLookupMembers.bind(this));
+    this.router.post("/api/home/:actionId", this.ensureAuthenticated, this.handleHomeAction.bind(this));
+    this.router.get("/api/plugins", this.ensureAuthenticated, this.handlePlugins.bind(this));
+    this.router.post("/api/plugins/:pluginId/:actionId", this.ensureAuthenticated, this.handlePluginAction.bind(this));
+  }
+  // --- Start/Stop Methods ---
+  async start() {
+    if (this.options.app || this.server) return;
+    const port = this.options.port ?? 3e3;
+    const host = this.options.host ?? "0.0.0.0";
+    this.server = createServer(this.app);
+    return new Promise((resolve) => {
+      this.server.listen(port, host, () => resolve());
+    });
+  }
+  async stop() {
+    if (!this.server) return;
+    return new Promise((resolve, reject) => {
+      this.server.close((error) => {
+        if (error) return reject(error);
+        resolve();
+      });
+      this.server = void 0;
+    });
+  }
+  // --- Route Handlers ---
+  handleRoot(req, res) {
+    if (!req.session.discordAuth) {
+      res.redirect(`${this.basePath}/login`);
+      return;
+    }
+    res.setHeader("Cache-Control", "no-store");
+    res.type("html").send(
+      this.templateRenderer({
+        dashboardName: this.options.dashboardName ?? "Discord Dashboard",
+        basePath: this.basePath,
+        setupDesign: this.options.setupDesign
+      })
+    );
+  }
+  handleLogin(req, res) {
+    const state = randomBytes(16).toString("hex");
+    req.session.oauthState = state;
+    const scope = (this.options.scopes && this.options.scopes.length > 0 ? this.options.scopes : ["identify", "guilds"]).join(" ");
+    const query = toQuery({
+      client_id: this.options.clientId,
+      redirect_uri: this.options.redirectUri,
+      response_type: "code",
+      scope,
+      state,
+      prompt: "none"
+    });
+    res.redirect(`https://discord.com/oauth2/authorize?${query}`);
+  }
+  async handleCallback(req, res) {
+    try {
+      const code = typeof req.query.code === "string" ? req.query.code : void 0;
+      const state = typeof req.query.state === "string" ? req.query.state : void 0;
+      if (!code || !state) return res.status(400).send("Missing OAuth2 code/state");
+      if (!req.session.oauthState || req.session.oauthState !== state) return res.status(403).send("Invalid OAuth2 state");
+      const tokenData = await this.exchangeCodeForToken(code);
+      const [user, guilds] = await Promise.all([fetchDiscord("/users/@me", tokenData.access_token), fetchDiscord("/users/@me/guilds", tokenData.access_token)]);
+      req.session.discordAuth = {
+        accessToken: tokenData.access_token,
+        refreshToken: tokenData.refresh_token,
+        expiresAt: tokenData.expires_in ? Date.now() + tokenData.expires_in * 1e3 : void 0,
+        user,
+        guilds
+      };
+      req.session.oauthState = void 0;
+      res.redirect(this.basePath);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "OAuth callback failed";
+      res.status(500).send(message);
+    }
+  }
+  handleLogout(req, res) {
+    req.session.destroy((sessionError) => {
+      if (sessionError) return res.status(500).json({ ok: false, message: "Failed to destroy session" });
+      res.clearCookie(this.options.sessionName ?? "discord_dashboard.sid");
+      res.json({ ok: true });
+    });
+  }
+  handleSession(req, res) {
+    const auth = req.session.discordAuth;
+    if (!auth) return res.status(200).json({ authenticated: false });
+    const manageableGuildCount = auth.guilds.filter((guild) => guild.owner || canManageGuild(guild.permissions)).length;
+    res.json({
+      authenticated: true,
+      user: { ...auth.user, avatarUrl: getUserAvatarUrl(auth.user) },
+      guildCount: manageableGuildCount,
+      expiresAt: auth.expiresAt
+    });
+  }
+  async handleGuilds(req, res) {
+    const context = this.createContext(req);
+    if (this.options.ownerIds && this.options.ownerIds.length > 0 && !this.options.ownerIds.includes(context.user.id)) {
+      return res.status(403).json({ message: "You are not allowed to access this dashboard." });
+    }
+    let manageableGuilds = context.guilds.filter((guild) => guild.owner || canManageGuild(guild.permissions));
+    if (this.options.guildFilter) {
+      const filtered = [];
+      for (const guild of manageableGuilds) {
+        if (await this.options.guildFilter(guild, context)) filtered.push(guild);
+      }
+      manageableGuilds = filtered;
+    }
+    const botGuildIds = await this.fetchBotGuildIds();
+    const enrichedGuilds = manageableGuilds.map((guild) => {
+      const botInGuild = botGuildIds.has(guild.id);
+      return {
+        ...guild,
+        iconUrl: getGuildIconUrl(guild),
+        botInGuild,
+        inviteUrl: botInGuild ? void 0 : this.createGuildInviteUrl(guild.id)
+      };
+    });
+    res.json({ guilds: enrichedGuilds });
+  }
+  async handleOverview(req, res) {
+    const context = this.createContext(req);
+    const cards = await this.resolveOverviewCards(context);
+    res.json({ cards });
+  }
+  async handleHomeCategories(req, res) {
+    const context = this.createContext(req);
+    const activeScope = this.resolveScope(context);
+    const categories = await this.resolveHomeCategories(context);
+    const visible = categories.filter((item) => item.scope === "setup" || item.scope === activeScope);
+    res.json({ categories: visible, activeScope });
+  }
+  async handleHome(req, res) {
+    const context = this.createContext(req);
+    const activeScope = this.resolveScope(context);
+    const categoryId = typeof req.query.categoryId === "string" ? req.query.categoryId : void 0;
+    let sections = await this.resolveHomeSections(context);
+    sections = sections.filter((section) => {
+      const sectionScope = section.scope ?? activeScope;
+      if (sectionScope !== "setup" && sectionScope !== activeScope) return false;
+      if (!categoryId) return true;
+      return section.categoryId === categoryId;
+    });
+    res.json({ sections, activeScope });
+  }
+  async handleLookupRoles(req, res) {
+    const context = this.createContext(req);
+    const guildId = typeof req.query.guildId === "string" && req.query.guildId.length > 0 ? req.query.guildId : context.selectedGuildId;
+    if (!guildId) return res.status(400).json({ message: "guildId is required" });
+    const query = typeof req.query.q === "string" ? req.query.q : "";
+    const limit = typeof req.query.limit === "string" ? Number(req.query.limit) : void 0;
+    const includeManaged = typeof req.query.includeManaged === "string" ? req.query.includeManaged === "true" : void 0;
+    const roles = await context.helpers.searchGuildRoles(guildId, query, { limit: Number.isFinite(limit) ? limit : void 0, includeManaged });
+    res.json({ roles });
+  }
+  async handleLookupChannels(req, res) {
+    const context = this.createContext(req);
+    const guildId = typeof req.query.guildId === "string" && req.query.guildId.length > 0 ? req.query.guildId : context.selectedGuildId;
+    if (!guildId) return res.status(400).json({ message: "guildId is required" });
+    const query = typeof req.query.q === "string" ? req.query.q : "";
+    const limit = typeof req.query.limit === "string" ? Number(req.query.limit) : void 0;
+    const nsfw = typeof req.query.nsfw === "string" ? req.query.nsfw === "true" : void 0;
+    const channelTypes = typeof req.query.channelTypes === "string" ? req.query.channelTypes.split(",").map((item) => Number(item.trim())).filter((item) => Number.isFinite(item)) : void 0;
+    const channels = await context.helpers.searchGuildChannels(guildId, query, { limit: Number.isFinite(limit) ? limit : void 0, nsfw, channelTypes });
+    res.json({ channels });
+  }
+  async handleLookupMembers(req, res) {
+    const context = this.createContext(req);
+    const guildId = typeof req.query.guildId === "string" && req.query.guildId.length > 0 ? req.query.guildId : context.selectedGuildId;
+    if (!guildId) return res.status(400).json({ message: "guildId is required" });
+    const query = typeof req.query.q === "string" ? req.query.q : "";
+    const limit = typeof req.query.limit === "string" ? Number(req.query.limit) : void 0;
+    const members = await context.helpers.searchGuildMembers(guildId, query, { limit: Number.isFinite(limit) ? limit : void 0 });
+    res.json({ members });
+  }
+  async handleHomeAction(req, res) {
+    const context = this.createContext(req);
+    const action = this.options.home?.actions?.[req.params.actionId];
+    if (!action) return res.status(404).json({ ok: false, message: "Home action not found" });
+    const payload = req.body;
+    if (!payload || typeof payload.sectionId !== "string" || !payload.values || typeof payload.values !== "object") {
+      return res.status(400).json({ ok: false, message: "Invalid home action payload" });
+    }
+    try {
+      const result = await action(context, { sectionId: payload.sectionId, values: payload.values });
+      res.json(result);
+    } catch (error) {
+      res.status(500).json({ ok: false, message: error instanceof Error ? error.message : "Home action failed" });
+    }
+  }
+  async handlePlugins(req, res) {
+    const context = this.createContext(req);
+    const activeScope = context.selectedGuildId ? "guild" : "user";
+    const payload = [];
+    for (const plugin of this.plugins) {
+      const pluginScope = plugin.scope ?? "both";
+      if (pluginScope !== "both" && pluginScope !== activeScope) continue;
+      const panels = await plugin.getPanels(context);
+      payload.push({ id: plugin.id, name: plugin.name, description: plugin.description, panels });
+    }
+    res.json({ plugins: payload });
+  }
+  async handlePluginAction(req, res) {
+    const context = this.createContext(req);
+    const plugin = this.plugins.find((item) => item.id === req.params.pluginId);
+    if (!plugin) return res.status(404).json({ ok: false, message: "Plugin not found" });
+    const action = plugin.actions?.[req.params.actionId];
+    if (!action) return res.status(404).json({ ok: false, message: "Action not found" });
+    try {
+      const result = await action(context, req.body);
+      res.json(result);
+    } catch (error) {
+      res.status(500).json({ ok: false, message: error instanceof Error ? error.message : "Plugin action failed" });
+    }
+  }
+  // --- Internal Dashboard Resolvers & Helpers ---
+  ensureAuthenticated = (req, res, next) => {
+    if (!req.session.discordAuth) {
+      res.status(401).json({ authenticated: false, message: "Authentication required" });
+      return;
+    }
+    next();
+  };
+  createContext(req) {
+    const auth = req.session.discordAuth;
+    if (!auth) throw new Error("Not authenticated");
+    return {
+      user: auth.user,
+      guilds: auth.guilds,
+      accessToken: auth.accessToken,
+      selectedGuildId: typeof req.query.guildId === "string" ? req.query.guildId : void 0,
+      helpers: this.helpers
+    };
+  }
+  async exchangeCodeForToken(code) {
+    const response = await fetch(`${DISCORD_API}/oauth2/token`, {
+      method: "POST",
+      headers: { "Content-Type": "application/x-www-form-urlencoded" },
+      body: toQuery({
+        client_id: this.options.clientId,
+        client_secret: this.options.clientSecret,
+        grant_type: "authorization_code",
+        code,
+        redirect_uri: this.options.redirectUri
+      })
+    });
+    if (!response.ok) throw new Error(`Failed token exchange: ${response.status} ${await response.text()}`);
+    return await response.json();
+  }
+  async resolveOverviewCards(context) {
+    if (this.options.getOverviewCards) return await this.options.getOverviewCards(context);
+    const manageableGuildCount = context.guilds.filter((guild) => guild.owner || canManageGuild(guild.permissions)).length;
+    return [
+      { id: "user", title: "Logged-in User", value: context.user.global_name || context.user.username, subtitle: `ID: ${context.user.id}`, intent: "info" },
+      { id: "guilds", title: "Manageable Guilds", value: manageableGuildCount, subtitle: "Owner or Manage Server permissions", intent: "success" },
+      { id: "plugins", title: "Plugins Loaded", value: this.plugins.length, subtitle: "Dynamic server modules", intent: "neutral" }
+    ];
+  }
+  async resolveHomeSections(context) {
+    const customSections = this.options.home?.getSections ? await this.options.home.getSections(context) : [];
+    const overviewSections = this.options.home?.getOverviewSections ? await this.options.home.getOverviewSections(context) : [];
+    if (customSections.length > 0 || overviewSections.length > 0) {
+      const normalizedOverview = overviewSections.map((section) => ({ ...section, categoryId: section.categoryId ?? "overview" }));
+      return [...normalizedOverview, ...customSections];
+    }
+    const selectedGuild = context.selectedGuildId ? context.guilds.find((guild) => guild.id === context.selectedGuildId) : void 0;
+    return [
+      {
+        id: "setup",
+        title: "Setup Details",
+        description: "Core dashboard setup information",
+        scope: "setup",
+        categoryId: "setup",
+        fields: [
+          { id: "dashboardName", label: "Dashboard Name", type: "text", value: this.options.dashboardName ?? "Discord Dashboard", readOnly: true },
+          { id: "basePath", label: "Base Path", type: "text", value: this.basePath, readOnly: true }
+        ]
+      },
+      {
+        id: "context",
+        title: "Dashboard Context",
+        description: selectedGuild ? `Managing ${selectedGuild.name}` : "Managing user dashboard",
+        scope: this.resolveScope(context),
+        categoryId: "overview",
+        fields: [
+          { id: "mode", label: "Mode", type: "text", value: selectedGuild ? "Guild" : "User", readOnly: true },
+          { id: "target", label: "Target", type: "text", value: selectedGuild ? selectedGuild.name : context.user.username, readOnly: true }
+        ]
+      }
+    ];
+  }
+  resolveScope(context) {
+    return context.selectedGuildId ? "guild" : "user";
+  }
+  async resolveHomeCategories(context) {
+    if (this.options.home?.getCategories) {
+      const categories = await this.options.home.getCategories(context);
+      return [...categories].sort((a, b) => a.id === "overview" ? -1 : b.id === "overview" ? 1 : 0);
+    }
+    return [
+      { id: "overview", label: "Overview", scope: this.resolveScope(context) },
+      { id: "setup", label: "Setup", scope: "setup" }
+    ];
+  }
+  createGuildInviteUrl(guildId) {
+    const scopes = this.options.botInviteScopes && this.options.botInviteScopes.length > 0 ? this.options.botInviteScopes : ["bot", "applications.commands"];
+    return `https://discord.com/oauth2/authorize?${toQuery({
+      client_id: this.options.clientId,
+      scope: scopes.join(" "),
+      permissions: this.options.botInvitePermissions ?? "8",
+      guild_id: guildId,
+      disable_guild_select: "true"
+    })}`;
+  }
+  async fetchBotGuildIds() {
+    const response = await fetch(`${DISCORD_API}/users/@me/guilds`, { headers: { Authorization: `Bot ${this.options.botToken}` } });
+    if (!response.ok) return /* @__PURE__ */ new Set();
+    const guilds = await response.json();
+    return new Set(guilds.map((guild) => guild.id));
+  }
+  resolveTemplateRenderer() {
+    const selectedTemplate = this.options.uiTemplate ?? "default";
+    const defaultRenderer = ({ dashboardName, basePath, setupDesign }) => renderDashboardHtml(dashboardName, basePath, setupDesign);
+    const customRenderer = this.options.uiTemplates?.[selectedTemplate];
+    if (customRenderer) return customRenderer;
+    const builtinRenderer = getBuiltinTemplateRenderer(selectedTemplate);
+    if (builtinRenderer) return builtinRenderer;
+    if (selectedTemplate !== "default") throw new Error(`Unknown uiTemplate '${selectedTemplate}'. Register it in uiTemplates.`);
+    return defaultRenderer;
+  }
+};
 export {
   DashboardDesigner,
+  DiscordDashboard,
+  DiscordHelpers,
   builtinTemplateRenderers,
-  createDashboard,
-  createDashboardDesigner,
-  createDiscordHelpers,
   getBuiltinTemplateRenderer
 };
 //# sourceMappingURL=index.js.map