@nimblebrain/mpak-sdk 0.0.1

package/dist/client.js

@@ -0,0 +1,283 @@
+import { createHash } from 'crypto';
+import { MpakNotFoundError, MpakIntegrityError, MpakNetworkError, } from './errors.js';
+const DEFAULT_REGISTRY_URL = 'https://api.mpak.dev';
+const DEFAULT_TIMEOUT = 30000;
+/**
+ * Client for interacting with the mpak registry
+ *
+ * Zero runtime dependencies - uses native fetch and crypto only.
+ * Requires Node.js 18+ for native fetch support.
+ */
+export class MpakClient {
+    registryUrl;
+    timeout;
+    constructor(config = {}) {
+        this.registryUrl = config.registryUrl ?? DEFAULT_REGISTRY_URL;
+        this.timeout = config.timeout ?? DEFAULT_TIMEOUT;
+    }
+    // ===========================================================================
+    // Bundle API
+    // ===========================================================================
+    /**
+     * Search for bundles
+     */
+    async searchBundles(params = {}) {
+        const searchParams = new URLSearchParams();
+        if (params.q)
+            searchParams.set('q', params.q);
+        if (params.type)
+            searchParams.set('type', params.type);
+        if (params.sort)
+            searchParams.set('sort', params.sort);
+        if (params.limit)
+            searchParams.set('limit', String(params.limit));
+        if (params.offset)
+            searchParams.set('offset', String(params.offset));
+        const queryString = searchParams.toString();
+        const url = `${this.registryUrl}/v1/bundles/search${queryString ? `?${queryString}` : ''}`;
+        const response = await this.fetchWithTimeout(url);
+        if (!response.ok) {
+            throw new MpakNetworkError(`Failed to search bundles: HTTP ${response.status}`);
+        }
+        return response.json();
+    }
+    /**
+     * Get bundle details
+     */
+    async getBundle(name) {
+        this.validateScopedName(name);
+        const url = `${this.registryUrl}/v1/bundles/${name}`;
+        const response = await this.fetchWithTimeout(url);
+        if (response.status === 404) {
+            throw new MpakNotFoundError(name);
+        }
+        if (!response.ok) {
+            throw new MpakNetworkError(`Failed to get bundle: HTTP ${response.status}`);
+        }
+        return response.json();
+    }
+    /**
+     * Get all versions of a bundle
+     */
+    async getBundleVersions(name) {
+        this.validateScopedName(name);
+        const url = `${this.registryUrl}/v1/bundles/${name}/versions`;
+        const response = await this.fetchWithTimeout(url);
+        if (response.status === 404) {
+            throw new MpakNotFoundError(name);
+        }
+        if (!response.ok) {
+            throw new MpakNetworkError(`Failed to get bundle versions: HTTP ${response.status}`);
+        }
+        return response.json();
+    }
+    /**
+     * Get a specific version of a bundle
+     */
+    async getBundleVersion(name, version) {
+        this.validateScopedName(name);
+        const url = `${this.registryUrl}/v1/bundles/${name}/versions/${version}`;
+        const response = await this.fetchWithTimeout(url);
+        if (response.status === 404) {
+            throw new MpakNotFoundError(`${name}@${version}`);
+        }
+        if (!response.ok) {
+            throw new MpakNetworkError(`Failed to get bundle version: HTTP ${response.status}`);
+        }
+        return response.json();
+    }
+    /**
+     * Get download info for a bundle
+     */
+    async getBundleDownload(name, version, platform) {
+        this.validateScopedName(name);
+        const params = new URLSearchParams();
+        if (platform) {
+            params.set('os', platform.os);
+            params.set('arch', platform.arch);
+        }
+        const queryString = params.toString();
+        const url = `${this.registryUrl}/v1/bundles/${name}/versions/${version}/download${queryString ? `?${queryString}` : ''}`;
+        const response = await this.fetchWithTimeout(url, {
+            headers: { Accept: 'application/json' },
+        });
+        if (response.status === 404) {
+            throw new MpakNotFoundError(`${name}@${version}`);
+        }
+        if (!response.ok) {
+            throw new MpakNetworkError(`Failed to get bundle download: HTTP ${response.status}`);
+        }
+        return response.json();
+    }
+    // ===========================================================================
+    // Skill API
+    // ===========================================================================
+    /**
+     * Search for skills
+     */
+    async searchSkills(params = {}) {
+        const searchParams = new URLSearchParams();
+        if (params.q)
+            searchParams.set('q', params.q);
+        if (params.tags)
+            searchParams.set('tags', params.tags);
+        if (params.category)
+            searchParams.set('category', params.category);
+        if (params.surface)
+            searchParams.set('surface', params.surface);
+        if (params.sort)
+            searchParams.set('sort', params.sort);
+        if (params.limit)
+            searchParams.set('limit', String(params.limit));
+        if (params.offset)
+            searchParams.set('offset', String(params.offset));
+        const queryString = searchParams.toString();
+        const url = `${this.registryUrl}/v1/skills/search${queryString ? `?${queryString}` : ''}`;
+        const response = await this.fetchWithTimeout(url);
+        if (!response.ok) {
+            throw new MpakNetworkError(`Failed to search skills: HTTP ${response.status}`);
+        }
+        return response.json();
+    }
+    /**
+     * Get skill details
+     */
+    async getSkill(name) {
+        this.validateScopedName(name);
+        const url = `${this.registryUrl}/v1/skills/${name}`;
+        const response = await this.fetchWithTimeout(url);
+        if (response.status === 404) {
+            throw new MpakNotFoundError(name);
+        }
+        if (!response.ok) {
+            throw new MpakNetworkError(`Failed to get skill: HTTP ${response.status}`);
+        }
+        return response.json();
+    }
+    /**
+     * Get download info for a skill (latest version)
+     */
+    async getSkillDownload(name) {
+        this.validateScopedName(name);
+        const url = `${this.registryUrl}/v1/skills/${name}/download`;
+        const response = await this.fetchWithTimeout(url, {
+            headers: { Accept: 'application/json' },
+        });
+        if (response.status === 404) {
+            throw new MpakNotFoundError(name);
+        }
+        if (!response.ok) {
+            throw new MpakNetworkError(`Failed to get skill download: HTTP ${response.status}`);
+        }
+        return response.json();
+    }
+    /**
+     * Get download info for a specific skill version
+     */
+    async getSkillVersionDownload(name, version) {
+        this.validateScopedName(name);
+        const url = `${this.registryUrl}/v1/skills/${name}/versions/${version}/download`;
+        const response = await this.fetchWithTimeout(url, {
+            headers: { Accept: 'application/json' },
+        });
+        if (response.status === 404) {
+            throw new MpakNotFoundError(`${name}@${version}`);
+        }
+        if (!response.ok) {
+            throw new MpakNetworkError(`Failed to get skill download: HTTP ${response.status}`);
+        }
+        return response.json();
+    }
+    /**
+     * Download skill content and verify integrity
+     *
+     * @throws {MpakIntegrityError} If expectedSha256 is provided and doesn't match (fail-closed)
+     */
+    async downloadSkillContent(downloadUrl, expectedSha256) {
+        const response = await this.fetchWithTimeout(downloadUrl);
+        if (!response.ok) {
+            throw new MpakNetworkError(`Failed to download skill: HTTP ${response.status}`);
+        }
+        const content = await response.text();
+        if (expectedSha256) {
+            const actualHash = this.computeSha256(content);
+            if (actualHash !== expectedSha256) {
+                throw new MpakIntegrityError(expectedSha256, actualHash);
+            }
+            return { content, verified: true };
+        }
+        return { content, verified: false };
+    }
+    // ===========================================================================
+    // Utility Methods
+    // ===========================================================================
+    /**
+     * Detect the current platform
+     */
+    static detectPlatform() {
+        const nodePlatform = process.platform;
+        const nodeArch = process.arch;
+        let os;
+        switch (nodePlatform) {
+            case 'darwin':
+                os = 'darwin';
+                break;
+            case 'win32':
+                os = 'win32';
+                break;
+            case 'linux':
+                os = 'linux';
+                break;
+            default:
+                os = 'any';
+        }
+        let arch;
+        switch (nodeArch) {
+            case 'x64':
+                arch = 'x64';
+                break;
+            case 'arm64':
+                arch = 'arm64';
+                break;
+            default:
+                arch = 'any';
+        }
+        return { os, arch };
+    }
+    /**
+     * Compute SHA256 hash of content
+     */
+    computeSha256(content) {
+        return createHash('sha256').update(content, 'utf8').digest('hex');
+    }
+    /**
+     * Validate that a name is scoped (@scope/name)
+     */
+    validateScopedName(name) {
+        if (!name.startsWith('@')) {
+            throw new Error('Package name must be scoped (e.g., @scope/package-name)');
+        }
+    }
+    /**
+     * Fetch with timeout support
+     */
+    async fetchWithTimeout(url, init) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => {
+            controller.abort();
+        }, this.timeout);
+        try {
+            return await fetch(url, { ...init, signal: controller.signal });
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new MpakNetworkError(`Request timeout after ${this.timeout}ms`);
+            }
+            throw new MpakNetworkError(error instanceof Error ? error.message : 'Network error');
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.test.d.ts.map

