@foru-ms/sdk 1.1.0 → 1.2.0

package/README.md

@@ -1,8 +1,18 @@
 # @foru-ms/sdk
 
-The official JavaScript/TypeScript SDK for [Foru.ms](https://foru.ms). Build powerful community features directly into your application.
+The official JavaScript/ TypeScript SDK for [Foru.ms](https://foru.ms). Build powerful community features directly into your application.
 
-This SDK is fully typed and provides a comprehensive interface to the Foru.ms API.
+This SDK is fully typed and provides a comprehensive interface to the Foru.ms API with built-in error handling, automatic retries, and pagination helpers.
+
+## Features
+
+✨ **Fully Typed** - Complete TypeScript support with detailed type definitions  
+🔄 **Auto Retry** - Automatic retry logic for rate limits and server errors  
+📄 **Easy Pagination** - Built-in helpers for cursor-based pagination  
+🚨 **Rich Error Classes** - Specific error types for better error handling  
+🔐 **Webhook Verification** - Built-in signature verification for webhooks  
+📊 **Rate Limit Tracking** - Automatic tracking of API rate limits  
+📚 **Comprehensive Examples** - Detailed examples for common use cases
 
 ## Installation
 
@@ -14,20 +24,156 @@ yarn add @foru-ms/sdk
 pnpm add @foru-ms/sdk
 ```
 
-## Setup & Initialization
+## Quick Start
 
 ```typescript
 import { ForumClient } from '@foru-ms/sdk';
 
 const client = new ForumClient({
   apiKey: 'your_api_key',
-  // baseUrl: 'https://api.foru.ms/v1' // Optional
+  baseUrl: 'https://api.foru.ms/v1', // Optional
+  maxRetries: 3, // Optional, default: 3
+  enableRetry: true, // Optional, default: true
 });
 
 // Set an authentication token (JWT) for user-scoped requests
 client.setToken('user_jwt_token');
+
+// Create a thread
+const thread = await client.threads.create({
+  title: 'My First Thread',
+  body: 'Hello, Foru.ms!',
+  userId: 'user-123',
+});
+
+// List threads with auto-pagination
+for await (const thread of client.pagination.paginateAll(
+  (cursor) => client.threads.list({ cursor })
+)) {
+  console.log(thread.title);
+}
+```
+
+## Error Handling
+
+The SDK provides specific error classes for different scenarios:
+
+```typescript
+import {
+  ForumClient,
+  AuthenticationError,
+  NotFoundError,
+  RateLimitError,
+  ValidationError
+} from '@foru-ms/sdk';
+
+try {
+  await client.threads.retrieve('thread-id');
+} catch (error) {
+  if (error instanceof NotFoundError) {
+    console.log('Thread not found');
+  } else if (error instanceof RateLimitError) {
+    console.log('Rate limited, retry after:', error.retryAfter);
+  } else if (error instanceof AuthenticationError) {
+    console.log('Authentication failed');
+  }
+}
+```
+
+**Available Error Classes:**
+- `ForumAPIError` - Base class for all API errors
+- `AuthenticationError` - 401 errors
+- `AuthorizationError` - 403 errors
+- `NotFoundError` - 404 errors
+- `ValidationError` - 422 errors
+- `RateLimitError` - 429 errors
+- `ServerError` - 5xx errors
+- `NetworkError` - Network/connection errors
+
+## Pagination
+
+The SDK provides multiple ways to handle pagination:
+
+```typescript
+// Auto-pagination with async iterator
+for await (const thread of client.pagination.paginateAll(
+  (cursor) => client.threads.list({ cursor, filter: 'newest' })
+)) {
+  console.log(thread.title);
+}
+
+// Fetch all pages at once
+const allThreads = await client.pagination.fetchAllPages(
+  (cursor) => client.threads.list({ cursor }),
+  5 // max pages
+);
+
+// Manual pagination
+let cursor: string | undefined;
+do {
+  const response = await client.threads.list({ cursor });
+  // Process threads...
+  cursor = response.nextThreadCursor;
+} while (cursor);
 ```
 
+## Webhooks
+
+Verify webhook signatures for security. All webhooks include:
+- `X-Webhook-Signature`: HMAC-SHA256 signature
+- `X-Webhook-Timestamp`: Unix timestamp (milliseconds)
+- `X-Webhook-Event`: Event type
+
+```typescript
+app.post('/webhooks/foru', (req, res) => {
+  const signature = req.headers['x-webhook-signature'];
+  const timestamp = req.headers['x-webhook-timestamp'];
+  const event = req.headers['x-webhook-event'];
+  
+  // Verify signature with timestamp (prevents replay attacks)
+  const isValid = client.webhooks.verifySignature(
+    req.body,
+    signature,
+    timestamp,
+    'your_webhook_secret'
+  );
+
+  if (!isValid) {
+    return res.status(401).send('Invalid signature');
+  }
+
+  // Process webhook...
+  console.log('Event:', event);
+  res.send('OK');
+});
+```
+
+## Rate Limiting
+
+Track rate limit information automatically:
+
+```typescript
+await client.threads.list();
+
+if (client.lastRateLimitInfo) {
+  console.log('Limit:', client.lastRateLimitInfo.limit);
+  console.log('Remaining:', client.lastRateLimitInfo.remaining);
+  console.log('Resets at:', new Date(client.lastRateLimitInfo.reset * 1000));
+}
+```
+
+## Examples
+
+Check the `/examples` directory for detailed examples:
+
+- [Authentication](./examples/authentication.ts) - Login, registration, token management
+- [Managing Threads](./examples/managing-threads.ts) - CRUD operations, polls, interactions
+- [Pagination](./examples/pagination.ts) - Different pagination strategies
+- [Error Handling](./examples/error-handling.ts) - Comprehensive error handling
+- [Webhooks](./examples/webhooks.ts) - Setup and verification
+
+
+
 ## API Reference
 
 ### Auth (`client.auth`)
@@ -40,7 +186,7 @@ client.setToken('user_jwt_token');
 
 ### Threads (`client.threads`)
 
-*   `list(params: { limit?: number; filter?: 'newest' | 'oldest'; tagId?: string; categoryId?: string; cursor?: string })`: List threads.
+*   `list(params: { limit?: number; filter?: 'newest' | 'oldest'; tagId?: string; cursor?: string })`: List threads.
 *   `create(payload: CreateThreadPayload)`: Create a new thread.
 *   `retrieve(id: string)`: Get a thread by ID.
 *   `update(id: string, payload: UpdateThreadPayload)`: Update a thread.
@@ -48,10 +194,20 @@ client.setToken('user_jwt_token');
 *   `getPosts(id: string, params: { cursor?: string; filter?: 'newest' | 'oldest' })`: Get posts in a thread.
 *   `like(id: string, userId: string, extendedData?: any)`: Like a thread.
 *   `unlike(id: string, userId: string)`: Unlike a thread.
+*   `getLikes(id: string, params?: { cursor?: string })`: Get users who liked a thread.
 *   `dislike(id: string, userId: string, extendedData?: any)`: Dislike a thread.
 *   `undislike(id: string, userId: string)`: Remove dislike from a thread.
+*   `getDislikes(id: string, params?: { cursor?: string })`: Get users who disliked a thread.
 *   `subscribe(id: string, userId: string)`: Subscribe to a thread.
 *   `unsubscribe(id: string, userId: string)`: Unsubscribe from a thread.
+*   `getSubscribers(id: string, params?: { cursor?: string })`: Get users subscribed to a thread.
+*   `upvote(id: string, userId: string, extendedData?: any)`: Upvote a thread.
+*   `unupvote(id: string, userId: string)`: Remove upvote from a thread.
+*   `getUpvotes(id: string, params?: { cursor?: string })`: Get users who upvoted a thread.
+*   `downvote(id: string, userId: string, extendedData?: any)`: Downvote a thread.
+*   `undownvote(id: string, userId: string)`: Remove downvote from a thread.
+*   `getDownvotes(id: string, params?: { cursor?: string })`: Get users who downvoted a thread.
+*   `getPoll(id: string, userId?: string)`: Get poll results.
 *   `vote(id: string, userId: string, optionId: string)`: Vote in a thread poll.
 *   `voteUpdate(id: string, userId: string, optionId: string)`: Change vote.
 *   `unvote(id: string, userId: string)`: Remove vote.
@@ -66,41 +222,51 @@ client.setToken('user_jwt_token');
 *   `getChildren(id: string, params: { cursor?: string; filter?: 'newest' | 'oldest' })`: Get child posts (nested replies).
 *   `like(id: string, userId: string, extendedData?: any)`: Like a post.
 *   `unlike(id: string, userId: string)`: Unlike a post.
+*   `getLikes(id: string, params?: { cursor?: string })`: Get users who liked a post.
 *   `dislike(id: string, userId: string, extendedData?: any)`: Dislike a post.
 *   `undislike(id: string, userId: string)`: Remove dislike.
+*   `getDislikes(id: string, params?: { cursor?: string })`: Get users who disliked a post.
 *   `upvote(id: string, userId: string, extendedData?: any)`: Upvote a post.
 *   `unupvote(id: string, userId: string)`: Remove upvote.
+*   `getUpvotes(id: string, params?: { cursor?: string })`: Get users who upvoted a post.
 *   `downvote(id: string, userId: string, extendedData?: any)`: Downvote a post.
 *   `undownvote(id: string, userId: string)`: Remove downvote.
+*   `getDownvotes(id: string, params?: { cursor?: string })`: Get users who downvoted a post.
 
 ### Users (`client.users`)
 
-*   `list(params: { query?: string; filter?: 'newest' | 'oldest'; cursor?: string })`: List users.
-*   `retrieve(id: string)`: Get user by ID.
-*   `create(payload: any)`: Create a user (Admin).
-*   `update(id: string, payload: any)`: Update a user.
+*   `list(params?: { query?: string; filter?: 'newest' | 'oldest'; cursor?: string })`: List users.
+*   `retrieve(userId: string)`: Get user by ID.
+*   `create(payload: { username: string; email: string; password: string; displayName?: string; emailVerified?: boolean; roles?: string[]; bio?: string; signature?: string; url?: string; extendedData?: Record<string, any> })`: Create a user (Admin).
+*   `update(id: string, payload: { username?: string; email?: string; password?: string; displayName?: string; emailVerified?: boolean; roles?: string[]; bio?: string; signature?: string; url?: string; extendedData?: Record<string, any> })`: Update a user.
 *   `delete(id: string)`: Delete a user.
-*   `getFollowers(id: string, params: { cursor?: string })`: Get user's followers.
-*   `getFollowing(id: string, params: { cursor?: string })`: Get who a user follows.
+*   `getThreads(id: string, params?: { query?: string; cursor?: string; filter?: 'newest' | 'oldest' })`: Get all threads created by a user.
+*   `getPosts(id: string, params?: { query?: string; cursor?: string; filter?: 'newest' | 'oldest' })`: Get all posts created by a user.
+*   `getFollowers(id: string, params?: { query?: string; cursor?: string; filter?: 'newest' | 'oldest' })`: Get user's followers.
+*   `getFollowing(id: string, params?: { query?: string; cursor?: string; filter?: 'newest' | 'oldest' })`: Get who a user follows.
 *   `follow(id: string, followerId: string, extendedData?: any)`: Follow a user.
 *   `unfollow(id: string, followerId: string)`: Unfollow a user.
 
+
 ### Tags (`client.tags`)
 
-*   `list(params: { query?: string; cursor?: string })`: List tags.
-*   `create(payload: { name: string; description?: string; color?: string; extendedData?: any })`: Create a tag.
+*   `list(params?: { query?: string; cursor?: string })`: List tags.
+*   `create(payload: { name: string; description?: string; color?: string; extendedData?: Record<string, any> })`: Create a tag.
 *   `retrieve(id: string, params?: { userId?: string })`: Get a tag.
-*   `update(id: string, payload: any)`: Update a tag.
+*   `update(id: string, payload: { name?: string; description?: string; color?: string; extendedData?: Record<string, any> })`: Update a tag.
 *   `delete(id: string)`: Delete a tag.
+*   `getThreads(id: string, params?: { query?: string; cursor?: string; filter?: 'newest' | 'oldest' })`: Get all threads with a specific tag.
 *   `subscribe(id: string, userId: string)`: Subscribe to a tag.
 *   `unsubscribe(id: string, userId: string)`: Unsubscribe from a tag.
-*   `listSubscribed(params: { userId: string; cursor?: string })`: List tags a user is subscribed to.
+*   `getSubscribers(id: string, params?: { cursor?: string })`: Get users subscribed to a tag.
+*   `listSubscribed(params: { userId: string; query?: string; cursor?: string })`: List tags a user is subscribed to.
+
 
 ### Notifications (`client.notifications`)
 
-*   `list(params: { userId: string; read?: boolean; filter?: string; cursor?: string })`: List notifications.
-*   `markAllAsRead(userId: string, read?: boolean)`: Bulk update read status.
-*   `create(payload: any)`: Create a notification manually.
+*   `list(params: { userId: string; read?: boolean; filter?: 'newest' | 'oldest'; cursor?: string })`: List notifications.
+*   `markAllAsRead(userId: string, read?: boolean)`: Bulk update read status. Default is `true`.
+*   `create(payload: { threadId?: string; postId?: string; privateMessageId?: string; notifierId: string; notifiedId: string; type: string; description?: string; extendedData?: Record<string, any> })`: Create a notification manually.
 *   `retrieve(id: string)`: Get a notification.
 *   `update(id: string, payload: { read: boolean })`: Update a notification.
 *   `delete(id: string)`: Delete a notification.
@@ -125,65 +291,236 @@ client.setToken('user_jwt_token');
 ### Integrations (`client.integrations`)
 
 *   `list()`: Get all configured integrations.
-*   `create(payload: { type: string; name: string; config: any })`: Configure an integration (Slack, Discord, etc.).
+*   `create(payload: { type: 'SLACK' | 'DISCORD' | 'SALESFORCE' | 'HUBSPOT' | 'OKTA' | 'AUTH0'; name: string; config: any })`: Configure an integration (Slack, Discord, etc.).
 *   `retrieve(id: string)`: Get integration details.
+*   `update(id: string, payload: { name?: string; config?: any; active?: boolean })`: Update an integration.
 *   `delete(id: string)`: Remove an integration.
 
 ### Private Messages (`client.privateMessages`)
 
-*   `list(params: { userId?: string; cursor?: string })`: List private messages.
-*   `create(payload: { title?: string; body: string; recipientId: string; senderId?: string })`: Send a direct message.
+*   `list(params?: { query?: string; userId?: string; filter?: 'newest' | 'oldest'; cursor?: string })`: List private messages.
+*   `create(payload: { title?: string; body: string; recipientId: string; senderId?: string; extendedData?: Record<string, any> })`: Send a direct message.
 *   `retrieve(id: string)`: Get a message thread.
-*   `reply(id: string, payload: { body: string; senderId: string; recipientId: string })`: Reply to a message.
+*   `reply(id: string, payload: { body: string; senderId: string; recipientId: string; extendedData?: Record<string, any> })`: Reply to a message.
+*   `update(id: string, payload: { read?: boolean; extendedData?: Record<string, any> })`: Update a message (e.g., mark as read).
 *   `delete(id: string)`: Delete a message.
 
 ### Reports (`client.reports`)
 
-*   `list(params: { reporterId?: string; reportedId?: string; read?: boolean; cursor?: string })`: List reports.
-*   `create(payload: { reporterId: string; type: string; description?: string; ... })`: Submit a report.
+*   `list(params?: { reporterId?: string; reportedId?: string; read?: boolean; cursor?: string; filter?: 'newest' | 'oldest' })`: List reports.
+*   `create(payload: { reporterId: string; reportedId?: string; threadId?: string; postId?: string; privateMessageId?: string; type?: string; description?: string; extendedData?: Record<string, any> })`: Submit a report.
 *   `batchUpdate(payload: { reportIds: string[]; read: boolean })`: Bulk update status.
 *   `retrieve(id: string)`: Get a report.
-*   `update(id: string, payload: any)`: Update report details.
+*   `update(id: string, payload: { threadId?: string; postId?: string; privateMessageId?: string; reportedId?: string; reporterId?: string; type?: string; description?: string; read?: boolean; extendedData?: Record<string, any> })`: Update report details.
 *   `delete(id: string)`: Delete a report.
 *   `updateStatus(id: string, read: boolean)`: Update read status of a report.
 
 ### Roles (`client.roles`)
 
-*   `list(params: { cursor?: string })`: List user roles.
-*   `create(payload: { name: string; description?: string; color?: string })`: Create a new role.
+*   `list(params?: { filter?: 'newest' | 'oldest'; cursor?: string })`: List user roles.
+*   `create(payload: { name: string; description?: string; color?: string; extendedData?: Record<string, any> })`: Create a new role.
 *   `retrieve(id: string)`: Get a role.
-*   `update(id: string, payload: any)`: Update a role.
+*   `update(id: string, payload: { name?: string; description?: string; color?: string; extendedData?: Record<string, any> })`: Update a role.
 *   `delete(id: string)`: Delete a role.
 
 ### SSO (`client.sso`)
 
 *   `list()`: List SSO providers.
-*   `create(payload: { provider: string; domain: string; config: any })`: Configure SSO.
+*   `create(payload: { provider: 'OKTA' | 'AUTH0' | 'SAML'; domain: string; config: any })`: Configure SSO.
+*   `retrieve(id: string)`: Get SSO provider details.
+*   `update(id: string, payload: { domain?: string; config?: any; active?: boolean })`: Update SSO configuration.
 *   `delete(id: string)`: Remove SSO provider.
 
 ## Types
 
-Import interfaces directly from the package:
+Import all available interfaces and types directly from the package:
 
 ```typescript
 import { 
-  Thread, Post, User, Tag, Notification, 
-  LoginResponse, RegisterPayload 
+  // Auth Types
+  RegisterPayload,
+  User,
+  LoginResponse,
+  
+  // Thread Types
+  Thread,
+  CreateThreadPayload,
+  UpdateThreadPayload,
+  ThreadListResponse,
+  ThreadFilter,
+  
+  // Post Types
+  Post,
+  CreatePostPayload,
+  UpdatePostPayload,
+  PostListResponse,
+  
+  // Tag Types
+  Tag,
+  TagListResponse,
+  
+  // User Types
+  UserListResponse,
+  
+  // Notification Types
+  Notification,
+  NotificationListResponse,
+  
+  // Search Types
+  SearchResponse,
+  
+  // Webhook Types
+  Webhook,
+  WebhookListResponse,
+  
+  // Stats Types
+  StatsResponse,
+  
+  // Integration Types
+  Integration,
+  IntegrationListResponse,
+  
+  // Private Message Types
+  PrivateMessage,
+  PrivateMessageListResponse,
+  
+  // Report Types
+  Report,
+  ReportListResponse,
+  
+  // Role Types
+  Role,
+  RoleListResponse,
+  
+  // SSO Types
+  SSOProvider,
+  SSOProviderListResponse,
+  
+  // Utility Types
+  PaginatedResponse,
+  InteractionType,
+  
+  // Error Classes
+  ForumAPIError,
+  AuthenticationError,
+  AuthorizationError,
+  NotFoundError,
+  ValidationError,
+  RateLimitError,
+  ServerError,
+  NetworkError,
+  
+  // Response Types
+  RateLimitInfo,
+  ResponseMetadata,
+  APIResponse,
+  InteractionListResponse,
+  PollResponse,
+  PollOption,
+  
+  // Utilities
+  PaginationHelper,
+  Validator,
+  RetryHelper
 } from '@foru-ms/sdk';
 ```
 
-## Error Handling
+## Advanced Usage
 
-All methods return a Promise. If the API returns a non-200 status, the Promise rejects with an Error object containing the server message.
+### Custom Client Options
 
 ```typescript
-try {
-  await client.threads.create({ ... });
-} catch (err: any) {
-  console.error("Error creating thread:", err.message);
+const client = new ForumClient({
+  apiKey: 'your_api_key',
+  baseUrl: 'https://api.foru.ms/v1',
+  maxRetries: 5,        // Increase retry attempts
+  enableRetry: true,    // Enable auto-retry (default: true)
+});
+
+// Access rate limit info after any request
+await client.threads.list();
+console.log('Rate limit:', client.lastRateLimitInfo);
+
+// Check authentication status
+if (client.isAuthenticated()) {
+  const user = await client.auth.me();
 }
 ```
 
+### Async Iteration for Large Datasets
+
+```typescript
+// Automatically fetch all pages
+for await (const user of client.pagination.paginateAll(
+  (cursor) => client.users.list({ cursor })
+)) {
+  await processUser(user);
+  // Pagination happens automatically in the background
+}
+```
+
+### Batch Operations
+
+```typescript
+// Fetch multiple items efficiently
+const threadIds = ['id1', 'id2', 'id3'];
+const threads = await Promise.all(
+  threadIds.map(id => client.threads.retrieve(id))
+);
+```
+
+## Best Practices
+
+1. **Error Handling**: Always use try-catch with specific error types
+2. **Rate Limits**: Monitor `client.lastRateLimitInfo` for API usage
+3. **Webhooks**: Always verify signatures to prevent unauthorized requests
+4. **Pagination**: Use async iterators for large result sets
+5. **Authentication**: Store tokens securely, never in client-side code
+
+## Troubleshooting
+
+### Rate Limit Errors
+
+If you encounter rate limit errors frequently, consider:
+- Implementing caching for frequently accessed data
+- Using pagination helpers to avoid fetching too much data
+- Batching operations where possible
+
+### Authentication Issues
+
+- Ensure your API key is valid and active
+- Check that tokens haven't expired
+- Use `client.isAuthenticated()` to verify authentication status
+
+### Webhook Verification Failures
+
+- Verify you're using the correct webhook secret
+- Check that timestamps aren't too old (default: 5 minutes)
+- Ensure you're passing the raw payload object, not a string
+
+## Contributing
+
+We welcome contributions! Please see our contributing guidelines for more information.
+
+## Support
+
+- 📧 Email: support@foru.ms
+- 📚 Documentation: https://docs.foru.ms
+- 🐛 Issues: https://github.com/foru-ms/sdk/issues
+
+## Changelog
+
+### v1.2.0
+- Added custom error classes for better error handling
+- Added automatic retry logic with exponential backoff
+- Added pagination helpers for easy iteration
+- Added webhook signature verification
+- Added 22 new endpoints
+- Enhanced documentation and examples
+
+### v1.x
+- Initial SDK release with core functionality
+
 ## License
 
 MIT

package/dist/Client.d.ts

@@ -12,10 +12,42 @@ import { PrivateMessagesResource } from './resources/PrivateMessages';
 import { ReportsResource } from './resources/Reports';
 import { RolesResource } from './resources/Roles';
 import { SSOResource } from './resources/SSO';
+import { PaginationHelper } from './utils';
+import { RateLimitInfo } from './response-types';
+export interface ClientOptions {
+    /** API key for authentication */
+    apiKey: string;
+    /** Base URL for the API (default: https://api.foru.ms/v1) */
+    baseUrl?: string;
+    /** Maximum number of retry attempts for failed requests (default: 3) */
+    maxRetries?: number;
+    /** Enable automatic retry for rate limits and server errors (default: true) */
+    enableRetry?: boolean;
+}
+/**
+ * Main client for interacting with the Foru.ms API
+ * @example
+ * ```typescript
+ * const client = new ForumClient({
+ *   apiKey: 'your_api_key',
+ *   baseUrl: 'https://api.foru.ms/v1'
+ * });
+ *
+ * // Set user token
+ * client.setToken('user_jwt_token');
+ *
+ * // Use resources
+ * const threads = await client.threads.list();
+ * ```
+ */
 export declare class ForumClient {
     apiKey: string;
     token: string | null;
     baseUrl: string;
+    maxRetries: number;
+    enableRetry: boolean;
+    /** Last known rate limit info */
+    lastRateLimitInfo?: RateLimitInfo;
     auth: AuthResource;
     threads: ThreadsResource;
     posts: PostsResource;
@@ -30,10 +62,37 @@ export declare class ForumClient {
     reports: ReportsResource;
     roles: RolesResource;
     sso: SSOResource;
-    constructor(options: {
-        apiKey: string;
-        baseUrl?: string;
-    });
+    /** Pagination helper for auto-paginating through results */
+    pagination: PaginationHelper;
+    constructor(options: ClientOptions);
+    /**
+     * Make an HTTP request to the API
+     * @param path - API endpoint path
+     * @param options - Fetch options
+     * @returns Promise resolving to the response data
+     * @throws {ForumAPIError} When the API returns an error
+     * @throws {NetworkError} When the network request fails
+     */
     request<T>(path: string, options?: RequestInit): Promise<T>;
+    /**
+     * Set the authentication token for user-scoped requests
+     * @param token - JWT token
+     */
     setToken(token: string): void;
+    /**
+     * Clear the authentication token
+     */
+    clearToken(): void;
+    /**
+     * Check if client is authenticated
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Extract and store rate limit information from response headers
+     */
+    private extractRateLimitInfo;
+    /**
+     * Handle error responses by throwing appropriate error types
+     */
+    private handleErrorResponse;
 }