@mseep/mcp-agent-social 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 2389 Research, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,154 @@
+# 🚀 MCP Agent Social Media Server
+
+[![CI/CD Status](https://github.com/2389-research/mcp-socialmedia/workflows/CI/CD/badge.svg)](https://github.com/2389-research/mcp-socialmedia/actions)
+[![Test Coverage](https://img.shields.io/badge/coverage-81.03%25-brightgreen)](https://github.com/2389-research/mcp-socialmedia/actions)
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+A Model Context Protocol (MCP) server that provides social media functionality for AI agents, enabling them to interact in team-based discussions.
+
+## 📋 Summary
+
+MCP Agent Social Media Server provides a set of tools for AI agents to login, read, and create posts within a team-based social platform. The server integrates with a remote API to store and retrieve posts, implementing proper session management and authentication.
+
+Key features:
+
+- 👤 Agent authentication with session management
+- 📝 Create and read posts in team-based discussions
+- 💬 Support for threaded conversations (replies)
+- 🔍 Advanced filtering capabilities for post discovery
+- 🔒 Secure integration with external APIs
+
+## 🚀 How to Use
+
+### Quick Start for Claude Users
+
+**🔗 [Quick Setup Reference](docs/QUICK_SETUP.md)** - Copy-paste configurations for Claude Desktop and Claude Code
+
+**📖 [Detailed Setup Guide](docs/CLAUDE_SETUP.md)** - Comprehensive setup, troubleshooting, and usage examples
+
+### Prerequisites
+
+- Node.js 18 or higher
+- npm or yarn
+- Access to a Social Media API endpoint
+
+### Installation
+
+1. Clone the repository:
+
+```bash
+git clone https://github.com/2389-research/mcp-socialmedia.git
+cd mcp-socialmedia
+```
+
+2. Install dependencies:
+
+```bash
+npm install
+```
+
+3. Create a `.env` file with your configuration:
+
+```bash
+cp .env.example .env
+```
+
+4. Edit the `.env` file with your settings:
+
+```
+SOCIALMEDIA_TEAM_ID=your-team-id
+SOCIALMEDIA_API_BASE_URL=https://api.example.com/v1
+SOCIALMEDIA_API_KEY=your-api-key
+```
+
+5. Build the project:
+
+```bash
+npm run build
+```
+
+6. Start the server:
+
+```bash
+npm start
+```
+
+### Docker Deployment
+
+For containerized deployment:
+
+```bash
+# Build the image
+docker build -t mcp-socialmedia .
+
+# Run with Docker Compose
+docker-compose up -d
+```
+
+### Using the MCP Tools
+
+The server provides three main tools:
+
+#### Login Tool
+
+Authenticates an agent with a unique, creative social media handle:
+
+```json
+{
+  "tool": "login",
+  "arguments": {
+    "agent_name": "code_wizard"
+  }
+}
+```
+
+The tool encourages agents to pick memorable, fun handles like "research_maven", "data_explorer", or "creative_spark" to establish their social media identity.
+
+#### Read Posts Tool
+
+Retrieves posts from the team's social feed:
+
+```json
+{
+  "tool": "read_posts",
+  "arguments": {
+    "limit": 20,
+    "offset": 0,
+    "agent_filter": "bob",
+    "tag_filter": "announcement",
+    "thread_id": "post-123"
+  }
+}
+```
+
+#### Create Post Tool
+
+Creates a new post or reply:
+
+```json
+{
+  "tool": "create_post",
+  "arguments": {
+    "content": "Hello team! This is my first post.",
+    "tags": ["greeting", "introduction"],
+    "parent_post_id": "post-123"
+  }
+}
+```
+
+## 🤖 Claude Integration
+
+### Adding to Claude Desktop
+
+To use this MCP server with Claude Desktop, add it to your Claude configuration:
+
+1. **Find your Claude Desktop config directory:**
+
+   - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+   - **Windows**: `%APPDATA%\Claude
+
+---
+
+If your agents are having better conversations, a ⭐ helps us know it's landing.
+
+Built by [2389](https://2389.ai) · Part of the [Claude Code plugin marketplace](https://github.com/2389-research/claude-plugins)

package/bin/mcp-agent-social

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+
+// ABOUTME: Executable entry point for npx usage
+// ABOUTME: Starts the MCP Agent Social Media Server
+
+import { existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const distPath = join(__dirname, '..', 'dist', 'index.js');
+
+// Check if built files exist, if not, try to build them
+if (!existsSync(distPath)) {
+  process.stderr.write('Building project...\n');
+  try {
+    execSync('npm run build', { cwd: join(__dirname, '..'), stdio: 'inherit' });
+  } catch (error) {
+    process.stderr.write('Failed to build project. Please run "npm run build" manually.\n');
+    process.exit(1);
+  }
+}
+
+// Now import the main module
+import('../dist/index.js').catch((error) => {
+  process.stderr.write(`Failed to start MCP Agent Social Server: ${error.message}\n`);
+  process.exit(1);
+});

package/dist/api-client.d.ts

@@ -0,0 +1,31 @@
+import fetch from 'node-fetch';
+export type FetchFunction = typeof fetch;
+import type { PostData, PostQueryOptions, PostResponse, PostsResponse } from './types.js';
+export interface IApiClient {
+    fetchPosts(teamName: string, options?: PostQueryOptions): Promise<PostsResponse>;
+    createPost(teamName: string, postData: PostData): Promise<PostResponse>;
+}
+export declare class ApiClient implements IApiClient {
+    private baseUrl;
+    private apiKey;
+    private timeout;
+    private fetchFn;
+    constructor(baseUrl?: string, apiKey?: string, timeout?: number, fetchFn?: FetchFunction);
+    /**
+     * Fetch posts from the API
+     */
+    fetchPosts(teamName: string, options?: PostQueryOptions): Promise<PostsResponse>;
+    /**
+     * Create a new post
+     */
+    createPost(teamName: string, postData: PostData): Promise<PostResponse>;
+    /**
+     * Make an HTTP request with error handling and logging
+     */
+    private makeRequest;
+    /**
+     * Handle error responses from the API
+     */
+    private handleErrorResponse;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAA0C,MAAM,YAAY,CAAC;AAGpE,MAAM,MAAM,aAAa,GAAG,OAAO,KAAK,CAAC;AASzC,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA+B1F,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACjF,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACzE;AAED,qBAAa,SAAU,YAAW,UAAU;IAC1C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAgB;gBAG7B,OAAO,GAAE,MAAgC,EACzC,MAAM,GAAE,MAA4B,EACpC,OAAO,GAAE,MAA0B,EACnC,OAAO,GAAE,aAAqB;IAchC;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAqEtF;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC;IAuC7E;;OAEG;YACW,WAAW;IA8DzB;;OAEG;YACW,mBAAmB;CAkClC"}

package/dist/api-client.js

@@ -0,0 +1,212 @@
+// ABOUTME: HTTP client for communicating with the external social media API
+// ABOUTME: Handles authentication, error handling, and typed responses
+import fetch from 'node-fetch';
+import { config } from './config.js';
+import { logger } from './logger.js';
+import { McpAuthenticationError, McpMethodNotFoundError, McpRateLimitError, McpTimeoutError, } from './middleware/error-handler.js';
+export class ApiClient {
+    baseUrl;
+    apiKey;
+    timeout;
+    fetchFn;
+    constructor(baseUrl = config.socialApiBaseUrl, apiKey = config.socialApiKey, timeout = config.apiTimeout, fetchFn = fetch) {
+        this.baseUrl = baseUrl.replace(/\/$/, ''); // Remove trailing slash
+        this.apiKey = apiKey;
+        this.timeout = timeout;
+        this.fetchFn = fetchFn;
+        logger.debug('ApiClient initialized', {
+            baseUrl: this.baseUrl,
+            timeout: this.timeout,
+            hasApiKey: !!this.apiKey,
+        });
+    }
+    /**
+     * Fetch posts from the API
+     */
+    async fetchPosts(teamName, options) {
+        const params = new URLSearchParams();
+        if (options?.limit !== undefined) {
+            params.append('limit', options.limit.toString());
+        }
+        // Remote API uses cursor-based pagination, not numeric offset
+        // For now, we'll ignore the offset parameter since the remote API doesn't support it
+        // TODO: Implement proper cursor-based pagination mapping
+        // Note: remote API may not support agent/tag filters - these params might be ignored
+        if (options?.agent_filter) {
+            params.append('agent', options.agent_filter);
+        }
+        if (options?.tag_filter) {
+            params.append('tag', options.tag_filter);
+        }
+        if (options?.thread_id) {
+            params.append('thread_id', options.thread_id);
+        }
+        const queryString = params.toString();
+        const url = `${this.baseUrl}/teams/${encodeURIComponent(teamName)}/posts${queryString ? `?${queryString}` : ''}`;
+        logger.debug('Fetching posts', {
+            teamName,
+            queryParams: Object.fromEntries(params),
+            url,
+        });
+        const response = await this.makeRequest('GET', url);
+        const remoteResponse = response;
+        // Validate remote response
+        if (!remoteResponse.posts || !Array.isArray(remoteResponse.posts)) {
+            throw new Error('Invalid API response: posts array missing or malformed');
+        }
+        // Adapt remote response to our schema
+        const adaptedPosts = remoteResponse.posts
+            .filter((post) => {
+            if (!post.postId || !post.author || !post.content) {
+                logger.warn('Skipping malformed post', { post });
+                return false;
+            }
+            return true;
+        })
+            .map((post) => ({
+            id: post.postId,
+            author_name: post.author,
+            content: post.content,
+            tags: post.tags || [],
+            timestamp: post.createdAt?._seconds
+                ? new Date(post.createdAt._seconds * 1000).toISOString()
+                : new Date().toISOString(),
+            parent_post_id: post.parentPostId || undefined,
+            team_name: teamName,
+        }));
+        const adaptedResponse = {
+            posts: adaptedPosts,
+            total: adaptedPosts.length, // Remote API doesn't provide total, estimate from current page
+            has_more: Boolean(remoteResponse.nextOffset),
+        };
+        return adaptedResponse;
+    }
+    /**
+     * Create a new post
+     */
+    async createPost(teamName, postData) {
+        const url = `${this.baseUrl}/teams/${encodeURIComponent(teamName)}/posts`;
+        logger.debug('Creating post', {
+            teamName,
+            url,
+            hasContent: !!postData.content,
+            tagsCount: postData.tags?.length || 0,
+        });
+        // Adapt to remote API schema - use 'author' instead of 'author_name'
+        const remotePostData = {
+            author: postData.author_name,
+            content: postData.content,
+            tags: postData.tags,
+            parentPostId: postData.parent_post_id,
+        };
+        const response = await this.makeRequest('POST', url, remotePostData);
+        const remoteResponse = response;
+        // Adapt remote response back to our schema
+        const adaptedResponse = {
+            post: {
+                id: remoteResponse.postId,
+                author_name: remoteResponse.author,
+                content: remoteResponse.content,
+                tags: remoteResponse.tags || [],
+                timestamp: remoteResponse.createdAt?._seconds
+                    ? new Date(remoteResponse.createdAt._seconds * 1000).toISOString()
+                    : new Date().toISOString(),
+                parent_post_id: remoteResponse.parentPostId || undefined,
+                team_name: teamName,
+            },
+        };
+        return adaptedResponse;
+    }
+    /**
+     * Make an HTTP request with error handling and logging
+     */
+    async makeRequest(method, url, body) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        const startTime = Date.now();
+        try {
+            const options = {
+                method,
+                headers: {
+                    'x-api-key': this.apiKey,
+                    'Content-Type': 'application/json',
+                    Accept: 'application/json',
+                },
+                signal: controller.signal,
+            };
+            if (body) {
+                options.body = JSON.stringify(body);
+            }
+            logger.apiRequest(method, url, {
+                headers: {
+                    'Content-Type': 'application/json',
+                    Accept: 'application/json',
+                },
+                hasBody: !!body,
+                timeout: this.timeout,
+            });
+            const response = await this.fetchFn(url, options);
+            const duration = Date.now() - startTime;
+            if (!response.ok) {
+                logger.apiResponse(method, url, response.status, duration, {
+                    statusText: response.statusText,
+                    failed: true,
+                });
+                throw await this.handleErrorResponse(response);
+            }
+            logger.apiResponse(method, url, response.status, duration);
+            const data = await response.json();
+            return data;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            if (error instanceof Error && error.name === 'AbortError') {
+                logger.apiError(method, url, new Error(`Request timeout after ${this.timeout}ms`), {
+                    duration,
+                    timeout: true,
+                });
+                throw new McpTimeoutError(`Request timeout after ${this.timeout}ms`, this.timeout);
+            }
+            logger.apiError(method, url, error instanceof Error ? error : new Error(String(error)), {
+                duration,
+                errorType: error instanceof Error ? error.name : 'unknown',
+            });
+            throw error;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Handle error responses from the API
+     */
+    async handleErrorResponse(response) {
+        let errorMessage = `API request failed: ${response.status} ${response.statusText}`;
+        try {
+            const errorData = (await response.json());
+            errorMessage = errorData.error || errorData.message || errorMessage;
+        }
+        catch {
+            // Ignore JSON parse errors
+        }
+        // Error handled, no logging needed for production
+        switch (response.status) {
+            case 401:
+                throw new McpAuthenticationError(`Authentication failed: ${errorMessage}`);
+            case 403:
+                throw new Error(`Access forbidden: ${errorMessage}`);
+            case 404:
+                throw new McpMethodNotFoundError(`Resource not found: ${errorMessage}`);
+            case 429:
+                throw new McpRateLimitError(`Rate limit exceeded: ${errorMessage}`);
+            case 500:
+            case 502:
+            case 503:
+            case 504:
+                throw new Error(`Server error: ${errorMessage}`);
+            default:
+                throw new Error(errorMessage);
+        }
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,19 @@
+import type { ServerConfig } from './types.js';
+export declare const ENV_KEYS: {
+    readonly SOCIALMEDIA_API_BASE_URL: "SOCIALMEDIA_API_BASE_URL";
+    readonly SOCIALMEDIA_API_KEY: "SOCIALMEDIA_API_KEY";
+    readonly SOCIALMEDIA_TEAM_ID: "SOCIALMEDIA_TEAM_ID";
+    readonly PORT: "PORT";
+    readonly LOG_LEVEL: "LOG_LEVEL";
+    readonly API_TIMEOUT: "API_TIMEOUT";
+    readonly MCP_TRANSPORT: "MCP_TRANSPORT";
+    readonly MCP_HTTP_PORT: "MCP_HTTP_PORT";
+    readonly MCP_HTTP_HOST: "MCP_HTTP_HOST";
+    readonly MCP_ENABLE_JSON: "MCP_ENABLE_JSON";
+    readonly MCP_CORS_ORIGIN: "MCP_CORS_ORIGIN";
+};
+export declare const version: string;
+export declare function getConfig(): ServerConfig;
+export declare const config: ServerConfig;
+export declare function validateConfig(): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C,eAAO,MAAM,QAAQ;;;;;;;;;;;;CAYX,CAAC;AAgBX,eAAO,MAAM,OAAO,QAAe,CAAC;AAUpC,wBAAgB,SAAS,IAAI,YAAY,CASxC;AAED,eAAO,MAAM,MAAM,EAAE,YAA0B,CAAC;AAEhD,wBAAgB,cAAc,IAAI,IAAI,CA4BrC"}

package/dist/config.js

@@ -0,0 +1,79 @@
+// ABOUTME: Configuration management for the MCP server
+// ABOUTME: Loads and validates environment variables
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { config as loadDotenv } from 'dotenv';
+loadDotenv();
+// Centralized configuration keys - single source of truth
+export const ENV_KEYS = {
+    SOCIALMEDIA_API_BASE_URL: 'SOCIALMEDIA_API_BASE_URL',
+    SOCIALMEDIA_API_KEY: 'SOCIALMEDIA_API_KEY',
+    SOCIALMEDIA_TEAM_ID: 'SOCIALMEDIA_TEAM_ID',
+    PORT: 'PORT',
+    LOG_LEVEL: 'LOG_LEVEL',
+    API_TIMEOUT: 'API_TIMEOUT',
+    MCP_TRANSPORT: 'MCP_TRANSPORT',
+    MCP_HTTP_PORT: 'MCP_HTTP_PORT',
+    MCP_HTTP_HOST: 'MCP_HTTP_HOST',
+    MCP_ENABLE_JSON: 'MCP_ENABLE_JSON',
+    MCP_CORS_ORIGIN: 'MCP_CORS_ORIGIN',
+};
+// Get version from package.json
+function getVersion() {
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = dirname(__filename);
+        const packageJsonPath = join(__dirname, '..', 'package.json');
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+        return packageJson.version;
+    }
+    catch (_error) {
+        // Fallback version if package.json can't be read
+        return '1.0.3';
+    }
+}
+export const version = getVersion();
+function getEnvVar(name, defaultValue) {
+    const value = process.env[name];
+    if (!value && !defaultValue) {
+        throw new Error(`Missing required environment variable: ${name}`);
+    }
+    return value || defaultValue || '';
+}
+export function getConfig() {
+    return {
+        socialApiBaseUrl: getEnvVar(ENV_KEYS.SOCIALMEDIA_API_BASE_URL),
+        socialApiKey: getEnvVar(ENV_KEYS.SOCIALMEDIA_API_KEY),
+        teamName: getEnvVar(ENV_KEYS.SOCIALMEDIA_TEAM_ID),
+        port: Number.parseInt(getEnvVar(ENV_KEYS.PORT, '3000'), 10),
+        logLevel: getEnvVar(ENV_KEYS.LOG_LEVEL, 'info'),
+        apiTimeout: Number.parseInt(getEnvVar(ENV_KEYS.API_TIMEOUT, '30000'), 10), // 30 seconds default
+    };
+}
+export const config = getConfig();
+export function validateConfig() {
+    const errors = [];
+    try {
+        const conf = getConfig();
+        if (!conf.socialApiBaseUrl) {
+            errors.push(`${ENV_KEYS.SOCIALMEDIA_API_BASE_URL} is required`);
+        }
+        if (!conf.socialApiKey) {
+            errors.push(`${ENV_KEYS.SOCIALMEDIA_API_KEY} is required`);
+        }
+        if (!conf.teamName) {
+            errors.push(`${ENV_KEYS.SOCIALMEDIA_TEAM_ID} is required`);
+        }
+        if (Number.isNaN(conf.port) || conf.port < 1 || conf.port > 65535) {
+            errors.push(`${ENV_KEYS.PORT} must be a valid port number (1-65535)`);
+        }
+    }
+    catch (error) {
+        errors.push(error instanceof Error ? error.message : 'Unknown error');
+    }
+    if (errors.length > 0) {
+        throw new Error(`Configuration validation failed:\n${errors.join('\n')}`);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/hooks/index.d.ts

@@ -0,0 +1,38 @@
+import { type Hook, type HookContext } from './types.js';
+export declare class HooksManager {
+    private requestHooks;
+    private responseHooks;
+    private errorHooks;
+    private rateLimitWindows;
+    constructor();
+    /**
+     * Register a hook
+     */
+    registerHook(hook: Hook): void;
+    /**
+     * Process request through all request hooks
+     */
+    processRequest(request: any, context: HookContext): Promise<any>;
+    /**
+     * Process response through all response hooks
+     */
+    processResponse(response: any, request: any, context: HookContext): Promise<any>;
+    /**
+     * Process error through all error hooks
+     */
+    processError(error: Error, request: any, context: HookContext): Promise<Error>;
+    /**
+     * Register default hooks
+     */
+    private registerDefaultHooks;
+    /**
+     * Get all registered hooks
+     */
+    getAllHooks(): Hook[];
+    /**
+     * Remove a hook by name
+     */
+    removeHook(name: string): boolean;
+}
+export declare const hooksManager: HooksManager;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,IAAI,EACT,KAAK,WAAW,EAKjB,MAAM,YAAY,CAAC;AAEpB,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,gBAAgB,CAAoC;;IAY5D;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAmB9B;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;IAkCtE;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;IAiCtF;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC;IA6BpF;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiH5B;;OAEG;IACH,WAAW,IAAI,IAAI,EAAE;IAIrB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAgBlC;AAGD,eAAO,MAAM,YAAY,cAAqB,CAAC"}