package/dist/client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.test.d.ts","sourceRoot":"","sources":["../src/client.test.ts"],"names":[],"mappings":""}

package/dist/client.test.js

@@ -0,0 +1,344 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { createHash } from 'crypto';
+import { MpakClient } from './client.js';
+import { MpakNotFoundError, MpakIntegrityError, MpakNetworkError, } from './errors.js';
+// Helper to compute SHA256 hash (same as client implementation)
+function sha256(content) {
+    return createHash('sha256').update(content, 'utf8').digest('hex');
+}
+// Helper to create a mock Response
+function mockResponse(body, init = {}) {
+    const bodyStr = typeof body === 'string' ? body : JSON.stringify(body);
+    return {
+        text: () => Promise.resolve(bodyStr),
+        json: () => Promise.resolve(typeof body === 'string' ? JSON.parse(body) : body),
+        status: init.status ?? 200,
+        ok: init.ok ?? (init.status === undefined || init.status < 400),
+    };
+}
+describe('MpakClient', () => {
+    let fetchMock;
+    beforeEach(() => {
+        fetchMock = vi.fn();
+        vi.stubGlobal('fetch', fetchMock);
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+    });
+    describe('constructor', () => {
+        it('uses default registry URL when not specified', async () => {
+            const client = new MpakClient();
+            fetchMock.mockResolvedValueOnce(mockResponse({ bundles: [], total: 0, pagination: {} }));
+            await client.searchBundles();
+            expect(fetchMock).toHaveBeenCalledWith(expect.stringContaining('https://api.mpak.dev'), expect.any(Object));
+        });
+        it('uses custom registry URL when specified', async () => {
+            const client = new MpakClient({
+                registryUrl: 'https://custom.registry.com',
+            });
+            fetchMock.mockResolvedValueOnce(mockResponse({ bundles: [], total: 0, pagination: {} }));
+            await client.searchBundles();
+            expect(fetchMock).toHaveBeenCalledWith(expect.stringContaining('https://custom.registry.com'), expect.any(Object));
+        });
+    });
+    describe('searchBundles', () => {
+        it('returns search results', async () => {
+            const client = new MpakClient();
+            const searchResponse = {
+                bundles: [
+                    { name: '@test/bundle-1', latest_version: '1.0.0', downloads: 100, published_at: '2024-01-01', verified: true },
+                ],
+                total: 1,
+                pagination: { limit: 20, offset: 0, has_more: false },
+            };
+            fetchMock.mockResolvedValueOnce(mockResponse(searchResponse));
+            const result = await client.searchBundles({ q: 'test' });
+            expect(result.bundles).toHaveLength(1);
+            expect(result.total).toBe(1);
+        });
+        it('passes query parameters correctly', async () => {
+            const client = new MpakClient();
+            fetchMock.mockResolvedValueOnce(mockResponse({ bundles: [], total: 0, pagination: {} }));
+            await client.searchBundles({
+                q: 'mcp',
+                type: 'python',
+                sort: 'downloads',
+                limit: 10,
+                offset: 5,
+            });
+            const calledUrl = fetchMock.mock.calls[0]?.[0];
+            expect(calledUrl).toContain('q=mcp');
+            expect(calledUrl).toContain('type=python');
+            expect(calledUrl).toContain('sort=downloads');
+            expect(calledUrl).toContain('limit=10');
+            expect(calledUrl).toContain('offset=5');
+        });
+        it('calls /v1/bundles/search endpoint', async () => {
+            const client = new MpakClient();
+            fetchMock.mockResolvedValueOnce(mockResponse({ bundles: [], total: 0, pagination: {} }));
+            await client.searchBundles();
+            const calledUrl = fetchMock.mock.calls[0]?.[0];
+            expect(calledUrl).toContain('/v1/bundles/search');
+        });
+    });
+    describe('getBundle', () => {
+        it('returns bundle details', async () => {
+            const client = new MpakClient();
+            const bundleResponse = {
+                name: '@test/bundle',
+                latest_version: '1.0.0',
+                downloads: 100,
+                published_at: '2024-01-01',
+                verified: true,
+                versions: [],
+            };
+            fetchMock.mockResolvedValueOnce(mockResponse(bundleResponse));
+            const result = await client.getBundle('@test/bundle');
+            expect(result.name).toBe('@test/bundle');
+        });
+        it('throws error for unscoped name', async () => {
+            const client = new MpakClient();
+            await expect(client.getBundle('invalid-name')).rejects.toThrow('Package name must be scoped');
+        });
+        it('throws MpakNotFoundError on 404', async () => {
+            const client = new MpakClient();
+            fetchMock.mockResolvedValueOnce(mockResponse('', { status: 404 }));
+            await expect(client.getBundle('@test/nonexistent')).rejects.toThrow(MpakNotFoundError);
+        });
+    });
+    describe('getBundleVersions', () => {
+        it('returns versions list', async () => {
+            const client = new MpakClient();
+            const versionsResponse = {
+                name: '@test/bundle',
+                latest: '1.0.0',
+                versions: [
+                    { version: '1.0.0', artifacts_count: 1, platforms: [], published_at: '2024-01-01', downloads: 50, publish_method: null },
+                ],
+            };
+            fetchMock.mockResolvedValueOnce(mockResponse(versionsResponse));
+            const result = await client.getBundleVersions('@test/bundle');
+            expect(result.versions).toHaveLength(1);
+            expect(result.latest).toBe('1.0.0');
+        });
+    });
+    describe('getBundleDownload', () => {
+        it('returns download info with URL', async () => {
+            const client = new MpakClient();
+            const downloadResponse = {
+                url: 'https://storage.example.com/bundle.mcpb',
+                bundle: {
+                    name: '@test/bundle',
+                    version: '1.0.0',
+                    platform: { os: 'darwin', arch: 'arm64' },
+                    sha256: 'abc123',
+                    size: 12345,
+                },
+                expires_at: '2024-01-02T00:00:00Z',
+            };
+            fetchMock.mockResolvedValueOnce(mockResponse(downloadResponse));
+            const result = await client.getBundleDownload('@test/bundle', '1.0.0');
+            expect(result.url).toBe('https://storage.example.com/bundle.mcpb');
+            expect(result.bundle.sha256).toBe('abc123');
+        });
+        it('passes platform parameters', async () => {
+            const client = new MpakClient();
+            fetchMock.mockResolvedValueOnce(mockResponse({
+                url: 'https://example.com',
+                bundle: { name: '@test/bundle', version: '1.0.0', platform: {}, sha256: '', size: 0 },
+            }));
+            await client.getBundleDownload('@test/bundle', '1.0.0', { os: 'linux', arch: 'x64' });
+            const calledUrl = fetchMock.mock.calls[0]?.[0];
+            expect(calledUrl).toContain('os=linux');
+            expect(calledUrl).toContain('arch=x64');
+        });
+    });
+    describe('searchSkills', () => {
+        it('returns search results', async () => {
+            const client = new MpakClient();
+            const searchResponse = {
+                skills: [
+                    { name: '@test/skill-1', description: 'Test skill', latest_version: '1.0.0', downloads: 50, published_at: '2024-01-01' },
+                ],
+                total: 1,
+                pagination: { limit: 20, offset: 0, has_more: false },
+            };
+            fetchMock.mockResolvedValueOnce(mockResponse(searchResponse));
+            const result = await client.searchSkills({ q: 'test' });
+            expect(result.skills).toHaveLength(1);
+            expect(result.total).toBe(1);
+        });
+        it('passes all query parameters', async () => {
+            const client = new MpakClient();
+            fetchMock.mockResolvedValueOnce(mockResponse({ skills: [], total: 0, pagination: {} }));
+            await client.searchSkills({
+                q: 'crm',
+                tags: 'sales,contacts',
+                category: 'development',
+                surface: 'claude-code',
+                sort: 'recent',
+                limit: 10,
+                offset: 5,
+            });
+            const calledUrl = fetchMock.mock.calls[0]?.[0];
+            expect(calledUrl).toContain('q=crm');
+            expect(calledUrl).toContain('tags=sales%2Ccontacts');
+            expect(calledUrl).toContain('category=development');
+            expect(calledUrl).toContain('surface=claude-code');
+            expect(calledUrl).toContain('sort=recent');
+        });
+        it('calls /v1/skills/search endpoint', async () => {
+            const client = new MpakClient();
+            fetchMock.mockResolvedValueOnce(mockResponse({ skills: [], total: 0, pagination: {} }));
+            await client.searchSkills();
+            const calledUrl = fetchMock.mock.calls[0]?.[0];
+            expect(calledUrl).toContain('/v1/skills/search');
+        });
+    });
+    describe('getSkill', () => {
+        it('returns skill details', async () => {
+            const client = new MpakClient();
+            const skillResponse = {
+                name: '@test/skill',
+                description: 'A test skill',
+                latest_version: '1.0.0',
+                downloads: 100,
+                published_at: '2024-01-01',
+                versions: [],
+            };
+            fetchMock.mockResolvedValueOnce(mockResponse(skillResponse));
+            const result = await client.getSkill('@test/skill');
+            expect(result.name).toBe('@test/skill');
+            expect(result.description).toBe('A test skill');
+        });
+        it('throws MpakNotFoundError on 404', async () => {
+            const client = new MpakClient();
+            fetchMock.mockResolvedValueOnce(mockResponse('', { status: 404 }));
+            await expect(client.getSkill('@test/nonexistent')).rejects.toThrow(MpakNotFoundError);
+        });
+    });
+    describe('getSkillDownload', () => {
+        it('returns download info', async () => {
+            const client = new MpakClient();
+            const downloadResponse = {
+                url: 'https://storage.example.com/skill.skill',
+                skill: {
+                    name: '@test/skill',
+                    version: '1.0.0',
+                    sha256: 'abc123def456',
+                    size: 1024,
+                },
+                expires_at: '2024-01-02T00:00:00Z',
+            };
+            fetchMock.mockResolvedValueOnce(mockResponse(downloadResponse));
+            const result = await client.getSkillDownload('@test/skill');
+            expect(result.url).toBe('https://storage.example.com/skill.skill');
+            expect(result.skill.sha256).toBe('abc123def456');
+        });
+    });
+    describe('getSkillVersionDownload', () => {
+        it('returns download info for specific version', async () => {
+            const client = new MpakClient();
+            const downloadResponse = {
+                url: 'https://storage.example.com/skill-v1.skill',
+                skill: {
+                    name: '@test/skill',
+                    version: '1.0.0',
+                    sha256: 'version1hash',
+                    size: 1024,
+                },
+                expires_at: '2024-01-02T00:00:00Z',
+            };
+            fetchMock.mockResolvedValueOnce(mockResponse(downloadResponse));
+            const result = await client.getSkillVersionDownload('@test/skill', '1.0.0');
+            expect(result.skill.version).toBe('1.0.0');
+        });
+        it('calls correct versioned endpoint', async () => {
+            const client = new MpakClient();
+            fetchMock.mockResolvedValueOnce(mockResponse({
+                url: 'https://example.com',
+                skill: { name: '@test/skill', version: '2.0.0', sha256: '', size: 0 },
+                expires_at: '',
+            }));
+            await client.getSkillVersionDownload('@test/skill', '2.0.0');
+            const calledUrl = fetchMock.mock.calls[0]?.[0];
+            expect(calledUrl).toContain('/versions/2.0.0/download');
+        });
+    });
+    describe('downloadSkillContent', () => {
+        it('downloads content without verification', async () => {
+            const client = new MpakClient();
+            const content = '# My Skill\n\nSkill content here';
+            fetchMock.mockResolvedValueOnce(mockResponse(content));
+            const result = await client.downloadSkillContent('https://example.com/skill.skill');
+            expect(result.content).toBe(content);
+            expect(result.verified).toBe(false);
+        });
+        it('verifies integrity when hash provided', async () => {
+            const client = new MpakClient();
+            const content = 'skill content';
+            const hash = sha256(content);
+            fetchMock.mockResolvedValueOnce(mockResponse(content));
+            const result = await client.downloadSkillContent('https://example.com/skill.skill', hash);
+            expect(result.content).toBe(content);
+            expect(result.verified).toBe(true);
+        });
+        it('throws MpakIntegrityError on hash mismatch (fail-closed)', async () => {
+            const client = new MpakClient();
+            const content = 'actual content';
+            fetchMock.mockResolvedValueOnce(mockResponse(content));
+            await expect(client.downloadSkillContent('https://example.com/skill.skill', 'wrong_hash')).rejects.toThrow(MpakIntegrityError);
+        });
+        it('does not return content when integrity fails', async () => {
+            const client = new MpakClient();
+            const secretContent = 'sensitive skill content';
+            fetchMock.mockResolvedValueOnce(mockResponse(secretContent));
+            let leakedContent;
+            try {
+                const result = await client.downloadSkillContent('https://example.com/skill.skill', 'wrong_hash');
+                leakedContent = result.content;
+            }
+            catch {
+                // Expected
+            }
+            expect(leakedContent).toBeUndefined();
+        });
+    });
+    describe('detectPlatform', () => {
+        it('returns current platform', () => {
+            const platform = MpakClient.detectPlatform();
+            expect(platform).toHaveProperty('os');
+            expect(platform).toHaveProperty('arch');
+            expect(['darwin', 'linux', 'win32', 'any']).toContain(platform.os);
+            expect(['x64', 'arm64', 'any']).toContain(platform.arch);
+        });
+    });
+    describe('timeout handling', () => {
+        it('throws MpakNetworkError on timeout', async () => {
+            const client = new MpakClient({ timeout: 100 });
+            fetchMock.mockImplementationOnce(() => new Promise((_, reject) => {
+                setTimeout(() => {
+                    const error = new Error('AbortError');
+                    error.name = 'AbortError';
+                    reject(error);
+                }, 50);
+            }));
+            await expect(client.searchBundles()).rejects.toThrow(MpakNetworkError);
+        });
+        it('includes timeout duration in error message', async () => {
+            const client = new MpakClient({ timeout: 5000 });
+            fetchMock.mockImplementationOnce(() => {
+                const error = new Error('AbortError');
+                error.name = 'AbortError';
+                return Promise.reject(error);
+            });
+            await expect(client.searchBundles()).rejects.toThrow('5000ms');
+        });
+        it('wraps generic fetch errors as MpakNetworkError', async () => {
+            const client = new MpakClient();
+            fetchMock.mockRejectedValueOnce(new Error('ECONNREFUSED'));
+            await expect(client.searchBundles()).rejects.toThrow(MpakNetworkError);
+        });
+    });
+});
+//# sourceMappingURL=client.test.js.map