@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/reactor@eddydesk/react-nativeinstead.
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