Initial release v1.0.0

Open-source marketplace for AI Agent skills.

Features:
- Next.js 15 web app with i18n (en/fa)
- CLI tool for skill installation (npx skillhub)
- GitHub crawler/indexer with multi-strategy discovery
- Security scanning for all indexed skills
- Self-hostable with Docker

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

apps/web/app/[locale]/claim/claim.test.ts

@@ -0,0 +1,190 @@
+import { describe, it, expect } from 'vitest';
+
+/**
+ * Claim Form Validation Tests
+ *
+ * These tests validate the URL validation logic used in the claim form.
+ * Full component tests require React Testing Library setup with jsdom environment.
+ */
+
+// Validate GitHub URL format (duplicated from ClaimForm for testing)
+function isValidGitHubUrl(url: string): boolean {
+  try {
+    const urlObj = new URL(url);
+    return urlObj.hostname === 'github.com' && urlObj.pathname.split('/').filter(Boolean).length >= 2;
+  } catch {
+    return false;
+  }
+}
+
+describe('Claim Form - URL Validation', () => {
+  describe('isValidGitHubUrl', () => {
+    it('should accept valid GitHub repository URL', () => {
+      expect(isValidGitHubUrl('https://github.com/owner/repo')).toBe(true);
+    });
+
+    it('should accept valid GitHub repository URL with trailing slash', () => {
+      expect(isValidGitHubUrl('https://github.com/owner/repo/')).toBe(true);
+    });
+
+    it('should accept valid GitHub repository URL with tree path', () => {
+      expect(isValidGitHubUrl('https://github.com/owner/repo/tree/main/path')).toBe(true);
+    });
+
+    it('should reject non-GitHub URLs', () => {
+      expect(isValidGitHubUrl('https://example.com/owner/repo')).toBe(false);
+    });
+
+    it('should reject GitHub URL without owner', () => {
+      expect(isValidGitHubUrl('https://github.com/owner')).toBe(false);
+    });
+
+    it('should reject GitHub homepage', () => {
+      expect(isValidGitHubUrl('https://github.com')).toBe(false);
+    });
+
+    it('should reject invalid URLs', () => {
+      expect(isValidGitHubUrl('not a url')).toBe(false);
+    });
+
+    it('should reject empty string', () => {
+      expect(isValidGitHubUrl('')).toBe(false);
+    });
+
+    it('should reject relative paths', () => {
+      expect(isValidGitHubUrl('/owner/repo')).toBe(false);
+    });
+
+    it('should reject GitHub gist URLs', () => {
+      expect(isValidGitHubUrl('https://gist.github.com/user/abc123')).toBe(false);
+    });
+  });
+});
+
+describe('Claim Form - Error Code Handling', () => {
+  it('should map RATE_LIMIT_EXCEEDED error code correctly', () => {
+    const errorCodes = {
+      'RATE_LIMIT_EXCEEDED': 'GitHub API rate limit exceeded. Please try again in a few minutes.',
+      'INVALID_REPO': 'The repository was not found or is not accessible.',
+      'NETWORK_TIMEOUT': 'Request timed out while checking the repository.',
+      'INVALID_URL': 'Please enter a valid GitHub repository URL.',
+    };
+
+    expect(errorCodes['RATE_LIMIT_EXCEEDED']).toBe('GitHub API rate limit exceeded. Please try again in a few minutes.');
+  });
+
+  it('should have distinct error messages for each error code', () => {
+    const errorCodes = [
+      'RATE_LIMIT_EXCEEDED',
+      'INVALID_REPO',
+      'NETWORK_TIMEOUT',
+      'INVALID_URL',
+      'ALREADY_PENDING',
+    ];
+
+    // All error codes should be unique
+    expect(new Set(errorCodes).size).toBe(errorCodes.length);
+  });
+});
+
+describe('Claim Form - API Response Scenarios', () => {
+  describe('Add Request Success Scenarios', () => {
+    it('should handle single skill found', () => {
+      const response = {
+        success: true,
+        hasSkillMd: true,
+        skillCount: 1,
+        skillPaths: ['skills/my-skill'],
+      };
+
+      expect(response.skillCount).toBe(1);
+      expect(response.hasSkillMd).toBe(true);
+    });
+
+    it('should handle multiple skills found', () => {
+      const response = {
+        success: true,
+        hasSkillMd: true,
+        skillCount: 3,
+        skillPaths: ['skills/skill1', 'skills/skill2', 'skills/skill3'],
+      };
+
+      expect(response.skillCount).toBe(3);
+      expect(response.skillPaths.length).toBe(3);
+    });
+
+    it('should handle no skills found', () => {
+      const response = {
+        success: true,
+        hasSkillMd: false,
+        skillCount: 0,
+        skillPaths: [],
+      };
+
+      expect(response.skillCount).toBe(0);
+      expect(response.hasSkillMd).toBe(false);
+      expect(response.skillPaths.length).toBe(0);
+    });
+  });
+
+  describe('Add Request Error Scenarios', () => {
+    it('should handle rate limit error', () => {
+      const errorResponse = {
+        error: 'GitHub API rate limit exceeded',
+        code: 'RATE_LIMIT_EXCEEDED',
+      };
+
+      expect(errorResponse.code).toBe('RATE_LIMIT_EXCEEDED');
+    });
+
+    it('should handle invalid repository error', () => {
+      const errorResponse = {
+        error: 'Repository not found',
+        code: 'INVALID_REPO',
+      };
+
+      expect(errorResponse.code).toBe('INVALID_REPO');
+    });
+
+    it('should handle network timeout error', () => {
+      const errorResponse = {
+        error: 'Request timed out',
+        code: 'NETWORK_TIMEOUT',
+      };
+
+      expect(errorResponse.code).toBe('NETWORK_TIMEOUT');
+    });
+  });
+});
+
+describe('Repository Validation - Error Message Clarity', () => {
+  it('should provide specific error for 404 (not found)', () => {
+    const error = 'Repository not found. Please check the URL and ensure the repository exists.';
+    expect(error).toContain('not found');
+    expect(error).toContain('check the URL');
+  });
+
+  it('should provide specific error for rate limit', () => {
+    const error = 'GitHub API rate limit exceeded. Please try again later.';
+    expect(error).toContain('rate limit');
+    expect(error).toContain('try again');
+  });
+
+  it('should provide specific error for private repository', () => {
+    const error = 'Repository is private or you do not have access. Please ensure the repository is public.';
+    expect(error).toContain('private');
+    expect(error).toContain('public');
+  });
+
+  it('should provide specific error for timeout', () => {
+    const error = 'Request timed out while checking repository. Please try again.';
+    expect(error).toContain('timed out');
+    expect(error).toContain('try again');
+  });
+
+  it('should provide generic error for network issues', () => {
+    const error = 'Network error while verifying repository. Please check your connection and try again.';
+    expect(error).toContain('Network error');
+    expect(error).toContain('connection');
+  });
+});