@cyanheads/college-scorecard-mcp-server 0.1.1

package/dist/services/scorecard/scorecard-service.js

@@ -0,0 +1,376 @@
+/**
+ * @fileoverview College Scorecard API service. Wraps the api.data.gov/ed/collegescorecard/v1
+ * endpoint with retry, field selection, and pagination support.
+ * @module services/scorecard/scorecard-service
+ */
+import { notFound, serviceUnavailable } from '@cyanheads/mcp-ts-core/errors';
+import { withRetry } from '@cyanheads/mcp-ts-core/utils';
+import { getServerConfig } from '../../config/server-config.js';
+const BASE_URL = 'https://api.data.gov/ed/collegescorecard/v1/schools';
+/** Default curated fields for school search results */
+const SEARCH_DEFAULT_FIELDS = [
+    'id',
+    'school.name',
+    'school.city',
+    'school.state',
+    'school.ownership',
+    'school.degrees_awarded.predominant',
+    'latest.student.size',
+    'latest.admissions.admission_rate.overall',
+    'latest.cost.tuition.in_state',
+    'latest.cost.tuition.out_of_state',
+    'latest.cost.avg_net_price.overall',
+    'latest.aid.median_debt.completers.overall',
+    'latest.earnings.6_yrs_after_entry.median',
+].join(',');
+/** Default fields for full school profile */
+const PROFILE_DEFAULT_FIELDS = [
+    'id',
+    'school.name',
+    'school.city',
+    'school.state',
+    'school.zip',
+    'school.school_url',
+    'school.ownership',
+    'school.carnegie_basic',
+    'school.locale',
+    'school.degrees_awarded.predominant',
+    'school.hbcu',
+    'school.men_only',
+    'school.women_only',
+    'latest.student.size',
+    'latest.admissions.admission_rate.overall',
+    'latest.admissions.sat_scores.average.overall',
+    'latest.admissions.sat_scores.25th_percentile.critical_reading',
+    'latest.admissions.sat_scores.75th_percentile.critical_reading',
+    'latest.admissions.sat_scores.25th_percentile.math',
+    'latest.admissions.sat_scores.75th_percentile.math',
+    'latest.admissions.act_scores.25th_percentile.cumulative',
+    'latest.admissions.act_scores.75th_percentile.cumulative',
+    'latest.cost.tuition.in_state',
+    'latest.cost.tuition.out_of_state',
+    'latest.cost.avg_net_price.overall',
+    'latest.cost.avg_net_price.by_income.0-30000',
+    'latest.cost.avg_net_price.by_income.30001-48000',
+    'latest.cost.avg_net_price.by_income.48001-75000',
+    'latest.cost.avg_net_price.by_income.75001-110000',
+    'latest.cost.avg_net_price.by_income.110001-plus',
+    'latest.cost.attendance.academic_year',
+    'latest.aid.median_debt.completers.overall',
+    'latest.aid.pell_grant_rate',
+    'latest.aid.federal_loan_rate',
+    'latest.repayment.3_yr_repayment.overall',
+    'latest.completion.rate_suppressed.overall',
+    'latest.earnings.6_yrs_after_entry.median',
+    'latest.earnings.6_yrs_after_entry.percentile25',
+    'latest.earnings.6_yrs_after_entry.percentile75',
+    'latest.earnings.8_yrs_after_entry.median_earnings',
+    'latest.earnings.10_yrs_after_entry.median',
+    'latest.earnings.10_yrs_after_entry.percentile25',
+    'latest.earnings.10_yrs_after_entry.percentile75',
+].join(',');
+/** Default fields for earnings time series */
+const EARNINGS_DEFAULT_FIELDS = [
+    'id',
+    'school.name',
+    'latest.earnings.6_yrs_after_entry.median',
+    'latest.earnings.6_yrs_after_entry.percentile25',
+    'latest.earnings.6_yrs_after_entry.percentile75',
+    'latest.earnings.8_yrs_after_entry.median_earnings',
+    'latest.earnings.10_yrs_after_entry.median',
+    'latest.earnings.10_yrs_after_entry.percentile25',
+    'latest.earnings.10_yrs_after_entry.percentile75',
+    'latest.earnings.6_yrs_after_entry.female_students.median_earnings',
+    'latest.earnings.6_yrs_after_entry.male_students.median_earnings',
+].join(',');
+/** Fields for program-level data */
+const PROGRAMS_DEFAULT_FIELDS = ['id', 'school.name', 'latest.programs.cip_4_digit'].join(',');
+export class ScorecardService {
+    apiKey;
+    constructor(_config, _storage) {
+        this.apiKey = getServerConfig().apiKey;
+    }
+    /** Build URL with query parameters */
+    buildUrl(params) {
+        const url = new URL(BASE_URL);
+        url.searchParams.set('api_key', this.apiKey);
+        for (const [key, value] of Object.entries(params)) {
+            if (value !== undefined && value !== '') {
+                url.searchParams.set(key, String(value));
+            }
+        }
+        return url.toString();
+    }
+    /** Fetch from the API with retry and error classification */
+    fetchApi(params, ctx) {
+        const url = this.buildUrl(params);
+        ctx.log.debug('Fetching Scorecard API', { path: url.replace(/api_key=[^&]+/, 'api_key=***') });
+        return withRetry(async () => {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), 30_000);
+            const signal = ctx.signal
+                ? AbortSignal.any([ctx.signal, controller.signal])
+                : controller.signal;
+            let response;
+            try {
+                response = await fetch(url, { signal });
+            }
+            finally {
+                clearTimeout(timer);
+            }
+            if (!response.ok) {
+                const status = response.status;
+                if (status === 429)
+                    throw serviceUnavailable(`Scorecard API rate limit exceeded (HTTP 429).`);
+                if (status === 403 || status === 401)
+                    throw serviceUnavailable(`Scorecard API key rejected (HTTP ${status}) — verify SCORECARD_API_KEY.`);
+                if (status >= 500)
+                    throw serviceUnavailable(`Scorecard API unavailable (HTTP ${status}).`);
+                throw serviceUnavailable(`Scorecard API returned HTTP ${status}.`);
+            }
+            const text = await response.text();
+            // Detect HTML error pages
+            if (/^\s*<(!DOCTYPE\s+html|html[\s>])/i.test(text)) {
+                throw serviceUnavailable('Scorecard API returned HTML instead of JSON — likely rate-limited or unavailable.');
+            }
+            let body;
+            try {
+                body = JSON.parse(text);
+            }
+            catch {
+                throw serviceUnavailable('Scorecard API returned non-JSON response.', {
+                    body: text.slice(0, 200),
+                });
+            }
+            const data = body;
+            // Check for API-level errors
+            if (data.error || (Array.isArray(data.errors) && data.errors.length > 0)) {
+                const apiErr = data;
+                const msg = apiErr.error?.message ??
+                    apiErr.errors?.[0]?.message ??
+                    'Scorecard API returned an error.';
+                const code = apiErr.error?.code ?? apiErr.errors?.[0]?.error;
+                if (code === 'API_KEY_MISSING' || code === 'API_KEY_INVALID') {
+                    throw serviceUnavailable(`Scorecard API key error: ${msg} — verify SCORECARD_API_KEY is valid.`);
+                }
+                throw serviceUnavailable(`Scorecard API error: ${msg}`, { code });
+            }
+            if (!data.results || !data.metadata) {
+                throw serviceUnavailable('Scorecard API returned unexpected response shape.', {
+                    keys: Object.keys(data),
+                });
+            }
+            return data;
+        }, {
+            operation: 'ScorecardService.fetchApi',
+            baseDelayMs: 1000,
+            signal: ctx.signal,
+        });
+    }
+    /** Search schools with filter params */
+    searchSchools(options, ctx) {
+        const params = {
+            fields: options.fields ?? SEARCH_DEFAULT_FIELDS,
+            per_page: options.perPage ?? 20,
+            page: options.page ?? 0,
+        };
+        if (options.name)
+            params['school.name'] = options.name;
+        if (options.state)
+            params['school.state'] = options.state;
+        if (options.ownership != null)
+            params['school.ownership'] = options.ownership;
+        if (options.degreeLevel != null)
+            params['school.degrees_awarded.predominant'] = options.degreeLevel;
+        if (options.sizeRange) {
+            const [min, max] = options.sizeRange;
+            params['latest.student.size__range'] = `${min}..${max}`;
+        }
+        if (options.acceptanceRateRange) {
+            const [min, max] = options.acceptanceRateRange;
+            params['latest.admissions.admission_rate.overall__range'] = `${min}..${max}`;
+        }
+        if (options.zip)
+            params.zip = options.zip;
+        if (options.distance)
+            params.distance = options.distance;
+        if (options.cipCode)
+            params['latest.programs.cip_4_digit.code'] = options.cipCode.replace('.', '');
+        if (options.sort)
+            params.sort = options.sort;
+        if (options.extraParams) {
+            for (const [k, v] of Object.entries(options.extraParams)) {
+                params[k] = v;
+            }
+        }
+        return this.fetchApi(params, ctx);
+    }
+    /** Fetch one or more school profiles by ID */
+    getSchoolProfiles(ids, fields, ctx) {
+        if (ids.length === 0)
+            throw notFound('No school IDs provided.');
+        const params = {
+            id: ids.join(','),
+            fields: fields ?? PROFILE_DEFAULT_FIELDS,
+            per_page: Math.min(ids.length, 100),
+        };
+        return this.fetchApi(params, ctx);
+    }
+    /** Fetch program data for a school */
+    getSchoolPrograms(id, cipCode, _minEarnings, _credentialLevel, ctx) {
+        const params = {
+            id: String(id),
+            fields: PROGRAMS_DEFAULT_FIELDS,
+            per_page: 1,
+        };
+        if (cipCode) {
+            params['latest.programs.cip_4_digit.code'] = cipCode.replace('.', '');
+        }
+        return this.fetchApi(params, ctx);
+    }
+    /** Fetch earnings time series for a school */
+    getSchoolEarnings(id, years, ctx) {
+        const yearFields = years.length > 0
+            ? years
+                .flatMap((y) => [
+                `${y}.earnings.6_yrs_after_entry.median`,
+                `${y}.earnings.10_yrs_after_entry.median`,
+            ])
+                .join(',')
+            : '';
+        const params = {
+            id: String(id),
+            fields: yearFields ? `${EARNINGS_DEFAULT_FIELDS},${yearFields}` : EARNINGS_DEFAULT_FIELDS,
+            per_page: 1,
+        };
+        return this.fetchApi(params, ctx);
+    }
+    /** Search programs across schools */
+    searchPrograms(options, ctx) {
+        const params = {
+            fields: [
+                'id',
+                'school.name',
+                'school.state',
+                'school.ownership',
+                'latest.cost.avg_net_price.overall',
+                'latest.programs.cip_4_digit',
+            ].join(','),
+            per_page: options.perPage ?? 20,
+            page: options.page ?? 0,
+        };
+        if (options.cipCode)
+            params['latest.programs.cip_4_digit.code'] = options.cipCode.replace('.', '');
+        if (options.state)
+            params['school.state'] = options.state;
+        if (options.ownership != null)
+            params['school.ownership'] = options.ownership;
+        if (options.maxNetPrice != null)
+            params['latest.cost.avg_net_price.overall__range'] = `..${options.maxNetPrice}`;
+        if (options.minEarnings != null) {
+            params['latest.programs.cip_4_digit.earnings.highest.1_yr.overall_median_earnings__range'] =
+                `${options.minEarnings}..`;
+        }
+        if (options.maxDebt != null) {
+            params['latest.programs.cip_4_digit.debt.median_debt__range'] = `..${options.maxDebt}`;
+        }
+        return this.fetchApi(params, ctx);
+    }
+    /** Fetch fields for value analysis (cost + earnings in parallel) */
+    getValueAnalysisData(id, ctx) {
+        const costFields = [
+            'id',
+            'school.name',
+            'school.carnegie_basic',
+            'school.ownership',
+            'latest.cost.tuition.in_state',
+            'latest.cost.tuition.out_of_state',
+            'latest.cost.avg_net_price.overall',
+            'latest.cost.avg_net_price.by_income.0-30000',
+            'latest.cost.avg_net_price.by_income.30001-48000',
+            'latest.cost.avg_net_price.by_income.48001-75000',
+            'latest.cost.avg_net_price.by_income.75001-110000',
+            'latest.cost.avg_net_price.by_income.110001-plus',
+            'latest.aid.median_debt.completers.overall',
+            'latest.repayment.3_yr_repayment.overall',
+            'latest.completion.rate_suppressed.overall',
+        ].join(',');
+        const earningsFields = [
+            'id',
+            'latest.earnings.6_yrs_after_entry.median',
+            'latest.earnings.6_yrs_after_entry.percentile25',
+            'latest.earnings.6_yrs_after_entry.percentile75',
+            'latest.earnings.8_yrs_after_entry.median_earnings',
+            'latest.earnings.10_yrs_after_entry.median',
+        ].join(',');
+        return Promise.all([
+            this.fetchApi({ id: String(id), fields: costFields, per_page: 1 }, ctx),
+            this.fetchApi({ id: String(id), fields: earningsFields, per_page: 1 }, ctx),
+        ]);
+    }
+    /** Fetch comparison data for multiple schools on a specific topic */
+    getComparisonData(ids, topic, ctx) {
+        const topicFields = {
+            costs: [
+                'id',
+                'school.name',
+                'latest.cost.tuition.in_state',
+                'latest.cost.tuition.out_of_state',
+                'latest.cost.avg_net_price.overall',
+                'latest.cost.avg_net_price.by_income.0-30000',
+                'latest.cost.avg_net_price.by_income.30001-48000',
+                'latest.cost.avg_net_price.by_income.48001-75000',
+                'latest.cost.avg_net_price.by_income.75001-110000',
+                'latest.cost.avg_net_price.by_income.110001-plus',
+                'latest.aid.median_debt.completers.overall',
+            ].join(','),
+            admissions: [
+                'id',
+                'school.name',
+                'latest.admissions.admission_rate.overall',
+                'latest.admissions.sat_scores.average.overall',
+                'latest.admissions.sat_scores.25th_percentile.math',
+                'latest.admissions.sat_scores.75th_percentile.math',
+                'latest.admissions.act_scores.25th_percentile.cumulative',
+                'latest.admissions.act_scores.75th_percentile.cumulative',
+                'latest.student.size',
+            ].join(','),
+            outcomes: [
+                'id',
+                'school.name',
+                'latest.completion.rate_suppressed.overall',
+                'latest.earnings.6_yrs_after_entry.median',
+                'latest.earnings.10_yrs_after_entry.median',
+                'latest.repayment.3_yr_repayment.overall',
+                'latest.aid.median_debt.completers.overall',
+            ].join(','),
+            aid: [
+                'id',
+                'school.name',
+                'latest.aid.pell_grant_rate',
+                'latest.aid.federal_loan_rate',
+                'latest.aid.median_debt.completers.overall',
+                'latest.repayment.3_yr_repayment.overall',
+                'latest.cost.avg_net_price.overall',
+            ].join(','),
+        };
+        const params = {
+            id: ids.join(','),
+            fields: topicFields[topic],
+            per_page: ids.length,
+        };
+        return this.fetchApi(params, ctx);
+    }
+}
+// --- Init/accessor pattern ---
+let _service;
+export function initScorecardService(config, storage) {
+    _service = new ScorecardService(config, storage);
+}
+export function getScorecardService() {
+    if (!_service) {
+        throw new Error('ScorecardService not initialized — call initScorecardService() in setup()');
+    }
+    return _service;
+}
+//# sourceMappingURL=scorecard-service.js.map

