chore: [sc-26283] Enhance namegraph-sdk (#596)

* Update readme & reduce magic numbers

* Moving default variables to index.ts & changing Responses to interfaces from types

* defaults & interfaces back to utils due to repo dependencies

* Detailed documentation as comments and docstrings (synchronized with python package amap)

* unit tests for index.ts and utils.ts

* Add changeset

Author: Y3drk

.changeset/strange-flies-nail.md

@@ -0,0 +1,5 @@
+---
+"@namehash/namegraph-sdk": patch
+---
+
+Update NameGraph SDK's README, add detailed documentation and provide test coverage for the package

packages/namegraph-sdk/README.md

@@ -2,6 +2,14 @@
 
 A TypeScript SDK for interacting with the NameGraph APIs, providing access to the world's largest collection of names. This SDK enables easy integration with the NameGraph API endpoints for name and collection suggestions.
 
+## Features
+
+- **Category-based Suggestions**: Get name suggestions organized by various categories including related terms, wordplay, alternates, and more
+- **Collection Management**: Find, count, and analyze collections of names
+- **Smart Sampling**: Sample and fetch top members from collections
+- **Advanced Search**: Search collections by string or by collection ID
+
+
 ## Installation
 
 ```bash
@@ -25,13 +33,6 @@ import { namegraph } from "namegraph-sdk";
 const suggestions = await namegraph.groupedByCategory("zeus");
 ```
 
-## Features
-
-- **Category-based Suggestions**: Get name suggestions organized by various categories including related terms, wordplay, alternates, and more
-- **Collection Management**: Find, count, and analyze collections of names
-- **Smart Sampling**: Sample and fetch top members from collections
-- **Advanced Search**: Search collections by string or by collection ID
-
 ## API Reference
 
 ### Client Configuration
@@ -62,12 +63,22 @@ const suggestions = await client.suggestionsByCategory("zeus");
 const members = await client.sampleCollectionMembers("collection_id");
 ```
 
-#### Fetch Top Collection Members
+#### Fetch Collection Members
 
 ```typescript
+// with pagination
+const members = await client.fetchCollectionMembers("collection_id", {offset: 0, limit: 20});
+
+// Top members
 const topMembers = await client.fetchTopCollectionMembers("collection_id");
 ```
 
+#### Generate Scrambled Variations of Collection Tokens
+
+```typescript
+const scrambled = await client.scrambleCollectionTokens('collection_id', {seed: 42});
+```
+
 #### Find Collections
 
 ```typescript
@@ -91,6 +102,11 @@ const stringCount = await client.countCollectionsByString("zeus god");
 const memberCount = await client.countCollectionsByMember("zeus");
 ```
 
+#### Get Collection by ID
+```typescript
+const collection = await client.getCollectionById("collection_id");
+```
+
 ### Response Types
 
 The SDK provides TypeScript types for all API responses. Key types include:
@@ -136,3 +152,13 @@ The SDK supports various grouping categories for name suggestions:
 - `expand`: Expanded versions
 - `gowild`: Creative variations
 - `other`: Additional suggestions
+
+## Contact Us
+
+Visit our [website](https://namehashlabs.org/) to get in contact.
+
+## License
+
+Licensed under the MIT License, Copyright © 2023-present [NameHash Labs](https://namehashlabs.org).
+
+See [LICENSE](./LICENSE) for more information.