@eddydesk/admin

Server-side admin SDK for EddyDesk — the QA platform for bug tracking, test management, email testing, auto-monitoring, and AI-powered QA testing.

Use this package for any server-side code that needs EddyDesk data: dashboards, CI/CD gates, deploy checks, analytics scripts, scheduled jobs.

For client-side widget integration, install @eddydesk/react or @eddydesk/react-native instead.

Install

npm install @eddydesk/admin

Two usage patterns

Class-based (binds credentials once)

import { EddyDeskAdmin } from '@eddydesk/admin';

const admin = new EddyDeskAdmin({
  supabaseUrl: process.env.EDDYDESK_SUPABASE_URL!,
  supabaseKey: process.env.EDDYDESK_SERVICE_ROLE_KEY!,
  projectId: process.env.EDDYDESK_PROJECT_ID!,
});

const { reports } = await admin.listReports({ limit: 10, status: 'new' });
const { testCases } = await admin.listTestCases({ limit: 50 });

Standalone functions (tree-shakeable)

import { listReports, getReport } from '@eddydesk/admin';
const result = await listReports(supabase, projectId, { limit: 10 });

What's inside

| Module | Functions | |--------|-----------| | reports | listReports, getReport, searchReports, updateReportStatus, bulkUpdateReports, getReportContext, addReportComment, getReportComments, resolveConversations | | tests | createTestCase, updateTestCase, deleteTestCases, listTestCases, listTestRuns, createTestRun, listTestAssignments, assignTests, unassignTests, enqueueTestRetest | | intelligence | getBugPatterns, suggestTestCases, getTestPriorities, getCoverageGaps, getRegressions, getCoverageMatrix, getStaleCoverage, generateDeployChecklist, getQAHealth, getQASessions, getQAAlerts | | bugs | createBugReport, getBugsForFile, markFixedWithCommit, getBugsAffectingCode, linkBugToCode, createRegressionTest | | deploy | getDeploymentAnalysis, getTesterRecommendations, analyzeCommitForTesting, getTestingPatterns, analyzeChangesForTests | | fixes | getPendingFixes, claimFixRequest, completeFixRequest | | team | listTesters, createTester, updateTester, getTesterWorkload, getTesterLeaderboard, getTesterReport | | analytics | getBugTrends, exportTestResults, getTestingVelocity | | messaging | listThreads, getThreadMessages, sendMessage, createThread, getUnreadSummary | | email | listCapturedEmails, getEmailPreview, getEmailCoverage | | monitoring | getAutoDetectedIssues, generateTestsFromErrors |

Do NOT use raw Supabase queries against EddyDesk tables in server code. The admin SDK handles auth, pagination, type safety, and stays aligned with the MCP tool surface that Claude Code uses.

Links

• Dashboard: https://app.eddydesk.ai
• Docs: https://github.com/Bear-Eddy/eddydesk
• MCP server (Claude Code integration): @eddydesk/mcp-server