package/dist/services/scorecard/scorecard-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorecard-service.js","sourceRoot":"","sources":["../../../src/services/scorecard/scorecard-service.ts"],"names":[],"mappings":"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"}

package/dist/services/scorecard/types.d.ts

@@ -0,0 +1,131 @@
+/**
+ * @fileoverview Domain types for College Scorecard API responses.
+ * @module services/scorecard/types
+ */
+/** Nested program object returned under `latest.programs.cip_4_digit` */
+export interface RawProgram {
+    code?: string;
+    counts?: {
+        ipeds_enrollment?: number | null;
+    };
+    credential?: {
+        level?: number | null;
+        title?: string | null;
+    };
+    debt?: {
+        median_debt?: number | null;
+    };
+    earnings?: {
+        highest?: {
+            '1_yr'?: {
+                overall_median_earnings?: number | null;
+                overall_count_titleiv?: number | null;
+            };
+        };
+    };
+    title?: string;
+}
+/** Raw school record from the Scorecard API (fields vary by query). */
+export interface RawSchoolRecord {
+    id?: number;
+    'latest.admissions.act_scores.25th_percentile.cumulative'?: number | null;
+    'latest.admissions.act_scores.75th_percentile.cumulative'?: number | null;
+    'latest.admissions.admission_rate.overall'?: number | null;
+    'latest.admissions.sat_scores.25th_percentile.critical_reading'?: number | null;
+    'latest.admissions.sat_scores.25th_percentile.math'?: number | null;
+    'latest.admissions.sat_scores.75th_percentile.critical_reading'?: number | null;
+    'latest.admissions.sat_scores.75th_percentile.math'?: number | null;
+    'latest.admissions.sat_scores.average.overall'?: number | null;
+    'latest.aid.federal_loan_rate'?: number | null;
+    'latest.aid.median_debt.completers.overall'?: number | null;
+    'latest.aid.pell_grant_rate'?: number | null;
+    'latest.completion.rate_suppressed.overall'?: number | null;
+    'latest.cost.attendance.academic_year'?: number | null;
+    'latest.cost.avg_net_price.by_income.0-30000'?: number | null;
+    'latest.cost.avg_net_price.by_income.30001-48000'?: number | null;
+    'latest.cost.avg_net_price.by_income.48001-75000'?: number | null;
+    'latest.cost.avg_net_price.by_income.75001-110000'?: number | null;
+    'latest.cost.avg_net_price.by_income.110001-plus'?: number | null;
+    'latest.cost.avg_net_price.overall'?: number | null;
+    'latest.cost.tuition.in_state'?: number | null;
+    'latest.cost.tuition.out_of_state'?: number | null;
+    'latest.earnings.6_yrs_after_entry.female_students.median_earnings'?: number | null;
+    'latest.earnings.6_yrs_after_entry.male_students.median_earnings'?: number | null;
+    'latest.earnings.6_yrs_after_entry.median'?: number | null;
+    'latest.earnings.6_yrs_after_entry.percentile25'?: number | null;
+    'latest.earnings.6_yrs_after_entry.percentile75'?: number | null;
+    'latest.earnings.8_yrs_after_entry.median_earnings'?: number | null;
+    'latest.earnings.10_yrs_after_entry.median'?: number | null;
+    'latest.earnings.10_yrs_after_entry.percentile25'?: number | null;
+    'latest.earnings.10_yrs_after_entry.percentile75'?: number | null;
+    'latest.programs.cip_4_digit'?: RawProgram[];
+    'latest.repayment.3_yr_repayment.overall'?: number | null;
+    'latest.student.size'?: number | null;
+    'school.carnegie_basic'?: number | null;
+    'school.city'?: string;
+    'school.degrees_awarded.predominant'?: number | null;
+    'school.hbcu'?: number | null;
+    'school.institutional_characteristics.level'?: number | null;
+    'school.locale'?: number | null;
+    'school.men_only'?: number | null;
+    'school.name'?: string;
+    'school.ownership'?: number | null;
+    'school.school_url'?: string;
+    'school.state'?: string;
+    'school.women_only'?: number | null;
+    'school.zip'?: string;
+    [key: string]: unknown;
+}
+/** Raw API response envelope */
+export interface ScorecardApiResponse {
+    metadata: {
+        total: number;
+        page: number;
+        per_page: number;
+    };
+    results: RawSchoolRecord[];
+}
+/** Error shape returned by the Scorecard API */
+export interface ScorecardApiError {
+    error?: {
+        code?: string;
+        message?: string;
+    };
+    errors?: Array<{
+        error?: string;
+        input?: string;
+        message?: string;
+    }>;
+}
+/** Options for a search query */
+export interface ScorecardSearchOptions {
+    /** Acceptance rate range [min, max] 0-1 */
+    acceptanceRateRange?: [number, number];
+    /** CIP code filter */
+    cipCode?: string;
+    /** Predominant degree level: 0-4 */
+    degreeLevel?: number;
+    /** Distance from zip (e.g. "50mi") */
+    distance?: string;
+    /** Additional query params */
+    extraParams?: Record<string, string | number>;
+    /** Custom field selection (comma-separated) */
+    fields?: string;
+    /** School unit ID(s) for batch lookup */
+    id?: string | number | Array<string | number>;
+    /** School name full-text filter */
+    name?: string;
+    /** Ownership type: 1=public, 2=private nonprofit, 3=for-profit */
+    ownership?: number;
+    page?: number;
+    perPage?: number;
+    /** Enrollment size range [min, max] */
+    sizeRange?: [number, number];
+    /** Sort expression (e.g. "latest.cost.tuition.in_state:asc") */
+    sort?: string;
+    /** Two-letter state code */
+    state?: string;
+    /** US zip code for geographic filter */
+    zip?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/scorecard/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/scorecard/types.ts"],"names":[],"mappings":"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"}

package/dist/services/scorecard/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Domain types for College Scorecard API responses.
+ * @module services/scorecard/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/scorecard/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/scorecard/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@cyanheads/college-scorecard-mcp-server",
+  "version": "0.1.1",
+  "description": "Search, compare, and analyze U.S. college data — costs, earnings, programs, and outcomes — via MCP. STDIO or Streamable HTTP.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "college-scorecard-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "changelog/",
+    "dist/",
+    "README.md",
+    "LICENSE",
+    "CLAUDE.md",
+    "Dockerfile",
+    "server.json"
+  ],
+  "scripts": {
+    "build": "tsx scripts/build.ts",
+    "rebuild": "tsx scripts/clean.ts && tsx scripts/build.ts",
+    "clean": "tsx scripts/clean.ts",
+    "devcheck": "tsx scripts/devcheck.ts",
+    "audit:refresh": "rm -f bun.lock && bun install && bun audit",
+    "tree": "tsx scripts/tree.ts",
+    "list-skills": "tsx scripts/list-skills.ts",
+    "format": "biome check --write --unsafe .",
+    "lint:mcp": "tsx scripts/lint-mcp.ts",
+    "lint:packaging": "tsx scripts/lint-packaging.ts",
+    "bundle": "npm run build && npx -y @anthropic-ai/mcpb pack . dist/college-scorecard-mcp-server.mcpb",
+    "changelog:build": "tsx scripts/build-changelog.ts",
+    "changelog:check": "tsx scripts/build-changelog.ts --check",
+    "test": "vitest run",
+    "start": "node dist/index.js",
+    "start:stdio": "MCP_TRANSPORT_TYPE=stdio node dist/index.js",
+    "start:http": "MCP_TRANSPORT_TYPE=http node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "college-scorecard",
+    "higher-education",
+    "department-of-education",
+    "college-search",
+    "university-data",
+    "financial-aid",
+    "student-outcomes",
+    "post-graduation-earnings",
+    "college-comparison"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cyanheads/college-scorecard-mcp-server.git"
+  },
+  "license": "Apache-2.0",
+  "engines": {
+    "bun": ">=1.3.0",
+    "node": ">=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cyanheads/mcp-ts-core": "^0.9.9",
+    "pino-pretty": "^13.1.3",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.15",
+    "@types/node": "^25.9.1",
+    "depcheck": "^1.4.7",
+    "ignore": "^7.0.5",
+    "tsc-alias": "^1.8.17",
+    "tsx": "^4.22.3",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7"
+  }
+}