pub-mcp 0.1.0

package/dist/tools/index.d.ts

@@ -0,0 +1,142 @@
+import { z } from 'zod';
+import type { PubClient } from '../clients/pubClient.js';
+import type { GitHubClient } from '../clients/githubClient.js';
+export declare const searchPackagesSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    limit: number;
+}, {
+    query: string;
+    limit?: number | undefined;
+}>;
+export declare const getPackageInfoSchema: z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+}, {
+    name: string;
+}>;
+export declare const getPackageVersionsSchema: z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+}, {
+    name: string;
+}>;
+export declare const getReadmeSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodDefault<z.ZodEnum<["markdown", "text", "html"]>>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    version?: string | undefined;
+    format?: "markdown" | "text" | "html" | undefined;
+}, {
+    name: string;
+    version?: string | undefined;
+    format?: "markdown" | "text" | "html" | undefined;
+}>;
+export declare const getDependenciesSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    version?: string | undefined;
+}, {
+    name: string;
+    version?: string | undefined;
+}>;
+export declare const getPackageScoreSchema: z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+}, {
+    name: string;
+}>;
+export declare const getChangelogSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    version?: string | undefined;
+}, {
+    name: string;
+    version?: string | undefined;
+}>;
+export declare const getPackageMetricsSchema: z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+}, {
+    name: string;
+}>;
+export type SearchPackagesInput = {
+    query: string;
+    limit?: number;
+};
+export type GetPackageInfoInput = {
+    name: string;
+};
+export type GetPackageVersionsInput = {
+    name: string;
+};
+export type GetReadmeInput = {
+    name: string;
+    version?: string;
+    format?: 'markdown' | 'text' | 'html';
+};
+export type GetDependenciesInput = {
+    name: string;
+    version?: string;
+};
+export type GetPackageScoreInput = {
+    name: string;
+};
+export type GetChangelogInput = {
+    name: string;
+    version?: string;
+};
+export type GetPackageMetricsInput = {
+    name: string;
+};
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+export declare const tools: ToolDefinition[];
+export declare function handleSearchPackages(client: PubClient, input: SearchPackagesInput): Promise<{
+    packages: {
+        name: string;
+        description: string;
+        latestVersion: string;
+    }[];
+    total: number;
+}>;
+export declare function handleGetPackageInfo(client: PubClient, input: GetPackageInfoInput): Promise<import("../types/index.js").PackageInfo>;
+export declare function handleGetPackageVersions(client: PubClient, input: GetPackageVersionsInput): Promise<{
+    versions: import("../types/index.js").PackageVersion[];
+}>;
+export declare function handleGetReadme(client: PubClient, githubClient: GitHubClient, input: GetReadmeInput): Promise<{
+    readme: string;
+    source: string;
+    format: string;
+}>;
+export declare function handleGetDependencies(client: PubClient, input: GetDependenciesInput): Promise<{
+    dependencies: Record<string, string>;
+}>;
+export declare function handleGetPackageScore(client: PubClient, input: GetPackageScoreInput): Promise<import("../types/index.js").PackageScore>;
+export declare function handleGetChangelog(client: PubClient, input: GetChangelogInput): Promise<import("../types/index.js").PackageChangelog>;
+export declare function handleGetPackageMetrics(client: PubClient, input: GetPackageMetricsInput): Promise<{
+    info: import("../types/index.js").PackageInfo;
+    score: import("../types/index.js").PackageScore;
+    versionCount: number;
+    latestVersion: string;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG/D,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;EAE/B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;EAEnC,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;EAI1B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;EAGhC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;EAEhC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;EAElC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACpE,MAAM,MAAM,mBAAmB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AACnD,MAAM,MAAM,uBAAuB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AACvD,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;CACvC,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AACpD,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACnE,MAAM,MAAM,sBAAsB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,eAAO,MAAM,KAAK,EAAE,cAAc,EAkGjC,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,mBAAmB;;;;;;;GAUvF;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,mBAAmB,oDAGvF;AAED,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,uBAAuB;;GAG/F;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,cAAc;;;;GAoCtB;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,oBAAoB;;GAGzF;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,oBAAoB,qDAGzF;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,yDAYnF;AAED,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,sBAAsB;;;;;GAa7F"}

package/dist/tools/index.js

@@ -0,0 +1,214 @@
+import { z } from 'zod';
+import { parseGitHubUrl } from '../clients/githubClient.js';
+export const searchPackagesSchema = z.object({
+    query: z.string().min(1),
+    limit: z.number().int().min(1).max(100).default(10),
+});
+export const getPackageInfoSchema = z.object({
+    name: z.string().min(1),
+});
+export const getPackageVersionsSchema = z.object({
+    name: z.string().min(1),
+});
+export const getReadmeSchema = z.object({
+    name: z.string().min(1),
+    version: z.string().optional(),
+    format: z.enum(['markdown', 'text', 'html']).default('markdown').optional(),
+});
+export const getDependenciesSchema = z.object({
+    name: z.string().min(1),
+    version: z.string().optional(),
+});
+export const getPackageScoreSchema = z.object({
+    name: z.string().min(1),
+});
+export const getChangelogSchema = z.object({
+    name: z.string().min(1),
+    version: z.string().optional(),
+});
+export const getPackageMetricsSchema = z.object({
+    name: z.string().min(1),
+});
+export const tools = [
+    {
+        name: 'search_packages',
+        description: 'Search for packages on pub.dev by query',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Search query string' },
+                limit: { type: 'number', description: 'Maximum number of results (default 10)' },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'get_package_info',
+        description: 'Get detailed information about a specific package',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Package name' },
+            },
+            required: ['name'],
+        },
+    },
+    {
+        name: 'get_package_versions',
+        description: 'Get all available versions of a package',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Package name' },
+            },
+            required: ['name'],
+        },
+    },
+    {
+        name: 'get_readme',
+        description: 'Get the README content of a package',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Package name' },
+                version: { type: 'string', description: 'Specific version (optional, defaults to latest)' },
+                format: {
+                    type: 'string',
+                    description: 'Output format: markdown, text, or html (default: markdown)',
+                    enum: ['markdown', 'text', 'html'],
+                },
+            },
+            required: ['name'],
+        },
+    },
+    {
+        name: 'get_dependencies',
+        description: 'Get the dependencies of a package',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Package name' },
+                version: { type: 'string', description: 'Specific version (optional, defaults to latest)' },
+            },
+            required: ['name'],
+        },
+    },
+    {
+        name: 'get_package_score',
+        description: 'Get package score and metrics (pana points, likes, downloads, tags)',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Package name' },
+            },
+            required: ['name'],
+        },
+    },
+    {
+        name: 'get_changelog',
+        description: 'Get the changelog of a specific package version',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Package name' },
+                version: { type: 'string', description: 'Specific version (optional, defaults to latest)' },
+            },
+            required: ['name'],
+        },
+    },
+    {
+        name: 'get_package_metrics',
+        description: 'Get comprehensive metrics for a package (info + score + versions)',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Package name' },
+            },
+            required: ['name'],
+        },
+    },
+];
+export async function handleSearchPackages(client, input) {
+    const result = await client.searchPackages(input.query, input.limit);
+    return {
+        packages: result.packages.map((p) => ({
+            name: p.name,
+            description: p.description,
+            latestVersion: p.latestVersion,
+        })),
+        total: result.total,
+    };
+}
+export async function handleGetPackageInfo(client, input) {
+    const pkg = await client.getPackage(input.name);
+    return pkg;
+}
+export async function handleGetPackageVersions(client, input) {
+    const versions = await client.getPackageVersions(input.name);
+    return { versions };
+}
+export async function handleGetReadme(client, githubClient, input) {
+    const readme = await client.getReadme(input.name, input.version);
+    let finalReadme = readme;
+    let source = 'pub.dev';
+    if (!readme && input.name) {
+        try {
+            const pkg = await client.getPackage(input.name);
+            if (pkg.repository) {
+                const parsed = parseGitHubUrl(pkg.repository);
+                if (parsed) {
+                    const githubReadme = await githubClient.getRepositoryReadme(parsed.owner, parsed.repo);
+                    if (githubReadme) {
+                        finalReadme = githubReadme;
+                        source = 'github';
+                    }
+                }
+            }
+        }
+        catch {
+            // ignore errors and return no readme
+        }
+    }
+    const content = finalReadme || 'No README available';
+    if (input.format === 'text') {
+        return {
+            readme: content.replace(/[#*`_~\[\]]/g, '').trim(),
+            source,
+            format: 'text',
+        };
+    }
+    return { readme: content, source, format: input.format || 'markdown' };
+}
+export async function handleGetDependencies(client, input) {
+    const dependencies = await client.getDependencies(input.name, input.version);
+    return { dependencies };
+}
+export async function handleGetPackageScore(client, input) {
+    const score = await client.getPackageScore(input.name);
+    return score;
+}
+export async function handleGetChangelog(client, input) {
+    const changelog = await client.getChangelog(input.name, input.version);
+    if (!changelog) {
+        return {
+            version: input.version || 'latest',
+            content: 'No changelog available',
+            published: '',
+        };
+    }
+    return changelog;
+}
+export async function handleGetPackageMetrics(client, input) {
+    const [info, score, versions] = await Promise.all([
+        client.getPackage(input.name),
+        client.getPackageScore(input.name),
+        client.getPackageVersions(input.name),
+    ]);
+    return {
+        info,
+        score,
+        versionCount: versions.length,
+        latestVersion: versions[0]?.version,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,55 @@
+export interface PackageInfo {
+    name: string;
+    description: string;
+    latestVersion: string;
+    published: string;
+    updated: string;
+    publisher?: string;
+    homepage?: string;
+    repository?: string;
+    issues?: string;
+}
+export interface PackageVersion {
+    version: string;
+    published: string;
+}
+export interface PackageScore {
+    grantedPoints: number;
+    maxPoints: number;
+    likeCount: number;
+    downloadCount30Days: number;
+    tags: string[];
+}
+export interface PackageChangelog {
+    version: string;
+    published: string;
+    content: string;
+}
+export interface PackageDependencies {
+    direct: Record<string, string>;
+    dev: Record<string, string>;
+    transitive: Record<string, string>;
+}
+export interface SearchResult {
+    packages: {
+        name: string;
+        description: string;
+        latestVersion: string;
+    }[];
+    total: number;
+}
+export interface ToolInput {
+    query?: string;
+    limit?: number;
+    name?: string;
+    version?: string;
+}
+export interface ToolOutput {
+    packages?: PackageInfo[];
+    versions?: PackageVersion[];
+    readme?: string;
+    dependencies?: PackageDependencies;
+    searchResults?: SearchResult;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;KACvB,EAAE,CAAC;IACJ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/utils/rateLimiter.d.ts

@@ -0,0 +1,13 @@
+export declare class RateLimiter {
+    private limit;
+    constructor(concurrency?: number);
+    run<T>(fn: () => Promise<T>): Promise<T>;
+    setConcurrency(concurrency: number): void;
+}
+export declare const rateLimiter: RateLimiter;
+export declare function withRetry<T>(fn: () => Promise<T>, options?: {
+    attempts?: number;
+    backoff?: number;
+}): Promise<T>;
+export declare function withRateLimit<T>(fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=rateLimiter.d.ts.map

package/dist/utils/rateLimiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimiter.d.ts","sourceRoot":"","sources":["../../src/utils/rateLimiter.ts"],"names":[],"mappings":"AAKA,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAA4B;gBAE7B,WAAW,GAAE,MAAuB;IAI1C,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI9C,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;CAG1C;AAED,eAAO,MAAM,WAAW,aAAoB,CAAC;AAE7C,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,OAAO,CAAC,CAAC,CAAC,CAyBZ;AAED,wBAAsB,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEvE"}

package/dist/utils/rateLimiter.js

@@ -0,0 +1,42 @@
+import pLimit from 'p-limit';
+const MAX_CONCURRENT = parseInt(process.env.MAX_CONCURRENT_REQUESTS || '5', 10);
+const RETRY_ATTEMPTS = parseInt(process.env.RETRY_ATTEMPTS || '3', 10);
+export class RateLimiter {
+    limit;
+    constructor(concurrency = MAX_CONCURRENT) {
+        this.limit = pLimit(concurrency);
+    }
+    async run(fn) {
+        return this.limit(fn);
+    }
+    setConcurrency(concurrency) {
+        this.limit = pLimit(concurrency);
+    }
+}
+export const rateLimiter = new RateLimiter();
+export async function withRetry(fn, options = {}) {
+    const attempts = options.attempts || RETRY_ATTEMPTS;
+    const backoff = options.backoff || 1000;
+    let lastError = null;
+    for (let i = 0; i < attempts; i++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            const isRetryable = error instanceof Error &&
+                ('statusCode' in error
+                    ? error.statusCode === 429
+                    : error.message.includes('ECONNRESET') || error.message.includes('ETIMEDOUT'));
+            if (!isRetryable || i === attempts - 1) {
+                throw lastError;
+            }
+            await new Promise((resolve) => setTimeout(resolve, backoff * Math.pow(2, i)));
+        }
+    }
+    throw lastError;
+}
+export async function withRateLimit(fn) {
+    return rateLimiter.run(fn);
+}
+//# sourceMappingURL=rateLimiter.js.map

package/dist/utils/rateLimiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimiter.js","sourceRoot":"","sources":["../../src/utils/rateLimiter.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,SAAS,CAAC;AAE7B,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;AAChF,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;AAEvE,MAAM,OAAO,WAAW;IACd,KAAK,CAA4B;IAEzC,YAAY,cAAsB,cAAc;QAC9C,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,EAAoB;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;IAED,cAAc,CAAC,WAAmB;QAChC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,UAAmD,EAAE;IAErD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,cAAc,CAAC;IACpD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;IAExC,IAAI,SAAS,GAAiB,IAAI,CAAC;IAEnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAc,CAAC;YAC3B,MAAM,WAAW,GAAG,KAAK,YAAY,KAAK;gBACxC,CAAC,YAAY,IAAI,KAAK;oBACpB,CAAC,CAAE,KAAiC,CAAC,UAAU,KAAK,GAAG;oBACvD,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;YAEnF,IAAI,CAAC,WAAW,IAAI,CAAC,KAAK,QAAQ,GAAG,CAAC,EAAE,CAAC;gBACvC,MAAM,SAAS,CAAC;YAClB,CAAC;YAED,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAI,EAAoB;IACzD,OAAO,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "pub-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for pub.dev - Enables AI assistants to access Dart/Flutter package information",
+  "main": "dist/cli.js",
+  "type": "module",
+  "bin": {
+    "pub-mcp": "./dist/cli.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yourusername/pub-mcp.git"
+  },
+  "homepage": "https://github.com/yourusername/pub-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/yourusername/pub-mcp/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/cli.js",
+    "cli": "node dist/cli.js",
+    "dev": "tsx watch src/cli.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "check": "npm run lint && npm run test && npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "pub.dev",
+    "dart",
+    "flutter",
+    "package-manager",
+    "ai",
+    "claude",
+    "openai"
+  ],
+  "author": "Your Name <your@email.com>",
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/yourusername/pub-mcp"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "cors": "^2.8.5",
+    "dotenv": "^16.4.0",
+    "express": "^4.18.0",
+    "p-limit": "^3.1.0",
+    "pino": "^10.3.1",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.6",
+    "@types/node": "^20.11.0",
+    "@typescript-eslint/eslint-plugin": "^6.21.0",
+    "@typescript-eslint/parser": "^6.21.0",
+    "@vitest/coverage-v8": "^1.6.1",
+    "eslint": "^8.56.0",
+    "prettier": "^3.2.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.2.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/skills-lock.json

@@ -0,0 +1,25 @@
+{
+  "version": 1,
+  "skills": {
+    "nodejs-backend-patterns": {
+      "source": "wshobson/agents",
+      "sourceType": "github",
+      "computedHash": "3d6cbc12f720d8f02e1936c3e7fab78245eaa69500edbceea93d493d4ece6094"
+    },
+    "nodejs-best-practices": {
+      "source": "sickn33/antigravity-awesome-skills",
+      "sourceType": "github",
+      "computedHash": "9f8d3f268624c4757f4039617942d3e8ddcf420b9295cb943bea3bf9feb37e9d"
+    },
+    "typescript-advanced-types": {
+      "source": "wshobson/agents",
+      "sourceType": "github",
+      "computedHash": "ee8377c523a911be41c31037b477805773ca5ab5ade181e44ca7dd3cd8df6692"
+    },
+    "vitest": {
+      "source": "antfu/skills",
+      "sourceType": "github",
+      "computedHash": "0efd9cf8c56aada060d418d009cfe621a7915d0c73a958fe611985bc0c2fa4b8"
+    }
+  }
+}